Package does not work in Jupyter/iPython Notebooks

[bmcleod3356]

Hi, thanks for this great package, it's very useful.

One trap for beginners is that it does not appear to work in a notebook environment, and this isn't documented.

I initially had a lot of trouble getting it working, and couldn't run sample code from the documentation, receiving a bunch of relatively opaque error messages:

• Asyncio issues (which can be fixed using nest-asyncio in the notebook)
• Once that is fixed, valid API calls still return a 403 – Forbidden error.

All these issues were resolved when I switched to a normal .py file. It would be great if this can be added to the github page and documentation, as otherwise the errors will trip up people who find the package and try to tinker in a notebook (which is pretty commonplace for data focused python users).

For completeness – I am using Python 3.12.11 and jupyter notebooks within VS Code.

[nc9]

I understand we have a lot of notebook users - i'll add some detail to the docs and include some example notebooks. Thanks for the report.

[nc9]

I think notebook users will be fine with sync calls - I'll make that explicit in the docs and do that in the examples. Async is more for concurrent integrations rather than one-off takes

I've noticed a few issues with integrating into environments and notebooks that i've cleared up in dev - I just need to put some example notebooks together