Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/roswell/roswell

intended to be a launcher for a major lisp environment that just works.
https://github.com/roswell/roswell

common-lisp quicklisp roswell

Last synced: about 2 months ago
JSON representation

intended to be a launcher for a major lisp environment that just works.

Host: GitHub
URL: https://github.com/roswell/roswell
Owner: roswell
License: mit
Created: 2014-07-29T18:07:03.000Z (over 10 years ago)
Default Branch: master
Last Pushed: 2024-11-19T06:46:47.000Z (2 months ago)
Last Synced: 2024-11-28T21:49:36.875Z (about 2 months ago)
Topics: common-lisp, quicklisp, roswell
Language: Common Lisp
Homepage:
Size: 3.07 MB
Stars: 1,792
Watchers: 71
Forks: 121
Open Issues: 152
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: COPYING
- Authors: AUTHORS

Awesome Lists containing this project

curated-awesome-cl - Roswell - A Lisp implementation installer, script launcher and more. (REPLs ##)

README

        # Roswell - Common Lisp environment setup Utility.

[![Build Status](https://travis-ci.org/roswell/roswell.svg?branch=master)](https://travis-ci.org/roswell/roswell)

[![Quicklisp](http://quickdocs.org/badge/roswell.svg)](http://quickdocs.org/roswell/)

Roswell is a Lisp implementation installer/manager, launcher, and much more!

Roswell started out as a command-line tool with the aim to make installing and managing Common Lisp implementations really simple and easy.

Roswell has now evolved into a full-stack environment for Common Lisp development, and has many features that makes it easy to test, share, and distribute your Lisp applications.

With Roswell, we aim to push the Common Lisp community to a whole new level of productivity.

Roswell is still in beta. Despite this, the basic interfaces are stable and not likely to change. Roswell currently works well on Unix-like platforms such as Linux, macOS and FreeBSD.

Roswell also works on other operating systems, but currently some parts or features might be missing or unstable.

Checkout [issues list](https://github.com/roswell/roswell/issues) if you are interested in what's lacking.

## Installation, Dependency & Usage

See our [github wiki](https://github.com/roswell/roswell/wiki).

We provide prebuilt binaries for homebrew on macOS, various Linux distributions and **also on Windows**.

* [Linux](https://github.com/roswell/roswell/wiki/Installation#linux)

* [FreeBSD](https://github.com/roswell/roswell/wiki/Installation#freebsd)

* [macOS (via Homebrew)](https://github.com/roswell/roswell/wiki/Installation#mac-os-x--homebrew)

* [Windows](https://github.com/roswell/roswell/wiki/Installation#windows)

* [Building from Source](https://github.com/roswell/roswell/wiki/Installation#building-from-source)

## Features

[Feature comparison is available!](https://github.com/roswell/roswell/wiki/How-is-Roswell-different)

* Implementation Manager

* Scripting environment (similar to cl-launch)

* Building utility (similar to buildapp)

* **Novel** : Easier setup for initializing a script

* **Novel** : Better integration to the command-line interface (Bash completion, etc)

* **Novel** : Infrastructure for bundling/installing the scripts to/from a quicklisp system

* **Novel** : Better support for Windows environment (tested exhaustively)

* **Novel** : Better integration to CI environment (e.g. [Travis-CI](https://github.com/roswell/roswell/wiki/Travis-CI), [CircleCI](https://github.com/roswell/roswell/wiki/Circle-CI), [Coveralls](https://github.com/roswell/roswell/wiki/Coveralls))

## Usage

Roswell has git-like subcommands which resemble that of cl-launch, buildapp.

```

$ ros

Common Lisp environment setup Utility.

Usage:

   ros [options] Command [arguments...]

or

   ros [options] [[--] script-path arguments...]

commands:

   run       Run repl

   install   Install a given implementation or a system for roswell environment

   update    Update installed systems.

   build     Make executable from script.

   use       Change default implementation.

   init      Creates a new ros script, optionally based on a template.

   list      List Information

   delete    Delete installed implementations

   config    Get and set options

   version   Show the roswell version information

Use "ros help [command]" for more information about a command.

Additional help topics:

   options

Use "ros help [topic]" for more information about the topic.

```

### Managing/Installing Several Lisp Installations

    $ ros install               # displays a list of all installable implementations

    

    $ ros install sbcl-bin      # default sbcl

    $ ros install sbcl          # The newest released version of sbcl

    $ ros install ccl-bin       # default prebuilt binary of ccl

    $ ros install sbcl/1.2.0    # A specific version of sbcl

    

    $ ros list installed sbcl   # Listing the installed implementations

    $ ros run -- --version      # check which implementation is used

    SBCL 1.2.15

    $ ros use sbcl/1.2.3        # change the default implementation

To use an implementation that was not installed by roswell, use i.e. `ros use sbcl/system`.

The list of supported implementations continues to grow!

By default roswell downloads the default stable lisp implementation (sbcl-bin). To use system implementation from the start run `ros lisp=sbcl-bin/system setup` before anything else.

### Installing scripts

It is also possible to install scripts using `ros install`:

    $ ros install qlot            # will install a program from quicklisp

    $ ros install fukamachi/qlot  # will install it from the GitHub

To add installable scripts into the system, you need to put roswell

scripts (files having `.ros` extensions) into a `roswell` subdirectory.

Take a look at [qlot's roswell/qlot.ros](https://github.com/fukamachi/qlot/tree/master/roswell).

### Scripting with Roswell

```diff

$ ros init

Usage: ros init [template] name [options...]

$ ros init fact

Successfully generated: fact.ros

$ emacs fact.ros

## editing the fact.ros ...

$ cat fact.ros

#!/bin/sh

#|-*- mode:lisp -*-|#

#|

exec ros -Q -- $0 "$@"

|#

(defun fact (n)

  (if (zerop n)

      1

      (* n (fact (1- n)))))

(defun main (n &rest argv)

  (declare (ignore argv))

  (format t "~&Factorial ~D = ~D~%" n (fact (parse-integer n))))

$ ./fact.ros 10

Factorial 10 = 3628800

```

## Chef recipe for roswell

[@Rudolph-Miller](https://github.com/Rudolph-Miller) is providing a Chef recipe for setting roswell up.

- [Rudolph-Miller/chef-roswell](https://github.com/Rudolph-Miller/chef-roswell)

## Roswell with CircleCI

[@fukamachi](https://github.com/fukamachi) use Roswell with CircleCI.

- [fukamachi/legion/circle.yml](https://github.com/fukamachi/legion/blob/master/circle.yml)

## Naming Origin 'roswell'

From ‘[made with secret alien technology](http://www.lisperati.com/logo.html)’.

I felt making it easier to use Lisp for people is a kind of making opportunity for humanbeings to mingle with alien technology. I recall ‘roswell incident’ by the concept. I'm not sure what you feel.

## See Also

+ [cl-launch](http://cliki.net/cl-launch) : influenced by the project of command line parameters design.

## Author

SANO Masatoshi ([email protected])

## Contributors

 * Eitaro Fukamachi ([email protected])

 * Tomoya KAWANISHI ([email protected])

 * Masataro Asai ([email protected])

## Special Thanks to

 * Eitaro Fukamachi ([email protected]) for naming this project.

 * Sunrin SHIMURA for [sionescu/cim](https://github.com/sionescu/CIM) that motivate me to start this project.

## Project

 * https://github.com/roswell/roswell

## License

Licensed under the MIT License.