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.20260924145205

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.20260924145205
File Interpreter ABI Platform
thds_core-1.58.20260924145205-py3-none-any.whl Python 3 none any Details

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

Download URL thds_core-1.58.20260924145205-py3-none-any.whl
Size 129.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
003fd8479be284cbaeecc9c074a0863325e788c50ff675310c0a356e87fc6dc8
BLAKE2b-256 checksum
How to use checksums
83ec7076c0643280375ffe0ebd2056c047c08e869857c3b692b4f75705d00758
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.20260924145205 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