pyznuny 0.0.16

A Python client for interacting with the Znuny ticketing system API.

pyznuny

A Python client for interacting with the Znuny ticketing system API.

Features

• Simple, typed client built on httpx
• Ticket create, update, and get routes
• Easy custom endpoint configuration

Installation

pip install pyznuny

Or with uv:

uv add pyznuny

Documentation

For a complete API Reference and guide on how to use pyznuny, please visit our documentation

Quick start

Create a client and authenticate using environment variables.

from pyznuny import TicketClient
from dotenv import load_dotenv
import os

load_dotenv()

client = TicketClient(
    base_url=os.getenv("HOST"),
    username=os.getenv("USER_LOGIN"),
    password=os.getenv("PASSWORD"),
)

Example .env:

HOST=https://your-znuny-instance.com
USER_LOGIN=your-username
PASSWORD=your-password

Usage examples

Create a ticket

payload = {
    "Ticket": {
        "Title": "Ticket Title",
        "Queue": "Ticket queue",
        "State": "Ticket state",
        "Priority": "Ticket priority",
        "CustomerUser": "[e-mail]",
    },
    "Article": {
        "Subject": "Ticket subject",
        "Body": "Ticket body...",
        "ContentType": "text/plain; charset=utf-8",
        "From": "[e-mail]",
    },
}

response = client.ticket.create(payload=payload)
print(response.json())

Get a ticket by ID

# default endpoint is GET /Ticket/{ticket_id}
response = client.ticket.get(ticket_id=1234)
print(response.json())

Update a ticket

response = client.ticket.update(
    ticket_id=1234,
    Ticket={"State": "open"},
)
print(response.json())

Customize endpoints

If your Znuny instance uses different paths, set them with the endpoint setter.

# Example: custom ticket get endpoint and identifier
client.set_endpoint.ticket_get(endpoint="Tickets/{id}", identifier="id")

response = client.ticket.get(ticket_id=1234)

Notes

• When username and password are provided, the client logs in and stores session_id automatically.
• You can pass a pre-configured httpx.Client via client=... if needed.
• You can send payloads as plain dicts using the same attributes shown in the examples.