biz.dfch.AsdSte100Vocab

Table of Contents

• Introduction
• Installation
• Create your own vocabulary entries
• Related Projects
• Make a Release
• License

Introduction

This is a Python library, that implements an ASD-STE100 Issue 9 compatible dictionary, that includes the Technical Nouns (TN) and Technical Verbs (TV) from the rule R1.5 and rule R1.12. A word has these properties:

• name, the name of a word item
• status, is this word APPROVED or REJECTED?
• source, where does this word come from?
• type_, the word type (similar to "part of speech")
• category, the TN or TV category or "default"
• spellings, all correct spellings of the Word item (this is not a "lemma")
• meanings, contains one or more meanings for an APPROVED word item
• alternatives, a list that contains one or more alternatives for a REJECTED word item
• note, an optional note for Word item
• ste_example, an example that shows how to use the Word item correctly
• nonste_example, an example that shows an incorrect use of the Word item

biz.dfch.AsdSte100Lookup uses this library for its word lists and the display of these words.

ASD-STE100: Copyright by (c) ASD.

I am in no way affiliated with ASD. ASD does not endorse my work.

NOTE: the previous name on pypi was biz-dfch-ste100vocab. From version v0.8.0 this library name is biz-dfch-asdste100vocab.

Installation

biz-dfch-asdste100vocab is on PyPI. Create a virtual environment and install the library with pip:

pip install biz-dfch-asdste100vocab

Or install with uv:

uv add biz-dfch-asdste100vocab

Create your own vocabulary entries

When you want to create your own word entries, you install the dev dependencies:

uv sync --extra dev
# or
uv pip install -e ".[dev]"
# or
pip install -e ".[dev]"

Then use this command:

uv run vocab new

You can use an .env file (or environment variables, see --help) to define recurring parameters (see example below) and you can use --interactive (or -i) for an interactive wizard. Each time you start the program, it will create a new JSONL entry.

The specified file must exist. The program will only append to an existing file, but not create a new file.

Example .env file

cat .env

VOCAB_STATUS=approved
VOCAB_SOURCE=ARBITRARY-SOURCE
VOCAB_TYPE=TN
VOCAB_CATEGORY=TN21
VOCAB_FILE=./vocab.jsonl

Related Projects

This library is part of the ASD-STE100 tooling family:

• biz.dfch.AsdSte100Vocab — this repo: the ASD-STE100 Issue 9 vocabulary library
• biz.dfch.AsdSte100Rules — the ASD-STE100 Issue 9 ruleset library
• biz.dfch.AsdSte100Nlp — WordNet-based synonym lookup for ASD-STE100 words
• biz.dfch.AsdSte100Lookup — an interactive CLI to look up words and rules
• biz.dfch.AsdSte100Mcp — an MCP server exposing vocabulary and rules lookup tools

Make a Release

1. Make sure that all tests are satisfactory

Before you make the release, make sure the CI pipeline is green on the dev branch:

uv run --frozen ruff format --check
uv run --frozen ruff check
uv run --frozen pylint $(git ls-files '*.py') || true
uv run --frozen python -m unittest discover -v -s tests -t . -p "test_*.py"

2. Increase the version

Update the version in pyproject.toml:

version = "x.y.z"

3. Commit and push to dev

git add pyproject.toml
git commit -m "chore: bump version to vx.y.z"
git push origin dev

4. Merge dev into main

git checkout main
git merge dev
git push origin main

5. Create and push a version tag

This will create a binary artifact of the application and add it to the release.

export VERSION=x.y.z
git tag v${VERSION}
git push origin v${VERSION}

Then, select the dev branch to continue your work.

git checkout dev

Pushing the tag automatically triggers the publish.yml workflow, which will:

• build the sdist and sheel with uv build (this step creates the artifact)
• create a GitHub Release with auto-generated release notes
• upload the files as a release artifact (this step adds the artifact to the release)

License

This library is licensed under the GNU Affero General Public License. See LICENSE for more information.

ASD-STE100 Simplified Technical English (Standard for Technical Documentation), Issue 9

Copyright 2025 Aerospace, Security and Defence Industries Association of Europe (ASD), https://www.asd-europe.org.

This library or the maintainer is not affiliated with ASD. ASD does not endorse this library or the maintainer.