randfacts 0.21.0__tar.gz → 0.23.0__tar.gz

randfacts-0.21.0/LICENSE.txt → randfacts-0.23.0/LICENSE

@@ -1,5 +1,5 @@
 MIT License
-Copyright (c) 2020-2021 Connor Sample
+Copyright (c) 2020-2024 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-0.21.0/randfacts.egg-info → randfacts-0.23.0}/PKG-INFO

@@ -1,10 +1,17 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: randfacts
-Version: 0.21.0
+Version: 0.23.0
 Summary: Package to generate random facts
-Home-page: https://github.com/TabulateJarl8/randfacts
-Author: Tabulate
+License: MIT
+License-File: LICENSE
+Author: TabulateJarl8
 Author-email: tabulatejarl8@gmail.com
+Requires-Python: >=3.6,<4.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
@@ -13,14 +20,13 @@ 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: Natural Language :: English
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Requires-Python: >=3.6
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: importlib-metadata (>=1.4,<2.0) ; python_version < "3.8"
+Project-URL: Homepage, https://tabulate.tech/software/randfacts/
+Project-URL: Repository, https://github.com/TabulateJarl8/randfacts
 Description-Content-Type: text/markdown
-License-File: LICENSE.txt
 
 <p align="center">
 <img src="https://raw.githubusercontent.com/TabulateJarl8/randfacts/master/imgs/logo-embedded-font.svg" />
@@ -35,6 +41,7 @@ License-File: LICENSE.txt
 	<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>
@@ -118,3 +125,4 @@ More help.
 ```sh
 $ python3 -m randfacts --help
 ```
+

{randfacts-0.21.0 → randfacts-0.23.0}/README.md

@@ -11,6 +11,7 @@
 	<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-0.23.0/pyproject.toml

