Disambiguate

Supported Python versions License

Source Code: https://github.com/frankify-app/disambiguate

Disambiguate resolves markdown glossary terms and their transitive dependencies in topological order. Point it at a directory of *.md term files in either GitHub format or Obsidian format, ask for a slug or two, and get back a self-contained markdown document where every term is defined before it is referenced.

Quickstart

uvx disambiguate                       # render the entire glossary
uvx disambiguate topological-order     # render one term and its dependency closure
uvx disambiguate --from notes.md       # extract glossary-shaped links from a doc
uvx disambiguate --explain             # render Disambiguate's own bundled spec
uvx disambiguate --lint                # validate the glossary
uvx disambiguate prune                 # remove terms nothing links

The runtime is stdlib-only — pip install disambiguate brings in nothing else. uvx works without an explicit install.

Installation

pip install disambiguate

How it works

Prune removes terms nothing links, for repos that acquire a shared term set and use only part of it; a term consents by carrying an auto-prune annotation.

The pipeline parses each term into a body plus a list of cross-references, builds a dependency graph from those references, then runs the resolver to produce topological order. The same pipeline backs from-mode and --explain.

For the architectural map, see docs/architecture.md. For the full vocabulary, see the bundled glossary — Disambiguate's own dogfood.

Contributing

See CONTRIBUTING.md. Conventional commits required — the release workflow uses them to compute the next version.

Development Status
- 2 - Pre-Alpha
Intended Audience
- Developers
Natural Language
- English
Operating System
- OS Independent
Programming Language
Topic
- Software Development :: Libraries

Download files

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

Source Distribution

disambiguate-0.3.0.tar.gz (32.3 kB view details)

Uploaded Jul 26, 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.

disambiguate-0.3.0-py3-none-any.whl (38.8 kB view details)

Uploaded Jul 26, 2026 Python 3

File details

Details for the file disambiguate-0.3.0.tar.gz.

File metadata

Download URL: disambiguate-0.3.0.tar.gz
Upload date: Jul 26, 2026
Size: 32.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for disambiguate-0.3.0.tar.gz
Algorithm	Hash digest
SHA256	`446aff71f40737e56633d96c8cdeb1a0e75b2de27d0f8a3711769d791171f3f3`
MD5	`bca646bca56b20f21e229aa5cf9f6578`
BLAKE2b-256	`368beb0d47a199c2f78d46c9d87e8b590c646199ff7b1d1bd9f28d7268128a0d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for disambiguate-0.3.0.tar.gz:

Publisher: publish.yml on frankify-app/disambiguate

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: disambiguate-0.3.0.tar.gz
- Subject digest: 446aff71f40737e56633d96c8cdeb1a0e75b2de27d0f8a3711769d791171f3f3
- Sigstore transparency entry: 2255841861
- Sigstore integration time: Jul 26, 2026
Source repository:
- Permalink: frankify-app/disambiguate@b82290d4a5c14dc336f40119d8fc2e5366b0b28c
- Branch / Tag: refs/tags/v0.3.0
- Owner: https://github.com/frankify-app
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@b82290d4a5c14dc336f40119d8fc2e5366b0b28c
- Trigger Event: push