Skip to main content

A CLI tool for RNG, shuffling and other pseudorandom stuff.

Project description


pseu is a CLI tool that provides the following pseudorandom utilities: picking, shuffling, dice-rolling and number generation. It's useful for people who frequently call on machines to make their life choices.

$ pseu pick "good life choice" "bad life choice"
bad life choice
$ pseu pick --n 2 </tmp/movies.txt
Boogie Nights
The Hunt for the Wilderpeople
$ pseu roll 1d6
$ pseu rand 100
$ pseu shuffle alice sue bob


Requires Python 3. Install from PyPI using pip:

pip3 install pseu-cli

More examples

roll and rand can print stats.

$ pseu roll 3d6 --stats
4 5 4
sum: 13
max: 5
min: 4

Multiple types of dice, multiple random numbers.

$ pseu roll 2d6 6d3
6 6 1 3 3 1 2 1
$ pseu rand 1-3x5 10-20
2 2 1 3 1 16

Use a (base64) seed to repeat results.

$ pseu 1-1000 --seed abc
$ pseu 1-1000 --seed abc


Feel free to submit tweaks.

To run tests, install tox via pip3 install tox and then run the tox command from the base directory.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pseu-cli-1.0.1.tar.gz (4.0 kB view hashes)

Uploaded Source

Built Distribution

pseu_cli-1.0.1-py3-none-any.whl (5.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page