randfacts 0.3.0__py3-none-any.whl → 0.24.0__py3-none-any.whl

randfacts/unsafe.txt

@@ -4,10 +4,8 @@ Instead of kissing, mothers of the Manchu tribe used to show affection by suckin
 Out of their natural habitat more than 60% of male pandas exhibit no sexual desire at all
 In Catalonia (Spain), a smiley-faced piece of wood called "Shitting Log" poops out the presents in Christmas.
 1 in every 5 couples has a sexless marriage, having less than 10 encounters a year.
-A group of cockroaches is called an intrusion.
 More people commit suicide in New York City than are murdered.
 It is estimated that 25-30% of suicides are accompanied by a note
-Nearly half the gold ever mined has come from one place: Witwatersrand, South Africa
 Homosexuals are 39% more likely to be left-handed.
 1 in every 5 people in Greenland attempt suicide at some point in their lives
 The Golden Gate Bridge is the #1 suicide site in the world.
@@ -39,3 +37,80 @@ Witold Pilecki, a Polish soldier, volunteered to be imprisoned in Auschwitz in o
 Besides Jews, others deported to Auschwitz included 150,000 Poles, 23,000 Romani and Sinti, 15,000 Soviet prisoners of war and 400 Jehovah's Witnesses
 Auschwitz's camp commandant Rudolf Hoss, was arrested in 1946, convicted of murder and hanged at the camp
 About 60 million Reichmarks, equivalent to 125m today, was generated for the Nazi state by slave labour at Auschwitz during the Holocaust
