Skip to main content

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)

Source distribution for contek-timbersaw 2.7
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)

Table of built distributions (wheels) for contek-timbersaw 2.7
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page