Analytix

Feature release

This release adds and changes a lot of little things.

Additions

* The `Analytics.retrieve` and `AsyncAnalytics.retrieve` methods now accept a `token_path` kwarg to allow users to save their tokens wherever without needing to manually authorise
* The `Report` class now has `dimensions` and `metrics` properties, which return columns that are dimensions and those that are metrics respectively

Changes

* The outdated version warning message was reworded
* The token refresh check is now a little more optimised
* Some imports are a little more optimised

Potential breaking change

* The `Report._nrows` and `Report._ncolumns` private attributes have been merged into `Report._shape`, and thus no longer exist. You should use `Report.shape[0]` and `Report.shape[1]` instead. This will cause problems for those using these attributes, but as they are private, this isn't a major version change.

Feature release

Additions

* Added ability to export report as Apache Arrow Table (28)
* Added ability to export report as Apache Feather file (28)
* Added ability to export report as Apache Parquet file (28)
* Added `analytix[arrow]` install method (28)

Feature release

Additions

* Native Modin support (23)
* `Report.to_excel` -- exports the report to an Excel spreadsheet (24)

Changes

The `Report.to_json` and `Report.to_csv` methods can now be called in sync or async contexts. For example, both of the following calls work:

py
report.to_csv("analytics.csv")
await report.to_csv("analytics.csv")


The `Report.ato_json` and `Report.ato_csv` methods still remain for backwards compatibility, but are deprecated.

Deprecations

* `analytix[df]` install method
* `await Report.ato_json`
* `await Report.ato_csv`

Bugfix release

This release fixes a few issues related to refreshing tokens.

Firstly, it fixes a misunderstanding in the README about how long refresh tokens last before they expire. The README stated that this is 200 days, when actually it's, more often than not, 7. I'd read the wrong part of the Google Documentation, and Google highlighting 200 days really didn't help that, sozza.

I've also fixed a bug where analytix couldn't handle refresh tokens being invalid -- you will now simply be prompted to manually reauthorise when necessary.

This will DEFINITELY be the last pre-release before stable, just a fair amount has changed since the last release.

Additions

* Added an update checker (ignore warnings on pre-releases)
* Moved report determination to the Query class, as it better fits there
* Declare PyPy 3.9 support

Fixes

* Add some functionality to AsyncAnalytics I accidentally missed
* Fixed some typos in the README
* Fixed a bug where columns would not be correctly sorted in reports

Changes

* Some behaviour with relation to refreshing tokens

DevOps

* Bring test coverage up to near 100% (the rest will be done playlist support is added)
* Added some more checks, including a dependency manager

Future plans