trendify2 2.0.4__tar.gz

trendify2-2.0.4/.github/workflows/docs.yml

@@ -0,0 +1,31 @@
+name: Documentation
+on:
+  push:
+    branches:
+      - master
+      - main
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/configure-pages@v5
+      - uses: actions/checkout@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - name: Install Python 3.14
+        run: uv python install 3.14
+      - run: uv run --locked --python 3.14 --group dev zensical build --clean
+      - uses: actions/upload-pages-artifact@v4
+        with:
+          path: site
+      - uses: actions/deploy-pages@v4
+        id: deployment

trendify2-2.0.4/.github/workflows/publish.yml

@@ -0,0 +1,80 @@
+name: "Publish"
+
+on:
+  push:
+    branches: ["main"] # Run tests on every push to main
+    tags: ["v*"] # Run tests AND publish on tags
+  pull_request:
+    branches: ["main"] # Run tests on PRs
+
+jobs:
+  test:
+    name: "Test (Python ${{ matrix.python-version }})"
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13", "3.14", "3.15"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Run unit tests
+        # Explicitly tells uv which python version to use for the test environment;
+        # --locked fails the job if uv.lock is out of date with pyproject.toml
+        run: uv run --locked --python ${{ matrix.python-version }} --group dev pytest
+  publish:
+    name: "Build and Publish"
+    needs: [test]
+    # ONLY run this job if the push was actually a tag
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+    permissions:
+      id-token: write # Required for PyPI Trusted Publishing
+      contents: write # Required to create GitHub Release and upload assets
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          # Fetch all history so we can see other branches
+          fetch-depth: 0
+
+      - name: Verify Tag is on Main
+        # Only perform this check if we were triggered by a tag
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          # Check if 'main' branch contains the current commit
+          if ! git branch -r --contains ${{ github.sha }} | grep -q "origin/main"; then
+            echo "::error::Tag ${{ github.ref_name }} was pushed on a non-main branch. Skipping workflow."
+            exit 1
+          fi
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Install Python 3.14
+        run: uv python install 3.14
+
+      - name: Build
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish --check-url https://pypi.org/simple
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: |
+            dist/*.whl
+            dist/*.tar.gz

trendify2-2.0.4/.gitignore

@@ -0,0 +1,41 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+mojo.log
+mojo.log.*
+
+site
+mojo-models
+textures
+
+typings
+
+# TypeScript build artifacts (node_modules is dev-only; compiled .js files ARE committed)
+node_modules/
+*.js.map
+
+.coverage
+
+**/*.code-workspace
+
+trendify.log*
+
+# Test output files
+discriminator_tests.json
+discriminator_tests.log
+
+/**/.DS_Store
+
+*.prof
+
+# Benchmark output (sweep results are large and machine specific)
+benchmarks/results/
+scripts/example_data

trendify2-2.0.4/.pre-commit-config.yaml

@@ -0,0 +1,57 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-added-large-files
+        args: ["--maxkb=500"]
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.17
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.11.21
+    hooks:
+      - id: uv-lock
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.11.21
+    hooks:
+      - id: uv-export
+  - repo: https://github.com/astral-sh/ty-pre-commit
+    # ty version.
+    rev: v0.0.89
+    hooks:
+      - id: ty
+        # ty checks against the project environment that `uv check` syncs from uv.lock, not
+        # pre-commit's own, so the optional extras must be installed for their imports to
+        # resolve (pydantic_ai, mjviser, viser); --frozen keeps uv.lock from being updated
+        args: [--frozen, --all-extras]
+  # - repo: https://github.com/RobertCraigie/pyright-python
+  #   rev: v1.1.411
+  #   hooks:
+  #     - id: pyright
+  #     - id: pyright
+  #       name: Pyright (docs examples)
+  #       args: [docs]
+  #       pass_filenames: false
+  #       always_run: true
+  #       stages: [pre-commit]
+  - repo: local
+    hooks:
+      - id: act-test
+        name: Run GitHub Actions locally (act)
+        entry: act -j test
+        language: system
+        stages: [pre-push]
+        pass_filenames: false
+        files: ^(src/|tests/|pyproject\.toml|uv\.lock)
+  - repo: local
+    hooks:
+      - id: verify-changelog-tag
+        name: Verify CHANGELOG.md entry and date for current tag push
+        entry: python scripts/verify_changelog_by_tag.py
+        language: python
+        stages: [pre-push]
+        pass_filenames: false
+        always_run: true

