Update CONTRIBUTING.md

Updated agents policy

.github/workflows/python-package.yml

@@ -19,9 +19,9 @@ jobs:
         python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
-    - uses: actions/checkout@v2.5.0
+    - uses: actions/checkout@v6.0.2
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4.3.0
+      uses: actions/setup-python@v6.2.0
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies
@@ -30,7 +30,7 @@ jobs:
         python -m pip install --group dev
         python -m pip install .
     - name: Setup FFmpeg
-      uses: FedericoCarboni/setup-ffmpeg@v2
+      uses: federicocarboni/setup-ffmpeg@v3.1
     - name: Test with pytest
       run: |
         pytest

.github/workflows/pythonpublish.yml

@@ -16,21 +16,25 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install setuptools build wheel twine lxml
+    - name: Setup uv and Handle Its Cache
+      # You may pin to the exact commit or the version.
+      # uses: hynek/setup-cached-uv@757bedc3f972eb7227a1aa657651f15a8527c817
+      uses: hynek/setup-cached-uv@v2.3.0          
     - name: Build 
-        python -m build .
+      run: |
+        uv build --wheel
     - name: Publish to Pypi
-      uses: pypa/gh-action-pypi-publish@v1.12.2
+      uses: pypa/gh-action-pypi-publish@v1.13.0
       with:
         password: ${{ secrets.PYPI_APIKEY }}
-    - name: Send Bluesky Post
+    # - name: Send Bluesky Post
-      uses: myConsciousness/bluesky-post@v5
+    #   uses: myConsciousness/bluesky-post@v5
-      with:
+    #   with:
-        text: |
+    #     text: |
-          I've released a new version of wavinfo, my module for 
+    #       I've released a new version of wavinfo, my module for 
-          reading WAVE metadata.
+    #       reading WAVE metadata.
-        link-preview-url: ${{ github.server_url }}/${{ github.repository }}
+    #     link-preview-url: ${{ github.server_url }}/${{ github.repository }}
-        identifier: ${{ secrets.BLUESKY_APP_USER }}  
+    #     identifier: ${{ secrets.BLUESKY_APP_USER }}  
-        password: ${{ secrets.BLUESKY_APP_PASSWORD }}
+    #     password: ${{ secrets.BLUESKY_APP_PASSWORD }}
-        service: bsky.social    
+    #     service: bsky.social    
-        retry-count: 1
+    #     retry-count: 1

.readthedocs.yaml

@@ -7,13 +7,13 @@ version: 2
 
 # Set the version of Python and other tools you might need
 build:
-  os: ubuntu-20.04
+  os: ubuntu-lts-latest
   tools:
-    python: "3.10"
+    python: "3.13"
-    # You can also specify other tool versions:
+  jobs:
-    # nodejs: "16"
+    install: 
-    # rust: "1.55"
+      - pip install --upgrade pip
-    # golang: "1.17"
+      - pip install --group 'doc'
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
@@ -28,5 +28,3 @@ python:
   install:
     - method: pip
       path: .
-      extra_requirements:
-        - doc

CONTRIBUTING.md

@@ -12,4 +12,36 @@ If you discover a bug or would like better support for a feature, please do the
    If you're facile with Python and understand what you'd like to fix, submit a PR and I'll 
    review it as soon as I can. There's a `.devcontainer` available so you can creates commits 
    on this project in a GitHub codespace.
-   
+
+
+## Regarding use of Agents
+
+`wavinfo` is an open-source project that is offered free for no commerical gain, and 
+is developed and maintained for educational and creative reasons.
+
+If you use an agent or LLM to produce code for it you are missing out on the benefits 
+of contributing to an open-source project, particularly community, collaboration with 
+other developers and designers, and being able to learn and experiment without the 
+burden of deadlines or worrying about business cases or profits.
+
+This project is supposed to be fun, do not let machines have fun for you.
+
+We can't prevent you from using LLMs to contribute to this project but we ask you 
+abide by the following eitiquette when doing so:
+
+* All communication with the maintainers must be written by a human in their own
+  voice. Never use an LLM to craft thread comments, discussion posts, issues, emails
+  or other correspondence with other developers or the maintainers. 
+* PRs must be submitted by a person. Do not allow an agent to submit its own PRs to
+  this project.
+* Especially if you are a new contributor to this project, please submit only one PR
+  at a time and please restrict the subject matter of the PR to a specific unit,
+  module or tool. All submissions have to be reviewed and understood by the
+  maintainers before they can be merged.
+
+Obviously we can't verify if you follow all of these rules but certain telltale 
+traits of LLM-predicted text or code will raise a flag: lack of brevity in 
+descriptions or code comments, large amounts of text describing your process or 
+steps that add little to understanding the changes you've made, use of an 
+obsequious tone or being excessively accomodating, immediately doing requests 
+without further discussion or clarifications.

docs/source/conf.py

@@ -12,25 +12,24 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
-import importlib
+# import importlib
 import os
 import sys
-sys.path.insert(0, os.path.abspath('../..'))
+sys.path.insert(0, os.path.abspath('../../src'))
-sys.path.insert(0, os.path.abspath("../../.."))
+sys.path.insert(0, os.path.abspath("../../../src"))
 print(sys.path)
 
-import importlib
-
 # -- Project information -----------------------------------------------------
 
 project = u'wavinfo'
-copyright = u'2018-2024, Jamie Hardt'
+copyright = u'2018-2025, Jamie Hardt'
 author = u'Jamie Hardt'
 
 # The short X.Y version
-version = "3.1"
+version = "4.0"
 # The full version, including alpha/beta/rc tags
-release = importlib.metadata.version("wavinfo")
+release = "4.0.0"
+# release = importlib.metadata.version("wavinfo")
 
 
 # -- General configuration ---------------------------------------------------

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "wavinfo"
-version = "3.1.1"
+version = "4.0.0"
 description = "Probe WAVE files for all metadata"
 authors = [{ name = "Jamie Hardt", email = "jamiehardt@me.com"}]
 license = "MIT"