jamalex/notion-py
Notion Py
notion-py este o bibliotecă Python care servește drept client API neoficial pentru interacțiunea cu paginile și bazele de date Notion. Funcționează ca un mapper obiect-relațional care traduce tabelele și blocurile bazelor de date Notion în clase Python pentru gestionarea structurată a datelor.
Proiectul dispune de un strat de sincronizare reactiv care utilizează long-polling și callback-uri pentru a menține obiectele Python locale actualizate cu schimbările de la distanță. Include un cache local de date thread-safe cu persistență pe disc pentru a reduce cererile de rețea și un convertor pentru transformarea textului Markdown în blocuri de conținut Notion formatate și structuri de text bogat.
Biblioteca acoperă o gamă largă de capabilități, inclusiv gestionarea programatică a blocurilor de conținut, interogarea bazelor de date cu filtre și sortare, și gestionarea identității utilizatorului. De asemenea, suportă serializarea textului bogat în CommonMark markdown, păstrând în același timp atributele LaTeX și de stilizare.
Features
- Notion Integrations - Acts as a Python-based connector for automating data exchange and management within a Notion workspace.
- Block Hierarchy Management - Organizes parent-child relationships and block types using an object-oriented interface to structure page content.
- Data Change Listeners - Triggers custom callback functions when remote Notion records are modified to synchronize local state.
- Notion Converters - Translates content between Markdown files and Notion pages while preserving formatting and styling.
- Notion Block Parsers - Transforms Markdown text into formatted Notion content blocks and rich text structures.
- Page Content Retrievals - Programmatically fetches specific page content from Notion using unique identifiers and authentication tokens.
- Page Content Updates - Creates, updates, and modifies page attributes and content blocks using an object-oriented interface.
- Programmatic Content Structuring - Provides an object-oriented interface to programmatically organize and structure Notion blocks and pages.
- Class-Based Schema Mappings - Dynamically translates remote collection schemas into native Python classes for object-oriented CRUD operations.
- Collection Querying - Retrieves, filters, and sorts Notion database rows using schema-based attributes and complex query parameters.
- Database and Table Management - Provides comprehensive capabilities for creating, reading, updating, and deleting Notion pages and databases.
- Record Change Monitoring - Subscribes to records via long-polling to detect updates and trigger data refreshes automatically.
- Thread-Safe Local Caching - Provides a thread-safe local data cache with disk persistence to reduce network requests and improve access speed.
- Remote Object Mappings - Maps remote database schemas and records to local Python classes for structured data manipulation.
- Object-Relational Mappers - Maps Notion database tables and blocks into Python classes for structured data management.
- Python API Clients - Provides a native Python library for interacting with Notion pages and databases through an API wrapper.
- Long-Polling Queries - Uses long-polling queries to monitor remote records and trigger local state synchronization.
- Reactive Remote Synchronization - Implements a reactive synchronization layer using long-polling and callbacks to keep local objects updated with remote changes.
- Markdown to Notion Converters - Transforms Markdown text into a formatted Notion data structure automatically during write operations.
- Notion Block Converters - Transforms standard Markdown text into structured data objects compatible with Notion content blocks.
- Rich Text to Markdown Converters - Transforms nested rich text formats into CommonMark markdown while preserving styles and LaTeX.
- API Mutation Atomic Batches - Groups multiple API modifications into single atomic requests to ensure efficient updates to remote data.
- Local Data Caches - Ships a thread-safe local cache with disk persistence to reduce network requests.
- Local State Caches - Maintains a local state cache that automatically refreshes record states to minimize server requests.
- Rich Text Serialization - Serializes nested remote rich text formats into CommonMark markdown while preserving styling and LaTeX.
- Notion Data Caching - Implements a thread-safe local storage system for persisting Notion records to reduce network overhead.
- Request Batching - Implements request batching to group multiple data operations into single atomic requests to reduce network overhead.
