v5.3.0

Changes

• Legacy playlist reports have been removed
• A breaking change within urllib3 has been countered (thanks for putting a breaking change in a minor release lads)

v5.2.1

Other

• Utilise parametrised tests for video reports
• Update min and max supported versions for dependencies

v5.2.0

Additions

• The new standard of playlist reports is now supported (see https://parafoxia.github.io/analytix/guides/new-playlist-reports)

Fixes

• Fixed a bug where the client would open the browser even if the user explicitly disallowed it
• Fixed a validation oversight in the "Top playlists (deprecated)" report type

v5.1.2

Changes

• Added deprecation warning regarding playlist reports

v5.1.1

Fixes

• Fixed a bug in to_polars that broke support for slightly older versions of Polars.

Changes

• Docs look nicer!
• Fixed some incorrectly specified dependencies.

v5.1.0

Additions

• All clients can now accept additional scopes for retrieving JWT tokens; check the document for Scopes for more information
• All clients can now decode JWT tokens retrieved from the YouTube Analytics API during authorisation

Changes

• The update checking request now has a timeout of 0.5 seconds to stop it blocking operations

Fixes

• Fixed a bug where Report.to_pandas() would error if month was provided as a dimension

v5.0.0

It's another major release!

For a full rundown of things that have changed, check out the migration guide.

This changelog will cover changes between v5.0.0rc3 and v5.0.0.

Additions

• Added ability to forcibly authorise the client
• Re-added the update checker
• Added ability to fetch group items from group (Group.fetch_items())

Changes

• Remove python-dateutil dependency
• More intelligently handle OOB redirect URIs
• Updated the banner!

Fixes

• Prevent a crash that would occur if a list of groups was requested for a channel with none

v5.0.0rc3

Changes

• The reports.interfaces module has been split into separate interfaces and resources modules, where resources contains things like the ResultTable.

Misc

• Many admin things, such as declaring support for Python 3.13-dev
• Documentation is now cleaner
• You can no longer install libs using extras -- this was just overly verbose considering each installed just one library

v5.0.0rc2

Additions

• The clients will now trigger the full auth flow if the scopes your tokens are authorised with aren't sufficient to make the requested fetch operations

Changes

• The can_use function now uses importlib.metadata instead of the deprecated pkg_resources
• Removed the InvalidFeatures and InvalidFeatureSet exception classes
• The AnalyticsReport.to_parquet and .to_feather methods no longer return Arrow tables

v5.0.0rc1

Changes

• This release changes the client interfaces quite a bit. They are now no longer async (async support may be reintroduced in an extension library), and are significantly simpler under the hood. The base client is now better suited to most web application uses.
• The oidc module has been re-written, and is now called auth. It performs largely the same tasks, just slightly differently in some cases.
• Shards can no longer refresh tokens -- that's now the client's job.
• The APIError exception class now has subclassed for 400, 401, 403, and 404 errors.
• Python 3.7 support has been dropped, but analytix now supports Python 3.12!

A full migration guide will be written nearer the time of full v5 release, but these are the bigger changes for now. Much of the "backend" stuff per se (like request verification, the AnalyticsReport class, etc.) remains the same for now, but some of these things will be changed before the final version goes out.

All new features have 100% unit test coverage, but let me know if you run into any issues!

Additional notes

• Live documentation won't be updated, though documentation has been added for new and updated features. To read these docs, run pip install -r requirements/docs.txt, then mkdocs serve.