Quicklisp beta (original) (raw)

Quicklisp is a library manager for Common Lisp. It works with your existing Common Lisp implementation to download, install, and load any of over 1,500 libraries with a few simple commands.

Quicklisp is easy to install and works with ABCL,Allegro CL,Clasp, Clozure CL, CLISP, CMUCL,ECL, LispWorks, MKCL,SBCL, andScieneer CL, on Linux, Mac OS X, and Windows. The libraries were last updated on October 12, 2024.

Quicklisp is provided as-is without warranty of any kind. See therelease notes for known problems.

To get news and announcements, follow @quicklisp on twitter or read the Quicklisp blog. If you have any questions or comments, please email me, use the Quicklisp discussion group mailing list, or visit #quicklisp on freenode. Quicklisp code is hosted on GitHub.

Installation

To install Quicklisp, download quicklisp.lisp and load it.

To verify the integrity of quicklisp.lisp, you can download itsdetached PGP signature file and verify it against the Quicklisp release signing key, which has a fingerprint of D7A3 489D DEFE 32B7 D0E7 CC61 3079 65AB 028B 5FF7, an id of 028B5FF7, and an email of release@quicklisp.org.

You only need to load quicklisp.lisp once to install Quicklisp. See Loading After Installation for how to load the installed Quicklisp into your Lisp session after the initial installation.

Here's an example installation session on MacOS X with SBCL. In this example, $ is the shell prompt and * is the Lisp REPL prompt.

$ curl -O https://beta.quicklisp.org/quicklisp.lisp % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 49843 100 49843 0 0 33639 0 0:00:01 0:00:01 --:--:-- 50397

$ curl -O https://beta.quicklisp.org/quicklisp.lisp.asc ... $ gpg --verify quicklisp.lisp.asc quicklisp.lisp gpg: Signature made Sat Feb 1 09:25:28 2014 EST using RSA key ID 028B5FF7 gpg: Good signature from "Quicklisp Release Signing Key release@quicklisp.org" $ sbcl --load quicklisp.lisp This is SBCL 1.0.42.52, an implementation of ANSI Common Lisp. More information about SBCL is available at http://www.sbcl.org/.

SBCL is free software, provided as is, with absolutely no warranty. It is mostly in the public domain; some portions are provided under BSD-style licenses. See the CREDITS and COPYING files in the distribution for more information.

==== quicklisp quickstart loaded ====

To continue, evaluate: (quicklisp-quickstart:install)

; Fetching #<URL "" title="undefined" rel="noopener noreferrer">http://beta.quicklisp.org/quickstart/asdf.lisp"> ; 144.48KB

147,949 bytes in 0.64 seconds (226.11KB/sec) ; Fetching #<URL "" title="undefined" rel="noopener noreferrer">http://beta.quicklisp.org/quickstart/quicklisp.tar"> ; 160.00KB

163,840 bytes in 0.76 seconds (211.36KB/sec) ; Fetching #<URL "" title="undefined" rel="noopener noreferrer">http://beta.quicklisp.org/quickstart/setup.lisp"> ; 2.78KB

2,846 bytes in 0.001 seconds (2779.30KB/sec) Upgrading ASDF package from version 2.004 to version 2.009 ; Fetching #<URL "" title="undefined" rel="noopener noreferrer">http://beta.quicklisp.org/dist/quicklisp.txt"> ; 0.40KB

408 bytes in 0.003 seconds (132.81KB/sec)

==== quicklisp installed ====

To load a system, use: (ql:quickload "system-name")

To find systems, use: (ql:system-apropos "term")

To load Quicklisp every time you start Lisp, use: (ql:add-to-init-file)

For more information, see http://www.quicklisp.org/beta/

NIL

; Fetching #<URL "" title="undefined" rel="noopener noreferrer">http://beta.quicklisp.org/dist/quicklisp/2010-10-07/systems.txt"> ; 45.30KB

46,386 bytes in 0.50 seconds (89.70KB/sec) ; Fetching #<URL "" title="undefined" rel="noopener noreferrer">http://beta.quicklisp.org/dist/quicklisp/2010-10-07/releases.txt"> ; 83.49KB

