Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/minwook-shin/notion-database
Python bindings for Notion Database API
https://github.com/minwook-shin/notion-database
api database notion notion-database pypi-package python
Last synced: 3 months ago
JSON representation
Python bindings for Notion Database API
- Host: GitHub
- URL: https://github.com/minwook-shin/notion-database
- Owner: minwook-shin
- License: lgpl-3.0
- Created: 2021-06-27T06:54:27.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-07-15T18:16:09.000Z (4 months ago)
- Last Synced: 2024-07-28T07:33:08.627Z (3 months ago)
- Topics: api, database, notion, notion-database, pypi-package, python
- Language: Python
- Homepage: https://pypi.org/project/notion-database/
- Size: 261 KB
- Stars: 136
- Watchers: 7
- Forks: 12
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
[](https://github.com/minwook-shin/notion-database/actions/workflows/python-publish.yml)
# Python Notion Database
> Database of Pythonic Notion API
created by database from the official Notion API.
"notion database" is Notion API wrapper library.
```python
import os
from notion_database.page import Page
from notion_database.properties import Properties
from notion_database.const.query import Direction, Timestamp
from notion_database.search import Search
S = Search(integrations_token=os.getenv('NOTION_KEY'))
S.search_database(query="", sort={"direction": Direction.ascending, "timestamp": Timestamp.last_edited_time})
for i in S.result:
PROPERTY = Properties()
PROPERTY.set_title("title", "title")
PROPERTY.set_rich_text("Description", "description text")
P = Page(integrations_token=os.getenv('NOTION_KEY'))
P.create_page(database_id=i["id"], properties=PROPERTY)
```
See detailed example [here](example.py).
## License Notice
hope that many people will use this package, also license has been changed to LGPL 3 from 1.0.
previous version is GPL, please be careful when using this out of version.
## What's new notion-version
* 1.0.0
* Now that we've implemented all features,
* change the version rule to the semantic version.
* notion-version : "2022-06-28"
* 2022.08.01
* **Update notion-version (2022-06-28)**
* 2022.03.27
* **Update notion-version (2022-02-22)**
* Using officially API (out of beta!).
* https://developers.notion.com/changelog/releasing-notion-version-2022-02-22
* 2021.09.01
* **Update notion-version (2021-08-16)**
## Installing / Getting started
```shell
pip install notion-database
```
### Docs
https://notion-database.readthedocs.io
## Building / Developing
```shell
python setup.py install
```
## Features
* Blocks
* ✅ Append block children
* ✅ Retrieve block children
* Pages
* ✅ Create a page
* ✅ Retrieve a page
* ✅ Retrieve a page property item
* ✅ Update page properties
* ✅ Archive a page
* Databases
* ✅ Create a database
* ✅ Query a database
* See detailed example [here](query_db_example.py).
* ✅ Retrieve a database
* ✅ Update a database
* ✅ Update database properties
* Blocks
* ✅ Retrieve a block
* ✅ Retrieve block children
## Contributing
If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome.
## Links
- Notion API : https://developers.notion.com
## Licensing
The code in this project is licensed under LGPL license.
## Example project using this package
* jira-2-notion-db
* https://github.com/minwook-shin/jira-2-notion-db