S-UTILS is collection of Common Lisp utilities. This simple package is used as a building block in a number of other open source projects, as can be seen from this description of some other Open Source Common Lisp packages.
S-UTILS helps in:
S-UTILS is considered stable code.
November 2005 - Created as a seperate project.
S-UTILS is written in ANSI standard Common Lisp and should be portable across any CL implementation.
You can download the latested released tarball of the S-UTILS package from http://homepage.mac.com/svc/s-utils/s-utils.tar.gz. This archive is signed on release by Sven Van Caekenberghe, whose public key is published at http://homepage.mac.com/svc/sven-public-ascii.gpg, the signature is in http://homepage.mac.com/svc/s-utils/s-utils.tar.gz.asc.
Alternatively you can access the DARCS repository at http://www.beta9.be/darcs/s-base64. For a good description on how to use DARCS see http://dirkgerrits.com/programming/erlisp/download/.
$ darcs get http://www.beta9.be/darcs/s-utils
The S-UTILS package is loaded using ASDF. There is an excellent tutorial on ASDF to get you started. Alternatively you can use ASDF-INSTALL. There is an great tutorial on ASDF-INSTALL to get you on the way.
CL-USER 1 > (asdf:oos 'asdf:load-op :s-utils)
Usage of the functionality in S-UTILS is straightforward, as the following examples demonstrate:
CL-USER 1 > (in-package :s-utils)
#<The S-UTILS package, 41/128 internal, 13/16 external>
S-UTILS 2 > (defvar *timestamp* (get-universal-time))
*TIMESTAMP*
S-UTILS 3 > (format-universal-time *timestamp*)
"Sat Nov 19 2005 18:08:51"
S-UTILS 4 > (format-iso-gmt-time *timestamp*)
"20051119T170851"
S-UTILS 5 > (format-universal-time *timestamp* :format +us-date-format+ :stream t)
Sat Nov 19 2005
NIL
S-UTILS 6 > (format-universal-time *timestamp* :format +us-time-format+ :timezone 0)
"Sat Nov 19 2005 17:08:51"
S-UTILS 7 > (format-duration (- (get-universal-time) *timestamp*))
"5 minutes 18 seconds"
S-UTILS 8 > (tokens *)
("5" "minutes" "18" "seconds")
S-UTILS 9 > (tokens "1-2-3-4-5" :separators '(#\-))
("1" "2" "3" "4" "5")
S-UTILS 10 > (parse-integer-safely "")
NIL
S-UTILS 11 > (parse-integer-safely "x" :default -1)
-1
S-UTILS 12 > (parse-integer-safely "111" :default 123 :start 2)
1
S-UTILS 13 > (parse-integer-safely "111" :default 123 :start 3)
123
S-UTILS 14 > (parse-integer-safely "" :default -1)
-1
S-UTILS 15 > (parse-integer-safely nil :default -1)
-1
S-UTILS 16 > (parse-integer-safely "FF" :radix 16)
255
S-UTILS 17 > (with-input-from-string (in "abcdefghi")
(copy-stream in *standard-output*)
(terpri))
abcdefghi
NIL
S-UTILS 18 > (make-subdirectory #p"/tmp/" '("foo" "bar"))
#P"/tmp/foo/bar/"
S-UTILS 19 > (pathname-parent #p"/tmp/")
#P"/"
S-UTILS 20 > (pathname-parent (make-subdirectory #p"/tmp/" "foo"))
#P"/tmp/"
There is automatically generated API Reference documentation available for the S-UTILS package.
There is no mailing list for this project.
Release Notes:
There is currently no TODO list.
Nothing appropriate.
There are no known bugs.
S-UTILS was written by Sven Van Caekenberghe.
S-UTILS is being maintained by Sven Van Caekenberghe.
You are granted the rights to distribute and use this software as governed by the terms of the Lisp Lesser General Public License (http://opensource.franz.com/preamble.html), also known as the LLGPL.
This is a new project.
Thera are no references.