historia 0.5.8__tar.gz

historia-0.5.8/.github/.codecov.yml

@@ -0,0 +1,20 @@
+# Allowed placement and naming from https://docs.codecov.com/docs/codecov-yaml#can-i-name-the-file-codecovyml
+comment:
+  layout: "reach, diff, flags, files"
+  behavior: once
+  require_changes: true  # if true: only post the comment if coverage changes
+  require_base: no        # [yes :: must have a base report to post]
+  require_head: yes       # [yes :: must have a head report to post]
+
+codecov:
+  notify:
+    require_ci_to_pass: yes
+
+coverage:
+  status:
+    project: off
+    patch: off
+
+ignore:
+  - "./tests/"
+  - "./pyproject.toml"

historia-0.5.8/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,46 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others’ private information, such as a physical or electronic address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team. All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project’s leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

historia-0.5.8/.github/workflows/build_and_upload_docker_image_dev.yml

@@ -0,0 +1,47 @@
+name: Test dev container (and push on merge)
+
+on:
+  workflow_dispatch:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  build-test-push:
+    name: Build and test dev image
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Build image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: containers/Dockerfile.dev
+          load: true
+          push: false
+          tags: ghcr.io/codycbakerphd/historia:dev
+
+      - name: Login to GitHub Container Registry
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets._GITHUB_API_KEY }}
+
+      - name: Push to GHCR
+        if: github.event_name != 'pull_request'
+        run: docker push ghcr.io/codycbakerphd/historia:dev

historia-0.5.8/.github/workflows/build_and_upload_docker_image_latest.yml

@@ -0,0 +1,63 @@
+name: Build and upload latest release Docker image to GHCR
+
+on:
+  workflow_dispatch:
+  workflow_run:
+    workflows: [Release to PyPI]
+    types: [completed]
+
+jobs:
+  release-image:
+    name: Build and upload release image
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout release tag
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.release.tag_name }}
+
+      - name: Derive image tags
+        id: image_tags
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: |
+          version_tag="${RELEASE_TAG#v}"
+          echo "latest=ghcr.io/${GITHUB_REPOSITORY,,}:latest" >> "$GITHUB_OUTPUT"
+          echo "versioned=ghcr.io/${GITHUB_REPOSITORY,,}:${version_tag}" >> "$GITHUB_OUTPUT"
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets._GITHUB_API_KEY }}
+
+      - name: Build image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: containers/Dockerfile.latest
+          load: true
+          push: false
+          tags: ${{ steps.image_tags.outputs.latest }}
+
+      - name: Add version tag
+        run: docker tag "${{ steps.image_tags.outputs.latest }}" "${{ steps.image_tags.outputs.versioned }}"
+
+      - name: Smoke test image
+        run: docker run --rm "${{ steps.image_tags.outputs.latest }}"
+
+      - name: Push to GHCR
+        run: |
+          docker push "${{ steps.image_tags.outputs.latest }}"
+          docker push "${{ steps.image_tags.outputs.versioned }}"

historia-0.5.8/.github/workflows/daily_link_checker.yml

@@ -0,0 +1,44 @@
+name: Daily link checker
+
+on:
+  schedule:
+    - cron: "0 12 * * *"
+  workflow_dispatch:
+
+jobs:
+  LinkChecker:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check links
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: >
+            --verbose
+            --no-progress
+            '**/*.md'
+            '**/*.rst'
+            '**/*.py'
+          fail: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  NotifyOnFailure:
+    runs-on: ubuntu-latest
+    needs: [LinkChecker]
+    if: ${{ always() && needs.LinkChecker.result == 'failure' }}
+    steps:
+      - uses: dawidd6/action-send-mail@v3
+        with:
+          server_address: smtp.gmail.com
+          server_port: 465
+          username: ${{ secrets.MAIL_USERNAME }}
+          password: ${{ secrets.MAIL_PASSWORD }}
+          subject: "CI Failure: Historia Daily Link Checker"
+          to: cody.c.baker.phd@gmail.com
+          from: Historia
+          body: "The daily link checker workflow failed, please check status at https://github.com/CodyCBakerPhD/historia/actions/workflows/daily_link_checker.yml"

historia-0.5.8/.github/workflows/daily_tests.yml

@@ -0,0 +1,29 @@
+name: Daily tests
+
+on:
+  schedule:
+    - cron: "0 12 * * *"
+  workflow_dispatch:
+
+jobs:
+  DailyTests:
+    permissions:
+      contents: read
+    uses: ./.github/workflows/testing.yml
+    secrets: inherit
+
+  NotifyOnFailure:
+    runs-on: ubuntu-latest
+    needs: [DailyTests]
+    if: ${{ always() && needs.DailyTests.result == 'failure' }}
+    steps:
+      - uses: dawidd6/action-send-mail@v3
+        with:
+          server_address: smtp.gmail.com
+          server_port: 465
+          username: ${{ secrets.MAIL_USERNAME }}
+          password: ${{ secrets.MAIL_PASSWORD }}
+          subject: "CI Failure: Historia Daily Tests"
+          to: cody.c.baker.phd@gmail.com
+          from: Historia
+          body: "The daily test workflow failed, please check status at https://github.com/CodyCBakerPhD/historia/actions/workflows/daily_tests.yml"

historia-0.5.8/.github/workflows/release_pypi.yml

@@ -0,0 +1,33 @@
+name: Release to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  release:
+    types:
+      - published
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Build package
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

historia-0.5.8/.github/workflows/testing.yml

@@ -0,0 +1,36 @@
+name: Testing
+
+on:
+  pull_request:
+  workflow_call:
+
+env:
+  GITHUB_TOKEN: ${{ secrets._GITHUB_API_KEY }}
+
+jobs:
+  Testing:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.13
+
+      - name: Install
+        run: pip install -e . pytest-cov
+
+      - name: Run tests
+        run: pytest --cov=src/historia --cov-report=xml
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage.xml
+          fail_ci_if_error: true

historia-0.5.8/.gitignore

@@ -0,0 +1,9 @@
+*.idea
+/**/__pycache__/
+uv*
+.DS_Store
+*.DS_Store
+coverage.xml
+.coverage
+docs/_build/
+docs/api/generated/

historia-0.5.8/.pre-commit-config.yaml

@@ -0,0 +1,35 @@
+default_install_hook_types:
+  - pre-commit
+
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+    -   id: check-yaml
+    -   id: end-of-file-fixer
+    -   id: trailing-whitespace
+
+-   repo: https://github.com/psf/black
+    rev: 25.1.0
+    hooks:
+    -   id: black
+
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.13.0
+  hooks:
+  - id: ruff
+    args: [ --fix ]
+
+- repo: https://github.com/codespell-project/codespell
+  rev: v2.4.1
+  hooks:
+  - id: codespell
+    additional_dependencies:
+    - tomli
+
+- repo: https://github.com/pre-commit/mirrors-mypy
+  rev: v2.0.0
+  hooks:
+  - id: mypy
+    additional_dependencies:
+    - types-requests

historia-0.5.8/AGENTS.md

