.github/dependabot.yml

@@ -0,0 +1,13 @@
+# Keep GitHub Actions up to date with GitHub's Dependabot...
+# https://docs.github.com/en/code-security/dependabot/working-with-dependabot/keeping-your-actions-up-to-date-with-dependabot
+# https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file#package-ecosystem
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    groups:
+      github-actions:
+        patterns:
+          - "*"  # Group all Actions updates into a single larger pull request
+    schedule:
+      interval: weekly

.github/workflows/lint_python.yml

@@ -0,0 +1,18 @@
+name: lint_python
+on: [pull_request, push]
+jobs:
+  lint_python:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          cache: pip
+          python-version: 3.x
+      - run: pip install --upgrade pip setuptools wheel
+      - run: pip install .[all]
+      - run: black --check --skip-string-normalization . || true
+      - run: ruff check --output-format=github  # See pyproject.toml for configuration
+      - run: pip install -r pex-requirements.txt -r tests/requirements.txt
+      - run: mypy .  # See setup.cfg for configuration
+      - run: safety check || true  # Temporary fix for https://pyup.io/v/51457/f17

.github/workflows/pre-commit.yml

@@ -0,0 +1,20 @@
+# https://pre-commit.com
+# This GitHub Action assumes that the repo contains a valid .pre-commit-config.yaml file.
+name: pre-commit
+on:
+  pull_request:
+  push:
+    branches: [master]
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+          cache: pip
+      - run: pip install pre-commit
+      - run: pre-commit --version
+      - run: pre-commit install
+      - run: pre-commit run --all-files

.github/workflows/test_install.yml

@@ -0,0 +1,16 @@
+name: test_install
+on:
+  pull_request:
+  push:
+    branches: [master]
+jobs:
+  install_internetarchive:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        setuptools-version: ["45.2.0", "58.1.0", "62.4.0"]
+    steps:
+      - uses: actions/checkout@v4
+      - run: pip install setuptools=="${{ matrix.setuptools-version }}"
+      - run: pip install .

.github/workflows/tox.yml

@@ -0,0 +1,18 @@
+name: tox
+on: [push, pull_request]
+jobs:
+  tox:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      max-parallel: 1  # Avoid timeout errors
+      matrix:
+        python: ['3.9', '3.10', '3.11', '3.12', '3.13', 'pypy-3.10']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+          cache: pip
+      - run: pip install tox
+      - run: tox -e py

.gitignore

@@ -1,28 +1,32 @@
+.cache
 .coverage
-*.pyc
-build
-dist
-*.egg-info
-stairs
-itemlist.txt
+.DS_Store
+.envrc
+.idea
+.pytest_cache/
+.python-version
 .tox
-TAGS
+.vagrant
+.venv*
+.vscode
 *.csv
-htmlcov
+*.egg-info
 *.log
 *.pex
-pex/
-wheelhouse
+*.pyc
 *gz
-.venv*
-.cache
-.vagrant
-.idea
-v2/
-v3.6/
-v3.7/
-.pytest_cache/
-.python-version
+build
+dist
+htmlcov
+itemlist.txt
+pex/
+stairs
+TAGS
 trash/
-.vscode
+v3.10/
+v3.7/
 v3.8/
+v3.9/
+wheelhouse
+ia.dist/
+ia.bin

.pre-commit-config.yaml

@@ -0,0 +1,59 @@
+# To enable these pre-commit hook run:
+# `python3 -m pip install pre-commit` or `brew install pre-commit`
+# Then in the project root directory run `pre-commit install`
+# Learn more about this config here: https://pre-commit.com/
+
+# default_language_version:
+#   python: python3.10
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-builtin-literals
+      - id: check-executables-have-shebangs
+      - id: check-shebang-scripts-are-executable
+      - id: check-yaml
+      - id: detect-private-key
+      - id: end-of-file-fixer
+      - id: mixed-line-ending
+      - id: requirements-txt-fixer
+      - id: trailing-whitespace
+
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: v0.8.5
+
+    hooks:
+      - id: ruff
+        # args: [ --fix, --exit-non-zero-on-fix ]
+
+  - repo: https://github.com/psf/black
+    rev: 24.10.0
+    hooks:
+      - id: black
+        language_version: python3
+        args:
+          - --diff
+          - --skip-string-normalization
+
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.3.0
+    hooks:
+      - id: codespell  # See setup.cfg for args
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.14.1
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - tqdm-stubs
+          - types-jsonpatch
+          - types-requests
+          - types-setuptools
+          - types-ujson
+          - types-urllib3
+
+  - repo: https://github.com/asottile/setup-cfg-fmt
+    rev: v2.7.0
+    hooks:
+      - id: setup-cfg-fmt

AUTHORS.rst

@@ -13,6 +13,7 @@ Contributors
 
 - Bryce Drennan <internetarchive@brycedrennan.com>
 - Max Zettlmeißl <max@zettlmeissl.de>
+- Ian Tait <thetaiter@gmail.com>
 
 Patches and Suggestions
 -----------------------

CONTRIBUTING.rst

@@ -25,7 +25,7 @@ All pull requests and patches are welcome, but please consider the following:
 - Include tests.
 - Include documentation for new features.
 - If your patch is supposed to fix a bug, please describe in as much detail as possible the circumstances in which the bug happens.
-- Please follow `PEP8 <http://legacy.python.org/dev/peps/pep-0008/>`_, with the exception of what is ignored in `setup.cfg <https://github.com/jjjake/internetarchive/blob/master/setup.cfg>`_. PEP8 compliancy is checked when tests run. Tests will fail if your patch is not PEP8 compliant.
+- Please follow `PEP8 <http://legacy.python.org/dev/peps/pep-0008/>`_, with the exception of what is ignored in `setup.cfg <https://github.com/jjjake/internetarchive/blob/master/setup.cfg>`_. PEP8 compliance is checked when tests run. Tests will fail if your patch is not PEP8 compliant.
 - Add yourself to AUTHORS.rst.
 - Avoid introducing new dependencies.
 - Open an issue if a relevant one is not already open, so others have visibility into what you're working on and efforts aren't duplicated.
@@ -37,7 +37,7 @@ Running Tests
 The minimal requirements for running tests are ``pytest``, ``pytest-pep8`` and ``responses``:
 
 .. code:: bash
-    
+
     $ pip install pytest pytest-pep8 responses
 
 Clone the `internetarchive lib <https://github.com/jjjake/internetarchive>`_:
@@ -68,4 +68,4 @@ To test against all supported Python versions, first make sure you have all of t
     $ pip install tox
     $ tox
 
-Even easier is simply creating a pull request. `Travis <https://travis-ci.com/>`_ is used for continuous integration, and is set up to run the full testsuite whenever a pull request is submitted or updated.
+Even easier is simply creating a pull request. `GitHub Actions <https://docs.github.com/en/actions>`_ are used for continuous integration, and are set up to run the full testsuite whenever a pull request is submitted or updated.