easypaperless 0.1.0__tar.gz

easypaperless-0.1.0/.env.EXAMPLE

@@ -0,0 +1,5 @@
+# Copy this file to .env and fill in your credentials.
+# .env is git-ignored and will never be committed.
+
+PAPERLESS_URL=https://your-paperless-instance.example.com
+PAPERLESS_API_KEY=your_api_key_here

easypaperless-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,31 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  build-and-publish:
+    name: Build and publish Python package
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build backend
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

easypaperless-0.1.0/.github/workflows/publish_testpypi.yml

@@ -0,0 +1,25 @@
+name: Publish to TestPyPI
+
+on:
+  push:
+    tags:
+      - "v*.*.*-rc*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - run: pip install build
+      - run: python -m build
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          password: ${{ secrets.TEST_PYPI_API_TOKEN }}

easypaperless-0.1.0/.gitignore

@@ -0,0 +1,42 @@
+# Virtual environment
+venv/
+.venv/
+
+# Environment variables
+.env
+.env.*
+!.env.EXAMPLE
+
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Test & coverage
+.pytest_cache/
+.coverage
+htmlcov/
+
+# IDE
+.vscode/
+.idea/
+*.iml
+
+# Claude Code
+.claude/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Deleted/archived code
+_deleted/
+
+# Local SQLite store
+*.db
+*.sqlite

easypaperless-0.1.0/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [Unreleased]

easypaperless-0.1.0/CLAUDE.md

@@ -0,0 +1,121 @@
+# Paperless API Wrapper Project
+> A Python project template with an AI-powered development workflow using specialized skills for Requirements, Architecture, API Design, Development, QA, and Deployment.
+
+## Tech Stack
+- **Language:** Python 3.11+
+- **HTTP client:** `httpx` (async-first)
+- **Data models:** Pydantic v2
+- **Build:** Hatch + hatchling
+- **Linting/formatting:** Ruff
+- **Type checking:** Mypy (strict)
+- **Testing:** pytest + pytest-asyncio + respx
+
+## Project Structure
+```
+src/
+└── easypaperless/
+    ├── __init__.py          # public API: PaperlessClient, SyncPaperlessClient
+    ├── client.py            # async PaperlessClient (composes from async mixins)
+    ├── sync.py              # SyncPaperlessClient (composes from sync mixins)
+    ├── exceptions.py        # custom exception hierarchy
+    ├── models/
+    │   ├── __init__.py
+    │   ├── documents.py
+    │   ├── tags.py
+    │   ├── correspondents.py
+    │   ├── document_types.py
+    │   ├── storage_paths.py
+    │   ├── custom_fields.py
+    │   └── permissions.py
+    └── _internal/
+        ├── http.py          # httpx session, auth, request helpers
+        ├── resolvers.py     # name-to-ID resolution and caching
+        ├── mixins/          # one async mixin per resource group
+        │   ├── __init__.py
+        │   ├── documents.py
+        │   ├── notes.py
+        │   ├── upload.py
+        │   ├── document_bulk.py
+        │   ├── non_document_bulk.py
+        │   ├── tags.py
+        │   ├── correspondents.py
+        │   ├── document_types.py
+        │   ├── storage_paths.py
+        │   └── custom_fields.py
+        └── sync_mixins/     # one sync mixin per resource group (mirrors mixins/)
+            ├── __init__.py
+            ├── documents.py
+            ├── notes.py
+            ├── upload.py
+            ├── document_bulk.py
+            ├── non_document_bulk.py
+            ├── tags.py
+            ├── correspondents.py
+            ├── document_types.py
+            ├── storage_paths.py
+            └── custom_fields.py
+tests/                       # mirrors src/easypaperless/ structure
+features/                    # one spec file per feature (PROJ-X-name.md)
+docs/
+└── PRD.md
+pyproject.toml
+LICENSE
+README.md
+CHANGELOG.md
+```
+
+## Development Workflow
+1. `/requirements` - Create feature spec from idea
+2. `/architecture` - Design structure, interfaces, tech decisions (no code)
+3. `/dev` - general coder. Implement features.
+4. `/qa` - Tests, type-check, lint, edge cases, security audit
+5. `/deploy` - Package, publish (PyPI / internal), release checklist
+
+## Key Conventions
+- **Feature IDs:** PROJ-1, PROJ-2, etc. (sequential)
+- **Commits:** `feat(PROJ-X): description`, `fix(PROJ-X): description`
+- **Single Responsibility:** One feature per spec file; one resource group per mixin file
+- **No private leakage:** `__init__.py` defines exactly what is public
+- **Human-in-the-loop:** All workflows have user approval checkpoints
+- **naming conventions:** @docs/api-conventions.md
+- **File size:** Keep files small and focused. Split any file that grows beyond ~200 lines into logical sub-modules (e.g. per-resource mixins). Prefer many small files over one large file.
+
+## Build & Test Commands
+```bash
+# Activate venv (Windows)
+source venv/Scripts/activate
+
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/
+
+# Run tests with coverage
+pytest tests/ --cov=easypaperless
+
+# Lint + format check
+ruff check .
+ruff format --check .
+
+# Type check
+mypy src/easypaperless/
+
+# Bump version (patch / minor / major)
+hatch version patch
+
+# Build package
+hatch build
+
+# Publish to PyPI
+hatch publish
+
+# Run integration tests (requires live paperless instance + tests/.env)
+pytest tests/integration/ -m integration -v
+```
+
+## Product Context
+@docs/PRD.md
+
+## Feature Overview
+@features/INDEX.md

