Fortune Lite
The lightweight python-based fortune cookie generator
Installing
The latest version can be installed by running pip3 install fortune-lite from the command line.
Usage
fortune <options>
| Argument | Description |
|---|---|
| -h, --help |
Prints a help-dialogue and exits. |
| -v, --version |
Prints out version information and exits. |
| -a, -all |
Selects from all databases, including offensive fortunes. |
| -e, --equal |
Makes it equally likely that the fortune will be selected from any given category, as opposed to making all fortunes equally likely regardless of category. |
| -f, --categories |
Instead of printing a fortune, just print a list of all fortune categories (files). |
| -o, --offensive |
Only print fortunes marked as offensive. |
| -w, --wait |
Wait the specified number of seconds after printing the fortune before exiting. |
Database Locations
Unlike other fortune programs, Fortune Lite is designed to parse fortunes out of specialized SQLite databases. By default, the Fortune Lite program looks for a database at ~/.fortune.db, and falls back to the prepackaged database if no database is found in the user's home directory.
Additionally, the $FORTUNE_DB environment variable can be used to override the default database locations, in which case the fortune program will only fall back to the default locations in the event that no database is found at the location stored in $FORTUNE_DB.
Building from Source
- Acquire the source code:
git clone https://github.com/buck-ross/fortune_lite.git. - Enter the source directory:
cd fortune_lite - (optional) Checkout the version you want to build:
git checkout tags/v1.0.1 - Build and install the package:
python3 setup.py install
Credit to fortune-mod
While Fortune Lite is a completely distinct and independent project from fortune-mod, we do currently use the datfile sources provided by fortune-mod in order to generate the SQLite fortune database. As such, the fortune-mod project deserves all credit for creating and the default fortune database.
License
Copyright © 2019 Buckley Ross
This project is licensed under the Apache License, Version 2.0 (Apache-2.0).
For a complete copy of the license, please see the included "LICENSE" file.
1 maintainer
Release files for fortune-lite 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| fortune_lite-1.0.1.tar.gz | 5.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fortune_lite-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.1 MB
Release files / fortune_lite-1.0.1.tar.gz
| Download URL | fortune_lite-1.0.1.tar.gz |
|---|---|
| Size | 5.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3cf2ec38cc3ac1775297514bdc6d6a6a1b749ae920023383ce129f7e3e5b7d70
|
|
BLAKE2b-256 checksum How to use checksums |
44e97fbd5536844842b69c231fa9a51a8b680c9264f531fe4411a9c79de03881
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.6
|
Release files / fortune_lite-1.0.1-py3-none-any.whl
| Download URL | fortune_lite-1.0.1-py3-none-any.whl |
|---|---|
| Size | 2.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
df9ff82be16d5ea7d8012865b1d15d3a8236fb9da64b7d4311befaf2affa1533
|
|
BLAKE2b-256 checksum How to use checksums |
ad0f9a1baed9f2cb85dbb9bbca99f796a718e7772c5f9f1f25be256c63827b5e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.6
|
