arxivis-python

Official Python SDK for the Arxivis document store.

Requirements

• Python ≥ 3.9
• httpx (installed automatically)

Installation

pip install arxivis

Or from source:

pip install ./sdk/python

Quick start

Synchronous

from arxivis import ArxivisClient, UploadOptions

with ArxivisClient("http://localhost:8080", "axv_xxxx_yyyy") as client:
    # Upload a file
    record = client.upload(
        open("invoice.pdf", "rb").read(),
        "invoice.pdf",
        UploadOptions(path="/invoices/2024/", tags=["cliente", "enero"]),
    )
    print(f"Stored: {record.id}  ({record.size} bytes)")

    # List files
    result = client.list("/invoices/2024/", limit=20)
    for f in result.files:
        print(f.original_name)

    # Full-text search
    hits = client.search("factura enero")
    for f in hits.files:
        print(f.original_name)

    # Download
    data = client.download(record.id)
    open("copy.pdf", "wb").write(data)

    # Delete
    client.delete(record.id)

Asynchronous

import asyncio
from arxivis import AsyncArxivisClient, UploadOptions

async def main():
    async with AsyncArxivisClient("http://localhost:8080", "axv_xxxx_yyyy") as client:
        stats = await client.get_stats()
        print(f"Total files: {stats.total_files}")

        record = await client.upload(
            open("doc.pdf", "rb").read(),
            "doc.pdf",
            UploadOptions(path="/docs/"),
        )
        print(record.id)

asyncio.run(main())

Upload from disk

record = client.upload_file("/path/to/file.pdf", UploadOptions(path="/docs/"))

API reference

ArxivisClient / AsyncArxivisClient

Both classes expose identical methods; async versions are prefixed with await.

UploadOptions

from arxivis import UploadOptions

opts = UploadOptions(
    path="/invoices/2024/",   # virtual folder (default "/")
    tags=["cliente", "ene"],  # list of tags (default [])
    compress=True,            # override server default (default None)
    encrypt=True,             # override server default (default None)
)

ArxivisError

from arxivis import ArxivisError

try:
    client.get("nonexistent-id")
except ArxivisError as e:
    print(e.status)           # HTTP status code
    print(e.is_not_found)     # True if 404
    print(e.is_unauthorized)  # True if 401
    print(e.is_rate_limited)  # True if 429

License

MIT