85,490 bytes in 0.53 seconds (157.22KB/sec) #<SYSTEM cl-vectors / cl-vectors-20101006-git / quicklisp 2010-10-07> #<SYSTEM lispbuilder-sdl-cl-vectors / lispbuilder-20101006-svn / quicklisp 2010-10-07> #<SYSTEM lispbuilder-sdl-cl-vectors-examples / lispbuilder-20101006-svn / quicklisp 2010-10-07> #<SYSTEM lispbuilder-sdl-vecto / lispbuilder-20101006-svn / quicklisp 2010-10-07> #<SYSTEM lispbuilder-sdl-vecto-examples / lispbuilder-20101006-svn / quicklisp 2010-10-07> #<SYSTEM static-vectors / static-vectors-20101006-git / quicklisp 2010-10-07> #<SYSTEM vecto / vecto-1.4.3 / quicklisp 2010-10-07> NIL * (ql:quickload "vecto") To load "vecto": Install 5 Quicklisp releases: cl-vectors salza2 vecto zpb-ttf zpng ; Fetching #<URL "" title="undefined" rel="noopener noreferrer">http://beta.quicklisp.org/archive/salza2/2010-10-06/salza2-2.0.7.tgz"> ; 14.84KB

15,197 bytes in 0.12 seconds (125.77KB/sec) ; Fetching #<URL "" title="undefined" rel="noopener noreferrer">http://beta.quicklisp.org/archive/zpng/2010-10-06/zpng-1.2.tgz"> ; 38.59KB

39,521 bytes in 0.37 seconds (103.47KB/sec) ; Fetching #<URL "" title="undefined" rel="noopener noreferrer">http://beta.quicklisp.org/archive/zpb-ttf/2010-10-06/zpb-ttf-1.0.tgz"> ; 42.59KB

43,611 bytes in 0.39 seconds (110.33KB/sec) ; Fetching #<URL "" title="undefined" rel="noopener noreferrer">http://beta.quicklisp.org/archive/cl-vectors/2010-10-06/cl-vectors-20101006-git.tgz"> ; 40.40KB

41,374 bytes in 0.37 seconds (109.20KB/sec) ; Fetching #<URL "" title="undefined" rel="noopener noreferrer">http://beta.quicklisp.org/archive/vecto/2010-10-06/vecto-1.4.3.tgz"> ; 75.71KB

77,526 bytes in 0.49 seconds (153.57KB/sec) ; Loading "vecto" .................................................. [package zpb-ttf]................................. [package salza2].................................. [package zpng].................................... [package net.tuxee.paths]......................... [package net.tuxee.aa]............................ [package net.tuxee.aa-bin]........................ [package net.tuxee.vectors]....................... [package vecto]........ ("vecto")

Press Enter to continue.

#P"/Users/quicklisp/.sbclrc"

Although this example uses a Unix shell, the same procedure would work for installation in the REPL of a Windows or Mac GUI-based CL implementation.

Loading After Installation

You only need to install Quicklisp with quicklisp.lisp once. To load Quicklisp into your Common Lisp session after the initial installation, load the file quicklisp/setup.lisp with the Common Lisp load function.

For example, if you installed Quicklisp in the default location in your home directory, the following command suffices to load Quicklisp into a running session:

(load "~/quicklisp/setup.lisp")

The path must be adjusted if Quicklisp is loaded in a different location, or if your implementation does not support the ~ pathname syntax (i.e. CMUCL).

The function ql:add-to-init-file will add code to do this to your init file automatically, so Quicklisp will load whenever your Common Lisp session starts.

Basic Commands

To load software, use:

(ql:quickload _system-name_)

For example:

CL-USER> **(ql:quickload "vecto")**
To load "vecto":
  Install 5 Quicklisp releases:
cl-vectors salza2 vecto zpb-ttf zpng
_loading output here_

Quicklisp will automatically download any supporting software it needs to load the system.

