Add support for the Tags New API endpoint (#20)

* Update pre-commit hooks

* Add the Tags New API endpoint, examples, update metrics handler; fix metrics & logs docstrings

* Rename a file

* Set line-length=100 as a pragmatic value across configs

* Improve pre-commit hooks, apply linters

* Apply linters

* Add a warning message about deprecation of Tags API in favor of Tags New

* Add class TagsNewTests, use ordering for some tests, remane some test classes

* Remove debugging stuff

* Add new Tags examples to README.md

* Improve TagsNewTests docstrings

* Fix checking multiple keys

* Add Python 3.14 support

* Fix dev environment yaml for py314

* Disable py314 in CI

* Fix markdown table

* Update the changelog

* Fix indentation

* Add a comment about running update and delete account tag tests

Author: skupriienko

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -37,6 +37,7 @@ body:
         - '3.11'
         - '3.12'
         - '3.13'
+        - '3.14'
     validations:
       required: true
   - type: textarea

.github/workflows/commit_checks.yaml

@@ -30,6 +30,7 @@ jobs:
       fail-fast: false
       matrix:
         os: ["ubuntu-latest", "macos-latest", "windows-latest"]
+        # TODO: Enable Python 3.14 when conda and conda-build will have py314 support.
         python-version: ["3.10", "3.11", "3.12", "3.13"]
     env:
       APIKEY: ${{ secrets.APIKEY }}

.github/workflows/publish.yml

@@ -24,7 +24,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: '3.12'
+          python-version: '3.13'
 
       - name: Install build tools
         run: pip install --upgrade build setuptools wheel setuptools-scm twine

.pre-commit-config.yaml

@@ -58,6 +58,11 @@ repos:
     hooks:
       - id: gitlint
 
+  - repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+      - id: detect-secrets  # Detect accidentally committed secrets
+
   - repo: https://github.com/codespell-project/codespell
     rev: v2.4.1
     hooks:
@@ -66,15 +71,10 @@ repos:
         exclude: ^tests
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.34.0
+    rev: 0.34.1
     hooks:
       - id: check-github-workflows
-
-#  - repo: https://github.com/pre-commit/mirrors-autopep8
-#    rev: v2.0.4
-#    hooks:
-#      - id: autopep8
-#        exclude: ^docs/
+        files: ^\.github/workflows/.*\.ya?ml$
 
   - repo: https://github.com/akaihola/darker
     rev: v3.0.0
@@ -104,21 +104,21 @@ repos:
         exclude: ^tests
 
   - repo: https://github.com/PyCQA/pylint
-    rev: v3.3.8
+    rev: v4.0.2
     hooks:
       - id: pylint
         args:
           - --exit-zero
 
   - repo: https://github.com/asottile/pyupgrade
-    rev: v3.20.0
+    rev: v3.21.0
     hooks:
       - id: pyupgrade
         args: [--py310-plus, --keep-runtime-typing]
 
   - repo: https://github.com/charliermarsh/ruff-pre-commit
     # Ruff version.
-    rev: v0.13.1
+    rev: v0.14.2
     hooks:
       # Run the linter.
       - id: ruff
@@ -148,7 +148,7 @@ repos:
         exclude: ^mailgun/examples/
 
   - repo: https://github.com/RobertCraigie/pyright-python
-    rev: v1.1.405
+    rev: v1.1.407
     hooks:
     - id: pyright
 
@@ -162,12 +162,12 @@ repos:
         additional_dependencies: [".[toml]"]
 
   - repo: https://github.com/crate-ci/typos
-    rev: v1.36.2
+    rev: v1.38.1
     hooks:
       - id: typos
 
   - repo: https://github.com/executablebooks/mdformat
-    rev: 0.7.22
+    rev: 1.0.0
     hooks:
       - id: mdformat
         additional_dependencies:

CHANGELOG.md

@@ -4,6 +4,36 @@ We [keep a changelog.](http://keepachangelog.com/)
 
 ## [Unreleased]
 
+## [1.3.0] - 2025-11-08
+
+### Added
+
+- Add the `Tags New` endpoint:
+  - Add `tags` to the `analytics` key of special cases in the class `Endpoint`.
+  - Add `mailgun/examples/tags_new_examples.py` with `post_analytics_tags()`, `update_analytics_tags()`, `delete_analytics_tags()`, `get_account_analytics_tag_limit_information()`.
+  - Add `Tags New` sections with examples to `README.md`.
+  - Add class `TagsNewTests` to tests/tests.py.
+- Add `# pragma: allowlist secret` for pseudo-passwords.
+- Add the `pytest-order` package to `pyproject.toml`'s test dependencies and to `environment-dev.yaml` for ordering some `DomainTests`, `Messages` and `TagsNewTests`.
+- Add docstrings to the test classes.
+- Add Python 3.14 support.
+
+### Changed
+
+- Update `metrics_handler.py` to parse Tags New API.
+- Mark deprecated `Tags API` in `README.md` with a warning.
+- Fix `Metrics` & `Logs` docstrings.
+- Format `README.md`.
+- Use ordering for some tests by adding `@pytest.mark.order(N)` to run specific tests sequentionally. It allows to remove some unnecessary `@pytest.mark.skip()`
+- Rename some test classes, e.i., `ComplaintsTest` -> `ComplaintsTests` for consistency.
+- Use `datetime` for `LogsTests` data instead of static date strings.
+- Update CI workflows: update `pre-commit` hooks to the latest versions; add py314 support (limited).
+- Set `line-length` to `100` across the linters in `pyproject.toml`.
+
+### Pull Requests Merged
+
+- [PR_20](https://github.com/mailgun/mailgun-python/pull/20) - Add support for the Tags New API endpoint
+
 ## [1.2.0] - 2025-10-02
 
 ### Added
@@ -98,7 +128,8 @@ We [keep a changelog.](http://keepachangelog.com/)
 
 ### Changed
 
-- Breaking changes! It's a new Python SKD for [Mailgun](http://www.mailgun.com/); an obsolete v0.1.1 on [PyPI](https://pypi.org/project/mailgun/0.1.1/) is deprecated.
+- Breaking changes! It's a new Python SKD for [Mailgun](http://www.mailgun.com/); an obsolete v0.1.1 on
+  [PyPI](https://pypi.org/project/mailgun/0.1.1/) is deprecated.
 
 ### Pull Requests Merged
 

Makefile

@@ -134,9 +134,9 @@ coverage: ## check code coverage quickly with the default Python
 	$(BROWSER) htmlcov/index.html
 
 lint-black:
-	black --line-length=80 $(SRC_DIR) $(TEST_DIR)
+	black --line-length=100 $(SRC_DIR) $(TEST_DIR)
 lint-isort:
-	isort --profile black --line-length=80 $(SRC_DIR) $(TEST_DIR)
+	isort --profile black --line-length=100 $(SRC_DIR) $(TEST_DIR)
 lint-flake8:
 	@flake8 $(SRC_DIR) $(TEST_DIR)
 lint-pylint:
@@ -145,7 +145,7 @@ lint-refurb:
 	@refurb $(SRC_DIR)
 
 format-black:
-	@black --line-length=88 $(SRC_DIR) $(TEST_DIR) $(SCRIPTS_DIR)
+	@black --line-length=100 $(SRC_DIR) $(TEST_DIR) $(SCRIPTS_DIR)
 format-isort:
 	@isort --profile black --line-length=88 $(SRC_DIR) $(TEST_DIR) $(SCRIPTS_DIR)
 format: format-black format-isort