Metadata-Version: 2.1
Name: zammadoo
Version: 0.2.0
Summary: an object-oriented REST API client for zammad
Home-page: https://github.com/flashdagger/zammadoo
License: MIT
Keywords: zammad,rest,api
Author: flashdagger
Requires-Python: >=3.8,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Dist: charset-normalizer (>=3.3,<4.0)
Requires-Dist: requests (>=2.31,<3.0)
Project-URL: Documentation, https://zammadoo.readthedocs.io/
Project-URL: Repository, https://github.com/flashdagger/zammadoo.git
Description-Content-Type: text/x-rst

.. image:: https://github.com/flashdagger/zammadoo/assets/17416271/a442afd7-c682-41dd-9de9-4ec7fcc62c06
  :alt: zammadoo logo

========
zammadoo
========

.. image:: https://img.shields.io/badge/python-3.8%2B-blue?logo=python&logoColor=white
   :target: https://python.org/
   :alt: [Python versions]

.. image:: https://img.shields.io/badge/pypi-v0.2.0%20(beta)-orange
   :target: https://pypi.python.org/pypi/zammadoo/
   :alt: PyPI

.. image:: https://img.shields.io/pypi/l/zammadoo.svg
    :target: https://pypi.python.org/pypi/zammadoo/
    :alt: PyPI license

.. image:: https://github.com/flashdagger/zammadoo/actions/workflows/core-tests.yml/badge.svg?event=push
    :target: https://github.com/flashdagger/zammadoo/actions/workflows/core-tests.yml
    :alt: Core Tests

.. image:: https://readthedocs.org/projects/zammadoo/badge/?version=latest
    :target: https://zammadoo.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

.. image:: https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2Fflashdagger%2F1a66c9e88a9e4267f7e0b1d185be98f4%2Fraw
    :target: https://gist.github.com/flashdagger/1a66c9e88a9e4267f7e0b1d185be98f4
    :alt: Coverage

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/ambv/black/
    :alt: Code Style Black


An object-oriented REST API client for the `Zammad helpdesk sytem <https://zammad.org/>`_.

.. note::
    Not to be confused with "Zammadoo" - a registered trademark and social networking app
    for leisure activities.


Find the full documentation under https://zammadoo.readthedocs.io.


Real life examples
------------------

.. code-block:: python

    from zammadoo import Client

    client = Client("https://myhost.com/api/v1/", http_auth=("<username>", "<mysecret>"))
    # or use an API token created via https://myhost.com/#profile/token_access
    client = Client("https://myhost.com/api/v1/", http_token="<token>")

    # I have a new ticket with id 17967 and need to download the attachment file
    path = client.tickets(17967).articles[0].attachments[0].download()
    print(f"The downloaded file is {path}")

    # I need to append a new ticket article with attached files
    client.ticket(17967).create_article("Server down again. See logfiles.", files=["kern.log", "syslog"])

    # I want to close all tickets with the tag "deprecated" and remove the tag
    for ticket in client.tickets.search("tags:deprecated"):
        ticket.update(state="closed")
        ticket.remove_tags("deprecated")


Design principles
-----------------

This library provides a fluent workflow. Since the resources are wrapped in its own type,
your IDE can show you many of the available properties and methods. Furthermore you can ensure
type safety with Python's static type checkers like `mypy <https://www.mypy-lang.org/>`_.

.. image:: https://github.com/flashdagger/zammadoo/assets/17416271/aa81ab7c-1d57-4dac-82d8-7b5fdc5e8699
  :alt: zammadoo typing

