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.
90 Jan 05, 2023
85 Dec 09, 2022
5 Sep 23, 2022
1 Nov 30, 2021
9 Sep 08, 2022
8 Dec 02, 2022
2 May 02, 2022
3 Jun 07, 2022
1 Jan 06, 2022
28.6k Dec 28, 2022
1 Nov 17, 2021
6 Jun 13, 2022
2 Sep 09, 2022
1 May 12, 2022
3 Feb 26, 2022
1 Jan 25, 2022
6 Aug 08, 2022
4 Dec 03, 2021
1 Feb 15, 2022
2 Jan 09, 2022