* feat(exceptions): separate failed signin error

Closes #1472

This makes sign in failures their own class of exceptions, while still
inheriting from NotSignedInException to not break backwards
compatability for any existing client code. This should allow users
to get out more specific exceptions more easily on what failed with
their authentication request.

* fix(error): raise exception when ServerInfo.get fails

If ServerInfoItem.from_response gets invalid XML, raise the error
immediately instead of suppressing the error and setting an invalid
version number

* fix(test): add missing test asset

---------

Co-authored-by: Jordan Woods <[email protected]>

* docs: add docstrings to auth objects and endpoints

* docs: add parameters and examples to methods

---------

Co-authored-by: Jordan Woods <[email protected]>

* add TSC_FILESIZE_LIMIT_MB environment variable

* add hard limit for filesize limit at 64MB

* fix formatting

---------

Co-authored-by: Jac <[email protected]>

Update permissions_item.py

added PulseMetricDefine cap

Co-authored-by: Jac <[email protected]>

… connections (#1482)

Co-authored-by: Jordan Woods <[email protected]>

* refactor request_options, add language param

I have refactored the classes to separate options that can be used in querying content, and options that can be used for exporting data. "language" is only available for data exporting.

* docs: docstrings for user item and endpoint

* docs: add serverresponseerror details

---------

Co-authored-by: Jordan Woods <[email protected]>

Now that python 3.13 has released, test builds on actual
3.13 instead of the 3.13-dev build

Co-authored-by: Jordan Woods <[email protected]>

Add detailed docstrings to workbook item and endpoint
Co-authored-by: Jordan Woods <[email protected]>

Resource is not currently an actual type, but an enum-like
holder for literal values. Added a Union for str types to
make mypy happy.

Co-authored-by: Jordan Woods <[email protected]>

* fix: handle 0 item response in querysets

A flaw in the __iter__ logic introduced to handle scenarios
where a pagination element is not included in the response xml
resulted in an infinite loop. This PR introduces a few changes
to protect against this:

1. After running QuerySet._fetch_all(), if the result_cache is
empty, return instead of performing other comparisons.
2. Ensure that any non-None total_available is returned from
the PaginationItem's object.
3. In _fetch_all, check if there is a PaginationItem that has been
populated so as to not call the server side endpoint muliple times
before returning.

* fix: null out PaginationItem._page_number

Tests were failing because the fetch_all method added a second
check before fetching the next page. This fix will allow the
next page to be retrieved when used normally

---------

Co-authored-by: Jordan Woods <[email protected]>

* ci: cache dependencies for faster builds

* ci: cache for mypy and black

---------

Co-authored-by: Jordan Woods <[email protected]>

Adding custom views PDF & CSV export endpoints

Favor list comprehensions for readability, consistency, and
performance

Co-authored-by: Jordan Woods <[email protected]>

* Replace obsolete env package with os.environ
* Python 2.x to 3.x updates
* Fix some comments
* Remove workbook data acceleration; feature was removed in 2022
* Remove switch_site() example which is confusing in this context of demonstrating login

Co-authored-by: Jordan Woods <[email protected]>

* Remove sample code showing group name encoding

This is no longer needed - ran the sample and verified that it works now.

Update pyproject.toml

Co-authored-by: Jordan Woods <[email protected]>

…lient-python into jac/subscription-sample