Skip to content
master
Switch branches/tags
Go to file
Code
This branch is 60 commits ahead, 3 commits behind yogsototh:master.

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Build Status

ZSH higher order functions

You can look at yogsototh's blogpost for the idea of higher order functions in zsh.

Install

If you are lazy just paste the following lines in your terminal:

cd /tmp && \
curl -O https://raw.github.com/Tarrasch/zsh-functional/master/install.sh && \
chmod u+x install.sh && . ./install.sh && \rm -f ./install.sh

If you want to do it manually, clone this repo to ~/.zsh/functional and add

. ~/.zsh/functional/functional.plugin.zsh

to your .zshrc

Antigen

If you use antigen, you can simply add

antigen-bundle Tarrasch/zsh-functional

Among your other antigen-bundle commands.

Examples and usage

Here are some examples:

$ mapa '$1*2' {1..3}
2
4
6

$ folda '$1+$2' {1..5}
15

$ folda '$acc+$x' {1..5}
15

$ filter 'echo $1|grep a >/dev/null' ab cd ef ada
ab
ada

$ map 'X $1:t Y' ~/.zsh/functional/src/*
X each Y
X filter Y
X fold Y
X map Y

$ map 'result $1' $(mapa '$1+5' $(mapa '$1*2' {1..3}))
result 7
result 9
result 11

$ echo "1\n2\n3" | mapa '$1*2' | mapa '$1+5' | map 'result $1'
result 7
result 9
result 11

Here are some examples with named functions:

$ insideXY(){print -- "X $1 Y"}
$ eachf insideXY a b c d
X a Y
X b Y
X c Y
X d Y

$ add(){print -- $(($1+$2))}
$ foldf add {1..5}
15

Please refer to the tests for complete specifications. The advantages of the cram tests are that they are validated and readable.

Furthermore, the commands will print out their --help if they are provided no arguments.

Naming conventions

I found the lambda expression versions most useful hence they have the shortest (plain) name. Functions ending with an f are those taking in a named function and functions ending with an a will take an arithmetic lambda expression. The examples above should clarify the syntax.

map or each?

map is simply each with an implicit echo, it should feel somewhat intuitive for ruby developers. Note how mapa exists but not eacha, and the contrary for mapf and eachf.

Reading from standard input

All functions will read from stdin if no arguments are given to them. Please see tests/filter.t For a test that lazily generates the first 10 primes.

Contributing

Good idea! Just add a test and implement the new functionality and send away your pull request! :)

Running the tests

We test like antigen does testing.

Creds

Yann Esposito for the HoF idea and big thanks to Sterling's blogpost for discovering and starting implementing the anonymous function features.

About

Higher order functions for zsh

Resources

Releases

No releases published

Packages

No packages published