4.0 KiB

Raw Blame History

dash.el

A modern list api for Emacs. No 'cl required.

Installation

It's available on marmalade and Melpa:

M-x package-install dash

Or you can just dump dash.el in your load path somewhere.

Functions

function-list

There are also anaphoric versions of these functions where that makes sense, prefixed with two dashes instead of one.

Anaphoric functions

While -map takes a function to map over the list, you can also use the anaphoric form with double dashes - which will then be executed with it exposed as the list item. Here's an example:

(-map (lambda (n) (* n n)) '(1 2 3 4)) ;; normal version

(--map (* it it) '(1 2 3 4)) ;; anaphoric version

of course the original can also be written like

(defun square (n) (* n n))

(-map 'square '(1 2 3 4))

which demonstrates the usefulness of both versions.

Documentation and examples

function-docs

Contribute

Yes, please do. Pure functions in the list manipulation realm only, please. There's a suite of tests in dev/examples.el, so remember to add tests for your function, or I might break it later.

You'll find the repo at:

https://github.com/magnars/dash.el

Run the tests with

./run-tests.sh

Create the docs with

./create-docs.sh

I highly recommend that you install these as a pre-commit hook, so that the tests are always running and the docs are always in sync:

cp pre-commit.sh .git/hooks/pre-commit

Oh, and don't edit README.md directly, it is auto-generated. Change readme-template.md or examples-to-docs.el instead.

Changelist

From 1.7.0 to 1.8.0

Add -first-item and -last-item (Wilfred Hughes)

From 1.6.0 to 1.7.0

Add -rotate (Matus Goljer)

From 1.5.0 to 1.6.0

Add -min, -max, -min-by and -max-by (Johan Andersson)

From 1.4.0 to 1.5.0

Add -sum and -product (Johan Andersson)

From 1.3.0 to 1.4.0

Add -sort
Add -reduce-r (Matus Goljer)
Add -reduce-r-from (Matus Goljer)

From 1.2.0 to 1.3.0

Add -partition-in-steps
Add -partition-all-in-steps

From 1.1.0 to 1.2.0

Add -last (Matus Goljer)
Add -insert-at (Emanuel Evans)
Add -when-let and -if-let (Emanuel Evans)
Add -when-let* and -if-let* (Emanuel Evans)
Some bugfixes

Contributors

Matus Goljer contributed -union, -separate, -zip, -zip-with, -reduce-r, -reduce-r-from and -rotate.
Takafumi Arakaki contributed -group-by.
tali713 is the author of -applify.
Víctor M. Valenzuela contributed -repeat.
Nic Ferrier contributed -cons*.
Wilfred Hughes contributed -slice, -first-item and -last-item.
Emanuel Evans contributed -if-let, -when-let and -insert-at.
Johan Andersson contributed -sum, -product, -min, -max, -min-by and -max-by.

Thanks!

License

Authors: Magnar Sveen magnars@gmail.com Keywords: lists

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

4.0 KiB Raw Blame History