Skip to main content

core Library

The monorepo successor to core

Development

If making changes to the library please add an entry to CHANGES.md, and if the change is more than a patch, please bump the version in pyproject.toml accordingly.

Config

thds.core.config provides a general-purpose config system designed to regularize how we implement configuration both for libraries and applications. Please see its README here!

Logging config

This library handles configuration of all DS loggers. By default, all INFO-and-above messages are written (to stderr).

Default output formatter

By default we use a custom formatter intended to make things maximally human-readable.

If you want structured logs, you might try setting THDS_CORE_LOG_FORMAT=logfmt, or json if you want JSON logs.

File format

To customize what level different modules are logged at, you should create a file that looks like this:

[debug]
thds.adls.download
thds.core.link
[warning]
thds.mops.pure.pickle_runner
thds.mops.k8s.watch

You may also/instead add an * to change the global default log level, e.g.:

[warning]
*

The wildcard syntax is not a generic pattern-matching facility; it only matches the root logger.

However, if you wish to match a subtree of the logger hierarchy, this is built in with Python loggers; simply configure thds.adls under [debug] and all otherwise-unconfigured loggers under thds.adls will now log at the DEBUG level.

THDS_CORE_LOG_LEVELS_FILE environment variable

Provide the path to the above-formatted file to thds.core via the THDS_CORE_LOG_LEVELS_FILE environment variable. You may wish to create this file and then set its path via exported envvar in your .bash/zshrc so that you can permanently tune our logging to meet your preferences.

Release files for thds.core 1.58.20260921185124

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for thds.core 1.58.20260921185124
File Interpreter ABI Platform
thds_core-1.58.20260921185124-py3-none-any.whl Python 3 none any Details

Release files / thds_core-1.58.20260921185124-py3-none-any.whl

Download URL thds_core-1.58.20260921185124-py3-none-any.whl
Size 129.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1063aa095079739ccfa6497b661d978a66cc1b6df3f011f0e6803dfc08ef778c
BLAKE2b-256 checksum
How to use checksums
1f7c022f1d70f8c8c12f7bc8c79f5a02860b3abb47841495f3cfad7ee1bd69ff
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release history Release notifications | RSS feed

This release

1.58.20260921185124 This release

1 release file

0.0.1

2 release files

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