trendify2-2.0.4/.python-version

@@ -0,0 +1 @@
+3.14

trendify2-2.0.4/CHANGELOG.md

@@ -0,0 +1,130 @@
+# Changelog
+
+## Version 2.0.4 (2026-10-17)
+
+- Added support for Python 3.15
+- Processing and rendering large sets of data is now up to 2.4x faster
+    - Saving results no longer slows down as more data is added (plot formatting is now looked up directly instead of searching through every saved record)
+    - Plots with lots of lines now draw faster (lines are drawn together in one batch instead of one at a time)
+- The viewer can now be placed inside an existing FastAPI website (mount it at a path like `/viz` and show it in an `<iframe>`)
+    - Slow plots no longer freeze the rest of your site (the viewer's database work now runs on its own background thread)
+    - Optional settings to hide the database path and to let other sites use the viewer (`show_db_path`, `cors_origins`)
+    - Bad requests now get a clear error, and the viewer's memory use is capped
+- Pressing Ctrl+C in the viewer now stops it right away instead of hanging for a minute or more
+- Fixed console errors when switching plots or tables while one was still loading
+
+## Version 2.0.3 (2026-09-14)
+
+- Added a changelog
+- Patched dependency security vulnerabilities (`httpx2`, `httpcore2`, `tornado`)
+- Removed unused MkDocs-only doc dependencies now that the docs build on Zensical
+
+## Version 2.0.0 (2026-07-05)
+
+### Core
+
+- Now formally supporting Python 3.14
+- Versioning is now controlled by `hatchling-vcs` (when a new tag "vX.Y.Z" is pushed to main the test+publish CI/CD automatically fires)
+- Overhauled the pipeline for running and processing data products (now called records to reduce confusion)
+    - Records are stored in a SQLite database with concurrent write protection for multiprocessing
+        - Records are no longer serialized as JSON in the input directories
+        - Records are no longer sorted and duplicated into a `data_products` folder
+        - This change cut the storage required (and therefore runtime) more than in half
+    - SQLite database allows for better tag indexing and the reduced file size greatly improves runtime
+- Format2D now supports a new `renderer` with options currently `Raster` (for JPG (default), PNG, etc.) and `Vector` (SVG)
+- Logger has been completely redone to use `Rich` logs and a rolling file backup
+    - This includes a fix for concurrent logs being broken on Windows
+- The CLI was completely rewritten using `typer` to allow for better scalability
+
+### Asset Generator
+
+- Scatter2D was added as another option (Trace2D can also now optionally have no line style)
+- Histograms can now be plotted with Trace2D, Point2D, and Scatter2D (previously they could only have AxLine)
+- Table maker now uses `polars` instead of `pandas`
+- Overhauled the previous interactive dashboard tool to use the new DB and also rewrote it to work as a FastAPI app (removing `streamlit`)
+    - The new dashboard is much more performant, user friendly, and now also include table views for `TableEntry` records
+    - It also comes with light/dark/system theming and a proper toast/notification system
+
+### Misc.
+
+- Example data generator was updated to provide more "interesting" data (it is also now part of the `trendify` CLI namespace)
+- The documentation site was transitioned to Zensical and branding was updated across the package
+    - User guide was rewritten to summarize how to use `trendify` and now include examples of the assets it produces
+    - The README/index was updated to match one another
+    - This also updated the CI/CD
+- Pyright and Ruff are now part of the pre-commit to improve code quality
+- Improved `__init__.py` to match [PEP 8](https://peps.python.org/pep-0008/#imports)
+- Added a bunch of unit tests
+
+### Broke
+
+- Format2D is now its own tagged Record (no longer an attribute of Trace2D, Point2D, etc.)
+   - This also removed the slow, and seldom used, union step that would be performed on every Format2D for every run
+   - Breaking this greatly reduces the DB size, especially since it usually just stored redundant information
+- Trace2D.from_xy was removed since Point2D was removed from it (Trace2D now instantiated the same way as all other types)
+- Trace2D was optimized to remove the ability to set a different style for each Point2D (which actually was never even possible but this includes a schema change)
+- `trendify_make_sample_data` CLI exe moved to `trendify` (see Misc change)
+- Python 3.11 no longer supported due to old generic typing system
+
+## v1.2.11 (2025-09-23)
+
+- Added `figure_size` (width and height) support to `Format2D` (#30)
+
+## v1.2.7 (2025-09-23)
+
+- Fixed nested quotes breaking generated histogram files
+- Fixed the logo and favicon
+- Added `zorder` control for Plotly traces/markers/histograms and Matplotlib histograms/legends
+- Fixed log-scaled plots not displaying correctly in Plotly
+
+## v1.2.6 (2025-09-21)
+
+- Changed plot title behavior
+- Added a tooltip selector and improved tooltip button UX
+- Added opacity/alpha support for traces, markers, and Plotly histogram edges
+- Fixed tooltip text color not adapting to the line color, making it unreadable in some cases (#25)
+- Dashboard tag keys are now sorted for easier browsing
+
+## v1.2.5 (2025-09-21)
+
+- Now requires Python >= 3.11
+- Fixed dashboard pushbuttons using the full tag name instead of a shorter key (#17)
+- Fixed `trendify make dashboard` not treating the given path as a raw string (#18)
+- Fixed the table builder, which was broken (#19)
+
+## v1.2.0 (2025-09-18)
+
+- Added a Streamlit dashboard, reusing the existing `dashboard` CLI argument to launch it
+- Added pushbutton controls for selecting a chart within nested expanders
+- Fixed the documentation site build
+- Adjusted logging levels
+
+## v1.1.16 (2025-09-10)
+
+- Updated documentation and fixed an indexing bug
+
+## v1.1.15 (2025-09-10)
+
+- Data products now record their source file in metadata
+
+## v1.1.14 (2025-09-10)
+
+- Sorting now overwrites existing products for a given source directory instead of duplicating them
+
+## v1.1.6 (2025-08-02)
+
+- Added a `Legend` object for customizing legend location and styling
+- Added log-scale support for the x and y axes
+
+## v1.1.1 (2025-07-28)
+
+- Added configurable logging with multiple verbosity levels
+- Grid styling now uses the `Pen` object instead of one-off custom settings
+- Added a tuple option for line style
+- Added noise to the example data generator for more realistic sample output
+- `XYDataPlot` can now be plotted together with histograms
+- Fixed histogram bins with no values still showing their edges, making empty bins look populated
+- Improved the auto-dashboard tool, including working Plotly support
+- Added support for multiple tags, plus a product gallery view
+- Fixed mean and max being swapped in the stats table
+- Added the ability to specify the data products JSON filename

trendify2-2.0.4/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 TalbotKnighton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

trendify2-2.0.4/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.5
+Name: trendify2
+Version: 2.0.4
+Summary: Tools for generating data products, storing, and interacting with them
+Project-URL: Homepage, https://github.com/Hydrowelder/trendify
+Project-URL: Documentation, https://Hydrowelder.github.io/trendify/
+Project-URL: Repository, https://github.com/Hydrowelder/trendify
+Project-URL: Issues, https://github.com/Hydrowelder/trendify/issues
+Project-URL: PyPI, https://pypi.org/project/trendify2/
+Author-email: Talbot Knighton <talbotknighton@gmail.com>, David Gable <david@david-gable.com>
+Maintainer-email: Talbot Knighton <talbotknighton@gmail.com>, David Gable <david@david-gable.com>
+License: MIT
+License-File: LICENSE.txt
+Keywords: Dashboard,Data,Database,Matplotlib,Plotly,Plotting,Post,Process,Products,Trends,Visualization
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: fastapi>=0.134.0
+Requires-Dist: matplotlib>=3.11.0
+Requires-Dist: numpy>=2.4.1
+Requires-Dist: numpydantic>=1.7.0
+Requires-Dist: plotly>=6.8.0
+Requires-Dist: polars>=1.39.0
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: rich>=14.3.3
+Requires-Dist: typer>=0.24.1
+Requires-Dist: uvicorn>=0.41.0
+Description-Content-Type: text/markdown
+
+<p align="center">
+    <img alt="Trendify" src="https://raw.githubusercontent.com/Hydrowelder/trendify/refs/heads/main/docs/assets/read-me-banner.png" style="width: 100%">
+</p>
+
+# trendify: Efficient Plotting and Table Building
+
+<p align="center">
+  <a href="https://pypi.org/project/trendify2/" class="badge-link">
+    <img src="https://img.shields.io/pypi/v/trendify2.svg?cacheSeconds=300" alt="PyPI version">
+  </a>
+  <a href="https://pypi.org/project/trendify2/" class="badge-link">
+    <img src="https://img.shields.io/pypi/pyversions/trendify2.svg?cacheSeconds=86400" alt="Python versions">
+  </a>
+  <a href="https://github.com/Hydrowelder/trendify/actions/workflows/publish.yml" class="badge-link">
+    <img src="https://github.com/Hydrowelder/trendify/actions/workflows/publish.yml/badge.svg?branch=main" alt="Tests & Release Status">
+  </a>
+  <a href="https://github.com/Hydrowelder/trendify/actions/workflows/workflow.yml" class="badge-link">
+    <img src="https://raw.githubusercontent.com/Hydrowelder/trendify/refs/heads/main/docs/assets/coverage-badge.svg" alt="Coverage">
+  </a>
+  <a href="https://github.com/astral-sh/ruff" class="badge-link">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
+  </a>
+  <a href="https://docs.pydantic.dev/latest/" class="badge-link">
+    <img src="https://img.shields.io/badge/Pydantic-v2-FF43A1?logo=pydantic&logoColor=white" alt="Pydantic v2">
+  </a>
+  <a href="https://opensource.org/licenses/MIT" class="badge-link">
+    <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License">
+  </a>
+  <a href="https://Hydrowelder.github.io/trendify/" class="badge-link">
+    <img src="https://img.shields.io/badge/docs-GitHub_Pages-blue.svg" alt="Documentation">
+  </a>
+</p>
+
+---
+
+## Installation
+
+Install the package via your preferred manager:
+
+```bash linenums="0"
+uv add trendify2
+```
+
+or with `pip`:
+
+```bash linenums="0"
+pip install trendify2
+```
+
+---
+
+## Core Features
+
+- **Built to scale**: process thousands of runs without holding every run's data in memory at once. Throughput stays flat whether you have dozens of runs or tens of thousands.
+- **Typed records, no migrations**: points, traces, tables, and histograms are validated [Pydantic](https://docs.pydantic.dev/latest/) models. Add your own record types anytime without writing a schema migration.
+- **Parallelizable**: `trendify generate` can fan your processing function out across multiple CPU cores with `--n-procs`, with multiprocessing-safe logging that funnels every worker's output through a single queue.
+- **Static assets or a live dashboard**: render tagged data straight to Matplotlib images and CSV tables with `trendify render`, or launch an interactive FastAPI dashboard with `trendify viewer` to browse tags, tables, and interactive plots in the browser.
+
+---
+
+## Why use `trendify`?
+
+- **Scalable.** Throughput stays flat whether you're processing dozens of runs or tens of thousands.
+- **Memory efficient.** Each run is processed once and cached on disk, nothing needs to stay open or held in memory for the whole sweep. This is critical for processing large amounts of data with less memory than is available when batch processing.
+- **Flexible output.** Render static Matplotlib images and CSV tables for a report, or browse the same data interactively in a live dashboard.

trendify2-2.0.4/README.md

@@ -0,0 +1,65 @@
+<p align="center">
+    <img alt="Trendify" src="https://raw.githubusercontent.com/Hydrowelder/trendify/refs/heads/main/docs/assets/read-me-banner.png" style="width: 100%">
+</p>
+
+# trendify: Efficient Plotting and Table Building
+
+<p align="center">
+  <a href="https://pypi.org/project/trendify2/" class="badge-link">
+    <img src="https://img.shields.io/pypi/v/trendify2.svg?cacheSeconds=300" alt="PyPI version">
+  </a>
+  <a href="https://pypi.org/project/trendify2/" class="badge-link">
+    <img src="https://img.shields.io/pypi/pyversions/trendify2.svg?cacheSeconds=86400" alt="Python versions">
+  </a>
+  <a href="https://github.com/Hydrowelder/trendify/actions/workflows/publish.yml" class="badge-link">
+    <img src="https://github.com/Hydrowelder/trendify/actions/workflows/publish.yml/badge.svg?branch=main" alt="Tests & Release Status">
+  </a>
+  <a href="https://github.com/Hydrowelder/trendify/actions/workflows/workflow.yml" class="badge-link">
+    <img src="https://raw.githubusercontent.com/Hydrowelder/trendify/refs/heads/main/docs/assets/coverage-badge.svg" alt="Coverage">
+  </a>
+  <a href="https://github.com/astral-sh/ruff" class="badge-link">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
+  </a>
+  <a href="https://docs.pydantic.dev/latest/" class="badge-link">
+    <img src="https://img.shields.io/badge/Pydantic-v2-FF43A1?logo=pydantic&logoColor=white" alt="Pydantic v2">
+  </a>
+  <a href="https://opensource.org/licenses/MIT" class="badge-link">
+    <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License">
+  </a>
+  <a href="https://Hydrowelder.github.io/trendify/" class="badge-link">
+    <img src="https://img.shields.io/badge/docs-GitHub_Pages-blue.svg" alt="Documentation">
+  </a>
+</p>
+
+---
+
+## Installation
+
+Install the package via your preferred manager:
+
+```bash linenums="0"
+uv add trendify2
+```
+
+or with `pip`:
+
+```bash linenums="0"
+pip install trendify2
+```
+
+---
+
+## Core Features
+
+- **Built to scale**: process thousands of runs without holding every run's data in memory at once. Throughput stays flat whether you have dozens of runs or tens of thousands.
+- **Typed records, no migrations**: points, traces, tables, and histograms are validated [Pydantic](https://docs.pydantic.dev/latest/) models. Add your own record types anytime without writing a schema migration.
+- **Parallelizable**: `trendify generate` can fan your processing function out across multiple CPU cores with `--n-procs`, with multiprocessing-safe logging that funnels every worker's output through a single queue.
+- **Static assets or a live dashboard**: render tagged data straight to Matplotlib images and CSV tables with `trendify render`, or launch an interactive FastAPI dashboard with `trendify viewer` to browse tags, tables, and interactive plots in the browser.
+
+---
+
+## Why use `trendify`?
+
+- **Scalable.** Throughput stays flat whether you're processing dozens of runs or tens of thousands.
+- **Memory efficient.** Each run is processed once and cached on disk, nothing needs to stay open or held in memory for the whole sweep. This is critical for processing large amounts of data with less memory than is available when batch processing.
+- **Flexible output.** Render static Matplotlib images and CSV tables for a report, or browse the same data interactively in a live dashboard.