+The male praying mantis cannot copulate while its head is attached to its body. The female initiates sex by ripping the males head off
+Sex acts like a natural antihistamine, in can clear up a stuffy nose
+During the female orgasm, endorphines are released, which are powerful painkillers. So headaches are in fact a bad excuse not to have sex
+In the past 60 years, the groundhog has only predicted the weather correctly 28% of the time. The rushing back and forth from burrows is believed to indicate sexual activity, not shadow seeking
+According to psychologists, the shoe and the foot are the most common sources of sexual fetishism in Western society
+In the U.S. there is, on average, three sex change operations per day
+In the 19th century, it was common practice for a Japanese woman to dye their teeth black. They believed that this enhanced sex appeal and maintained healthier teeth
+There are approximately 100 million acts of sexual intercourse each day
+Humans and dolphins are the only species that have sex for pleasure
+In 1926, a waiter in Budapest committed suicide. He left his suicide note in the form of a crossword and the police had to get help from the public to solve it
+The most frequent season for most suicides to occur is in the spring. The winter months have the lowest number of suicides
+Teenage suicide is the second cause of death in the state of Wisconsin
+Singer Billy Joel tried to commit suicide when he was 21 by drinking furniture polish
+Back in 1919, the Russian transplant pioneer Serge Voronoff made headlines by grafting monkey testicles onto human males.
+Nazi leader Adolf Hitler had only one testicle
+About a third of all Jewish people alive at that time were murdered in the Holocaust.
+A Muslim family that saved Jews during the Holocaust, was later saved by Israel during the genocide in Bosnia, and converted to Judaism.
+In 1945, Eisenhower predicted that people would try to deny the holocaust, so he urged the press to come.
+At least 1.1 million Jewish children were murdered during the Holocaust.
+The Leica Camera company helped hundreds of jews before the Holocaust by hiring, and sending them abroad.
+A barnacle has the largest penis of any other animal in relation to its size
+14% of Americans have skinny-dipped with a member of the opposite sex at least once.
+Male bats have the highest rate of homosexuality of any mammal.
+A man's beard grows fastest when he anticipates sex.
+Sex is biochemically no different from eating large quantities of chocolate.
+Sex is the safest tranquilizer in the world. IT IS 10 TIMES MORE EFFECTIVE THAN VALIUM.
+"Ithyphallophobia" is a morbid fear of seeing, thinking about or having an erect penis.
+An American urologist bought Napoleon's penis for $40,000.
+1 sperm contains about 37.5MB of DNA data, so 1 ejaculation transfers about 15,875GB of data, equivalent to almost 16TB
+A whale's penis is called a dork.
+Sex burns 360 calories per hour.
+Every year 11,000 Americans injure themselves while trying out bizarre sexual positions.
+Honking of car horns for a couple that just got married is an old superstition to insure great sex.
+The Black Widow spider eats her mate during or after sex.
+Steely Dan got their name from a sexual device depicted in the book 'The Naked Lunch'.
+60% of all people using the Internet, use it for pornography.
+UK's Internet Porn Filter Architect was Arrested On Child Porn Offenses in 2014
+A man will ejaculate approximately 18 quarts of semen in his lifetime.
+Adolf Hitler was a vegetarian.
+Hitler and Napoleon both had only one testicle
+To "testify" was based on men in the Roman court swearing to a statement made by swearing on their testicles.
+During WW1, a British soldier spared the life of a wounded German: Adolf Hitler
+Hitler was saved from drowning by a priest when he was 4 years old
+Hitler planned to collect thousands of Jewish artifacts to build a "Museum of An Extinct Race" after the war.
+During WW2, when Hitler visited Paris, the French cut the lift cables on the Eiffel Tower so that Hitler would have to climb the steps if he wanted to reach the top
+Hitler, while in prison, wrote to a Mercedes dealership begging for a car loan
+Hitler was nominated for the Nobel Peace Prize in 1939
+When the D-Day forces landed, Hitler was asleep. None of his generals dared send re-enforcements without his permission, and no-one dared wake him.
+As a child, Hitler wanted to be a priest
+Adolf Hitler loved chocolate cake
+Adolf Hitler wanted to be an architect, but he failed the entrance exam at the architectural school in Vienna
+Adolf Hitler was one of the people that was responsible in the creation of the Volkswagen Beetle. He came up with the idea of producing a car that was cheap enough for the average German working man to afford.
+The NY phone book had 22 Hitlers before WWII. The NY phone book had 0 Hitlers after WWII.
+Adolf Hitler's mother seriously considered having an abortion but was talked out of it by her doctor.
+"Adolf Schicklgruber" would have been Hitler's name. His father changed his last name in 1877.
+There was a Jewish-Austrian doctor who didn't charge Hitler's family due to their economic hardship. Hitler had him protected and called him "Noble Jew"
+Hitler suffered chronic flatulence and took 28 different drugs to fight it.
+Aborting a child because of its gender is legal in Sweden
+2% of people who jump off the Golden Gate Bridge survive the fall. One man even jumped off for "fun".
+Every 2 weeks, on average, someone jumps off the Golden Gate Bridge.
+Lithuania has the highest suicide rate in the world.
+According to suicide statistics, Monday is the favored day for self-destruction.
+The sperm count of an average American male compared to thirty years ago is down thirty percent
+Males produce one thousand sperm cells each second – 86 million each day.
+The sperm of a mouse is actually longer than the sperm of an elephant.
+The average shelf-life of a latex condom is about two years.
+"Venus observa" is the technical term for the "missionary position."
+Ramses brand condom is named after the great pharaoh Ramses II who fathered over 160 children.
+During World War II, condoms were used to cover rifle barrels from being damaged by salt water as the soldiers swam to shore
+The human vagina always holds a small amount of yeast.
+In some parts of Australia, up to 90% of the koala population can be afflicted which chlamydia.
+During the medieval times (circa 1400s), France had impotency trials. Which allowed women to divorce their husbands who could not perform sexually.
+Dildos have been around for centuries. With the oldest potential dildo being 28,000 years old.
+Vibrators were created in the 19th century to reduce "hysteria" in women.
+Famous gangster, Al Capone, had undiagnosed syphillis until he went to prison.
+According to a British law passed in 1845, attempting to commit suicide was a capital offense. Offenders could be hanged for trying.
+There is a town named Dildo in the province of Newfoundland, Canada

