prot-struct-viz
Render a protein structure as a self-contained static HTML file using Mol*, with residues colored, labeled, and styled from a CSV. Everything the view needs — coordinates, colors, tooltips, labels — is embedded in the one file, so it can be dropped on GitHub Pages with no backend.
- Documentation: https://jbloomlab.github.io/prot-struct-viz/
- Live example: https://jbloomlab.github.io/prot-struct-viz/examples/
Install
pip install prot-struct-viz
Quick start
Write a CSV of the residues you want to say something about, and a spec file naming the structure, where the HTML goes, and one or more views of it. Then:
prot-struct-viz spec.yaml
That writes the page, plus a report on any disagreement between the CSV and the structure. One spec can hold several named views — different colorings, labels, representations, or heteroatoms — and the page gets a selector that switches between them without moving the camera. The URL tracks the selector, so a link can point at one particular view.
The quick start shows both files in full; the documentation covers every spec key, the CSV columns, and what a reader of the output can click.
Development
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev,docs]"
scripts/check.sh # pytest + ruff + black
scripts/build_examples.sh # render examples/*/spec.yaml into examples/output/
scripts/build_docs.sh # mkdocs build --strict
Documentation lives in docs/, which is the single source — this README is a front door,
not a second copy. Conventions, and the checks to run after changing anything that affects
rendering, are in CLAUDE.md.
Releasing
Releases are tag-driven and publish to PyPI through
trusted publishing, so no API token is
stored in the repo. The one-time PyPI setup and the per-release recipe are documented at
the top of .github/workflows/release.yml. In short:
# 1. Bump `version` in pyproject.toml and roll CHANGELOG's [Unreleased] into it.
git commit -am "release vX.Y.Z"
git tag vX.Y.Z
git push && git push --tags
The workflow verifies the tag matches pyproject.toml before anything reaches PyPI.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file prot_struct_viz-0.2.0.tar.gz.
File metadata
- Download URL: prot_struct_viz-0.2.0.tar.gz
- Upload date:
- Size: 213.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
77f232fcb1c4c7d86b90e7fa3ea343eb41207ce3bed7d3bc6ce8f2e54f5b6751
|
|
| MD5 |
12b5189fe4380d533e28c299daa13482
|
|
| BLAKE2b-256 |
8231dba27ab8a401a2fdfdbc6589fdc3b629ecc72d49c9bc48a9ef59636d0f92
|
Provenance
The following attestation bundles were made for prot_struct_viz-0.2.0.tar.gz:
Publisher:
release.yml on jbloomlab/prot-struct-viz
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
prot_struct_viz-0.2.0.tar.gz -
Subject digest:
77f232fcb1c4c7d86b90e7fa3ea343eb41207ce3bed7d3bc6ce8f2e54f5b6751 - Sigstore transparency entry: 2686041426
- Sigstore integration time:
-
Permalink:
jbloomlab/prot-struct-viz@30ba448be8474d8452bb7b4576adb9537e049b0f -
Branch / Tag:
refs/tags/v0.2.0 - Owner: https://github.com/jbloomlab
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@30ba448be8474d8452bb7b4576adb9537e049b0f -
Trigger Event:
push
-
Statement type:
File details
Details for the file prot_struct_viz-0.2.0-py3-none-any.whl.
File metadata
- Download URL: prot_struct_viz-0.2.0-py3-none-any.whl
- Upload date:
- Size: 44.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8acd66715e7fb8c13f4db5a89ba61682229d205d1f9a7bc63f0a8ca62d046df6
|
|
| MD5 |
4d76b7b13efda9c29c5f4f641f9bc2cb
|
|
| BLAKE2b-256 |
a8f3f1b496c49c0c40d3063a3fdc77a826234d5e1f23238a8422f1f9d234cb56
|
Provenance
The following attestation bundles were made for prot_struct_viz-0.2.0-py3-none-any.whl:
Publisher:
release.yml on jbloomlab/prot-struct-viz
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
prot_struct_viz-0.2.0-py3-none-any.whl -
Subject digest:
8acd66715e7fb8c13f4db5a89ba61682229d205d1f9a7bc63f0a8ca62d046df6 - Sigstore transparency entry: 2686042726
- Sigstore integration time:
-
Permalink:
jbloomlab/prot-struct-viz@30ba448be8474d8452bb7b4576adb9537e049b0f -
Branch / Tag:
refs/tags/v0.2.0 - Owner: https://github.com/jbloomlab
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@30ba448be8474d8452bb7b4576adb9537e049b0f -
Trigger Event:
push
-
Statement type:
