antenati 6.0__tar.gz

antenati-6.0/.gitignore

@@ -0,0 +1,201 @@
+# Created by https://www.toptal.com/developers/gitignore/api/python,visualstudiocode
+# Edit at https://www.toptal.com/developers/gitignore?templates=python,visualstudiocode
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Auto-generated by hatch-vcs at build time
+src/antenati/_version.py
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# uv (not the project's package manager — only used ad-hoc locally)
+uv.lock
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+### Python Patch ###
+# Poetry local configuration file - https://python-poetry.org/docs/configuration/#local-configuration
+poetry.toml
+
+# ruff
+.ruff_cache/
+
+# LSP config files
+pyrightconfig.json
+
+### VisualStudioCode ###
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+!.vscode/*.code-snippets
+
+# Local History for Visual Studio Code
+.history/
+
+# Built Visual Studio Code Extensions
+*.vsix
+
+### VisualStudioCode Patch ###
+# Ignore all local history of files
+.history
+.ionide
+
+# End of https://www.toptal.com/developers/gitignore/api/python,visualstudiocode

antenati-6.0/CHANGELOG.md

@@ -0,0 +1,123 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+
+## [6.0] - 2026-06-11
+
+### Added
+- Comprehensive test suite (15+ test modules) covering IIIF parsing, HTTP handling, download orchestration, filesystem operations, and end-to-end flows with mocked HTTP
+- Typed exception hierarchy (`ManifestError`, `WafChallengeError`, `ThreadError`) replacing generic `RuntimeError`
+- `--verbose` / `-vv` flags to control log verbosity (WARNING → INFO → DEBUG)
+- Automatic exponential backoff retry policy for transient 5xx and rate-limit (429) responses
+
+### Changed
+- Dropped Intel macOS (macOS 13) binary artifacts: GitHub Actions no longer provides Intel macOS runners; only Apple Silicon (macOS 14, arm64) is now built
+- Refactored monolithic `antenati.py` into a modular package structure under `src/antenati/`:
+  - `downloader.py`: core `Downloader` class with thread-pool orchestration
+  - `iiif.py`: pure IIIF manifest parsing helpers (no I/O, offline-testable)
+  - `http.py`: HTTP session building and request handling
+  - `errors.py`: typed exception hierarchy
+  - `cli.py`: CLI entry point with logging configuration
+- CI/CD pipeline updated with linting (ruff), type checking (mypy), and offline test runs
+
+## [5.0] - 2025-11-01
+
+### Added
+- Restored support for full/resolution image size downloads
+
+### Changed
+- Default requested size is now `0` (maximum available size) instead of 1000 pixels; use `--size N` to limit size
+
+### Fixed
+- Graceful handling of server denials (403 or WAF challenge)
+
+
+## [4.0] - 2025-07-27
+
+### Changed
+- Updated implementation to comply with recent SAN server filter requirements:
+  - Full-resolution downloads are no longer supported; this may be revisited in future releases
+  - Users must now specify the maximum image size using the `-s/--size` option (default: 1000 px); requests for larger images will result in a 403 error
+  - Download logic now detects AWS WAF challenges and provides a clear error message, replacing the previous generic 202 error; no workaround is currently available
+  - Reduced default number of threads and connections to minimize server load
+  - Updated the user agent string to a modern value
+- Replaced the use of the `urllib3` Python module with the more flexible `requests` library
+- Removed the `-c/--nconn` parameter; connection management now relies on the defaults provided by the `requests` library
+
+## [3.2] - 2025-07-14
+
+### Fixed
+- Access to IIIF manifest with proper HTTP headers to address recent changes in SAN server filters that broke v3.1
+
+### Changed
+- Download size now reported in binary format (MiB rather than MB)
+- Update Python dependencies
+
+## [3.1] - 2025-02-08
+
+### Added
+- Pyinstaller artifacts now built with Python 3.12
+- Support for multiple platforms:
+  - Ubuntu 22.04 (x86_64)
+  - macOS 13 (Intel)
+  - macOS 14 (arm64)
+  - Windows 2022
+
+### Changed
+- Minimum Python version moved to 3.9
+- Improved README documentation
+
+## [3.0] - 2024-10-14
+
+### Added
+- New GUI available with `antenati_gui.py`
+- GUI standalone executables generated by pyinstaller
+- Support for Windows, macOS and Linux standalone executables
+
+## [2.5] - 2023-01-22
+
+### Fixed
+- Support for new URL [antenati.cultura.gov.it](https://antenati.cultura.gov.it/)
+
+## [2.4] - 2022-12-28
+
+### Added
+- Possibility to set range of pages to download using `-f` and `-l` options
+- Type hints throughout the codebase
+
+### Fixed
+- Removed usage of deprecated `cgi.parse_header`
+
+## [2.3] - 2022-05-21
+
+### Added
+- HTTP headers to get around SAN server filters
+
+## [2.2] - 2022-02-16
+
+### Changed
+- Several minor improvements
+
+## [2.1] - 2021-11-20
+
+### Changed
+- Code restyle with argument parsing to specify number of threads and number of connections
+
+## [2.0] - 2021-11-19
+
+### Added
+- Support for new Portale Antenati (Fall 2021)
+
+## [1.1] - 2019-10-12
+
+### Changed
+- Upgraded to Python 3 using 2to3 tool
+
+## [1.0] - 2019-04-14
+
+### Added
+- First stable release

antenati-6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Giovanni Cerretani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

antenati-6.0/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: antenati
+Version: 6.0
+Summary: Download data from the Portale Antenati, the italian state genealogy archive
+Project-URL: Homepage, https://gcerretani.github.io/antenati/
+Project-URL: Repository, https://github.com/gcerretani/antenati
+Project-URL: Issues, https://github.com/gcerretani/antenati/issues
+Project-URL: Changelog, https://github.com/gcerretani/antenati/blob/master/CHANGELOG.md
+Author: Giovanni Cerretani
+License: MIT License
+        
+        Copyright (c) 2018 Giovanni Cerretani
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: antenati,downloader,genealogy,iiif,portale-antenati
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Environment :: X11 Applications
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Natural Language :: Italian
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.10
+Requires-Dist: click~=8.3.0
+Requires-Dist: humanize~=4.14.0
+Requires-Dist: python-slugify~=8.0.4
+Requires-Dist: requests~=2.32.5
+Requires-Dist: tqdm~=4.67.1
+Provides-Extra: dev
+Requires-Dist: mypy==1.19.1; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pytest==9.0.3; extra == 'dev'
+Requires-Dist: responses==0.25.8; extra == 'dev'
+Requires-Dist: ruff==0.15.8; extra == 'dev'
+Requires-Dist: types-requests; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# antenati
+A tool to download data from the *[Portale Antenati](http://antenati.cultura.gov.it/)*, the genealogy digital archive maintained by the italian **Ministero per i beni e le attività culturali**.
+
+Since the website tends to be pretty slow in the evening, we present a script to help the retrieval of the documents for your family tree. The script allows you to download **all the images of any archive at the same time**, without any human action. Just launch the script and have a coffee while it downloads all the stuff for you.
+
+## GUI version
+
+Just get the executable from the [release artifacts](https://github.com/gcerretani/antenati/releases/latest), and have fun!
+
+![GUI Screenshot](docs/gui_screenshot.png)
+
+#### Example:
+In the website, navigate to the archive you want to download. For example, for the people born in Viareggio in 1807 you should find the page:
+
+[https://antenati.cultura.gov.it/ark:/12657/an_ua19944535/w9DWR8x](https://antenati.cultura.gov.it/ark:/12657/an_ua19944535/w9DWR8x)
+
+Copy the link to the first page, and paste it in the Archive URL field of the window. Then, specify a destination folder: the results will be placed there, in a new subfolder named *archivio-di-stato-di-lucca-stato-civile-napoleonico-viareggio-1807-nati-19944549*.
+
+## CLI version
+
+### Requirements
+The software is written in Python 3 and requires Python 3.10 or newer. On Windows the version on the Microsoft Store is fine, on Linux use your distribution package manager.
+
+### Install
+From a checkout of this repository:
+
+    pip install .
+
+This installs an `antenati` command on your `PATH` (and an `antenati-gui` one for the GUI).
+
+### Run
+To download the images of a gallery, pass the URL of the gallery page:
+
+    antenati <URL of the album>
+
+You can also invoke the package directly without installing the script:
+
+    python3 -m antenati <URL of the album>
+
+The files will be downloaded to a new folder named as *ARCHIVE-PLACE-YEAR-TYPE-ID* of the downloaded archive. For more options, see the help:
+
+    antenati -h
+
+#### Example:
+In the website, navigate to the archive you want to download. For example, for the people born in Viareggio in 1807 you should find the page:
+
+[https://antenati.cultura.gov.it/ark:/12657/an_ua19944535/w9DWR8x](https://antenati.cultura.gov.it/ark:/12657/an_ua19944535/w9DWR8x)
+
+Then, copy the link to the first page, and call the script with that link as argument:
+
+    antenati https://antenati.cultura.gov.it/ark:/12657/an_ua19944535/w9DWR8x
+
+The results will be placed in a folder named *archivio-di-stato-di-lucca-stato-civile-napoleonico-viareggio-1807-nati-19944549*.
+
+To include the archive and image IDs in the saved file names (e.g. `pag-1+an_ua19944535+w9DWR8x.jpg` instead of `pag-1.jpg`), add the `-d`/`--descriptive-names` flag.
+
+## AWS WAF challenge
+
+Outside Italy, the Portale Antenati gallery pages are often protected by an AWS WAF challenge that this tool cannot solve, and the download fails with an *AWS WAF challenge cannot be bypassed* error (see [#25](https://github.com/gcerretani/antenati/issues/25)). The IIIF manifest and the images themselves are **not** behind the WAF, so you can work around it:
+
+1. open the gallery page in your browser;
+2. copy the **IIIF manifest** link at the bottom of the left side panel (it looks like `https://dam-antenati.cultura.gov.it/antenati/containers/.../manifest`);
+3. pass that URL to the tool (both CLI and GUI) instead of the gallery page URL.

antenati-6.0/README.md

@@ -0,0 +1,63 @@
+# antenati
+A tool to download data from the *[Portale Antenati](http://antenati.cultura.gov.it/)*, the genealogy digital archive maintained by the italian **Ministero per i beni e le attività culturali**.
+
+Since the website tends to be pretty slow in the evening, we present a script to help the retrieval of the documents for your family tree. The script allows you to download **all the images of any archive at the same time**, without any human action. Just launch the script and have a coffee while it downloads all the stuff for you.
+
+## GUI version
+
+Just get the executable from the [release artifacts](https://github.com/gcerretani/antenati/releases/latest), and have fun!
+
+![GUI Screenshot](docs/gui_screenshot.png)
+
+#### Example:
+In the website, navigate to the archive you want to download. For example, for the people born in Viareggio in 1807 you should find the page:
+
+[https://antenati.cultura.gov.it/ark:/12657/an_ua19944535/w9DWR8x](https://antenati.cultura.gov.it/ark:/12657/an_ua19944535/w9DWR8x)
+
+Copy the link to the first page, and paste it in the Archive URL field of the window. Then, specify a destination folder: the results will be placed there, in a new subfolder named *archivio-di-stato-di-lucca-stato-civile-napoleonico-viareggio-1807-nati-19944549*.
+
+## CLI version
+
+### Requirements
+The software is written in Python 3 and requires Python 3.10 or newer. On Windows the version on the Microsoft Store is fine, on Linux use your distribution package manager.
+
+### Install
+From a checkout of this repository:
+
+    pip install .
+
+This installs an `antenati` command on your `PATH` (and an `antenati-gui` one for the GUI).
+
+### Run
+To download the images of a gallery, pass the URL of the gallery page:
+
+    antenati <URL of the album>
+
+You can also invoke the package directly without installing the script:
+
+    python3 -m antenati <URL of the album>
+
+The files will be downloaded to a new folder named as *ARCHIVE-PLACE-YEAR-TYPE-ID* of the downloaded archive. For more options, see the help:
+
+    antenati -h
+
+#### Example:
+In the website, navigate to the archive you want to download. For example, for the people born in Viareggio in 1807 you should find the page:
+
+[https://antenati.cultura.gov.it/ark:/12657/an_ua19944535/w9DWR8x](https://antenati.cultura.gov.it/ark:/12657/an_ua19944535/w9DWR8x)
+
+Then, copy the link to the first page, and call the script with that link as argument:
+
+    antenati https://antenati.cultura.gov.it/ark:/12657/an_ua19944535/w9DWR8x
+
+The results will be placed in a folder named *archivio-di-stato-di-lucca-stato-civile-napoleonico-viareggio-1807-nati-19944549*.
+
+To include the archive and image IDs in the saved file names (e.g. `pag-1+an_ua19944535+w9DWR8x.jpg` instead of `pag-1.jpg`), add the `-d`/`--descriptive-names` flag.
+
+## AWS WAF challenge
+
+Outside Italy, the Portale Antenati gallery pages are often protected by an AWS WAF challenge that this tool cannot solve, and the download fails with an *AWS WAF challenge cannot be bypassed* error (see [#25](https://github.com/gcerretani/antenati/issues/25)). The IIIF manifest and the images themselves are **not** behind the WAF, so you can work around it:
+
+1. open the gallery page in your browser;
+2. copy the **IIIF manifest** link at the bottom of the left side panel (it looks like `https://dam-antenati.cultura.gov.it/antenati/containers/.../manifest`);
+3. pass that URL to the tool (both CLI and GUI) instead of the gallery page URL.

antenati-6.0/pyproject.toml

@@ -0,0 +1,113 @@
+[build-system]
+requires = ["hatchling>=1.21", "hatch-vcs>=0.4"]
+build-backend = "hatchling.build"
+
+[project]
+name = "antenati"
+description = "Download data from the Portale Antenati, the italian state genealogy archive"
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.10"
+authors = [
+    { name = "Giovanni Cerretani" },
+]
+keywords = ["antenati", "genealogy", "iiif", "downloader", "portale-antenati"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Environment :: X11 Applications",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Natural Language :: English",
+    "Natural Language :: Italian",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Multimedia :: Graphics",
+]
+dependencies = [
+    "click~=8.3.0",
+    "humanize~=4.14.0",
+    "python-slugify~=8.0.4",
+    "requests~=2.32.5",
+    "tqdm~=4.67.1",
+]
+dynamic = ["version"]
+
+[project.optional-dependencies]
+# Pinned dev tooling. Install with: pip install -e ".[dev]"
+dev = [
+    "mypy==1.19.1",
+    "pre-commit",
+    "pytest==9.0.3",
+    "responses==0.25.8",
+    "ruff==0.15.8",
+    "types-requests",
+]
+
+[project.urls]
+Homepage = "https://gcerretani.github.io/antenati/"
+Repository = "https://github.com/gcerretani/antenati"
+Issues = "https://github.com/gcerretani/antenati/issues"
+Changelog = "https://github.com/gcerretani/antenati/blob/master/CHANGELOG.md"
+
+[project.scripts]
+antenati = "antenati.cli:main"
+
+[project.gui-scripts]
+antenati-gui = "antenati.gui:main"
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/antenati/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/antenati"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/antenati",
+    "tests",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "pyproject.toml",
+]
+
+[tool.ruff]
+line-length = 160
+target-version = "py310"
+extend-exclude = ["build", "dist", "src/antenati/_version.py"]
+
+[tool.ruff.lint]
+# Conservative starting set: enabled rules already pass on the current
+# codebase. Stricter rules (PTH, ANN, D, etc.) will be turned on as the
+# refactor lands and the affected code is rewritten.
+select = ["E", "F", "W", "I", "B", "UP", "SIM", "RUF", "RET", "TID"]
+
+[tool.ruff.format]
+quote-style = "single"
+exclude = ["src/antenati/_version.py"]
+
+[tool.mypy]
+python_version = "3.10"
+ignore_missing_imports = true
+warn_redundant_casts = true
+warn_unreachable = true
+check_untyped_defs = true
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+testpaths = ["tests"]
+addopts = "-ra --strict-markers"
+markers = [
+    "integration: tests that hit the live Portale Antenati (opt-in, slow, may flake)",
+]