Bashumerate

https://numerlab.org/2026/07/20/bashumerate-enumerator/
Admin
Bashumerate is a programmable iterator for your shell, providing a consistent way to iterate over...
Tokens:980
Snippets:20
Trust Score:5.5
Update:3 months ago
Show doc for...
Tokens:
Raw
### Install bashumerate by Cloning and Symlinking

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

Alternative installation method for bashumerate by cloning the repository and creating a symbolic link.

```bash
git clone https://github.com/wallach-game/bashumerate.git
ln -s "$PWD/bashumerate/bin/enumerate" ~/.local/bin/

```

--------------------------------

### Install bashumerate with basher

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

Instructions for installing bashumerate using the basher package manager.

```bash
basher install wallach-game/bashumerate

```

--------------------------------

### Iterating Markdown Files with bashumerate

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

Example of using bashumerate to iterate over markdown files and count their lines, showing the command execution.

```bash
enumerate -f '*.md' -- 'wc -l {}'
# → wc -l README.md
# → wc -l docs/guide.md

```

--------------------------------

### Using Custom Docker Source with bashumerate

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

Demonstrates how to use the custom 'docker' source with bashumerate to restart containers.

```bash
enumerate docker -- 'docker restart {}'

```

--------------------------------

### File Iteration with find and wc

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

Using the find command to locate .sh files and execute wc -l on them.

```bash
find . -name '*.sh' -exec wc -l {} +

```

--------------------------------

### Template Mode with bashumerate

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

Using bashumerate's template mode to process file content, showing the first 5 lines of each file.

```bash
enumerate -f '*' -- 'cat {} | head -5'

```

--------------------------------

### Iterating Files with bashumerate

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

Using bashumerate to iterate over files matching a pattern and execute a command on each.

```bash
enumerate -f '*.sh' -- 'wc -l {}'

```

--------------------------------

### Basic File Iteration with for loop

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

A traditional shell for loop to iterate over files ending with .txt and count their lines.

```bash
for f in *.txt; do
  wc -l "$f"
done

```

--------------------------------

### Custom Source: Docker Container Names

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

Defines a bash function to enumerate Docker container names, which can then be used as a source with bashumerate.

```bash
enumerate_source_docker() {
  docker ps --format '' | while read -r name; do
    printf '%s\0' "$name"
  done
}

```

--------------------------------

### File Deletion with find and xargs (Unsafe)

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

A common but potentially unsafe pattern using find and xargs to delete .log files, which can fail with filenames containing spaces.

```bash
find . -name '*.log' | xargs rm

```

--------------------------------

### Iterating a List with bashumerate

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

Using bashumerate to iterate over a list of items and process each item with a command.

```bash
enumerate -L a b c -- 'echo item: {}'

```

--------------------------------

### Iterating a Range with bashumerate

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

Using bashumerate to generate a sequence of numbers and process each number with a command.

```bash
enumerate -r 1 10 -- 'printf "n=%d\n" {}'

```

--------------------------------

### Iterating Lines with bashumerate

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

Using bashumerate to read lines from a file and process each line with a command.

```bash
enumerate -l /etc/hosts -- 'echo {}'

```

--------------------------------

### Piping bashumerate Output to xargs

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

Safely piping bashumerate's file iteration output to xargs for processing, like deleting files.

```bash
enumerate -f '*.log' | xargs rm

```

--------------------------------

### Processing URLs from a File with bashumerate

Source: https://numerlab.org/2026/07/20/bashumerate-enumerator

Reading URLs from a file using bashumerate's line iterator and processing each URL with curl.

```bash
cat urls.txt | enumerate -l - | while read url; do curl -s "$url"; done

```
Tokens:
Raw