NAntCollections

Created Issue: Fix the "static-ness" of the dictionaries / lists for sessions

JeffyW — Wed, 23 Jul 2008 16:31:03 GMT

If a nant task calls the <nant> target calling a script which subsequently loads dictionaries, those dictionaries collide and overwrite each-other. These should be isolated.

CREATED ISSUE: Clean up errors in documentation

JeffyW — Thu, 01 Nov 2007 20:15:21 GMT

This ticket will be used to track as many errors in documentation that should be cleaned up for the next release:

dict::contains-key
<echo message="MyFirstKey found: ${dict::contains-key('MyDict','MyFirstKey)}"/>
<echo message="MyThirdKey found: ${dict::contains-key('MyDict','MyThirdKey)}"/>
- Should read -
<echo message="MyFirstKey found: ${dict::contains-key('MyDict','MyFirstKey')}"/>
<echo message="MyThirdKey found: ${dict::contains-key('MyDict','MyThirdKey')}"/>

list-create
<list-create dictionary="MyList">
- Should read -
<list-create list="MyList">

COMMENTED ISSUE: New function "list::top"

jkohlhepp — Thu, 01 Nov 2007 01:32:57 GMT

I'd like to see a function that will return the value of the last item added (the "top") much like the "pop" function without removing that item. This will allow me to add an item and then reference it like:

<list-add list="xyz" value="item"/>
<property name="action.${list::top('xyz')" value="something"/>

Currently I
<property name="a" value="item"/>
<list-add list="xyz" value="${a}"/>
<property name="action.${a}" value="something"/>
Comments: ** Comment from web user: jkohlhepp **

Could you just do a ${list::get-item(list::count-1))}? Not sure if "get-item" is the name of the function but you get the idea...

CREATED ISSUE: New function "list::top"

JeffyW — Tue, 30 Oct 2007 19:15:23 GMT

NEW POST: Loading list/dictionary from xml files

jkohlhepp — Thu, 18 Oct 2007 11:34:21 GMT

Thanks for the suggested bhehe1. Glad to see someone found some use for this project. I added your suggestion as an issue.

http://www.codeplex.com/NAntCollections/WorkItem/View.aspx?WorkItemId=7861

During the next release cycle (not sure when that will be - whenever more interest / requests pile up) we will make sure to add it.

~ Justin

CREATED FEATURE: Initialize collection from external file

jkohlhepp — Thu, 18 Oct 2007 11:32:21 GMT

It is desirable to have the initial values of a dictionary or list loaded from an external file. Not sure what the format of the external file should be, but it might be easiest if we kept the same NAnt syntax and hijacked the NAnt parser to read it. So the NAnt task would look like this:

<list-create sourceFile="c:\blah.xml"/>

and the external file would look like this:

<list-item value="1"/>
<list-item value="2"/>
<list-item value="3"/>

(Not sure if that syntax matches NAntCollections exactly; been awhile since I looked at the code.)

NEW POST: Loading list/dictionary from xml files

bhehe1 — Wed, 22 Aug 2007 19:46:44 GMT

It would be very desirable to have an ability to load the list/dictionary from an external file. I'd have to imagine this is simple to implement though I haven't looked into it yet myself (I've only wrote 1 custom NAnt task myself and found it fairly simple).

UPDATED RELEASE: NAntCollections 0.2

Thu, 19 Jul 2007 01:03:05 GMT

This release will wrap up all current work items.

CLOSED FEATURE: list-unshift, list::shift

JeffyW — Tue, 10 Jul 2007 01:41:44 GMT

Add items to make it easier to use list as a stack (fifo).

REOPENED FEATURE: list-unshift, list::shift

JeffyW — Tue, 10 Jul 2007 01:41:25 GMT

Add items to make it easier to use list as a stack (fifo).
Comments: ** Comment from web user: JeffyW **

Add to release 0.2

CLOSED FEATURE: list-unshift, list::shift

JeffyW — Sun, 08 Jul 2007 23:46:11 GMT

Add items to make it easier to use list as a stack (fifo).

COMMENTED FEATURE: list-unshift, list::shift

JeffyW — Sun, 08 Jul 2007 23:46:03 GMT

Add items to make it easier to use list as a stack (fifo).
Comments: ** Comment from web user: JeffyW **

Finished and checked in.

Source code checked in

JeffyW — Sun, 08 Jul 2007 23:45:20 GMT

Added Shift and Unshift functions on List

UPDATED RELEASE: NAntCollections 0.1 - Beta (Jul 08, 2007)

Sun, 08 Jul 2007 20:16:22 GMT

This is the first beta release of NAntCollections. We are actively looking for potential users, testers, and contributers for this project. If you have an interest, please let us know. Thanks.

Source code checked in

jkohlhepp — Sun, 08 Jul 2007 20:06:45 GMT

CREATED ISSUE: packaging - SLN contains SCC binding

jkohlhepp — Sun, 08 Jul 2007 20:05:56 GMT

There is an issue with packaging the source for release. The SLN gets included with the src zip file, but this SLN has the TFS SCC binding in it for Codeplex. As a consequence, anyone who opens the SLN will be prompted for the username/pass for codeplex and will have to click through several warnings and dialogs before they can get into the source.

Source code checked in

jkohlhepp — Sun, 08 Jul 2007 19:36:33 GMT

Commented out parts of build file not in use. Broke out assembly info into AssemblyInfo.cs and CommonAssemblyInfo.cs so there is less duplication.

Source code checked in

jkohlhepp — Sun, 08 Jul 2007 18:51:57 GMT

Updating readme.txt

UPDATED WIKI: Home

jkohlhepp — Sun, 08 Jul 2007 18:51:28 GMT

What is NAntCollections?
NAntCollections is a library of NAnt tasks and functions which add the ability to use collections (namely lists and dictionaries) within NAnt scripts.

Why?
NAnt and NAntContrib provide an excellent list of features to create very
robust build scripts. However, out of the box there is no way to maintain
a collection of values except by maintaining a delimited list in a property.
This is adequate for simple cases but when it is necessary to maintain large
collections or collections of collections this quickly becomes unwieldy.
The goal of NAntCollections is to bring proper collections to NAnt.

Example
A quick example would be something like this:

  <dict-add dictionary="MyDict" key="FirstKey" value="FirstValue"/>
  <dict-add dictionary="MyDict" key="SecondKey" value="SecondValue"/>
  <dict-foreach dictionary="MyDict" key-property="_key">
    <echo message="The value of the key ${_key} is ${dict::get-value('MyDict',_key)}"/>
  </dict-foreach>

Building NAntCollections
NAntCollections is coded against the .NET Framework version 2.0.
NAntCollections can be built using Visual Studio 2005. It can also
be built using the NAntCollections.build script included with the
source code.

Using NAntCollections within NAnt scripts
In order for a NAnt script to be able to use the tasks and functions defined
in this library, NAnt must be able to locate and scan the compiled DLL.
Details on the various way to have NAnt find the library can be found in the
NAnt documentation here under "Loading custom extensions":
http://nant.sourceforge.net/release/latest/help/fundamentals/tasks.html

Copyright © 2007 Justin Kohlhepp

CLOSED TASK: Examples in XML documentation

jkohlhepp — Sat, 07 Jul 2007 23:06:36 GMT

The XML documentation for functions and tasks does not contain examples. Examples make the generated documentation easier to use. See the NAnt source for how to format examples in the XML comments.
Comments: Examples now present on all tasks and functions.