Hi,

I have made some changes to tools.cli to fix an annoying bug arround
boolean flags and the inability to collect 'trailing arguments'.
Whilst gathering opinions on these changes, a few other suggestions
were made such as removing all magic functions and System/exit calls.
The update is therefore going to break the existing API which you
obviously need to be aware of if you are currently using 0.1.0 and
intend to upgrade to 0.2.0.

The release has been cut, but the last time I checked it still hadn't
hit maven central, so this is slightly advanced notice. To see details
of the new api please see: https://github.com/clojure/tools.cli.

There are a few things worth mentioning... support for grouped options
has been removed, and the result of the call to cli is now a vector of
[options, trailing arguments, usage banner] (originally it was just a
hash of options). Automatic help is also no longer provided, an
example of how to roll your own is at the bottom of the aforementioned
page.

a brief example of the differences (see the site for full details though):

0.1.0:

(cli ["-p" "8080" "-v" "--foo" "bar" "some-filename"]
     (optional ["-p" "--port" "The port"] #(Integer. %))
     (optional ["-f" "--foo" "Some foos"])
     (optional ["-v" "--[no-]verbose" "Be chatty"])

=> {:port 8080, :foo "bar", :verbose true}

0.2.0:

(cli ["-p" "8080" "--foo" "bar" "-v" "some-filename"]
     ["-p" "--port" "The port" :parse-fn  #(Integer. %)]
     ["-f" "--foo" "Some foos"]
     ["-v" "--[no-]verbose" "Be chatty" :default false])

=> [{:port 8080, :foo "bar", :verbose true}, ["some-filename"], "*the
usage banner*"]

Apologies for anyone upset by the timing / notification of the changes
-- I will give greater advanced notice in future if there are any more
breaking changes (hopefully there wont be :D)

-- 
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with your 
first post.
To unsubscribe from this group, send email to
clojure+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en

Reply via email to