Audible

Added

- function `activation_bytes.fetch_activation_sign_auth`
- Spain marketplace

Changed

- `activation_bytes.get_activation_bytes` uses the new `fetch_activation_sign_auth` function, if `signing` auth method is available. Otherwise activation bytes will be fetched the old way with a `player_token`.

Added

- Add initial cookies to login function to prevent captcha requests in most cases.

Added

- Fetched activation bytes (with `extract=True` argument) will be stored to `activation_bytes` attribute of Authenticator class instance for now. Ignore existing activation bytes and force refresh with `auth.get_activation_bytes(force_refresh=True)`
- `activation_bytes` will be loaded from and save to file. Saved auth files are **not backward compatible** to previous audible versions so keep old files save.
- Add `Client.raw_request` and `AsyncClient.raw_request` method.
- Provide a custom Callback with `approval_callback` keyword argument when login.
- Add classmethod `Authenticator.from_login_external` and method `Authenticator.re_login_external`.
- Add `login_external` function to login.py

Misc

- Add description how to use pyotp with custom otp callback to docs
- Add description how to use login external to docs

Added

- Added support to output the whole activation blob instead of the extracted activation bytes with `get_activation_bytes(extract=False, ...)`.
- Added support to fetch website cookies for another country with `Authenticator.set_website_cookies_for_country`.
- Added `Client.put` and `AsyncClient.put`.
- Added support to solve approval alerts during login

Changed

- The `FileAuthenticator` has been deprecated, use classmethod `Authenticator.from_file` instead.
- The `Authenticator` don’t inherit from MutableMapping anymore
- The `Authenticator` sets allowed instance attributes at creation to `None`, not allowed attributes will raise an Exception
- The `LoginAuthenticator` has been deprecated, use classmethod `Authenticator.from_login` instead.
- Changed internal code base for encryption and decryption metadata. Moved the related code to `metadata.py`.

Remove

- deprecated `AudibleAPI`

Misc

- Added more docstrings and type hints to code base
- Added support to install Sphinx documentation dependencies with `pip install audible[docs]`.
- Added a guide to use authentication with [Postman](https://www.postman.com).
- Rework documentation.
- Added `.readthedocs.yml` config file
- Added module description (autodoc) to docs
- Uses `httpx` 0.16.\* for now

Bugfix

- Set `padding=„none“` when decrypting license voucher


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/).

Unreleased

Bugfix

- Fixing `[Errno 18] Invalid cross-device link` when downloading files using the `--output-dir` option. This error is fixed by creating the resume file on the same location as the target file.

Added

- The `--chapter-type` option is added to the download command. Chapter can now be
downloaded as `flat` or `tree` type. `tree` is the default. A default chapter type
can be set in the config file.

Changed

- Improved podcast ignore feature in download command
- make `--ignore-podcasts` and `--resolve-podcasts` options of download command mutual
exclusive
- Switched from a HEAD to a GET request without loading the body in the downloader
class. This change improves the program's speed, as the HEAD request was taking
considerably longer than a GET request on some Audible pages.
- `models.LibraryItem.get_content_metadatata` now accept a `chapter_type` argument.
Additional keyword arguments to this method are now passed through the metadata
request.
- Update httpx version range to >=0.23.3 and <0.28.0.
- fix typo from `resolve_podcats` to `resolve_podcasts`
- `models.Library.resolve_podcats` is now deprecated and will be removed in a future version

Bugfix

- fix a `TypeError` on some Python versions when calling `importlib.metadata.entry_points` with group argument