Little api client for paperless(-ngx).
Project description
PyPaperless
Little asynchronous client for Paperless-ngx, written in Python. You should at least use Python >=3.12
.
Features
- Depends on aiohttp, works in async environments.
- Token authentication only. No credentials.
- Request single resource items.
- Iterate over all resource items or request them page by page.
- Create, update and delete resource items.
- Add, remove and update custom fields on documents.
- Almost feature complete.
- pypaperless is designed to transport data only. Your code must organize it.
Find out more about Paperless-ngx here:
- Project: https://docs.paperless-ngx.com
- API Docs: https://docs.paperless-ngx.com/api/
- Source Code: https://github.com/paperless-ngx/paperless-ngx
Installation
pip install pypaperless
Documentation
Please check out the docs for detailed instructions and examples.
Compatibility matrix
Choosing the right version of pypaperless for your Paperless-ngx instance can be tricky. This little matrix is here to help.
Paperless-ngx | pypaperless |
---|---|
>= 2.17 | >= 5.0 |
>= 2.16 | >= 4.1 |
>= 2.15 | >= 4.0 |
< 2.15 | < 4.0 |
- pypaperless
<4.0
is not compatible with Paperless-ngx>=2.15
due to breaking server changes. - pypaperless
5.0
implements date changes in the document API and is therefore not compatible with Paperless-ngx<2.16
. - pypaperless
>=5.1
will drop support for all Paperless-ngx versions without the Open API schema, introduced in2.15
.
[!TIP] Consider keeping both Paperless-ngx and pypaperless always updated.
Authors & contributors
pypaperless is written by Tobias Schulz. Its his first Python project. Feedback appreciated.
Check out all contributors here.
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
File details
Details for the file pypaperless-5.0.0.tar.gz
.
File metadata
- Download URL: pypaperless-5.0.0.tar.gz
- Upload date:
- Size: 121.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
0fd1ebbb8e23b89874cdb09a734d4e0cd4f18b885c219058a1f279321d0d419b
|
|
MD5 |
e56de830a3399d6d838280672ffff8c2
|
|
BLAKE2b-256 |
f4af226b93d7bba25fd5890a34903d91206a031c8c185f679a35a2a3ef642e2c
|
Provenance
The following attestation bundles were made for pypaperless-5.0.0.tar.gz
:
Publisher:
release.yml
on tb1337/paperless-api
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1
-
Predicate type:
https://docs.pypi.org/attestations/publish/v1
-
Subject name:
pypaperless-5.0.0.tar.gz
-
Subject digest:
0fd1ebbb8e23b89874cdb09a734d4e0cd4f18b885c219058a1f279321d0d419b
- Sigstore transparency entry: 272803688
- Sigstore integration time:
-
Permalink:
tb1337/paperless-api@b93c6020e997677312c944aecd764d1d2a42570b
-
Branch / Tag:
refs/tags/v5.0.0
- Owner: https://github.com/tb1337
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com
-
Runner Environment:
github-hosted
-
Publication workflow:
release.yml@b93c6020e997677312c944aecd764d1d2a42570b
-
Trigger Event:
release
-
Statement type:
File details
Details for the file pypaperless-5.0.0-py3-none-any.whl
.
File metadata
- Download URL: pypaperless-5.0.0-py3-none-any.whl
- Upload date:
- Size: 45.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
b93c2ddfeb0150c7dddbd986487fb5be6f2bd36e22e7efb4f1d5b58928ec976c
|
|
MD5 |
b21558b6223cc516257637775f566272
|
|
BLAKE2b-256 |
4a4377082842c1aa17703b32dbbd3d2f3ee384b1821b2352b36877e14081158f
|
Provenance
The following attestation bundles were made for pypaperless-5.0.0-py3-none-any.whl
:
Publisher:
release.yml
on tb1337/paperless-api
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1
-
Predicate type:
https://docs.pypi.org/attestations/publish/v1
-
Subject name:
pypaperless-5.0.0-py3-none-any.whl
-
Subject digest:
b93c2ddfeb0150c7dddbd986487fb5be6f2bd36e22e7efb4f1d5b58928ec976c
- Sigstore transparency entry: 272803690
- Sigstore integration time:
-
Permalink:
tb1337/paperless-api@b93c6020e997677312c944aecd764d1d2a42570b
-
Branch / Tag:
refs/tags/v5.0.0
- Owner: https://github.com/tb1337
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com
-
Runner Environment:
github-hosted
-
Publication workflow:
release.yml@b93c6020e997677312c944aecd764d1d2a42570b
-
Trigger Event:
release
-
Statement type: