NOFUS - Nate's One-File Utilities Stash
Project description
NOFUS: Nate's One-File Utilities Stash
About NOFUS
A collection of single purpose classes for common tasks, focusing on simple and straightforward use. Each class can be taken and used individually and requires no external dependencies.
Uses
ConfigFile: No Hassle Config File Parser
Example Config:
[email]
admin = admin@example.com
reply_to = feedback@example.com
[auth.sql]
host = sql.example.com
db = mydbname
user = sqluser
pw = "secret_passwd"
[auth.ldap]
uri = "ldap://ldap1.example.com:389"
uri = "ldap://ldap2.example.com:389"
uri = "ldap://ldap3.example.com:389"
Example Use:
from nofus import ConfigFile
conf = ConfigFile("/path/to/my.conf")
if not conf.load():
print(conf.errors())
else:
admin_email = conf.get("email.admin")
reply_email = conf.get("email.reply_to", default="donotreply@example.com")
sqlauth = conf.get("auth.sql")
sql_host = sqlauth.get("host")
sql_db = sqlauth.get("db")
sql_user = sqlauth.get("user")
sql_pw = sqlauth.get("pw")
ldap_uris = conf.get_list("auth.ldap.uri")
Logger: Simplified Alternate Logging Interface
Example Use:
from nofus import Logger
# Fast setup, default to logging LOG_DEBUG and higher
Logger.initialize('/tmp/myfile.log')
Logger.info("Info!")
Logger.notice("Notice!")
Logger.warning("Warning!")
Logger.error("Error!")
Logger.critical("Critical!")
# Easily put an exception stack trace into the log
try:
1/0
except ZeroDivisionError as exc:
Logger.info("Caught something.", exc_info=exc)
# Disable logging
Logger.disable()
# Set custom log level
Logger.initialize('/tmp/myfile.log', Logger.LOG_TRACE)
Logger.trace("Trace!")
# Check log level
if Logger.is_enabled(Logger.LOG_DEBUG):
Logger.debug("Yep, we're debugging.")
# Or Define a custom logger
from nofus import LoggingInterface
class CustomLogger(LoggingInterface):
def __init__(self, log_file=None, log_level=None):
if log_level is None:
log_level = Logger.LOG_LOW
# Customize your init
def make_log(self, entry, log_level):
# Customize your log actions
Logger.register(CustomLogger())
Installation
If all you need is one class, you can just grab a file and throw it in your project.
Or you can install the whole stack using pip
:
pip install nofus
License
NOFUS is covered by the Simplified BSD License.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
nofus-0.1.5.tar.gz
(12.9 kB
view hashes)
Built Distribution
nofus-0.1.5-py3-none-any.whl
(13.8 kB
view hashes)