randfacts-0.24.0.dist-info/METADATA

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: randfacts
+Version: 0.24.0
+Summary: Package to generate random facts
+Keywords: facts,random,generator,trivia,cli,dataset
+Author: TabulateJarl8
+Author-email: TabulateJarl8 <tabulatejarl8@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Natural Language :: English
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Education
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: dataclasses>=0.8 ; python_full_version == '3.6.*'
+Requires-Dist: importlib-metadata>=4.8.3 ; python_full_version < '3.8'
+Requires-Python: >=3.6
+Project-URL: homepage, https://tabulate.tech/software/randfacts/
+Project-URL: repository, https://github.com/TabulateJarl8/randfacts
+Project-URL: issues, https://github.com/TabulateJarl8/randfacts/issues
+Description-Content-Type: text/markdown
+
+<p align="center">
+<img src="https://raw.githubusercontent.com/TabulateJarl8/randfacts/master/imgs/logo-embedded-font.svg" />
+</p>
+<p align="center">
+	<a href="https://badge.fury.io/py/randfacts"><img alt="PyPI" src="https://img.shields.io/pypi/v/randfacts" /></a>
+	<a href="https://aur.archlinux.org/packages/python-randfacts/"><img alt="AUR version" src="https://img.shields.io/aur/version/python-randfacts"></a>
+	<a href="https://pepy.tech/project/randfacts"><img alt="Downloads" src="https://pepy.tech/badge/randfacts" /></a>
+	<a href="https://pypi.python.org/pypi/randfacts/"><img alt="PyPI license" src="https://img.shields.io/pypi/l/randfacts.svg" /></a>
+	<a href="https://GitHub.com/TabulateJarl8/randfacts/graphs/commit-activity"><img alt="Maintenance" src="https://img.shields.io/badge/Maintained%3F-yes-green.svg" /></a>
+	<a href="https://GitHub.com/TabulateJarl8/randfacts/issues/"><img alt="GitHub Issues" src="https://img.shields.io/github/issues/TabulateJarl8/randfacts.svg" /></a>
+	<a href="https://github.com/TabulateJarl8/randfacts/actions/workflows/main.yml"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/TabulateJarl8/randfacts/main.yml?branch=master&label=Duplicate%20Facts%20Test" /></a>
+	<a href="https://github.com/TabulateJarl8"><img alt="GitHub followers" src="https://img.shields.io/github/followers/TabulateJarl8?style=social" /></a>
+	<a href="https://github.com/TabulateJarl8/randfacts"><img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/TabulateJarl8/randfacts?style=social" /></a>
+	<a href="https://codecov.io/gh/TabulateJarl8/randfacts"><img src="https://codecov.io/gh/TabulateJarl8/randfacts/graph/badge.svg?token=HUQJ88VXLQ"/></a>
+	<br>
+	<a href="https://ko-fi.com/L4L3L7IO2"><img alt="Kofi Badge" src="https://ko-fi.com/img/githubbutton_sm.svg" /></a>
+</p>
+
+Randfacts is a Python module 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 uv/pipx/pip:
+
+```sh
+# Install with UV:
+$ uv tool install randfacts
+
+# Or just try it out:
+$ uvx randfacts
+
+# Install with pipx:
+$ pipx install randfacts
+
+# Install with bare pip:
+$ pip3 install randfacts
+```
+
+### Installation via AUR:
+
+Via your AUR helper, like paru:
+
+```sh
+$ paru -S python-randfacts
+```
+
+Or manually
+
+```sh
+$ git clone https://aur.archlinux.org/python-randfacts.git && cd python-randfacts
+$ makepkg -si
+```
+
+# Usage and examples
+
+```python
+import randfacts
+x = randfacts.get_fact()
+print(x)
+```
+
+The above example 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`.
+
+```python
+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:
+
+```py
+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 SFW (safe for work) facts
+
+```sh
+$ python3 -m randfacts
+```
+
+The unsafe argument can be supplied to provide only NSFW (not safe for work) facts
+
+```sh
+$ python3 -m randfacts --unsafe
+```
+
+The mixed argument can be provided to provide both SFW and NSFW facts.
+
+```sh
+$ python3 -m randfacts --mixed
+```
+
+More help.
+
+```sh
+$ python3 -m randfacts --help
+```
+
+# Contributing
+
+Contributions are welcome, this project uses [uv](https://github.com/astral-sh/uv) to manage it's dependencies, so setup is very simple.
+
+## Development Setup
+
+1. Make sure uv is properly installed
+2. Fork and clone the repository with `git clone git@github.com:your-username/randfacts.git`
+3. Install dependencies with `uv sync --dev`
+4. After making changes, ensure the tests pass, and add any unit tests needed to bring code coverage to 100% with the following command:
+
+```sh
+# check everything, if you're just working on one particular issue,
+# see the Makefile for more granular tasks
+make check-all
+```
+
+## Duplicate facts test
+
+I've created a fairly complex duplicate fact detection test in Rust. It will be easier to run on your machine to check/fix any issues, but it also runs in CI if you don't want to set up Rust. It can be run with the following:
+
+```sh
+cd tests/checkduplicates
+cargo run --release
+```

randfacts-0.24.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+randfacts/__init__.py,sha256=njWNkZJZjgGDDUAxvARaBdpG9Ev7UP_m9o1Bhmjd0ec,1210
+randfacts/__main__.py,sha256=9_2xK8cMQNhjhqifDerkF-1TWJKCyAuy4nrg5NlPIsw,1546
+randfacts/randfacts.py,sha256=Bhqvaa14VE5BDImubvrvzhC87uRazyVVIrO4PTdOI64,1393
+randfacts/safe.txt,sha256=Z_iZzNPFgB1Nw-YqyOTOx7GiY13bD41P99GLZW7OliI,633651
+randfacts/unsafe.txt,sha256=VVyEymaWDO7RuAVw9xlLhN3T4FfnmU4eLyqu2XupoHM,10483
+randfacts-0.24.0.dist-info/licenses/LICENSE,sha256=jjeRXh9TXJsz3sInGyxSrmmGr8EFGmiO_nwoyA1ADOU,1088
+randfacts-0.24.0.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
+randfacts-0.24.0.dist-info/entry_points.txt,sha256=DTFTayZZUdAqMhujblUe0dTWtBi4oQLbpOjmJP4tgwQ,65
+randfacts-0.24.0.dist-info/METADATA,sha256=MJxYM0Kq-vfvraUtfVS9BqaCMzpsmp8S0nPe96x2aOI,6519
+randfacts-0.24.0.dist-info/RECORD,,

{randfacts-0.3.0.dist-info → randfacts-0.24.0.dist-info}/WHEEL

@@ -1,5 +1,4 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.36.2)
+Generator: uv 0.9.26
 Root-Is-Purelib: true
 Tag: py3-none-any
-

randfacts-0.24.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+randfacts = randfacts.__main__:cli_entrypoint
+

randfacts-0.3.0.dist-info/LICENSE.txt → randfacts-0.24.0.dist-info/licenses/LICENSE

@@ -1,5 +1,5 @@
 MIT License
-Copyright (c) 2020 Connor Sample
+Copyright (c) 2020-2026 Connor Sample
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
@@ -14,4 +14,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

randfacts/__version__.py

@@ -1,8 +0,0 @@
-__title__ = "randfacts"
-__description__ = "Package to generate random facts"
-__url__ = "https://github.com/TabulateJarl8/randfacts"
-__version__ = "0.3.0"
-__author__ = "Tabulate"
-__author_email__ = "tabulatejarl8@gmail.com"
-__license__ = "MIT"
-__copyright__ = "Copyright 2021 Connor Sample"

randfacts/main.py

@@ -1,16 +0,0 @@
-from random import choice
-import os
-
-dir_path = os.path.dirname(os.path.realpath(__file__))
-
-with open(os.path.join(dir_path, "safe.txt")) as f:
-	safeFacts = [fact.rstrip('\r\n ') for fact in f.readlines() if fact != '']
-with open(os.path.join(dir_path, "unsafe.txt")) as f:
-	unsafeFacts = [fact.rstrip('\r\n ') for fact in f.readlines() if fact != '']
-
-allFacts = safeFacts + unsafeFacts
-
-def getFact(filter=True):
-	if filter == False:
-		return choice(allFacts)
-	return choice(safeFacts)

randfacts-0.3.0.dist-info/METADATA

@@ -1,41 +0,0 @@
-Metadata-Version: 2.1
-Name: randfacts
-Version: 0.3.0
-Summary: Package to generate random facts
-Home-page: https://github.com/TabulateJarl8/randfacts
-Author: Tabulate
-Author-email: tabulatejarl8@gmail.com
-License: UNKNOWN
-Platform: UNKNOWN
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-
-[![PyPI version](https://badge.fury.io/py/randfacts.svg)](https://badge.fury.io/py/randfacts)
-[![Downloads](https://pepy.tech/badge/randfacts)](https://pepy.tech/project/randfacts)
-[![PyPI license](https://img.shields.io/pypi/l/ansicolortags.svg)](https://pypi.python.org/pypi/ansicolortags/)
-[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://GitHub.com/TabulateJarl8/randfacts/graphs/commit-activity)
-[![GitHub issues](https://img.shields.io/github/issues/TabulateJarl8/randfacts.svg)](https://GitHub.com/TabulateJarl8/randfacts/issues/)
-
-
-Randfacts is a python library that generates random facts. You can use ```randfacts.getFact()``` to return a random fun fact.
-
-Example:
-```python
-import randfacts
-x = randfacts.getFact()
-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` parameter to `False`.
-```python
-from randfacts import getFact
-print(getFact(False))
-```
-
-If you want to access the list of facts directly, you can just import the `safeFacts`, `unsafeFacts`, or `allFacts` lists from the randfacts module.
-

randfacts-0.3.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-randfacts/__init__.py,sha256=ehBnCENjaf4PCrPSk4bbvhlxDvOJrp3lrcTciLO58x0,200
-randfacts/__version__.py,sha256=9XRlw3Xlt2jCN6YmHldrniz0iGWB2dTPcS2kRwbb8Fw,290
-randfacts/main.py,sha256=7eEb81KTeLaEZw4co85QHDmUdWMJ09FpcHer3Jag1Io,489
-randfacts/safe.txt,sha256=YV-AArk1mAAk6gp_HwLU4MBHArKhj7sp6UP3gwWyc-4,146690
-randfacts/unsafe.txt,sha256=SFadRUr9tfzJDS3ccU0SBmVTwFxkI3-RvyhkqeJthG0,3637
-randfacts-0.3.0.dist-info/LICENSE.txt,sha256=MV0O-_E0DNx6iBE1wdVgHoZ5fBcEjO0CorKlYz2NxKM,1081
-randfacts-0.3.0.dist-info/METADATA,sha256=P_akMI_Fod2OCiax8vMYQXs3Ge2TvQuNEn7uum9RwcE,1733
-randfacts-0.3.0.dist-info/WHEEL,sha256=OqRkF0eY5GHssMorFjlbTIq072vpHpF60fIQA6lS9xA,92
-randfacts-0.3.0.dist-info/top_level.txt,sha256=CtuA0wZECn98oIjL-EgzBRN804oPMLtAPPpM0KJbWIU,10
-randfacts-0.3.0.dist-info/RECORD,,

randfacts-0.3.0.dist-info/top_level.txt

@@ -1 +0,0 @@
-randfacts