@@ -0,0 +1,133 @@
+[tool.poetry]
+name = "randfacts"
+version = "0.23.0"
+description = "Package to generate random facts"
+authors = ["TabulateJarl8 <tabulatejarl8@gmail.com>"]
+license = "MIT"
+readme = "README.md"
+include = ["randfacts/*.txt"]
+homepage = "https://tabulate.tech/software/randfacts/"
+repository = "https://github.com/TabulateJarl8/randfacts"
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.6",
+  "Programming Language :: Python :: 3.7",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Natural Language :: English",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Development Status :: 5 - Production/Stable",
+  "Intended Audience :: Developers",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+packages = [{ include = 'randfacts' }]
+
+[tool.poetry.scripts]
+randfacts = 'randfacts.randfacts:_cli_entrypoint'
+
+[tool.pyright]
+reportUnusedCallResult = false
+
+[tool.ruff.lint]
+preview = true
+select = ["ALL"]
+
+ignore = [
+  # complains about tab indentation
+  "W191",
+  "D206",
+  # adds a line break before a class docstring
+  "D203",
+  # puts the first line summary of a docstring on a different line than the """
+  "D213",
+  # tries to add a blank line after the last docstring section
+  "D413",
+  # yells at you if you use a bool typed function argument
+  "FBT001",
+  "FBT002",
+  # yells at you for using try-except in a for loop
+  "PERF203",
+  # allow for the use of Any
+  "ANN401",
+  # false positives for overriding methods (i think)
+  "PLR6301",
+  # disable too many branches check
+  "PLR0912",
+  # copyright at top of file
+  "CPY",
+  # complains about random.choice() not being good for cryptography
+  "S311",
+]
+
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = [
+  "S101",
+  "ANN001",
+  "ANN002",
+  "PLC2701",
+  "ARG002",
+  "PLR2004",
+  "DOC",
+  "INP001",
+  "S",
+]
+"randfacts/randfacts.py" = ["T201"]
+"randfacts/__main__.py" = ["D100"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "tab"
+line-ending = "lf"
+
+[tool.ruff.lint.isort]
+combine-as-imports = true
+force-wrap-aliases = true
+order-by-type = true
+
+[tool.poetry.dependencies]
+python = "^3.6"
+importlib-metadata = { version = "^1.4", python = "<3.8" }
+
+[tool.poetry.group.dev.dependencies]
+ruff = [
+  { version = "^0.14.11", python = "^3.9" },
+  { version = "^0.7.4", python = ">=3.7,<3.9" },
+]
+pytest = [
+  { version = "^9.0.2", python = "^3.10" },
+  { version = "^8.3.3", python = ">=3.9,<3.10" },
+  { version = "^6.2.0", python = ">=3.6,<3.8" },
+]
+pytest-cov = [
+  { version = "^7.0.0", python = "^3.9" },
+  { version = "^5.0.0", python = ">=3.8,<3.9" },
+  { version = "^4.0.0", python = ">=3.6,<3.8" },
+]
+mypy = [
+  { version = "^1.19.1", python = "^3.9" },
+  { version = "~1.14.0", python = ">=3.8,<3.9" },
+  { version = "~1.4.0", python = ">=3.7,<3.8" },
+]
+
+[tool.coverage.run]
+omit = ["randfacts/__main__.py"]
+
+# legacy import: ingore types
+[tool.mypy]
+[[tool.mypy.overrides]]
+module = "importlib_metadata.*"
+ignore_missing_imports = true
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

randfacts-0.23.0/randfacts/__init__.py

@@ -0,0 +1,57 @@
+"""Module to generate random facts.
+
+randfacts provides an interface to a list of facts installed with the module.
+You can retrieve facts via the get_fact method. randfacts also allows for
+execution via the command line. See the examples section for more details.
+
+Code Examples:
+				Example usage of randfacts in code.
+
+				Generate a random SFW (safe for work) fact.
+
+						>>> randfacts.get_fact()
+
+				Generate a random NSFW (not safe for work) fact.
+
+						>>> randfacts.get_fact(only_unsafe=True)
+
+				Generate a random mixed fact (possibility of both SFW and NSFW facts)
+
+						>>> randfacts.get_fact(filter_enabled=False)
+
+CLI Examples:
+		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 SFW and NSFW facts.
+
+				$ python3 -m randfacts --mixed
+
+		More help.
+
+				$ python3 -m randfacts --help
+
+"""
+
+from randfacts.randfacts import (
+	__version__,
+	all_facts,
+	get_fact,
+	safe_facts,
+	unsafe_facts,
+)
+
+__all__ = [
+	"__version__",
+	"all_facts",
+	"get_fact",
+	"safe_facts",
+	"unsafe_facts",
+]

randfacts-0.23.0/randfacts/__main__.py

@@ -0,0 +1,3 @@
+from .randfacts import _cli_entrypoint  # pyright: ignore[reportPrivateUsage]
+
+_cli_entrypoint()

randfacts-0.23.0/randfacts/randfacts.py

@@ -0,0 +1,94 @@
+"""Contains the core functionality of randfacts."""
+
+import argparse
+import sys
+from pathlib import Path
+from random import choice
+
+if sys.version_info >= (3, 8):  # noqa: UP036
+	from importlib import metadata
+else:
+	import importlib_metadata as metadata
+
+__version__: str = metadata.version("randfacts")
+
+dir_path = Path(__file__).resolve().parent
+
+with (dir_path / "safe.txt").open(encoding="utf-8") as f:
+	safe_facts = [fact.rstrip("\r\n ") for fact in f if fact.rstrip("\r\n ")]
+
+with (dir_path / "unsafe.txt").open(encoding="utf-8") as f:
+	unsafe_facts = [fact.rstrip("\r\n ") for fact in f if fact.rstrip("\r\n ")]
+
+all_facts = safe_facts + unsafe_facts
+
+
+def get_fact(filter_enabled: bool = True, only_unsafe: bool = False) -> str:
+	"""This function returns a random fact.
+
+	Parameters
+	----------
+	filter_enabled : bool
+			The `filter_enabled` parameter determines if the function will filter
+			out potentially inappropriate facts. Defaults to True.
+
+	only_unsafe : bool
+			The `only_unsafe` parameter determines if the function will only give
+			unsafe (NSFW) facts. Takes precedence over the `filter_enabled` argument.
+
+	Returns:
+	------
+	str
+			A random fact.
+
+	"""
+	if only_unsafe:
+		return choice(unsafe_facts)
+	if not filter_enabled:
+		return choice(all_facts)
+	return choice(safe_facts)
+
+
+def _cli_entrypoint() -> None:
+	"""Entrypoint for execution via command-line."""
+	parser = argparse.ArgumentParser(
+		description="Generate random facts from the command-line",
+	)
+
+	parser.add_argument(
+		"-V",
+		"--version",
+		action="store_true",
+		help="Print the package version and exit",
+	)
+
+	group = parser.add_mutually_exclusive_group()
+	group.add_argument(
+		"-m",
+		"--mixed",
+		action="store_true",
+		help="Include safe and unsafe facts",
+	)
+
+	group.add_argument(
+		"-u",
+		"--unsafe",
+		action="store_true",
+		help="Only include unsafe facts",
+	)
+
+	args = parser.parse_args()
+
+	if args.version:  # pyright: ignore[reportAny]
+		print(__version__)
+		return
+	if args.mixed:  # pyright: ignore[reportAny]
+		print(get_fact(filter_enabled=False))
+	elif args.unsafe:  # pyright: ignore[reportAny]
+		print(get_fact(only_unsafe=True))
+	else:
+		print(get_fact())
+
+
+if __name__ == "__main__":
+	_cli_entrypoint()

{randfacts-0.21.0 → randfacts-0.23.0}/randfacts/safe.txt

@@ -378,7 +378,7 @@ Whales can suffer from sunburns
 In 2015, a U.S. journalist was sentenced to 5 years in jail for posting a link on the web
 South Koreans drink twice as much alcohol as Russians
 A newborn baby has about one cup of blood in his body.
-4%of women in the U.S. are pregnant right now
+4% of women in the U.S. are pregnant right now
 The world's longest hangover lasted 4 weeks after a Scotsman consumed 60 pints of beer.
 In 1962, John F Kennedy secretly installed a taping system in the White House.
 Men with shaved heads are perceived as an inch taller and 13% stronger than men with hair.
@@ -850,7 +850,6 @@ Historically, for every 100 climbers who have made it to the summit of Mount Eve
 Robert F. Kennedy was shot by a Palestinian because of his strong support for Israel.
 London ranked as the 6th most expensive city to live in 2016
 Some Buddhist monks in Japan used to practice self-mummification by adhering to a special diet, then sealing themselves alive into burial chambers.
-Einstein was offered the presidency of Israel which he politely declined.
 In Finland, 9 out of 10 plastic bottles are returned for recycling and almost 100% of glass bottles are also recycled.
 The word "mortgage" comes from a French word that means "death contract".
 D'oh! is a real word in the  Oxford English Dictionary . In The Simpsons scripts, it just says "annoyed grunt.
@@ -1269,7 +1268,7 @@ Having an orgasm at least 3 times a week cuts in half the likelihood of coronary
 30 million people in China live on less than US$1 per day, as of 2019.
 Brazil is defined as a "federal republic" composed of the Federal District, 26 states, and 5,570 municipalities.
 People with autism are less likely to catch yawns. The more severe their condition, the less common the behavior gets.
-Mexico has68 official languages.
+Mexico has 68 official languages.
 Girls who complete secondary school are 6 times less likely to become child brides
 La Paz, Bolivia, was the first South American city to get an electricity supply. It was powered by llama dung
 Penguins have an organ near the eye that filters salt from the water out of their system
@@ -3159,7 +3158,6 @@ The meaning of Siberia is "sleeping land."
 Ancient Romans at one time used human urine as an ingredient in their toothpaste
 Billie Jean by Michael Jackson was the first video to air on MTV by a black artist
 Eyebrow hair lasts between 3-5 months before it sheds
-An elephant cannot jump
 Scientists say that babies that are breastfed are more likely to be slimmer as adults than those that are not breastfed
 The reason why the Mexican sombrero hat is so wide is to provide shade for the entire body
 Amazingly, goalies in the National Hockey League played without masks until the year 1959
@@ -3843,7 +3841,6 @@ The loss of eyelashes is referred to as madarosis
 Approximately 75% of human poop is made of water
 The popular chocolate bar "Three Musketeers" got its name because when it was first introduced in 1932 there were three individual bars. The flavours were strawberry, chocolate, and vanilla
 Every photograph of the first American atomic bomb detonation was taken by Harold Edgerton
-Heinz Catsup leaving the bottle travels at 25 miles per year
 In 1864, A Quebec farmer found a frog inside a hailstone
 Actor Sylvester Stallone once had a job as a lion cage cleaner
 The first time there was an instance where they had a separate toilet for women and men was in 1739 at a ball in Paris
@@ -4264,7 +4261,6 @@ Mario, of Super Mario Bros. fame, appeared in the 1981 arcade game, Donkey Kong.
 Women are 37% more likely to go to a psychiatrist than men are.
 Diet Coke was only invented in 1982.
 There are more than 1,700 references to gems and precious stones in the King James translation of the Bible.
-American car horns beep in the tone of F.
 Turning a clock's hands counterclockwise while setting it is not necessarily harmful. It is only damaging when the timepiece contains a chiming mechanism.
 There are twice as many kangaroos in Australia as there are people. The kangaroo population is estimated at about 40 million.
 Police dogs are trained to react to commands in a foreign language; commonly German but more recently Hungarian.
@@ -4377,7 +4373,6 @@ There are more chickens than people in the world (at least before that chicken-f
 All 50 states are listed across the top of the Lincoln Memorial on the back of the $5 bill.
 The slogan on New Hampshire license plates is "Live Free or Die." These license plates are manufactured by prisoners in the state prison in Concord.
 Hydrogen gas is the least dense substance in the world, at 0.08988g/cc. Hydrogen solid is the most dense substance in the world, at 70.6g/cc.
-The longest place name still in use is: Taumatawhakatangihangaoauauotam-eteaturipukakapikimaungahoronukupokai-whenu a kitanatahu – a New Zealand hill.
 Only 1 in 2,000,000,000 will live to be 116 or older.
 When you tie a noose, the rope is wrapped twelve times around because it's the same length as a persons head.
 The sentence, "The quick brown fox jumps over the lazy dog," uses every letter in the alphabet.
@@ -4397,7 +4392,6 @@ To escape the grip of a crocodile's jaws, push your thumbs into its eyeballs –
 Reindeer like to eat bananas.
 More people are killed annually by donkeys than airplane crashes.
 Because of the rotation of the earth, an object can be thrown farther if it is thrown west.
-The average person spends 6 months of their life sitting at red lights.
 More Monopoly money is printed in a year, than real money throughout the world.
 Caesar salad has nothing to do with any of the Caesars. It was first concocted in a bar in Tijuana, Mexico, in the 1920′s.
 Seattle's Fremont Bridge rises up and down more than any drawbridge in the world.
@@ -4457,7 +4451,6 @@ Golf courses cover 4% of North America.
 The average person will accidentally eat just under a pound of insects every year.
 Until 1994, world maps and globes sold in Albania only had Albania on them.
 The value of Pi will be officially "rounded down" to 3.14 from 3.14159265359 on December 31, 1999.
-The Great Wall of China is the only man-made structure visible from space.
 A piece of paper can be folded no more then 9 times.
 The amount of computer Memory required to run WordPerfect for Win95 is 8 times the amount needed aboard the space shuttle.
 The average North American will eat 35,000 cookies during their life span.
@@ -4596,7 +4589,6 @@ Bullet proof vests, fire escapes, windshield wipers, and laser printers were all
 Lorne Greene had one of his nipples bitten off by an alligator while he was host of "Lorne Greene's Wild Kingdom."
 Who's that playing the piano on the "Mad About You" theme? Paul Reiser himself.
 Over 1000 birds a year die from smashing into windows!
-Recycling one glass jar, saves enough energy to watch T.V for 3 hours!
 Q is the only letter in the alphabet that does not appear in the name of any of the United States!
 166,875,000,000 pieces of mail are delivered each year in the US
 Daffy Duck's middle name is "Dumas"
@@ -5077,7 +5069,6 @@ Many insects can carry 50 times their own body weight. This would be like an adu
 There are over a million described species of insects. Some people estimate there are actually between 15 and 30 million species.
 Most insects are beneficial to people because they eat other insects, pollinate crops, are food for other animals, make products we use (like honey and silk) or have medical uses.
 Butterflies and insects have their skeletons on the outside of their bodies, called the exoskeleton. This protects the insect and keeps water inside their bodies so they don't dry out.
-Elephants are the only mammals that cannot jump.
 11% of the world is left-handed.
 A healthy (non-colorblind) human eye can distinguish between 500 shades of gray.
 Lizards can self-amputate their tails for protection. It grows back after a few months.
@@ -5119,7 +5110,6 @@ In a survey of 200000 ostriches over 80 years, not one tried to bury its head in
 Andorra, a tiny country between France & Spain, has the longest average lifespan: 83.49 years.
 In America you will see an average of 500 advertisements a day.
 John Lennon's first girlfriend was named Thelma Pickles.
-You can lead a cow upstairs but not downstairs.
 "Duff" is the decaying organic matter found on a forest floor.
 The US has more personal computers than the next 7 countries combined.
 Kuwait is about 60% male (highest in the world). Latvia is about 54% female (highest in the world).
@@ -5473,7 +5463,6 @@ Ketchup Used to Be Considered a Medicine
 Polar Bears Don't Have White Skin or Fur
 Sudan Has Almost Twice as Many Pyramids as Egypt
 Barbie and Ken Have Full Names
-About 1 Out of Every 2,000 Babies Is Born With a Tooth
 T-Mobile Owns the Color Magenta
 The Only Words That Rhyme With "Purple" Are "Hirple" and "Curple"
 The Vatican's ATMs Are in Latin
@@ -5602,7 +5591,6 @@ Sign language has tongue twisters.
 Penguins fly underwater.
 Minnie the Mouse's first name is not Minnie.
 Rudolph the Reindeer is female.
-A jiffy is a proper unit of time.
 April 11, 1954, was recorded as the most boring day in the world.
 Tiramisu translates to 'take me to heaven' in Italian.
 Buttermilk does not contain any butter.
@@ -5758,7 +5746,6 @@ Up to 20% of power outages in the U.S are due to squirrels.
 The Mayo Clinic made glow in the dark cats while trying to find a cure for AIDS.
 The Antarctic glaciers are made up of 3% penguin urine.
 The happiest prisoner on death row had an IQ of 46.
-Violin bows are made from horsehair.
 IKEA is an acronym.
 Stephen Hawking held a reception for time travelers in 2009.
 A Norwegian Island made dying illegal.
@@ -6203,7 +6190,7 @@ The man who designed the Pringles can, Fred Bauer, is buried in one-or at least
 There's a world record for the holder of the most world records: Ashrita Furman, who's set more than 600 records and currently holds more than 200. His records have ranged from fastest mile on a pogo stick, longest time to hula hoop underwater and greatest distance traveled on a bicycle balancing a milk bottle on the head.
 The sun makes up more than 99% of the mass in our solar system.
 Lined up, all of the planets in the solar system could fit between the Earth and the moon.
-The Great Wall of China is not actually visible from space.
+The Great Wall of China is not actually visible from space with the naked eye.
 One million Earths could fit inside the sun.
 It rains diamonds on both Jupiter and Saturn. On these planets, lightning turns methane in the atmosphere into carbon, which hardens into bits of graphite and diamond as it falls to the ground.
 Outer space is completely silent.
@@ -6212,7 +6199,6 @@ The largest known volcano in the solar system is Olympus Mons, located on Mars.
 On Mars, sunsets appear blue due to the way light is captured in the atmosphere.
 Because there is no atmosphere, wind, or water to erode them, astronaut footprints on the moon will likely remain there for hundreds of millions of years.
 One spacesuit for a NASA astronaut costs $12 million to make.
-Uranus is the only planet to spin on its side.
 The diameter of Pluto is smaller than the horizontal length of the United States.
 The Kármán line, the invisible boundary that officially separates Earth from outer space, is located 62 miles above sea level. So you're only about 62 miles from space right now!
 It's impossible to burp in space. The lack of gravity in space prevents air in your stomach from separating and rising up from food you've eaten.
@@ -6350,7 +6336,6 @@ A rainbow can be seen only in the morning or late afternoon. It can occur only w
 Lightning strikes the Earth 100 times every second.
 La Paz, Bolivia has an average annual temperature below 50 degrees Fahrenheit. However, it has never recorded a zero-degree temperature. Same for Stanley, the Falkland Islands, and Punta Arenas, Chile.
 There are over 87,000 Americans on waiting lists for organ transplants.
-Catsup leaves the bottle at a rate of 25 miles per year.
 Toxic house plants poison more children than household chemicals do.
 You are more likely to be infected by flesh-eating bacteria than you are to be struck by lightning.
 It is physically impossible for you to lick your elbow.
@@ -6371,7 +6356,6 @@ A kiss stimulates 29 muscles and chemicals that cause relaxation. Women seem to
 Every time you lick a stamp, you're consuming 1/10 of a calorie.
 Our eyes are always the same size from birth, but our nose and ears never stop growing.
 The average person falls asleep in seven minutes.
-Almost everyone who reads this will try to lick their elbow.
 According to Chinese acupuncture, there is a point on the head that you can press to control your appetite. It is located in the hollow just in front of the flap of the ear.
 In a recent survey, Americans revealed that banana was their favorite smell.
 When opossums are "playing 'possum," they are not playing. They actually pass out from sheer terror.
@@ -6502,7 +6486,6 @@ If Barbie were life-size, her measurements would be 39-23-33. She would stand 7
 On average, people fear spiders more than they do death.
 Thirty-five percent of the people who use personal ads for dating are already married.
 In Tokyo you can buy a toupee for your dog.
-A dime has 118 ridges around the edge.
 The world's oldest wooden wheel has been around for more than 5,000 years
 Dead skin cells are a main ingredient in household dust
 Sudan has more pyramids than any country in the world
@@ -6714,7 +6697,6 @@ NFL refs also get Super Bowl rings.
 President Hubert Hoover invented a game called "Hooverball" which was a cross between tennis and volleyball and was played with a medicine ball.
 Only one city has won three major championships in one year. In 1935, the Detroit Lions won the Super Bowl, the Tigers won the world series, and the Red Wings won the Stanley Cup.
 More than 100 baseballs are used during a typical professional baseball game.
-You can't hum while plugging your nose.
 Tomatoes have more genes than humans.
 We're one to two centimeters taller in the morning than at night.
 One quarter of all our bones are in our feet.
@@ -6761,7 +6743,7 @@ Turns out, a dog's paw print is just as unique as a human's. Good news for dog d
 A camel can drink up to 40 gallons of water in one go. That's seriously impressive!
 Don't bring your crystal ball to Maryland! Fortune telling is illegal in the state.
 Speaking of ferrets, did you know they used to be used to protect grain stores from rodents?
-The technical term for a fear of long words is ""hippopotomonstrosesquippedaliophobia." No way you can self-diagnose yourself with that one!
+The technical term for a fear of long words is "hippopotomonstrosesquippedaliophobia." No way you can self-diagnose yourself with that one!
 The White House has 35 bathrooms. So every bathroom break can be different for POTUS!
 Greyhounds can run up to 45 mph. So don't challenge one to a race!
 Hiking naked is illegal in Switzerland. Though we must say, it doesn't seem like a good idea in general!
@@ -7020,7 +7002,6 @@ Rubber bands last longer when refrigerated.
 Since 1896, the beginning of the modern Olympics, only Greece and Australia have participated in every Games.
 The average person has over 1,460 dreams a year.
 The band Duran Duran got their name from an astronaut in the 1968 Jane Fonda movie Barbarella.
-The Earth weighs around 6,588,000,000,000,000,000,000,000 tons.
 The first toilet ever seen on television was on "Leave It To Beaver."
 The international telephone dialing code for Antarctica is 672.
 The name "Jeep" came from the abbreviation used in the army for the "general purpose" vehicle, G.P.
@@ -7164,7 +7145,6 @@ Only animal besides a human that can get sunburn: a pig.
 Proportional to their weight, men are stronger than horses.
 It is believed that Shakespeare was 46 around the time that the King James Version of the Bible was written. In Psalms 46, the 46th word from the first word is "shake," and the 46th word from the last word is "spear."
 The parachute was invented by Leonardo da Vinci in 1515.
-"Canada" is a Native American word meaning "big village."
 The symbol on the "pound" key (#) is called an octothorpe.
 A full 7% of the entire Irish barley crop goes to the production of Guinness beer.
 Tigers have striped skin, not just striped fur.
@@ -7346,7 +7326,6 @@ There's an ant species unique to New York City.
 The Eiffel Tower was originally intended for Barcelona.
 There's only one Shell garage actually shaped like a Shell.
 The shortest commercial flight in the world is in Scotland.
-Dolphins have names for one another.
 The blob of toothpaste on a toothbrush has a name - a nurdle.
 One part of Istanbul is in Europe and the other is in Asia.
-There are more than 1,000 types of bananas growing in the world.
+There are more than 1,000 types of bananas growing in the world.

{randfacts-0.21.0 → randfacts-0.23.0}/randfacts/unsafe.txt

@@ -112,4 +112,4 @@ During the medieval times (circa 1400s), France had impotency trials. Which allo
 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.
+According to a British law passed in 1845, attempting to commit suicide was a capital offense. Offenders could be hanged for trying.

randfacts-0.21.0/MANIFEST.in

@@ -1 +0,0 @@
-include randfacts/*.txt

randfacts-0.21.0/PKG-INFO

@@ -1,120 +0,0 @@
-Metadata-Version: 2.1
-Name: randfacts
-Version: 0.21.0
-Summary: Package to generate random facts
-Home-page: https://github.com/TabulateJarl8/randfacts
-Author: Tabulate
-Author-email: tabulatejarl8@gmail.com
-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: Natural Language :: English
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-License-File: LICENSE.txt
-
-<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>
-	<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 pip:
-
-```sh
-$ 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
-```

randfacts-0.21.0/randfacts/__init__.py

@@ -1,53 +0,0 @@
-"""Module to generate random facts.
-
-randfacts provides an interface to a list of facts installed with the module.
-You can retrieve facts via the get_fact method. randfacts also allows for
-execution via the command line. See the examples section for more details.
-
-Code Examples:
-		Example usage of randfacts in code.
-
-		Generate a random SFW (safe for work) fact.
-
-			>>> randfacts.get_fact()
-
-		Generate a random NSFW (not safe for work) fact.
-
-			>>> randfacts.get_fact(only_unsafe=True)
-
-		Generate a random mixed fact (possibility of both SFW and NSFW facts)
-
-			>>> randfacts.get_fact(False)
-			>>> # or
-			>>> randfacts.get_fact(filter_enabled=False)
-
-CLI Examples:
-	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 SFW and NSFW facts.
-
-		$ python3 -m randfacts --mixed
-
-	More help.
-
-		$ python3 -m randfacts --help
-
-"""
-
-from .__version__ import __title__, __description__, __url__, __version__, __author__, __author_email__, __license__, __copyright__
-from randfacts.randfacts import get_fact, safe_facts, unsafe_facts, all_facts
-
-import warnings as _warnings
-# Deprecated methods
-def getFact(filter_enabled=True, only_unsafe=False):
-	"""This method is deprecated. Please use get_fact"""
-	_warnings.warn("getFact is deprecated. Please use get_fact", DeprecationWarning, stacklevel=2)
-	return get_fact(filter_enabled, only_unsafe)

randfacts-0.21.0/randfacts/__main__.py

@@ -1,2 +0,0 @@
-from .randfacts import _cli_entrypoint
-_cli_entrypoint()

randfacts-0.21.0/randfacts/__version__.py

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

randfacts-0.21.0/randfacts/randfacts.py

@@ -1,84 +0,0 @@
-from random import choice
-import os
-import argparse
-
-dir_path = os.path.dirname(os.path.realpath(__file__))
-
-with open(os.path.join(dir_path, 'safe.txt'), encoding='utf-8') as f:
-	safe_facts = [
-		fact.rstrip('\r\n ')
-		for fact in f.readlines()
-		if fact.rstrip('\r\n ') != ''
-	]
-
-with open(os.path.join(dir_path, 'unsafe.txt'), encoding='utf-8') as f:
-	unsafe_facts = [
-		fact.rstrip('\r\n ')
-		for fact in f.readlines()
-		if fact.rstrip('\r\n ') != ''
-	]
-
-all_facts = safe_facts + unsafe_facts
-
-
-def get_fact(filter_enabled: bool = True, only_unsafe: bool = False) -> str:
-	"""This function returns a random fact.
-
-	Parameters
-	----------
-	filter_enabled : bool
-		The `filter_enabled` parameter determines if the function will filter
-		out potentially inappropriate facts. Defaults to True.
-
-	only_unsafe : bool
-		The `only_unsafe` parameter determines if the function will only give
-		unsafe (NSFW) facts. Takes precedence over the `filter_enabled` argument.
-
-	Returns
-	------
-	str
-		A random fact.
-
-	"""
-
-	if only_unsafe:
-		return choice(unsafe_facts)
-	if filter_enabled is False:
-		return choice(all_facts)
-	return choice(safe_facts)
-
-
-def _cli_entrypoint():
-	"""Entrypoint for execution via command-line."""
-
-	parser = argparse.ArgumentParser(
-		description='Generate random facts from the command-line'
-	)
-
-	group = parser.add_mutually_exclusive_group()
-	group.add_argument(
-		'-m',
-		'--mixed',
-		action='store_true',
-		help='Include safe and unsafe facts'
-	)
-
-	group.add_argument(
-		'-u',
-		'--unsafe',
-		action='store_true',
-		help='Only include unsafe facts'
-	)
-
-	args = parser.parse_args()
-
-	if args.mixed:
-		print(get_fact(False))
-	elif args.unsafe:
-		print(get_fact(only_unsafe=True))
-	else:
-		print(get_fact())
-
-
-if __name__ == '__main__':
-	_cli_entrypoint()

randfacts-0.21.0/randfacts.egg-info/SOURCES.txt

@@ -1,16 +0,0 @@
-LICENSE.txt
-MANIFEST.in
-README.md
-setup.cfg
-setup.py
-randfacts/__init__.py
-randfacts/__main__.py
-randfacts/__version__.py
-randfacts/randfacts.py
-randfacts/safe.txt
-randfacts/unsafe.txt
-randfacts.egg-info/PKG-INFO
-randfacts.egg-info/SOURCES.txt
-randfacts.egg-info/dependency_links.txt
-randfacts.egg-info/top_level.txt
-tests/test.py

randfacts-0.21.0/randfacts.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

randfacts-0.21.0/randfacts.egg-info/top_level.txt

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

randfacts-0.21.0/setup.cfg

@@ -1,7 +0,0 @@
-[metadata]
-description-file = README.md
-
-[egg_info]
-tag_build = 
-tag_date = 0
-

randfacts-0.21.0/setup.py

@@ -1,43 +0,0 @@
-import pathlib
-import setuptools
-
-here = pathlib.Path(__file__).parent.resolve()
-
-with open(here / "README.md", "r") as fh:
-	long_description = fh.read()
-
-about = {}
-with open(here / "randfacts/__version__.py", "r") as f:
-	exec(f.read(), about)
-
-packages = ['randfacts']
-
-setuptools.setup(
-	name=about["__title__"],
-	version=about["__version__"],
-	author=about["__author__"],
-	author_email=about["__author_email__"],
-	description=about["__description__"],
-	long_description=long_description,
-	long_description_content_type="text/markdown",
-	url=about["__url__"],
-	packages=packages,
-	package_dir={'randfacts': 'randfacts'},
-	classifiers=[
-		"Programming Language :: Python :: 3",
-		"Programming Language :: Python :: 3.6",
-		"Programming Language :: Python :: 3.7",
-		"Programming Language :: Python :: 3.8",
-		"Programming Language :: Python :: 3.9",
-		"Programming Language :: Python :: 3.10",
-		"Programming Language :: Python :: 3.11",
-		"Programming Language :: Python :: 3.12",
-		"Natural Language :: English",
-		"License :: OSI Approved :: MIT License",
-		"Operating System :: OS Independent",
-		"Development Status :: 5 - Production/Stable",
-		"Intended Audience :: Developers"
-	],
-	python_requires='>=3.6',
-	include_package_data=True
-)

randfacts-0.21.0/tests/test.py

@@ -1,45 +0,0 @@
-import unittest
-import sys
-import pathlib
-import subprocess
-
-sys.path.insert(1, str(pathlib.Path(__file__).parents[1]))
-from randfacts import randfacts # local randfacts instead of installed version
-
-class TestRandfacts(unittest.TestCase):
-
-	def test_get_fact(self):
-		self.assertIsInstance(randfacts.get_fact(), str, 'get_fact() must return a string')
-
-	def test_all_facts_list(self):
-		self.assertIsInstance(randfacts.all_facts, list, 'all_facts must be a list')
-
-	def test_safe_facts_list(self):
-		self.assertIsInstance(randfacts.safe_facts, list, 'safe_facts must be a list')
-
-	def test_unsafe_facts_list(self):
-		self.assertIsInstance(randfacts.unsafe_facts, list, 'unsafe_facts must be a list')
-
-	def test_cli_no_args(self):
-		child = subprocess.Popen(['python3', '-m', 'randfacts'], stdout=subprocess.DEVNULL)
-		child.communicate()
-		self.assertEqual(child.returncode, 0, '`python3 -m randfacts` must return with exit code 0')
-
-	def test_cli_unsafe_args(self):
-		child = subprocess.Popen(['python3', '-m', 'randfacts', '--unsafe'], stdout=subprocess.DEVNULL)
-		child.communicate()
-		self.assertEqual(child.returncode, 0, '`python3 -m randfacts --unsafe` must return with exit code 0')
-
-	def test_cli_mixed_args(self):
-		child = subprocess.Popen(['python3', '-m', 'randfacts', '--mixed'], stdout=subprocess.DEVNULL)
-		child.communicate()
-		self.assertEqual(child.returncode, 0, '`python3 -m randfacts --mixed` must return with exit code 0')
-
-	def test_invalid_characters(self):
-		bad_characters = ["‘", "’", "“", "”", "…", "—"]
-		for index, fact in enumerate(randfacts.all_facts):
-			for char in bad_characters:
-				self.assertNotIn(char, fact, f'Index: {index}')
-
-if __name__ == '__main__':
-	unittest.main()