Package to generate random facts
Project description
Randfacts is a python library that generates random facts. You can use randfacts.get_fact()
to return a random fun fact. Disclaimer: Facts are not guaranteed to be true.
Installation
randfacts can either be installed via pip or via the AUR, whichever way you prefer.
Installation via pip:
$ pip3 install randfacts
Installation via AUR:
$ git clone https://aur.archlinux.org/python-randfacts.git && cd python-randfacts
$ makepkg -si
Usage and examples
import randfacts
x = randfacts.get_fact()
print(x)
will print a random fact like:
Penguins can't taste sweet or savory flavors, only sour and salty ones
This package has a filter option to filter out potentially inappropriate facts. The filter is on by default. To disable the filter, you can just set the filter_enabled
parameter to False
.
from randfacts import get_fact
print(get_fact(False))
# or
print(get_fact(filter_enabled=False))
get_fact
also has a parameter that will make the function only return unsafe facts. This argument takes precedence over the filter_enabled
argument. For example:
print(get_fact(only_unsafe=True))
If you want to access the list of facts directly, you can just import the safe_facts
, unsafe_facts
, or all_facts
lists from the randfacts module.
Command line usage
randfacts can be executed via the command line with the following commands:
Normal execution; only safe facts
$ python3 -m randfacts
The unsafe argument can be supplied to provide only unsafe facts
$ python3 -m randfacts --unsafe
The mixed argument can be provided to provide both safe and unsafe facts.
$ python3 -m randfacts --mixed
More help.
$ python3 -m randfacts --help
REST API Usage
There is an unofficial REST API for this module. The source code/links can be found here.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for randfacts-0.13.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1b79049ee5e1accae06bbfb54afc5829931e8f5185d5cb8ac9e677eaa0ff48f6 |
|
MD5 | a36c4bfb97518a5735fab6c76344fdad |
|
BLAKE2b-256 | c4ad64d1bc93161729704945e2df1a0f6fdf5625aa44008ce0a63704d1bd29c1 |