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.
3 Nov 28, 2021
5 Jan 25, 2022
1 Dec 17, 2021
4 Sep 22, 2022
5 Dec 24, 2022
1 Sep 25, 2022
2 Oct 14, 2021
1 Mar 31, 2022
139 Jan 02, 2023
633 Dec 23, 2022
3 Oct 14, 2022
2 Jan 23, 2022
185 Dec 29, 2022
1 Nov 21, 2021
2 Jan 23, 2022
8 Oct 02, 2022
64 Dec 17, 2022
1 Feb 01, 2022
1 Jan 25, 2022
1 Dec 21, 2021