matvu 0.1.0__tar.gz

matvu-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,47 @@
+name: release
+
+# Publishing is triggered when a GitHub Release is published (or manually).
+# PyPI upload uses Trusted Publishing (OIDC) - no API token is stored.
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade pip build twine
+          python -m build
+          python -m twine check dist/*
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/matvu/
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI (Trusted Publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1

matvu-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,32 @@
+name: tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    env:
+      MPLBACKEND: Agg
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Run tests
+        run: python -m pytest -q

matvu-0.1.0/.gitignore

@@ -0,0 +1,25 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+
+# Tooling caches
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# Editors / OS
+.DS_Store
+.vscode/
+.idea/
+*.swp
+
+# MatVu outputs
+examples/out/
+preview.png

matvu-0.1.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## 0.1.0 (2026-10-10)
+
+First public release.
+
+- `Structure` model with a POSCAR reader and a plugin registry for more formats
+- Automatic viewpoint optimisation:
+  - maximin projected-dispersion search for crystals, constrained to a
+    comfortable above-horizon elevation band
+  - one shared three-quarter view for all cubic lattices
+  - ~30 degree tilt for layered 2D materials; face-on views for molecules
+- Two rendering backends:
+  - `tracer` (default): pure-numpy analytic ray casting with exact occlusion
+    and supersampling, orthographic or perspective camera
+  - `matplotlib`: fast preview backend (PNG / PDF / SVG)
+- Look presets: `3d` (shaded), `toon` (cel/animation), `flat` (pure fill)
+- Designed element palettes (`matvu`, `jmol`, `pastel`) and user-editable
+  TOML themes covering colours, radii and style overrides
+- Symmetric periodic boundary decoration, unit cell frames for 3D crystals,
+  transparent output by default, fixed-canvas option for uniform-scale series
+- CLI: `matvu render`, `matvu info`, `matvu candidates`, `matvu theme`