/rutils

Radical Utilities for Common Lisp
  1. Common Lisp 99.1%
  2. NewLisp 0.9%
Switch branches/tags
Nothing to show
Find file
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
contrib Added hash-set and relevant utilities. Added generic tally & pushx ab… Jan 5, 2018
core Make dolines evaluate src only once Jul 26, 2018
docs fix file modes Jan 5, 2018
test Added hash-set and relevant utilities. Added generic tally & pushx ab… Jan 5, 2018
.gitignore A working but untested version. See README for plans :) Nov 22, 2009
AUTHORS Release candidate for v.2.0.0 - a backweards incompatible re-thinking… Oct 30, 2011
LICENSE A working but untested version. See README for plans :) Nov 22, 2009
README.md fix typos in README Sep 30, 2014
rutils-test.asd Added hash-set and relevant utilities. Added generic tally & pushx ab… Jan 5, 2018
rutils.asd Added hash-set and relevant utilities. Added generic tally & pushx ab… Jan 5, 2018
rutilsx-test.asd simple test for -> and ->> macros Jun 14, 2014
rutilsx.asd Added => Mar 16, 2017
version.txt Added hash-set and relevant utilities. Added generic tally & pushx ab… Jan 5, 2018

README.md

RUTILS is a syntactic utilities package for Common Lisp

(that aims to radically simplify the Lisp programmer's life both in the REPL and in large system development)

RUTILS stands for RADICAL-UTILITIES :)

See the announcement.

Short history

Originally, RUTILS stood for REASONABLE-UTILITIES, but now I switched to calling them RADICAL-UTILITIES, because they make some uncommon and not generally acceptable choices in terms of style of CL development. Namely:

  • Introducing several literal notations for anonymous functions, hash-tables, heredoc-strings etc.
  • Adding a lot of abbreviations of long symbols from the CL package
  • Having several versions of the same utilities with different names

But, what's more important, they aim to radically simplify Lisp programming in the small (with a special accent on simplifying REPL-driven development).

See the original rationale for REASONABLE-UTILITIES.

Brief description

Included in core

  • "Modern" readtable with support for literal syntax for hash-tables, lambdas and heredoc-strings

Basic common control utilities, like

  • Common macros like WITH-GENSYMS, ONCE-ONLY, EVAL-ALWAYS etc.
  • Basic anaphoric macros
  • Symbol manipulation utilities
  • List manipulation utilities
  • Sequence manipulation utilities (including SPLIT-SEQUENCE, or rather, simply SPLIT)
  • Hash-table manipulation utilities
  • String manipulation utilities
  • Tree manipulation utilities
  • A simple pair data structure and accompanying utilities

Included in contrib (RUTILSX)

  • generic access to elements of any data structure: GENERIC-ELT/?
  • ITER macro with keywords support
  • generic BIND
  • Clojure-style threading macros -> and ->>

Explicitly not supported

The following broad topics are not supported by design:

  • Concurrency.

    The reason is not, that I consider this not useful or general-purpose enough, but rather, that it's a whole new paradigm, and the scope of RUTILS is too small to comfortably accommodate it.

  • Functional paradigm.

    As in the above, it's as well a whole other paradigm. It has a limited, but reasonable support in CL. Other features should be unified in it's own package, and maybe RUTILS can serve as a model for such package or even accommodate it in the future.

  • Advanced collections are as well a separate area in CS, so it requires a lot of effort to maintain and develop a comprehensive package in it.

    Look at FSET and CL-CONTAINERS for such things.

  • MOP. MOP abstraction layer is a CDR and it is as well an essential part of CL. It is implemented and well supported by CLOSER-MOP.

Technical notes

Dependencies

Exported features

The following symbols are added to *FEATURES*:

  • :split-sequence (by RUTILS.SEQUENCE, RUTILS, and RUTIL)
  • :iter (by RUTILSX.ITER and RUTILSX)

Organizational notes

(c) 2009-2014, Vsevolod Dyomkin vseloved@gmail.com

See LICENSE for usage permissions. See AUTHORS for credits.