`dbx-tools-core`

Dependency-free Python configuration and identity helpers shared by dbx-tools packages.

Install from PyPI:

pip install dbx-tools-core

To install the current main branch directly from the repository instead:

pip install "dbx-tools-core @ git+https://github.com/reggie-db/dbx-tools.git@main#subdirectory=packages/py/core"

Key features

config.text() resolves scoped keys from the process environment, then the nearest project .env file, then the single App's config.env in validated Databricks bundle JSON. Root bundle variables are not a config source: they are authoring inputs interpolated into the bundle's own targets, resources, and paths, so reading one as a process setting resolves names the deployed App never sees. Reference a variable from config.env to make it one.
.env.<NODE_ENV> wins over .env, with production/prod and development/dev treated as aliases.
Bundle validation stays lazy: the Databricks CLI runs only after environment and dotenv lookup miss. Dotenv files and bundle results are each loaded once per resolved working-directory context.
Deployed Databricks Apps skip local files and bundle validation because the platform has already populated real environment variables.
DBX_TOOLS_DATABRICKS_APP_ENV=true or false forces Databricks App runtime detection; absent or unrecognized values retain automatic detection.
DBX_TOOLS_CONFIG_DOTENV and DBX_TOOLS_CONFIG_BUNDLE independently force each local source on or off, overriding the usual deployed-App skip.
Bundle reads default off when NODE_ENV=production unless DBX_TOOLS_CONFIG_BUNDLE=true explicitly enables them.
String, boolean, positive-number, positive-integer, and list helpers use the same loose configuration coercions as @dbx-tools/core.
Stable-key, FNV hash, and identifier functions preserve deterministic Node and Python identity contracts.

Quick start

from dbx_tools.core import config

host = config.text("HOST", {"prefix": "SMTP"})
port = config.positive_int(None, "PORT", 587, {"prefix": "SMTP"})

The default key order for HOST with prefix SMTP is DBX_TOOLS_SMTP_HOST, SMTP_HOST, then HOST. Pass config.ENV_ONLY when a caller must read the exact process environment without local file fallbacks. config.is_databricks_app_env() validates the App name, HTTP(S) workspace host, and TCP port unless config.DATABRICKS_APP_ENV_KEY names a recognized boolean override in the environment. config.CONFIG_DOTENV_KEY and config.CONFIG_BUNDLE_KEY name the equivalent per-source overrides. Recognized booleans win; absent or unrecognized values read files outside a Databricks App and skip them inside one. Bundle validation also stays off by default in production.

Modules

config — layered environment, dotenv, and Databricks bundle configuration;
hash.fnv_hash() — the single-string subset of TypeScript fnvHashWithOptions, including UTF-16 code-unit hashing and base-32 output;
object.to_stable_key() — strict structured identity canonicalization;
string.to_identifier() — readable identifier tokenization, with the same hyphen default as TypeScript and an explicit delimiter override for consumers such as the underscore-delimited Postgres bus channel.

The identity functions exist so Python packages do not copy the TypeScript algorithms locally and silently drift. Their shared behavior is tested from packages/test/polyglot/fixtures/core/fixture.json. Configuration precedence, dotenv discovery/parsing, bundle fallback, laziness, and cache behavior are shared fixtures under packages/test/polyglot/fixtures/core/config.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dbx_tools_core-0.6.87.tar.gz (8.6 kB view details)

Uploaded Aug 5, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

dbx_tools_core-0.6.87-py3-none-any.whl (10.4 kB view details)

Uploaded Aug 5, 2026 Python 3

File details

Details for the file dbx_tools_core-0.6.87.tar.gz.

File metadata

Download URL: dbx_tools_core-0.6.87.tar.gz
Upload date: Aug 5, 2026
Size: 8.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for dbx_tools_core-0.6.87.tar.gz
Algorithm	Hash digest
SHA256	`1d4035bdaee4a06c641a5d7f74253a57a2bf00874c1d3ee937dbd56edf947e93`
MD5	`706eeda42ba5468c50209a4e9858a733`
BLAKE2b-256	`3be78c77db0f05e576d652c4f62a2d6eb524db1dcf1f85543bf2b9dfe985eefa`

See more details on using hashes here.

Provenance

The following attestation bundles were made for dbx_tools_core-0.6.87.tar.gz:

Publisher: python-release.yml on reggie-db/dbx-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: dbx_tools_core-0.6.87.tar.gz
- Subject digest: 1d4035bdaee4a06c641a5d7f74253a57a2bf00874c1d3ee937dbd56edf947e93
- Sigstore transparency entry: 2341752615
- Sigstore integration time: Aug 5, 2026
Source repository:
- Permalink: reggie-db/dbx-tools@c75e4addbcae0ab130d94c431aac612afe7e737d
- Branch / Tag: refs/tags/v0.6.87
- Owner: https://github.com/reggie-db
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-release.yml@c75e4addbcae0ab130d94c431aac612afe7e737d
- Trigger Event: push