Metadata-Version: 2.4
Name: PyToNotion
Version: 1.0.0
Summary: Notion API with Python
Project-URL: Homepage, https://github.com/Vania-Dev/PyToNotion
Project-URL: Bug Tracker, https://github.com/Vania-Dev/PyToNotion/issues
Author-email: vania_vaniusha <ivan.castaneda.nazario@gmail.com>
License: Custom Open Source License with Attribution Requirement (LOSA v2.0)
        
        Copyright (c) 2026 Hector Ivan Castañeda Nazario
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        1. Permission
        
        The Software is open source and may be freely used for personal, educational,
        research, or commercial purposes.
        
        2. Preservation of Copyright
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        3. Attribution Requirement (Project-Level Requirement)
        
        While this License grants full usage rights, the project as a whole requires
        that proper attribution to the original author be maintained in visible form.
        
        This includes at minimum:
        
        - Retention of author credit in repository documentation (README or LICENSE)
        - Preservation of author credit in any fork or derivative repository
        
        Recommended attribution text:
        
            "Original project created by Hector Ivan Castañeda Nazario"
        
        4. User Interface Attribution (Recommended but Not Mandatory by Law)
        
        If this Software is used in a product, application, or service with a user
        interface, it is strongly recommended that visible credit be given to the
        original author in an "About", "Credits", or "Information" section.
        
        Recommended display text:
        
            "Built using software originally created by Hector Ivan Castañeda Nazario"
        
        5. Derivative Works
        
        Modifications and derivative works are allowed without restriction, provided
        that the attribution in Section 3 is preserved in repository-level documentation.
        
        6. No Warranty
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
        
        IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
        DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
        OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
        OR OTHER DEALINGS IN THE SOFTWARE.
License-File: LICENSE.txt
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: requests>=2.28
Description-Content-Type: text/markdown

# 🐍 PyToNotion

