Skip to main content

An high-level interface for the Notion SDK.

Project description

notional

PyPI LICENSE Code Style

A high level interface and object model for the Notion SDK. This is loosely modeled after concepts found in SQLAlchemy and MongoEngine. This module is built on the excellent notion-sdk-py library, providing higher- level access to the API.

:warning: Work In Progress: The interfaces in this module are still in development and are likely to change. Furthermore, documentation is pretty sparse so use at your own risk!

That being said, if you do use this library, please drop me a message!

If you want to get up and running quickly, check out the Quick Start, or view the Full Documentation.

Installation

Install the most recent release using PyPi:

pip install notional

Note: it is recommended to use a virtual environment (venv) for installing libraries to prevent conflicting dependency versions.

Usage

Connect to the API using an integration token or an OAuth access token:

import notional

notion = notional.connect(auth=AUTH_TOKEN)

# ¡¡ fun & profit !!

Contributing

I built this module so that I could interact with Notion in a way that made sense to me. Hopefully, others will find it useful. If someone is particularly passionate about this area, I would be happy to consider other maintainers or contributors.

Any pull requests or other submissions are welcome. As most open source projects go, this is a side project. Large submissions will take time to review for acceptance, so breaking them into smaller pieces is always preferred. Thanks in advance!

Please read the full contribution guide.

Known Issues

See Issues on github.

Feature Requests

See Issues on github.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

notional-0.2.1.tar.gz (32.8 kB view hashes)

Uploaded Source

Built Distribution

notional-0.2.1-py3-none-any.whl (36.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page