Bigxml

This is a maintenance release. Internal tooling is being upgraded, featuring support for
pytest version 8 and formatting of the codebase with ruff.

:house: Internal

- Change code formatter from black to ruff
- Fix doctests not being run with other tests
- Fix coverage report under some versions of PyPy
- Upgrade dev dependencies
- Remove pylint, assuming its benefits are provided by the ruff+mypy combo
- Use trusted publishing for PyPi releases

Let's celebrate version 1! :tada: We know that `bigxml` has already been used in
production for years, but now it's official.

:bug: Fixes

- Improve documentation about usage with `requests`

:rocket: Added

- Export `Streamable` and `XMLElementAttributes` to ease type hints
- Be explicit about what is part of the public API

:house: Internal

- End of Python 3.7 support
- Necessary code changes following dev dependency update: mypy, ruff
- Use `pyproject.toml` and modern build system
- Improve tox & CI pipelines
- Add tests for PyPy 3.10
- Add tests for CPython 3.12
- Use CPython 3.12 for misc. tests
- Freeze dev dependencies

:boom: Breaking changes

- Renamed the base class for exceptions to `BigXmlError` in conformance with PEP8

:rocket: Added

- Add documentation to explain how to import the library
- Warnings due to wrong usage are now using `UserWarning` instead of `RuntimeWarning`
- Undocumented parameter `insecurely_allow_entities` to `Parser`

:house: Internal

- Necessary code changes following dev dependency update: mypy
- Use ruff for linting (and remove isort)

v0.9.0 introduces custom exceptions.

:boom: Breaking changes

- All exceptions raised due to invalid stream content are now instances of
`BigXmlException` instead of `xml.etree.ElementTree.ParseError` or
`defusedxml.DefusedXmlException`.

:bug: Fixes

- Add a workaround against pylint `not-an-iterable` false-positive on `iter_from`

:house: Internal

- Necessary code changes following dev dependency update: mypy, pylint, pytest
- Add tests for CPython 3.11
- Use CPython 3.11 for misc. tests
- Update Github actions dependencies

:bug: Fixes

- Fix an edge case when a class decorated with `xml_handle_text` has an attribute
decorated with `xml_handle_element`

:rocket: Added

- Type hints
- New export: `HandlerTypeHelper` that can help with type hints in some cases
- Sanity check on `xml_handler` method of class handlers for returned values (`None` or
an iterable)

:house: Internal

- End of Python 3.6 support
- Add tests for PyPy 3.9
- Refactor handler creator code
- Type validation with mypy
- Distribute `py.typed` file in conformance with [PEP 561]
- Update `typing-extensions` dependency

[pep 561]: https://www.python.org/dev/peps/pep-0561/

v0.7.0 improves dependencies requirements.

:rocket: Added

- Don't use upper bound constraints on dependencies
- Specify the Python versions required in package metadata

:house: Internal

- Improving memory consumption tests by using `tracemalloc` instead of `resource`