Please note that some systems have different names than their projects. For example, to load cl-yacc's system, run (ql:quickload "yacc"), not (ql:quickload "cl-yacc").

ql:quickload can also be used to load local systems that aren't part of Quicklisp. If the local system depends on software that is available through Quicklisp, the dependencies will be automatically loaded.

By default, ql:quickload hides most compilation and loading output, including warnings, and shows progess as a series of dots. You can show full compilation and loading output by passing :verbose t as arguments to ql:quickload. This output can be especially helpful when reporting and troubleshooting problems.

To remove software, use:

(ql:uninstall _system-name_)

For example:

CL-USER> **(ql:uninstall "vecto")**
T

An uninstall does the following:

Uninstalling does not alter the current Lisp session in any other way; if the given system has been loaded, it remains loaded and accessible until the session is ended.

To find out what's available in Quicklisp, use:

(ql:system-apropos _substring_)

For example:

CL-USER> **(ql:system-apropos "xml")**
#<SYSTEM bknr.xml / bknr-datastore-20100916-git / quicklisp 2010-09-16>
#<SYSTEM cl-libxml2 / cl-libxml2-0.3.4 / quicklisp 2010-09-16>
#<SYSTEM cxml / cxml-20100916-git / quicklisp 2010-09-16>
#<SYSTEM cxml-dom / cxml-20100916-git / quicklisp 2010-09-16>
#<SYSTEM cxml-klacks / cxml-20100916-git / quicklisp 2010-09-16>
#<SYSTEM cxml-rng / cxml-rng-2008-11-30 / quicklisp 2010-09-16>
#<SYSTEM cxml-rpc / cxml-rpc-20100916-git / quicklisp 2010-09-16>
#<SYSTEM cxml-stp / cxml-stp-2008-11-30 / quicklisp 2010-09-16>
#<SYSTEM cxml-stp-test / cxml-stp-2008-11-30 / quicklisp 2010-09-16>
#<SYSTEM cxml-test / cxml-20100916-git / quicklisp 2010-09-16>
#<SYSTEM cxml-xml / cxml-20100916-git / quicklisp 2010-09-16>
#<SYSTEM pithy-xml / pithy-xml-20100916-git / quicklisp 2010-09-16>
#<SYSTEM s-xml / s-xml-20100916-http / quicklisp 2010-09-16>
#<SYSTEM s-xml-rpc / s-xml-rpc-20100916-http / quicklisp 2010-09-16>
#<SYSTEM xml-render / cl-typesetting-20100916-svn / quicklisp 2010-09-16>
#<SYSTEM xmls / xmls-1.3 / quicklisp 2010-09-16>

The system name is the word after "SYSTEM" and before the first "/", e.g. "cxml-stp". System names are used by ql:quickload and for expressing dependency information in system definitions.

To load Quicklisp when you start Lisp, use:

(ql:add-to-init-file)

Quicklisp will append code to your Lisp's init file that will load Quicklisp on startup.

To install and configure SLIME, use: 

(ql:quickload "quicklisp-slime-helper")

Then follow the directions it displays. quicklisp-slime-helper will create a file you can load in Emacs that configures the right load-path for loading Quicklisp's installation of SLIME.

To get updated software, use:

(ql:update-dist "quicklisp")

Software updates are usually available about once per month.

To update the Quicklisp client, use:

(ql:update-client)

Quicklisp client updates are usually available a few times per year.

To go back to a previous set of libraries, see the blog post Going back in (dist) time. This can be useful if your project depends on the state (APIs, etc) of the Quicklisp library universe from a particular point in time.

To see what systems depend on a particular system, use:

(ql:who-depends-on system-name)

License information

Copyright © 2010 Zachary Beane zach@quicklisp.org

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Portions of Quicklisp are derived from Pierre Mai's Deflate library, which is available under the following terms:

Deflate --- RFC 1951 Deflate Decompression

Copyright (C) 2000-2009 PMSF IT Consulting Pierre R. Mai.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name of the author shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization from the author.

Zach Beane 2015-04-30