integrate notion api with your workflow
Project description
NotionPy
for creating,updating and querying databases and pages , NotionPy is a python module to help you integrete notion with your software/workflow
installation
in your terminal :
pip install auto-py-notion
Requirments
before we get started there are a couple of things we need to do :
-
create an integration and grab a token from here
-
share the integration with you database or page
-
get the id of the database or page :
https://www.notion.so/myworkspace/a8aec43384f447ed84390e8e42c2e089?v=...
the database id is before the question mark and after the backslash
more details from official notion docs
Getting Started
let's create a sample page inside a database :
from NotionPy.notionpy import NotionClient
inst = NotionClient("Your integration token")
inst.create.page(
database_id="the id of database of choice",
data=[ # List of tuples # provided properties must be created first in the db
("Name", "title", "kareem"),
("price", "number", 254),
("to-do", "checkbox", False),
],
#Optional
icon="🔥",
#Optional
cover="https://images.unsplash.com/photo-1523867574998-1a336b6ded04?ixlib=rb-1.2.1&ixid=MnwxMjA3fDB8MHxzZWFyY2h8Mnx8Y292ZXJ8ZW58MHx8MHx8&w=1000&q=80",
)
-> Note that the data inserted must be [ ( prop_name ,type ,value ) ]
- currently there is no support for creating empty pages or empty values but look forward for feature updates
retreiving data from a database :
inst.query.db("id of the database",
in_json=True, #Optional
json_indent=2, #Optional
print_data=True #Optional
)
Supported properties type
-title -rich_text
-select -multi_select
-relation -people
-checkbox -url
-files -email
-phone -number
NotionPy 0.1.2 , What's New !
- sorting in queryring databases
- filtering in queyring databases
- Bug fx
Notes
- there are other modules that interact with notion's API so what makes this module different ? it is the fact that , as far as my research went , it is the most userfriendly and practical one
- This module is still has a lot to offer in the future , so all of your suggestions , issues , contributions are very welcomed
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 auto_py_notion-0.1.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 71beb9fd2f3b9f9f590e2e85f7f5983966142530fdc155b0510671743d8869e6 |
|
MD5 | d57e540696bb7f7f8d3172a010845cea |
|
BLAKE2b-256 | cebd640adc04a923c87f9b057b136d077a5fe7355a011afdd4bce6633c129aab |