@@ -0,0 +1,16 @@
+# Agent instructions
+
+-   Always run `pre-commit` before committing and pushing changes
+-   To the best of your ability, ensure tests are passing
+-   Follow assertion style (actual on left, expected on right)
+-   Always mark AI-generated tests with `ai_generated` Pytest marker
+-   Attempt to utilize `pytest.mark.parametrize` wherever appropriate to reduce duplication in test cases
+-   Avoid importing private-marked API functions (those with leading underscores) and always favor importing what is publicly exposed through `__init__.py` files
+-   Always bump the version in `pyproject.toml` appropriately when any file under `src/` (except `tests/` or `docs/`), only once per pull request; do NOT bump the version for changes that are purely CI/workflow, documentation, or configuration (e.g. adding a GitHub Actions workflow, updating `AGENTS.md`, or editing `README.md` badges)
+-   Leave a short description of the change or addition in the top `## Upcoming` section of the `CHANGELOG.md` under the appropriate subsection (`### 🚀 Enhancement`, `### 🐛 Bug Fix`, `### 📝 Documentation`, `### 🔩 Dependency Updates`, or `### 🏠 Internal`); create the subsection if it does not yet exist; include the GitHub PR link at the end of each entry in the format `([#N](https://github.com/stamped-principles/stamped-checklist/pull/N))`- `### 🚀 Enhancement` — new features
+-   PR titles should be human-readable and in the past tense; they should NOT use conventional commit style
+-   Always add new imports to the top of the file rather than locally scoped inside a function; the only exception is if it is needed to avoid a circular dependency
+-   Never include code other than imports, `__all__`, simple import errors, or magic `__dir__` overrides in any `__init__.py` file
+-   For external dependencies, always avoid specific import style (e.g., using `import abc from xyz` keyword) in favor of the generic full import (e.g., `import xyz; xyz.abc`)
+-   For internal imports, always use the relative import style (e.g., `from .foo import bar`); when monkeypatching such imports in tests, target the importing module's binding, not the original definition module (e.g., `foo.baz`, instead of `foo._bar.baz`)
+-   Every commit you author MUST include a `Co-Authored-By` trailer identifying both your tool name + version and your underlying model + version. Format (replace all `<…>` placeholders with actual values): `Co-Authored-By: <Tool> <tool-version> / <Model> <model-version> <noreply@<vendor-domain>>

historia-0.5.8/CHANGELOG.md

@@ -0,0 +1,50 @@
+# Changelog
+
+## Upcoming
+
+### 🏠 Internal
+
+- Updated the PyPI release workflow to also trigger on `v*` tag pushes so PyPI uploads occur when a tag is cut, in addition to GitHub release publication. ([#57](https://github.com/CodyCBakerPhD/historia/pull/57))
+
+## v0.5.8
+
+### 📝 Documentation
+
+- Added tutorial to the docs showing step-by-step usage of the CLI and Python API for data collection, minification, project creation, population, date updates, and status transitions. ([#50](https://github.com/CodyCBakerPhD/historia/pull/50))
+- Added AI usage addendum to the developer guide covering commit co-authorship requirements when AI tools contribute to commits, and updated `AGENTS.md` with the co-authorship rule. ([#48](https://github.com/CodyCBakerPhD/historia/pull/48))
+- Added the Historia logo to the README and documentation landing page, and configured docs rendering so the landing-page logo remains non-clickable without the dark-mode background wrapper. ([#39](https://github.com/CodyCBakerPhD/historia/pull/39))
+- Added a centered README badge block for PyPI version, supported Python versions, CI workflows, coverage, and license status. ([#37](https://github.com/CodyCBakerPhD/historia/pull/37))
+- Added basic developer documentation page that embeds `AGENTS.md` content via MyST include directive. ([#44](https://github.com/CodyCBakerPhD/historia/pull/44))
+- Added Sphinx documentation scaffolding with the PyData theme, API autodocs, and Read the Docs configuration for hosted docs builds. ([#19](https://github.com/CodyCBakerPhD/historia/pull/19))
+- Added a GitHub icon link to the docs navbar for quick navigation back to the repository, and removed the "Show Source" page links that exposed raw HTML output. ([#42](https://github.com/CodyCBakerPhD/historia/pull/42))
+- Set Sphinx Python signature rendering options to use Black-style wrapping behavior in API docs output. ([#19](https://github.com/CodyCBakerPhD/historia/pull/19))
+
+### 🚀 Enhancement
+
+- Generalized project status transitions so `historia project transition` can move items from any source status to any destination status via `--status` and `--new`. ([#47](https://github.com/CodyCBakerPhD/historia/pull/47))
+- Simplified CLI option names to dash-free forms (for example `--url` and `--placeholder`) while preserving snake_case keyword routing in command handlers. ([#46](https://github.com/CodyCBakerPhD/historia/pull/46))
+- Added data-update routing at `historia data update github ...`, with GitHub-specific data APIs nested under `historia.data.github` (including `historia.data.github.update(...)`), and exposed `historia._cli.historia_data_update_cli` for plugin-oriented extension. ([#38](https://github.com/CodyCBakerPhD/historia/pull/38))
+- Removed REST request modes and related logic so data collection now consistently uses GitHub GraphQL APIs. ([#6](https://github.com/CodyCBakerPhD/historia/pull/6))
+- Reorganized the CLI into nested `data` and `project` command groups, including `historia project update dates`, so operations were grouped by type and better mirrored API structure. ([#12](https://github.com/CodyCBakerPhD/historia/pull/12))
+- Added mirrored API submodule groupings at `historia.data` and `historia.project` (including `historia.project.update`) to align import paths with the CLI domain structure. ([#12](https://github.com/CodyCBakerPhD/historia/pull/12))
+- Limited top-level `historia` exports to submodules (`historia.data`, `historia.project`) so package imports consistently follow domain-grouped API paths. ([#12](https://github.com/CodyCBakerPhD/historia/pull/12))
+- Renamed the root CLI function to `historia_cli` and exposed it for plugin integrations as both `historia._cli.historia_cli` and `historia.historia_cli`, while preserving private aliases. ([#12](https://github.com/CodyCBakerPhD/historia/pull/12))
+- Unpacked project date updates to `historia.project.update_project_item_dates` and removed the `historia.project.update` submodule layer entirely. ([#34](https://github.com/CodyCBakerPhD/historia/pull/34))
+
+### 🐛 Bug Fix
+
+- Fixed GraphQL rate-limit handling to return an empty result set without raising key errors, and updated tests to be deterministic/offline-compatible. ([#6](https://github.com/CodyCBakerPhD/historia/pull/6))
+- Fixed Sphinx API reference pages to render autodoc content for documented module members instead of appearing empty under the toctree. ([#19](https://github.com/CodyCBakerPhD/historia/pull/19))
+
+### 🏠 Internal
+
+- Expanded ruff lint rules to `select = ["ALL"]` and resolved all newly enabled violations, including adding request timeouts, fixing exception chaining, converting to absolute imports, and collapsing implicit string concatenations. ([#48](https://github.com/CodyCBakerPhD/historia/pull/48))
+- Added mypy via pre-commit mirror for static type checking, with all pre-existing type errors resolved. ([#45](https://github.com/CodyCBakerPhD/historia/pull/45))
+- Added a scheduled daily link checker workflow using `lycheeverse/lychee-action` that scans all Markdown, RST, and Python files for broken links, with a separate email notification track to distinguish failures from daily test failures. ([#51](https://github.com/CodyCBakerPhD/historia/pull/51))
+- Added GHCR Dockerfiles and GitHub Actions workflows to publish `dev` and release-tagged `latest` container images. ([#36](https://github.com/CodyCBakerPhD/historia/pull/36))
+- Added a GitHub Actions release workflow to automatically build and publish packages to PyPI when a release is published. ([#32](https://github.com/CodyCBakerPhD/historia/pull/32))
+- Enhanced CLI tests to cover all commands (`data minify`, `project populate`, `project transition`), failure/error paths, and subgroup help output, using parametrize for exception-type variants. ([#33](https://github.com/CodyCBakerPhD/historia/pull/33))
+- Rewrote repetitive API export tests to use pytest parametrization and reduce duplication. ([#17](https://github.com/CodyCBakerPhD/historia/pull/17))
+- Added Codecov integration to track test coverage on every pull request. ([#18](https://github.com/CodyCBakerPhD/historia/pull/18))
+- Added a scheduled daily testing workflow that reuses the shared testing workflow via `workflow_call` to avoid duplicate CI configuration. ([#29](https://github.com/CodyCBakerPhD/historia/pull/29))
+- Added email notification to the daily tests workflow to alert on failures via `dawidd6/action-send-mail`. ([#40](https://github.com/CodyCBakerPhD/historia/pull/40))

historia-0.5.8/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Historia
+
+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.

historia-0.5.8/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: historia
+Version: 0.5.8
+Summary: Collects GitHub activity for use in project dashboards.
+Author-email: Cody Baker <cody.c.baker.phd@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Historia
+        
+        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.
+License-File: LICENSE.txt
+Keywords: GitHub,data collection,project management,work history
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: Unix
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.10
+Requires-Dist: ipython
+Requires-Dist: pre-commit
+Requires-Dist: pytest
+Requires-Dist: requests
+Requires-Dist: rich-click
+Requires-Dist: tqdm
+Description-Content-Type: text/markdown
+
+# Historia
+
+<p align="center">
+  <img alt="Historia logo" src="https://raw.githubusercontent.com/CodyCBakerPhD/historia/main/docs/assets/historia-logo.png" width="320">
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/historia/"><img alt="PyPI latest release version" src="https://badge.fury.io/py/historia.svg"></a>
+  <a href="https://pypi.org/project/historia/"><img alt="Supported Python versions" src="https://img.shields.io/pypi/pyversions/historia.svg"></a>
+  <a href="https://codecov.io/gh/CodyCBakerPhD/historia"><img alt="codecov" src="https://codecov.io/gh/CodyCBakerPhD/historia/branch/main/graph/badge.svg"></a>
+</p>
+<p align="center">
+  <a href="https://github.com/CodyCBakerPhD/historia/actions/workflows/daily_tests.yml"><img alt="Daily tests" src="https://github.com/CodyCBakerPhD/historia/actions/workflows/daily_tests.yml/badge.svg"></a>
+  <a href="https://github.com/CodyCBakerPhD/historia/actions/workflows/daily_link_checker.yml"><img alt="Daily link checker" src="https://github.com/CodyCBakerPhD/historia/actions/workflows/daily_link_checker.yml/badge.svg"></a>
+  <a href="https://github.com/CodyCBakerPhD/historia/blob/main/LICENSE.txt"><img alt="License" src="https://img.shields.io/pypi/l/historia.svg"></a>
+</p>
+
+A command-line tool for backing up records of GitHub activity for use in creating dashboard reports of work history.
+
+For full documentation, visit [historia.readthedocs.io](https://historia.readthedocs.io).

historia-0.5.8/README.md

@@ -0,0 +1,20 @@
+# Historia
+
+<p align="center">
+  <img alt="Historia logo" src="https://raw.githubusercontent.com/CodyCBakerPhD/historia/main/docs/assets/historia-logo.png" width="320">
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/historia/"><img alt="PyPI latest release version" src="https://badge.fury.io/py/historia.svg"></a>
+  <a href="https://pypi.org/project/historia/"><img alt="Supported Python versions" src="https://img.shields.io/pypi/pyversions/historia.svg"></a>
+  <a href="https://codecov.io/gh/CodyCBakerPhD/historia"><img alt="codecov" src="https://codecov.io/gh/CodyCBakerPhD/historia/branch/main/graph/badge.svg"></a>
+</p>
+<p align="center">
+  <a href="https://github.com/CodyCBakerPhD/historia/actions/workflows/daily_tests.yml"><img alt="Daily tests" src="https://github.com/CodyCBakerPhD/historia/actions/workflows/daily_tests.yml/badge.svg"></a>
+  <a href="https://github.com/CodyCBakerPhD/historia/actions/workflows/daily_link_checker.yml"><img alt="Daily link checker" src="https://github.com/CodyCBakerPhD/historia/actions/workflows/daily_link_checker.yml/badge.svg"></a>
+  <a href="https://github.com/CodyCBakerPhD/historia/blob/main/LICENSE.txt"><img alt="License" src="https://img.shields.io/pypi/l/historia.svg"></a>
+</p>
+
+A command-line tool for backing up records of GitHub activity for use in creating dashboard reports of work history.
+
+For full documentation, visit [historia.readthedocs.io](https://historia.readthedocs.io).

historia-0.5.8/containers/Dockerfile.dev

@@ -0,0 +1,10 @@
+FROM python:3.13-slim
+
+LABEL org.opencontainers.image.source="https://github.com/CodyCBakerPhD/historia"
+LABEL org.opencontainers.image.description="A Docker image of the latest development version of Historia."
+
+ADD ./ historia
+RUN cd historia && python -m pip install --no-cache-dir .
+
+ENTRYPOINT ["historia"]
+CMD ["--help"]

historia-0.5.8/containers/Dockerfile.latest

@@ -0,0 +1,9 @@
+FROM python:3.13-slim
+
+LABEL org.opencontainers.image.source="https://github.com/CodyCBakerPhD/historia"
+LABEL org.opencontainers.image.description="A Docker image of the latest released version of Historia."
+
+RUN pip install --no-cache-dir nwb2bids
+
+ENTRYPOINT ["historia"]
+CMD ["--help"]

historia-0.5.8/docs/.readthedocs.yaml

@@ -0,0 +1,14 @@
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.13"
+  jobs:
+    install:
+      - pip install --upgrade pip
+      - pip install . --group docs
+
+sphinx:
+   configuration: docs/conf.py
+   fail_on_warning: true

historia-0.5.8/docs/README.md

@@ -0,0 +1,17 @@
+Project documentation is built with [Sphinx](https://www.sphinx-doc.org/) using the [PyData Sphinx Theme](https://pydata-sphinx-theme.readthedocs.io/).
+
+### Building Locally
+
+Install the docs dependencies:
+
+```bash
+pip install -e . --group docs
+```
+
+Build the HTML output:
+
+```bash
+python -m sphinx -b html docs docs/_build/html
+```
+
+Open `docs/_build/html/index.html` in your browser to preview the result.

historia-0.5.8/docs/_static/custom.css

@@ -0,0 +1,20 @@
+/* Make sphinx-tabs follow the pydata-sphinx-theme background
+   in both light and dark mode, instead of using prefers-color-scheme. */
+.sphinx-tabs-panel,
+.sphinx-tabs-tab {
+    background-color: var(--pst-color-background) !important;
+    color: var(--pst-color-text-base) !important;
+}
+
+.sphinx-tabs-tab[aria-selected="true"] {
+    background-color: var(--pst-color-on-background) !important;
+    border-bottom-color: var(--pst-color-on-background) !important;
+}
+
+.sphinx-tabs-panel {
+    border-color: var(--pst-color-border) !important;
+}
+
+.sphinx-tabs-tab {
+    border-color: var(--pst-color-border) !important;
+}

historia-0.5.8/docs/api/index.rst

@@ -0,0 +1,8 @@
+API reference
+=============
+
+.. autosummary::
+   :toctree: generated
+
+   historia.data
+   historia.project