prosperousheart/python-log-helper

This repo is the culmination of a long standing desire to make logging easier while leveraging decorators.

About

This python-log-helper repo is the culmination of a long standing desire to make logging easier while leveraging decorators.

Table of Contents

• Business Requirements
  • Must Have
  • Nice to Have
• Current Status
• Additional Resources

Business Requirements

Here are the requirements & nice to haves in relation to this project.

Must Have

Aside from being easily imported into any repo ...

1. Provide easy way to add logging to a repo without having to recreate the settings for each project
2. Have a decorator function that provides DEBUG entry and exit for functions
3. Provide way to turn on / off logging to console (set level to anything other than WARNING)
4. Provide way for choice in what logging file is saved
5. Have some way to show start/end of logging in the file per run
6. Have formatting show time, file name, function name, and logging level in saved logs (to start)
7. easy way to show start and stop of log file logs for each run

Nice to Have

1. Leverage built in functions of logger to limit the number of files chosen when starting run
2. Flexible options for formatting (both console and file)
3. Have way to email log file(s)
4. Consider this when looking to move to a class

Current Status

v1] was to get everything set up and working as functions.

v2 was to migrate from functions to classes, with some fixes and improvements along the way.

v3 was fixing some of the issues found within v2 (like not having modularity).

v4 was to begin adding testing to the code, but other issues were found while fixing some of the work. Eventually bringing us to where we are now ... where for some reason the console is logging twice on import when it wasn't before. Latest as of 20240217.

Additional Resources

The following were used to build this repo:

• PEP 454 - type hints (see here for typing support in python 3)
• Jupyter Python class training

python-log-helper's Issues

review decorator input parameters

Current way may not be the best or most efficient. See:

1. https://stackoverflow.com/a/24617244/10474024

update decorator function to be more flexible

could potential merge the 2 decorator functions. See here

Additional resources:

• https://dev.to/aldo/implementing-logging-in-python-via-decorators-1gje
• https://fangpenlin.com/posts/2012/08/26/good-logging-practice-in-python
• https://docs.python-guide.org/writing/logging