The ultimate Python client for Notion!
Project description
Ultimate Notion is the ultimate Python client for Notion 🚀 It allows you to access and modify your Notion databases and pages in the most convenient and pythonic way.
CI/CD | |
Package | |
Details |
Installation
Install the most recent release using PyPI with:
pip install ultimate-notion
or to install all additional dependencies, use:
pip install 'ultimate-notion[all]'
Usage
Make sure you have set the environment variable NOTION_TOKEN
to your Notion
integration token. Then it's as simple as:
import ultimate_notion as uno
PAGE_TITLE = "Getting Started"
with uno.Session() as notion:
page = notion.search_page(PAGE_TITLE).item()
page.show()
# Alternatively, without a context manager:
notion = uno.Session()
page = notion.search_page(PAGE_TITLE).item()
page.show()
notion.close()
Check out the official Ultimate Notion documentation for more details. Especially the page about creating a Notion integration to get the token. The documentation is made with Material for MkDocs and is hosted on GitHub Pages.
Contributing
After having cloned this repository:
- make sure hatch is installed globally, e.g.
pipx install hatch
, - make sure pre-commit is installed globally, e.g. with
pipx install pre-commit
,
and then you are already set up to start hacking. Use hatch run test
to run the unit tests or hatch run vcr-only
to run the offline unit tests using VCR.py. Regenerate the cassettes with hatch run vcr-rewrite
.
Check out the environment setup of hatch in pyproject.toml for many more commands.
If you are using VS Code, it's quite convenient to create a file .vscode/.env
with
NOTION_TOKEN=secret_YOUR_TOKEN_TO_YOUR_TEST_NOTION_ACCOUNT
ULTIMATE_NOTION_CONFIG=/path/to/repo/.ultimate-notion/config.toml
Check out this page about contributing for more details.
License & Credits
Ultimate Notion is distributed under the terms of the MIT license. To start this project off a lot of inspiration and code was taken from hatch and notional. Ultimate Notion highly depends on notion-sdk-py.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ultimate_notion-0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6de893a70ef9dba675235ed31b61ccfbf0838395e55873239a050b8e25bb63cc |
|
MD5 | 8cdf3582d908fb8293f2acf27699637c |
|
BLAKE2b-256 | a69081d4c0e6361833575df123032dbbd731ea167d0a59c9b959ed3402cf71bc |