Updating from head Repo

.flake8

@@ -0,0 +1,10 @@
+[flake8]
+select = B,B9,C,D,DAR,E,F,N,RST,S,W
+ignore = E203,E501,RST201,RST203,RST301,W503,D205,D415,S101,RST304
+max-line-length = 100
+max-complexity = 10
+docstring-convention = google
+per-file-ignores = tests/*:S101,F401,F811
+rst-roles = class,const,func,meth,mod,ref
+rst-directives = deprecated
+# exclude = tests/*

.gitattributes

@@ -0,0 +1 @@
+lib/*.so filter=lfs diff=lfs merge=lfs -text

.github/ISSUE_TEMPLATE/bug-report---feature-request.md

@@ -0,0 +1,35 @@
+---
+name: Bug Report / Feature Request
+about: Bug Report / Feature Request
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+# Bug Report
+
+**IMPORTANT**  
+If your bug involves a specific DSS file, please ZIP it and attach the ZIP archive to your issue.
+
+## Description
+A clear and concise description of what the bug is.
+
+## Steps to Reproduce
+1. **Environment**  
+   - Python version: e.g. `3.9.12`  
+   - Package version: e.g. `hecdss==0.1.10`  
+   - Operating System: e.g. Windows 10, macOS 12  
+2. **Script**  
+   ```python
+   from hecdss import HecDss
+
+   with HecDss.open("file") as dss:
+        ts=dss.get("path")
+3.**DSS file**
+Attach DSS file.
+
+Note: GitHub strips large binaries, so always ZIP before attaching.
+
+Additional Context
+Add any other context about the problem here (logs, screenshots, etc.).

.github/workflows/publish-to-test-pypi.yml

@@ -0,0 +1,212 @@
+name: Deployment
+
+# The deployment workflow should only run when changes are merged into the `main` branch.
+# Since a branch protection rule prevents directly pushing to `main` this workflow will
+# only run on a successful merge request.
+on:
+  push:
+    branches:
+      - main
+
+  # Allow the workflow to be manually triggered from the Actions tab.
+  workflow_dispatch:
+
+jobs:
+  # Build and test the distribution before deploying to the various platforms. This allows
+  # us to store the build artifacts and reuse them in the deployment jobs below.
+  build:
+    name: Build Distribution
+    runs-on: ubuntu-latest
+
+    needs: [testing]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set Up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+#      - name: Install Poetry
+#        uses: abatilo/actions-poetry@v3
+#
+#      - name: Cache Virtual Environment
+#        uses: actions/cache@v4
+#        with:
+#          path: ./.venv
+#          key: venv-${{ hashFiles('poetry.lock') }}
+#
+#      - name: Install Dependencies
+#        run: poetry install
+
+      # The tests should have already been run in the testing workflow, but we run them
+      # again here to make sure that we do not deploy a broken distribution.
+#      - name: Run Tests
+#        run: poetry run pytest tests/
+
+      # Once the tests have passsed we can build the distribution and store it, so it can
+      # be accessed in the jobs below.
+#      - name: Build Distribution
+#        run: poetry build
+#
+#      - name: Store Distribution
+#        uses: actions/upload-artifact@v4
+#        with:
+#          name: package-dist
+#          path: dist/
+      - name: Install requests
+        run: pip install requests
+
+      - name: add dll
+        run: python3 src/hecdss/download_hecdss.py
+
+      - name: Install pypa/build
+        run: >-
+          python3 -m
+          pip install
+          build
+          --user
+      - name: Build a binary wheel and a source tarball
+        run: python3 -m build
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: package-dist
+          path: dist/
+
+  testing:
+    name: testing HECDSS functions
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install requests
+        run: pip install requests
+
+      - name: add dll
+        run: python3 src/hecdss/download_hecdss.py
+
+      - name: Install Packages
+        run: pip install pytest
+
+      - name: Install numpy
+        run: pip install numpy
+
+      - name: Install tzdata (Python)
+        run: pip install tzdata
+
+      - name: Run tests
+        run: pytest tests/
+
+  # The development distribution is a snapshot of the package and is deployed each time
+  # changes are merged into the main branch.
+  deploy-dev:
+    name: Publish Development Distribution
+    runs-on: ubuntu-latest
+
+    # The distribution will only be published if the tests have passed.
+    needs:
+      - build
+      - testing
+
+    # Set up the environment for trusted publishing on PyPI.
+    environment:
+      name: development
+      url: https://test.pypi.org/p/hecdss
+
+    permissions:
+      id-token: write # IMPORTANT: mandatory for trusted publishing
+
+    steps:
+      - name: Download Distribution
+        uses: actions/download-artifact@v4
+        with:
+          name: package-dist
+          path: dist/
+
+      - name: Publish Distribution To Test PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  # The release distribution is published whenever a tagged branch is merged into the main
+  # branch.
+  deploy-release:
+    name: Publish Release Distribution
+    runs-on: ubuntu-latest
+
+    # Require a tag push to publish a release distribution.
+#    if: >
+#      startsWith(github.ref, 'refs/tags/')
+#      || (github.event_name == 'workflow_dispatch' && github.event.inputs.tag_name != '')
+
+    # The distribution will only be published if the tests have passed.
+    needs:
+      - build
+      - testing
+
+    # Set up the environment for trusted publishing on PyPI.
+    environment:
+      name: release
+      url: https://pypi.org/p/hecdss
+
+    permissions:
+      id-token: write # IMPORTANT: mandatory for trusted publishing
+
+    steps:
+      - name: Download Distribution
+        uses: actions/download-artifact@v4
+        with:
+          name: package-dist
+          path: dist/
+
+      - name: Publish Distribution To PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  # Upload a GitHub release whenever a release distribution is published.
+  github-release:
+    name: Create Signed GitHub Release
+    runs-on: ubuntu-latest
+
+    # GitHub releases are only uploaded for release (tagged) distributions.
+    needs:
+      - deploy-release
+      - build
+
+    permissions:
+      contents: write # IMPORTANT: mandatory for making GitHub Releases
+      id-token: write # IMPORTANT: mandatory for sigstore
+
+    steps:
+      - name: Download Distribution
+        uses: actions/download-artifact@v4
+        with:
+          name: package-dist
+          path: dist/
+
+      - name: Sign Distribution
+        uses: sigstore/[email protected]
+        with:
+          inputs: |
+            ./dist/*.tar.gz
+            ./dist/*.whl
+
+      - name: Create GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        run: |
+          gh release create '${{ github.ref_name }}' \
+            --repo '${{ github.repository }}' \
+            --notes ""
+
+      - name: Upload GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        run: |-
+          gh release upload '${{ github.ref_name }}' dist/** \
+            --repo '${{ github.repository }}'

.github/workflows/test.yml

@@ -0,0 +1,43 @@
+name: Test
+
+on:
+  pull_request:
+    types: [opened, edited, synchronize]
+
+  # Allow the workflow to be manually triggered from the Actions tab.
+  workflow_dispatch:
+
+jobs:
+  testing:
+    name: testing HECDSS functions
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    steps:
+      - name: Set Up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      # On all platforms install the PyPI tzdata distribution
+      # (stdlib zoneinfo will auto‐pick it up; the backport will too)
+      - name: Install tzdata (Python)
+        run: pip install tzdata
+
+      - name: Install runtime dependencies
+        run: |
+          pip install requests
+          pip install numpy
+          pip install pytest
+
+      - name: add dll
+        run: python3 src/hecdss/download_hecdss.py
+
+      - name: Run tests
+        run: pytest tests
+

.github/workflows/update-version.yml

@@ -0,0 +1,45 @@
+name: update-version
+
+# The deployment workflow should only run when changes are merged into the `main` branch.
+# Since a branch protection rule prevents directly pushing to `main` this workflow will
+# only run on a successful merge request.
+on:
+  # Allow the workflow to be manually triggered from the Actions tab.
+  workflow_dispatch:
+    inputs:
+      tag_name:
+        description: 'If you want to update the version and release, type an existing or new version tag (eg. 1.2.0)'
+        required: false
+        default: ''
+
+jobs:
+
+  update-version:
+    name: Update Version
+    runs-on: ubuntu-latest
+    if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.tag_name != '' }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Update version in pyproject.toml
+        run: |
+          sed -i "s/^version = .*/version = \"${{ github.event.inputs.tag_name }}\"/" pyproject.toml
+
+      - name: Update version in setup.cfg
+        run: |
+          sed -i "s/^version = .*/version = ${{ github.event.inputs.tag_name }}/" setup.cfg
+
+      - name: Commit and push version update
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add pyproject.toml setup.cfg
+          git commit -m "chore: update version to ${{ github.event.inputs.tag_name }}"
+          git push
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1 +1,16 @@
-__pycache__/**
+.mypy_cache/
+# /.coverage
+# /.coverage.*
+# /.nox/
+/.python-version
+/.pytype/
+/dist/
+# /docs/_build/
+/src/*.egg-info/
+__pycache__/
+.vscode
+tests/data/**/tmp/*
+hecdss.dll
+libhecdss.so
+.idea
+.ipynb_checkpoints

INTENT.md

@@ -0,0 +1,9 @@
+
+
+Licensing Intent
+
+The intent is that this software and documentation ("Project") should be treated as if it is licensed under the license associated with the Project ("License") in the LICENSE.md file. However, because we are part of the United States (U.S.) Federal Government, it is not that simple.
+
+The portions of this Project written by United States (U.S.) Federal government employees within the scope of their federal employment are ineligible for copyright protection in the U.S.; this is generally understood to mean that these portions of the Project are placed in the public domain.
+
+In countries where copyright protection is available (which does not include the U.S.), contributions made by U.S. Federal government employees are released under the License. Merged contributions from private contributors are released under the License

MANIFEST.in

@@ -0,0 +1 @@
+recursive-include src *