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.
5 Feb 18, 2022
42 Dec 18, 2022
183 Jan 06, 2023
7 Nov 12, 2022
8 Nov 28, 2021
100 Jan 01, 2023
2 Feb 18, 2022
2 Oct 31, 2022
255 Dec 23, 2022
1 Dec 04, 2021
6 Nov 07, 2021
2 Oct 21, 2021
6 Jan 20, 2022
2 Oct 07, 2021
2 Jan 04, 2022
2 Mar 05, 2022
62 Sep 19, 2022
8 Dec 04, 2021
6 Nov 24, 2022
13 Nov 18, 2022