mooch 1.0.0

A collection of common python utilities.

mooch

mooch is a lightweight Python utility library designed to streamline common development tasks needed for every python project — file handling, path operations, logging decorators, and more — all in one convenient minimum package.

Table of Contents

• Features
• Install
• Usage
• Contributing
• License

✨ Features

Location Class

Provide a zip code to get city, state and lat, lon.

Require Class

Raise an exception if the installed python version is not compatible with a script. Raise an exception if the desired operating system is not compatible with a script.

Logging Decorators

@log_entry_exit

• Logs the entry and exit of the function, including the arguments.
• Useful for debugging and tracing.

Function Decorators

@silent(fallback="fallback value")

• Suppresses exceptions raised within the decorated function.
• Returns fallback if an exception is caught.

@retry(3)

• Retries the decorated function if an exception is raised.
• Returns the last exception on final retry attempt. Optional fallback returned instead if desired.
• Set delay time between tries with delay argument.

🛠 Install

pip install mooch

or

uv add mooch

📌 Dependencies

Python 3.9 or greater

💡 Usage

Browse the examples folder for more examples.

Logging Decorator

from mooch.decorators import log_entry_exit

@log_entry_exit
def random_function(arg1, arg2):
    print(arg1)
    print(arg2)

Log File Output:

DEBUG:__main__:Entering: random_function with args=('Hello', 'World'), kwargs={}
DEBUG:__main__:Exiting: random_function

Retry Decorator

from mooch.decorators import retry

@retry(3)
def get_age(name="random_person"):
    age = ...some other task...
    return age

Location

from mooch import Location
location = Location(62704).load()

print(location.city)                # "Springfield"
print(location.state)               # "Illinois"
print(location.state_abbreviation)  # "IL"
print(location.latitude)            # "39.7725"
print(location.longitude)           # "-89.6889"

Require

Raise an Exception if the requirement isn't satisified.

from mooch import Require

Require.python_version("3.13")
Require.operating_system("Windows")

🏆 Contributing

PRs accepted.

If editing the Readme, please conform to the standard-readme specification.

Bug Reports and Feature Requests

Please use the issue tracker to report any bugs or request new features.

Contributors

📃 License

MIT © Nick Stuer