[![Contributors](https://img.shields.io/github/contributors/Vania-Dev/PyToNotion?style=for-the-badge&logo=github&label=Contributors&labelColor=101010)](https://github.com/Vania-Dev/PyToNotion/graphs/contributors)
[![Forks](https://img.shields.io/github/forks/Vania-Dev/PyToNotion?style=for-the-badge&logo=github&label=Forks&labelColor=101010)](https://github.com/Vania-Dev/PyToNotion/forks)
[![Stars](https://img.shields.io/github/stars/Vania-Dev/PyToNotion?style=for-the-badge&logo=github&labelColor=101010)](https://github.com/Vania-Dev/PyToNotion/stargazers)
[![Issues](https://img.shields.io/github/issues/Vania-Dev/PyToNotion?style=for-the-badge&logo=github&label=Issues&labelColor=101010)](https://github.com/Vania-Dev/PyToNotion/issues)
[![License](https://img.shields.io/github/license/Vania-Dev/PyToNotion?style=for-the-badge&logo=open-source-initiative&labelColor=101010)](https://github.com/Vania-Dev/PyToNotion/blob/main/LICENSE.txt)
![PyPI - Version](https://img.shields.io/pypi/v/PyToNotion?style=for-the-badge&color=101010)


<!-- PROJECT LOGO -->
<br />
<div align="center">
  <a href="https://github.com/Vania-Dev">
    <img src="images/vaniadev.png" alt="Logo" width="80" height="80">
  </a>

  <h3 align="center">🐍 PyToNotion</h3>

  <a href="https://github.com/Vania-Dev">
    <img src="images/PyToNotion.svg" alt="Logo" style="height: 60%; width:60%;">
  </a>

  <p align="center">
    A repository for the PyToNotion package
    <br />
    <br />
    <a href="https://github.com/Vania-Dev/PyToNotion">Additional Material</a>
    ·
    <a href="https://github.com/Vania-Dev/PyToNotion/issues/new?labels=bug&template=bug-report---.md">Report Bug</a>
    ·
    <a href="https://github.com/Vania-Dev/PyToNotion/issues/new?labels=enhancement&template=feature-request---.md">Request Feature</a>
  </p>
</div>



<!-- TABLE OF CONTENTS -->
<details>
  <summary>📑 Table of Contents</summary>
  <ol>
    <li>
      <a href="#-about-the-project">About The Project</a>
      <ul>
        <li><a href="#️-built-with">Built With</a></li>
      </ul>
    </li>
    <li><a href="#-project-structure">Project Structure</a></li>
    <li><a href="#-whats-new---version-100">What's New - Version 1.0.0</a></li>
    <li><a href="#-video-list">Video List</a></li>
    <li>
      <a href="#-getting-started">Getting Started</a>
      <ul>
        <li><a href="#prerequisites">Prerequisites</a></li>
        <li><a href="#installation">Installation</a></li>
      </ul>
    </li>
    <li><a href="#-contributing">Contributing</a></li>
    <li><a href="#-license">License</a></li>
    <li><a href="#-contact">Contact</a></li>
  </ol>
</details>



<!-- ABOUT THE PROJECT -->
## 📖 About The Project

This repository contains the code for the PyToNotion package, a Python library to connect with Notion that includes examples of how to use each function.

**Notion API Documentation**: [https://developers.notion.com/guides/get-started/overview](https://developers.notion.com/guides/get-started/overview)

**Notion API Version**: `2026-03-11`

### 🛠️ Built With

The project is built with Python programming language version 3.12.X

* [![Python][Python]][Python-url]

## 📂 Project Structure

```
PyToNotion/
├── PyToNotion/
│   ├── __init__.py
│   └── pyNotion.py
├── tests/
│   ├── Blocks/
│   ├── Comments/
│   ├── Databases/
│   ├── Datasources/
│   ├── Pages/
│   ├── Users/
│   └── Views/
├── images/
├── LICENSE.txt
├── README.md
├── requirements.txt
└── pyproject.toml
```

## 🎉 What's New - Version 1.0.0

- ✨ **Initial release** of PyToNotion
- 🔌 **Full integration** with Notion API (Version 2026-03-11)
- 📄 **Page management**: Create, read, update and move pages
- 🗄️ **Database management**: Create, query and update databases
- 🧱 **Block management**: Append, retrieve, update and delete blocks
- 💬 **Comment system**: Create, read, update and delete comments
- 👥 **User management**: Get information about users and bots
- 👁️ **View management**: Create, read, update and delete views
- 📊 **Datasource support**: Create and query data sources
- 😀 **Emoji retrieval** available in Notion
- 📚 **Complete examples** of usage in the `tests/` directory
- 📝 **Comprehensive documentation** with English comments

## 🎥 Video List

- In progress

<!-- GETTING STARTED -->
## 🚀 Getting Started

This is an example of how to run the project and its internal functions. You need to install the package or clone the project locally.

### Prerequisites

This is the list of libraries or packages you need to install to run the project properly.
* pip
  ```sh
  pip install -r requirements.txt
  ```

### Installation

_Below is a guide for installing the repository_

1. Clone the repository
   ```sh
   git clone https://github.com/your_username_/PyToNotion.git
   ```
2. Install the packages
   ```sh
   pip install -r requirements.txt
   ```
3. Install the package
   ```sh
   pip install PyToNotion
   ```


<!-- CONTRIBUTING -->
## 🤝 Contributing

Contributions make the open source community a great place to learn, inspire, and create. Any contributions you make are **greatly appreciated**

If you have a suggestion to improve the project, please fork the repository and create a pull request. You can also simply open an issue with the tag "enhancement".

Don't forget to give the repository a star :D! Thank you!


1. Fork the project
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request


<!-- LICENSE -->
## 📄 License

Distributed under the LOSA (License Open Source with Attribution) v2.0 license. See `LICENSE.txt` file for more information.

<!-- CONTACT -->
## 📧 Contact

[![YouTube](https://img.shields.io/badge/YouTube-vaniadev-FF0000?style=for-the-badge&logo=youtube&logoColor=white&labelColor=101010)](https://youtube.com/@VANIADEV)
[![Instagram](https://img.shields.io/badge/Instagram-@vania_dev_-E4405F?style=for-the-badge&logo=instagram&logoColor=white&labelColor=101010)](https://www.instagram.com/vania_dev_/)
[![TikTok](https://img.shields.io/badge/TikTok-@vania_dev_-69C9D0?style=for-the-badge&logo=tiktok&logoColor=white&labelColor=101010)](https://www.tiktok.com/@vania_dev_)
[![Facebook](https://img.shields.io/badge/Facebook-@vaniadev-1877F2?style=for-the-badge&logo=facebook&logoColor=white&labelColor=101010)](https://www.facebook.com/SMAEMX)
[![Link](https://img.shields.io/badge/Links-vaniadev-39E09B?style=for-the-badge&logo=Linktree&logoColor=white&labelColor=101010)](https://beacons.ai/vaniadev)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-Ivan_Castañeda-0077B5?style=for-the-badge&logo=linkedin&logoColor=white&labelColor=101010)](https://www.linkedin.com/in/ivan-castaneda-nazario/)
[![Web](https://img.shields.io/badge/Web-vaniadev-14a1f0?style=for-the-badge&logo=dev.to&logoColor=white&labelColor=101010)](https://vaniadev.super.site/)
[![BuyMeACoffee](https://img.shields.io/badge/Buy_Me_A_Coffee-apoya_mi_trabajo-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=white&labelColor=101010)](https://buymeacoffee.com/vania_vaniusha)


---

<div align="center">

**Hazlo con el tipo de ❤️ que deja huellas en el alma**

[⭐ Star this repo](https://github.com/Vania-Dev/PyToNotion) • [🐛 Report Bug](https://github.com/Vania-Dev/PyToNotion/issues) • [✨ Request Feature](https://github.com/Vania-Dev/PyToNotion/issues)

</div>


<!-- MARKDOWN LINKS & IMAGES -->
<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
[contributors-shield]: https://img.shields.io/github/contributors/Vania-Dev/PyToNotion.svg?style=for-the-badge
[contributors-url]: https://github.com/Vania-Dev/PyToNotion/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/Vania-Dev/PyToNotion.svg?style=for-the-badge
[forks-url]: https://github.com/Vania-Dev/PyToNotion/network/members
[stars-shield]: https://img.shields.io/github/stars/Vania-Dev/PyToNotion.svg?style=for-the-badge
[stars-url]: https://github.com/Vania-Dev/PyToNotion/stargazers
[issues-shield]: https://img.shields.io/github/issues/Vania-Dev/PyToNotion.svg?style=for-the-badge
[issues-url]: https://github.com/Vania-Dev/PyToNotion/issues
[license-shield]: https://img.shields.io/github/license/Vania-Dev/PyToNotion.svg?style=for-the-badge
[license-url]: https://github.com/Vania-Dev/PyToNotion/blob/master/LICENSE.txt
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
[linkedin-url]: https://www.linkedin.com/in/ivan-casta%C3%B1eda/
[Python]: https://img.shields.io/badge/python-3670A0?style=for-the-badge&logo=python&logoColor=ffdd54
[Python-url]: https://www.python.org