Merge latest skeleton

Signed-off-by: Philippe Ombredanne <pombredanne@nexb.com>

Author: pombredanne

.gitattributes

@@ -0,0 +1,3 @@
+# Ignore all Git auto CR/LF line endings conversions
+* -text
+pyproject.toml export-subst

.github/workflows/docs-ci.yml

@@ -0,0 +1,32 @@
+name: CI Documentation
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+
+    strategy:
+      max-parallel: 4
+      matrix:
+        python-version: [3.12]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Dependencies
+        run:  ./configure --dev
+
+      - name: Check documentation and HTML for errors and dead links
+        run: make docs-check
+
+      - name: Check documentation for style errors
+        run: make doc8
+
+

.github/workflows/pypi-release.yml

@@ -21,21 +21,24 @@ on:
 jobs:
   build-pypi-distribs:
     name: Build and publish library to PyPI
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
 
     steps:
-      - uses: actions/checkout@master
+      - uses: actions/checkout@v4
       - name: Set up Python
-        uses: actions/setup-python@v1
+        uses: actions/setup-python@v5
         with:
-          python-version: 3.9
+          python-version: 3.12
 
-      - name: Install pypa/build
-        run: python -m pip install build --user
+      - name: Install pypa/build and twine
+        run: python -m pip install --user build twine
 
       - name: Build a binary wheel and a source tarball
         run: python -m build --sdist --wheel --outdir dist/
 
+      - name: Validate wheel and sdis for Pypi
+        run: python -m twine check dist/*
+
       - name: Upload built archives
         uses: actions/upload-artifact@v4
         with:
@@ -47,7 +50,7 @@ jobs:
     name: Create GH release
     needs:
       - build-pypi-distribs
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
 
     steps:
       - name: Download built archives
@@ -57,7 +60,7 @@ jobs:
           path: dist
 
       - name: Create GH release
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         with:
           draft: true
           files: dist/*
@@ -67,7 +70,7 @@ jobs:
     name: Create PyPI release
     needs:
       - create-gh-release
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
 
     steps:
       - name: Download built archives
@@ -78,6 +81,6 @@ jobs:
 
       - name: Publish to PyPI
         if: startsWith(github.ref, 'refs/tags')
-        uses: pypa/gh-action-pypi-publish@master
+        uses: pypa/gh-action-pypi-publish@release/v1
         with:
           password: ${{ secrets.PYPI_API_TOKEN }}

.gitignore

@@ -1,50 +1,49 @@
-# Byte-compiled / optimized / DLL files
-__pycache__/
+# Python compiled files
 *.py[cod]
-*$py.class
 
-# C extensions
-*.so
-
-# Distribution / packaging
+# virtualenv and other misc bits
+/src/*.egg-info
+*.egg-info
+/dist
+/build
+/bin
+/lib
+/scripts
+/Scripts
+/Lib
+/pip-selfcheck.json
+/tmp
+/venv
 .Python
-build/
-develop-eggs/
-dist/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-
+/include
+/Include
+/local
+*/local/*
+/local/
+/share/
+/tcl/
+/.eggs/
 
 # Installer logs
 pip-log.txt
-pip-delete-this-directory.txt
-pip-selfcheck.json
 
 # Unit test / coverage reports
-htmlcov/
-.tox/
+.cache
 .coverage
 .coverage.*
-.cache
-coverage.xml
-*.cover
+nosetests.xml
+htmlcov
 
 # Translations
 *.mo
-*.pot
 
-# Django stuff:
-*.log
-local_settings.py
+# IDEs
+.project
+.pydevproject
+.idea
+org.eclipse.core.resources.prefs
+.vscode
+.vs
 
 # Sphinx
 docs/_build
@@ -55,51 +54,6 @@ docs/Lib
 doc/pyvenv.cfg
 pyvenv.cfg
 
-# PyBuilder
-target/
-
-# Jupyter Notebook
-.ipynb_checkpoints
-
-# pyenv and pip
-.python-version
-pyvenv.cfg
-bin/
-
-# Environments
-.env
-.venv
-env/
-venv/
-ENV/
-
-
-# mypy
-.mypy_cache/
-
-
-# Database
-*.sqlite3*
-
-# Staticfiles
-staticfiles/
-
-# virtualenv
-bin
-include
-lib64
-share
-Pipfile
-
-# editors
-.vscode
-# PyCharm
-.idea/
-
-# pytest
-.pytest_cache
-
-
 # Various junk and temp files
 .DS_Store
 *~
@@ -108,7 +62,6 @@ Pipfile
 .ve
 *.bak
 /.cache/
-/tmp/
 
 # pyenv
 /.python-version
@@ -119,3 +72,5 @@ tcl
 
 # Ignore Jupyter Notebook related temp files
 .ipynb_checkpoints/
+/.ruff_cache/
+/.env

.readthedocs.yml

@@ -26,4 +26,4 @@ python:
     - method: pip
       path: .
       extra_requirements:
-        - dev
+        - docs

AUTHORS.rst

@@ -1,17 +1,3 @@
 The following organizations or individuals have contributed to this repo:
 
-- nexB Inc. @nexB
-- Haiko Schol @haikoschol
-- Philippe Ombredanne @pombredanne
-- Kartik Sibal @kartiksibal
-- Shivam Sandbhor @sbs2001
-- Ranvir Singh @singh1114
-- Thomas Druez @tdruez
-- Ayush Lohani @lohani2280
-- Islam Elhakmi @EslamHiko
-- Edoardo Lanzini @elanzini
-- Navonil Das @NavonilDas
-- Tushar Upadhyay @tushar912
-- Hritik Vijay @hritik14
-- Tushar Goel @TG1999
-- Keshav Priyadarshi @keshav-space
+-