Timbersaw Logging Configurator
timbersaw is a an automatic logging configurator.
1. Quick Start
import logging
import contek_timbersaw as timbersaw
timbersaw.setup()
logger = logging.getLogger(__name__)
logger.info('foo bar')
2. Results
INFO level logging will be written to:
{WORKING_DIRECTORY}/logs/info/{yyyy}-{MM}-{dd}.log
ERROR level logging will be written to:
{WORKING_DIRECTORY}/logs/error/{yyyy}-{MM}-{dd}.log
3. Features
Compression
When an INFO log file passes its active period (defaults to when a new day starts), it gets GZipped. For example:
2009-01-03.log -> 2009-01-03.log.gz
Retention
Old logs will be deleted after their retention period. By default, INFO logs are kept for 14 days and ERROR logs are kept for 28 days.
4. Default Settings
log_format
%(asctime)s %(levelname)s %(filename)s:%(lineno)d - %(message)s
log_date_format
%Y-%m-%dT%H:%M:%S
log_root
{WORKDING_DIRECTORY}/logs
log_rolling
MIDNIGHT
log_utc
False
log_info_retention_days
14
log_error_retention_days
28
5. Customization
Settings are configurable via environment properties. They can be set before your program starts using export. For
example:
export log_error_retention_days=7
Otherwise, they can be set at runtime using os.environ. For example:
import os
os.environ['log_error_retention_days'] = '7'
Metadata
Release files for contek-timbersaw 2.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| contek-timbersaw-2.7.tar.gz | 4.9 kB | Without provenance | Details for contek-timbersaw-2.7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| contek_timbersaw-2.7-py3-none-any.whl | Python 3 | none | any | Details for contek_timbersaw-2.7-py3-none-any.whl |
Total release size: 11.4 kB
Release files / contek-timbersaw-2.7.tar.gz
| Download URL | contek-timbersaw-2.7.tar.gz |
|---|---|
| Size | 4.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1d13ee99b81db35c74dd47d4316e6afc364954810ff3be8716901a466e33ca74
|
|
BLAKE2b-256 checksum How to use checksums |
e37b9d575333d44886732d16a5f7e2973aaddcc3d6f6d192450f2b463a1ea4d1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.0 CPython/3.10.0
|
Release files / contek_timbersaw-2.7-py3-none-any.whl
| Download URL | contek_timbersaw-2.7-py3-none-any.whl |
|---|---|
| Size | 6.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bb537732e5613da402ed8161ba76bf6a2324f1f7e2f9958514ac8649d0647a13
|
|
BLAKE2b-256 checksum How to use checksums |
d5515a0de420efc4e9290dff21bf754fd493982559189142408ec02e5348942c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.0 CPython/3.10.0
|
Security for contek-timbersaw 2.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.