easypaperless-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moritz Grenke
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.

easypaperless-0.1.0/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: easypaperless
+Version: 0.1.0
+Summary: A Python API wrapper for paperless-ngx
+Project-URL: Homepage, https://github.com/TastyMojito/easypaperless
+Project-URL: Repository, https://github.com/TastyMojito/easypaperless
+Project-URL: Issues, https://github.com/TastyMojito/easypaperless/issues
+Author-email: Moritz Grenke <info@360mix.de>
+License: MIT
+License-File: LICENSE
+Keywords: api,document management,paperless,paperless-ngx,wrapper
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: python-dotenv>=1.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: pdoc>=14; extra == 'docs'
+Provides-Extra: scripts
+Requires-Dist: python-dotenv>=1.0; extra == 'scripts'
+Description-Content-Type: text/markdown
+
+# easypaperless 
+
+[![PyPI version](https://img.shields.io/pypi/v/easypaperless.svg)](https://pypi.org/project/easypaperless/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**easypaperless** is a high-level easy-to-use Python API wrapper for [Paperless-ngx](https://github.com/paperless-ngx/paperless-ngx). 
+
+Unlike other wrappers that simply mirror REST endpoints, **easypaperless** is designed for humans. It provides a true abstraction layer, allowing you to interact with your document management system using intuitive Python methods and objects. You don't need to understand the underlying REST API to be productive.
+
+---
+
+## ✨ Key Features
+
+* **True Abstraction:** Focus on your logic, not on HTTP methods or JSON payloads.
+* **Developer Experience (DX):** Full Type Hinting support. Your IDE (VS Code, PyCharm, etc.) will provide perfect autocompletion and documentation as you type.
+* **Extensive Coverage:** Covers all essential workflows from document management to complex bulk operations.
+* **Async-First with Sync Support:** Built on top of httpx, easypaperless is fully asynchronous by default for high-performance applications. But it also offers a synchronous wrapper for a classic blocking workflow.
+* **Built-in Bulk Tools:** Easily manage hundreds of tags, correspondents, or documents with single-method calls.
+* **Intuitive Error Hierarchy:** easypaperless provides descriptive, custom exceptions that tell you exactly what went wrong,
+
+---
+
+## 📋 Requirements
+
+* Python: 3.11 or higher
+* Paperless-ngx: 2.18 or higher (only tested with 2.18 so far)
+
+### Core Dependencies: 
+
+* httpx>=0.27 
+* Pydantic>=2.0 
+
+---
+
+## 🚀 Installation
+
+Install the package via pip:
+
+```bash
+
+pip install easypaperless
+
+```
+
+---
+
+## 🛠 Quickstart
+
+Get up and running in seconds. No API deep-dive required.
+
+### async Client
+
+``` Python
+
+from easypaperless import PaperlessClient
+import asyncio
+
+async def main():
+
+    # create a paperless client 
+    # we encourage you to use .env files to store your credentials later
+    async with PaperlessClient(url="http://localhost:8000", api_key="YOUR_TOKEN") as client:
+        # List documents — full-text search across title and OCR content, return the last three added documents
+        docs = await client.list_documents(search="test", max_results=3, ordering="added", descending=True)
+        for doc in docs:
+            print(f"Id: {doc.id} \nTitle: {doc.title} \nadded: {doc.added}\n")
+
+        # Fetch a single document
+        doc = await client.get_document(id=1)
+        print(doc.title, doc.created_date)
+
+        #check if a "API_edited" tag already exists - otherwise create it.
+        tags = await client.list_tags(name_exact="API_edited")
+        if not tags:
+            await client.create_tag(name="API_edited", color = "#40bfb7")
+
+        # Update metadata — string names are resolved to IDs automatically
+        await client.update_document(id=1, tags=["API_edited"])
+
+        # Upload and wait for processing to complete
+        #doc = await client.upload_document("path/scan.pdf", title="your title here", wait=True)
+        #print("Processed:", doc.id)
+
+asyncio.run(main())
+
+```
+
+### sync Client
+
+``` Python
+
+from easypaperless import SyncPaperlessClient
+
+# same example with the sync client:
+# we encourage you to use .env files to store your credentials later
+with SyncPaperlessClient(url="http://localhost:8000", api_key="YOUR_TOKEN") as client:
+    # List documents — full-text search across title and OCR content, return the last three added documents
+    docs = client.list_documents(search="test", max_results=3, ordering="added", descending=True)
+    for doc in docs:
+        print(f"Id: {doc.id} \nTitle: {doc.title} \nadded: {doc.added}\n")
+
+    # Fetch a single document
+    doc = client.get_document(id=1)
+    print(doc.title, doc.created_date)
+
+    #check if a "API_edited" tag already exists - otherwise create it.
+    tags = client.list_tags(name_exact="API_edited")
+    if not tags:
+        client.create_tag(name="API_edited", color = "#40bfb7")
+
+    # Update metadata — string names are resolved to IDs automatically
+    client.update_document(id=1, tags=["API_edited"])
+
+```
+
+## 📖 Functional Overview
+
+### Client
+
+* **PaperlessClient / SyncPaperlessClient** Allows token based authentication. Allows to increase timeout period for slow instances.
+
+### Documents
+
+* **list_documents()** This is the workhorse of the wrapper and allows you to search for documents in your paperless-ngx instance and filter them by several criteria.
+* **get_document()** Fetch a single document's data and optionally include its extended file metadata.
+* **get_document_metadata()** Retrieve file-level technical metadata (checksums, sizes, MIME types) for a specific document.
+* **update_document()** Partially update document fields like title, tags, or dates using PATCH semantics.
+* **delete_document()** Permanently remove a document from your Paperless-ngx instance.
+* **download_document()** Download the binary content of a document, either the archived PDF or the original file.
+* **upload_document()** Upload a new file to Paperless-ngx and optionally wait for the processing task to complete.
+
+### Document Notes
+
+* **get_notes()** Retrieve all text notes attached to a specific document.
+* **create_note()** Add a new text note to an existing document.
+* **delete_note()** Remove a specific note from a document.
+
+### Non-Document Entities
+
+* **list_tags() / get_tag() / create_tag() / update_tag()** Manage document tags, supporting colors and matching algorithms.
+* **list_correspondents() / get_correspondent() / create_correspondent()** Manage document authors, senders, or recipients.
+* **list_document_types() / get_document_type() / create_document_type()** Manage categories like "Invoice," "Letter," or "Contract."
+* **list_storage_paths() / get_storage_path() / create_storage_path()** Manage the physical directory structure where files are stored.
+* **list_custom_fields() / get_custom_field() / create_custom_field()** Manage user-defined metadata fields for advanced document tracking.
+
+### Bulk Operations
+
+* **bulk_edit()** A low-level method to execute arbitrary batch operations on a list of document IDs. It is recommended to use the high level methods below.
+* **bulk_add_tag()** Add a single tag to a collection of documents in one request.
+* **bulk_remove_tag()** Strip a specific tag from multiple documents simultaneously.
+* **bulk_modify_tags()** Atomically add and remove multiple tags across a set of documents.
+* **bulk_delete()** Permanently delete a list of documents in a single batch.
+* **bulk_set_correspondent()** Assign or clear the correspondent for multiple documents at once.
+* **bulk_set_document_type()** Change the document type for a group of documents in one go.
+* **bulk_set_storage_path()** Update the storage path for multiple documents simultaneously.
+* **bulk_modify_custom_fields()** Batch update or remove custom field values across multiple documents.
+* **bulk_set_permissions()** Manage ownership and access permissions for a list of documents.
+
+### Bulk Operations (Non-Documents)
+
+* **bulk_edit_objects()** A low level method to execute batch operations on system objects like tags or correspondents. It is recommended to use the high level methods below.
+* **bulk_delete_tags() / bulk_delete_correspondents() / bulk_delete_document_types() / bulk_delete_storage_paths()** Batch delete various entity types to clean up your metadata.
+* **bulk_set_permissions_tags() / _correspondents() / _document_types() / _storage_paths()** Batch update access control and ownership for specific metadata entities.
+
+
+## 📚 Documentation
+
+See the 👉 [Full API Reference (pdoc)](https://tastymojito.github.io/easypaperless/)
+
+## 🤝 Contributing
+
+Contributions are welcome! If you find a bug or have a feature request, please open an issue or submit a pull request.
+
+## 📄 License
+
+This project is licensed under the MIT License.
+
+

easypaperless-0.1.0/README.md

@@ -0,0 +1,178 @@
+# easypaperless 
+
+[![PyPI version](https://img.shields.io/pypi/v/easypaperless.svg)](https://pypi.org/project/easypaperless/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**easypaperless** is a high-level easy-to-use Python API wrapper for [Paperless-ngx](https://github.com/paperless-ngx/paperless-ngx). 
+
+Unlike other wrappers that simply mirror REST endpoints, **easypaperless** is designed for humans. It provides a true abstraction layer, allowing you to interact with your document management system using intuitive Python methods and objects. You don't need to understand the underlying REST API to be productive.
+
+---
+
+## ✨ Key Features
+
+* **True Abstraction:** Focus on your logic, not on HTTP methods or JSON payloads.
+* **Developer Experience (DX):** Full Type Hinting support. Your IDE (VS Code, PyCharm, etc.) will provide perfect autocompletion and documentation as you type.
+* **Extensive Coverage:** Covers all essential workflows from document management to complex bulk operations.
+* **Async-First with Sync Support:** Built on top of httpx, easypaperless is fully asynchronous by default for high-performance applications. But it also offers a synchronous wrapper for a classic blocking workflow.
+* **Built-in Bulk Tools:** Easily manage hundreds of tags, correspondents, or documents with single-method calls.
+* **Intuitive Error Hierarchy:** easypaperless provides descriptive, custom exceptions that tell you exactly what went wrong,
+
+---
+
+## 📋 Requirements
+
+* Python: 3.11 or higher
+* Paperless-ngx: 2.18 or higher (only tested with 2.18 so far)
+
+### Core Dependencies: 
+
+* httpx>=0.27 
+* Pydantic>=2.0 
+
+---
+
+## 🚀 Installation
+
+Install the package via pip:
+
+```bash
+
+pip install easypaperless
+
+```
+
+---
+
+## 🛠 Quickstart
+
+Get up and running in seconds. No API deep-dive required.
+
+### async Client
+
+``` Python
+
+from easypaperless import PaperlessClient
+import asyncio
+
+async def main():
+
+    # create a paperless client 
+    # we encourage you to use .env files to store your credentials later
+    async with PaperlessClient(url="http://localhost:8000", api_key="YOUR_TOKEN") as client:
+        # List documents — full-text search across title and OCR content, return the last three added documents
+        docs = await client.list_documents(search="test", max_results=3, ordering="added", descending=True)
+        for doc in docs:
+            print(f"Id: {doc.id} \nTitle: {doc.title} \nadded: {doc.added}\n")
+
+        # Fetch a single document
+        doc = await client.get_document(id=1)
+        print(doc.title, doc.created_date)
+
+        #check if a "API_edited" tag already exists - otherwise create it.
+        tags = await client.list_tags(name_exact="API_edited")
+        if not tags:
+            await client.create_tag(name="API_edited", color = "#40bfb7")
+
+        # Update metadata — string names are resolved to IDs automatically
+        await client.update_document(id=1, tags=["API_edited"])
+
+        # Upload and wait for processing to complete
+        #doc = await client.upload_document("path/scan.pdf", title="your title here", wait=True)
+        #print("Processed:", doc.id)
+
+asyncio.run(main())
+
+```
+
+### sync Client
+
+``` Python
+
+from easypaperless import SyncPaperlessClient
+
+# same example with the sync client:
+# we encourage you to use .env files to store your credentials later
+with SyncPaperlessClient(url="http://localhost:8000", api_key="YOUR_TOKEN") as client:
+    # List documents — full-text search across title and OCR content, return the last three added documents
+    docs = client.list_documents(search="test", max_results=3, ordering="added", descending=True)
+    for doc in docs:
+        print(f"Id: {doc.id} \nTitle: {doc.title} \nadded: {doc.added}\n")
+
+    # Fetch a single document
+    doc = client.get_document(id=1)
+    print(doc.title, doc.created_date)
+
+    #check if a "API_edited" tag already exists - otherwise create it.
+    tags = client.list_tags(name_exact="API_edited")
+    if not tags:
+        client.create_tag(name="API_edited", color = "#40bfb7")
+
+    # Update metadata — string names are resolved to IDs automatically
+    client.update_document(id=1, tags=["API_edited"])
+
+```
+
+## 📖 Functional Overview
+
+### Client
+
+* **PaperlessClient / SyncPaperlessClient** Allows token based authentication. Allows to increase timeout period for slow instances.
+
+### Documents
+
+* **list_documents()** This is the workhorse of the wrapper and allows you to search for documents in your paperless-ngx instance and filter them by several criteria.
+* **get_document()** Fetch a single document's data and optionally include its extended file metadata.
+* **get_document_metadata()** Retrieve file-level technical metadata (checksums, sizes, MIME types) for a specific document.
+* **update_document()** Partially update document fields like title, tags, or dates using PATCH semantics.
+* **delete_document()** Permanently remove a document from your Paperless-ngx instance.
+* **download_document()** Download the binary content of a document, either the archived PDF or the original file.
+* **upload_document()** Upload a new file to Paperless-ngx and optionally wait for the processing task to complete.
+
+### Document Notes
+
+* **get_notes()** Retrieve all text notes attached to a specific document.
+* **create_note()** Add a new text note to an existing document.
+* **delete_note()** Remove a specific note from a document.
+
+### Non-Document Entities
+
+* **list_tags() / get_tag() / create_tag() / update_tag()** Manage document tags, supporting colors and matching algorithms.
+* **list_correspondents() / get_correspondent() / create_correspondent()** Manage document authors, senders, or recipients.
+* **list_document_types() / get_document_type() / create_document_type()** Manage categories like "Invoice," "Letter," or "Contract."
+* **list_storage_paths() / get_storage_path() / create_storage_path()** Manage the physical directory structure where files are stored.
+* **list_custom_fields() / get_custom_field() / create_custom_field()** Manage user-defined metadata fields for advanced document tracking.
+
+### Bulk Operations
+
+* **bulk_edit()** A low-level method to execute arbitrary batch operations on a list of document IDs. It is recommended to use the high level methods below.
+* **bulk_add_tag()** Add a single tag to a collection of documents in one request.
+* **bulk_remove_tag()** Strip a specific tag from multiple documents simultaneously.
+* **bulk_modify_tags()** Atomically add and remove multiple tags across a set of documents.
+* **bulk_delete()** Permanently delete a list of documents in a single batch.
+* **bulk_set_correspondent()** Assign or clear the correspondent for multiple documents at once.
+* **bulk_set_document_type()** Change the document type for a group of documents in one go.
+* **bulk_set_storage_path()** Update the storage path for multiple documents simultaneously.
+* **bulk_modify_custom_fields()** Batch update or remove custom field values across multiple documents.
+* **bulk_set_permissions()** Manage ownership and access permissions for a list of documents.
+
+### Bulk Operations (Non-Documents)
+
+* **bulk_edit_objects()** A low level method to execute batch operations on system objects like tags or correspondents. It is recommended to use the high level methods below.
+* **bulk_delete_tags() / bulk_delete_correspondents() / bulk_delete_document_types() / bulk_delete_storage_paths()** Batch delete various entity types to clean up your metadata.
+* **bulk_set_permissions_tags() / _correspondents() / _document_types() / _storage_paths()** Batch update access control and ownership for specific metadata entities.
+
+
+## 📚 Documentation
+
+See the 👉 [Full API Reference (pdoc)](https://tastymojito.github.io/easypaperless/)
+
+## 🤝 Contributing
+
+Contributions are welcome! If you find a bug or have a feature request, please open an issue or submit a pull request.
+
+## 📄 License
+
+This project is licensed under the MIT License.
+
+