Install ASCENT

SPEC: 1.0.0-rc1 · Nexus: 3.0.0 Crystal Wire · ascent-wire: 2.1.0 · MIT

Python (`ascent-wire`)

Recommended: PyPI

pip install ascent-wire
ascent self-test
ascent encode --header --role guide "Hello, Universe."

Project: https://pypi.org/project/ascent-wire/

Optional deep-space RS support:

pip install "ascent-wire[deep-space]"
# or: pip install reedsolo

GitHub Release wheel / git

# Release asset
pip install ascent_wire-2.1.0-py3-none-any.whl

# From git tag
pip install "git+https://github.com/Pitchfork-and-Torch/ascent.git@v2.1.0"

Editable clone

git clone https://github.com/Pitchfork-and-Torch/ascent.git
cd ascent
pip install -e ".[deep-space]"
python -m ascent self-test

Import

from ascent import encode_text, decode_stream, hello_universe_bytes
print(hello_universe_bytes().hex()[:32])

JavaScript (`ascent-wire` on npm)

npm install ascent-wire

const { AscentCodec, AscentRS, AscentDLab } = require("ascent-wire");
const wire = AscentCodec.encodeText("Hello, Universe.\n", {
  header: true,
  roleName: "guide",
  nonAscii: "v",
});
console.log(AscentCodec.hexOf(wire));

https://www.npmjs.com/package/ascent-wire

Monorepo path (same sources): packages/ascent-js
Live lab: https://ascent.jonbailey.xyz/

Golden lock

set PYTHONPATH=ref
python tests/test_ascent_codec.py
node tests/run_js_lock.js

Registries

Registry	Status
PyPI `ascent-wire`	Published 2.1.0
npm `ascent-wire`	Published 2.1.0
GitHub Releases	Wheel + sdist also attached
Trusted Publishing	`.github/workflows/publish-pypi.yml` (OIDC on release)

Re-publish helper: scripts/publish-packages.ps1

Future releases (no Desktop tokens)

If PyPI Trusted Publisher is linked to this repo:

Bump version in pyproject.toml
git tag + gh release create
Workflow publish-pypi uploads to PyPI via OIDC

Configure on pypi.org: Project → Settings → Trusted publishers
Owner Pitchfork-and-Torch, repo ascent, workflow publish-pypi.yml, environment pypi.

FilesExpand file tree

INSTALL.md

Latest commit

History