🤪 gigity-goo

Welcome to gigity-goo, the most over-engineered, mathematically profound, and utterly ridiculous number-checking library ever conceived in Python.

Have you ever looked at a number and thought: "Sure, it's even, but is it a Spy Number? Is it over 9000? Is it spooky? What if I ask this Python module if a number is Peter Griffin?"

Well, my friend, gigity-goo is exactly what you didn't know you needed.

It is designed to demonstrate the power of Python's execution contexts, "magic" dunder methods, and operator overloading, all while insulting you with sarcastic errors if you do something stupid.

📦 Installation

pip install gigity-goo

🚀 Usage

Even though the package is named gigity-goo (because someone stole the name gigity on PyPI, looking at you, whoever you are), the module is imported simply as gigity:

import gigity

🧠 The "Magic" Behavior

The functions in this library never actually return a primitive boolean (True or False). Instead, they return a custom object (GigityResult) that reads your mind depending on where you use it.

It acts like a boolean for the cold logic of the computer, but screams sentences for the delicate eyes of the user!

1. Logic Contexts (__bool__)

If you use it in an if statement, it acts like a ninja. It evaluates strictly as True or False silently.

if gigity.isEven(4):          
    print("The computer knows it's even, but the module kept its mouth shut!")

2. Display Contexts (__repr__)

If you type it into an interactive REPL or print() it, it suddenly becomes chatty:

>>> gigity.isEven(2)
yes 2 is an even number

3. Doing Math with Sentences (__add__, __sub__, etc)

Because True acts as 1 and False acts as 0 in Python, we overloaded the math operators. You can literally add sentences together!

>>> gigity.isEven(2) + gigity.isEven(4)
2

>>> gigity.isEven(2) + 10
11

4. The Sarcastic Error Handler (__getattr__)

If you try to call a function that doesn't exist, it intercepts your typo and insults you:

>>> gigity.isFloatingPoint(3.14)
AttributeError: GigityError: I don't know how to check 'isFloatingPoint'. Who do you think I am?

>>> gigity.isHappy("yes")
TypeError: GigityBrainDamageError: You passed a str ('yes') to isHappy(). I only evaluate numbers, genius.

>>> gigity.isPeter(1)
AttributeError: GigityFamilyGuyError: Yes, I get the reference. But 'isPeter' isn't a real function.

>>> gigity.isMeg(2)
AttributeError: GigityError: Shut up, Meg.

🧮 The Arsenal of Checks

We support everything from basic middle-school math to college-level number theory, trigonometry, and pure internet brainrot.

Basic Math

>>> gigity.isEven(2)
yes 2 is an even number

>>> gigity.isPrime(7)
yes 7 is a prime number

>>> gigity.isPositive(-5)
no -5 is not a positive number

Advanced Nerd Math

>>> gigity.isFibonacci(8)
yes 8 is a Fibonacci number

>>> gigity.isArmstrong(153)
yes 153 is an Armstrong number

>>> gigity.isHappy(19)
yes 19 is a happy number

>>> gigity.isPronic(12)
yes 12 is a pronic number

>>> gigity.isFascinating(192)
yes 192 is a fascinating number

(Also supports: isSquare, isCube, isPerfect, isPowerOfTwo, isHarshad, isAbundant, isDeficient, isPalindrome, isTriangular, isAutomorphic, isNeon, isSpy)

Constants & Trigonometry

>>> gigity.isPi(3.14159)
yes 3.14159 is Pi (π)

>>> gigity.isGoldenRatio(1.61803)
yes 1.61803 is the Golden Ratio (φ)

>>> gigity.isRightAngle(90)
yes 90 is a right angle in degrees

Internet Brainrot & Memes

>>> gigity.isBeast(666)
yes 666 is the number of the beast! 🤘

>>> gigity.isLeet(1337)
yes 1337 is absolutely l33t.

>>> gigity.isOver9000(9001)
IT'S OVER 9000!!! (yes, 9001 is > 9000)

>>> gigity.isWeed(420)
420 blaze it! 🌿💨

>>> gigity.isSpooky(13)
woah 13 is super spooky! 👻

>>> gigity.isError404(404)
Error 404: Number not found.

>>> gigity.isMeaningOfLife(42)
yes 42 is the meaning of life, the universe, and everything.

>>> gigity.isGigity(69)
giggity giggity goo! 69 is gigity!