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.
2 Oct 21, 2021
2 Dec 10, 2021
11 Dec 30, 2021
3 Nov 08, 2022
4 Sep 24, 2021
3 Nov 02, 2022
4 Jun 05, 2022
7 Sep 20, 2022
1 Dec 01, 2021
3.5k Dec 30, 2022
4 Oct 02, 2022
1 May 14, 2022
1 Aug 02, 2021
15 Dec 20, 2022
1 Dec 05, 2021
1 Jan 07, 2022
5 Oct 09, 2022
6 Jul 19, 2022
6 May 16, 2022
6 Jul 15, 2022