Metadata-Version: 2.1
Name: gotipy
Version: 0.1
Summary: A Python wrapper for Gotify
Author-email: Alyetama <56323389+Alyetama@users.noreply.github.com>
Description-Content-Type: text/markdown
Classifier: License :: OSI Approved :: MIT License
Requires-Dist: requests
Project-URL: Home, https://github.comm/Alyetama/gotipy

## Gotipy

A simple Python wrapper for [Gotify](https://github.com/gotify/server)

## Requirements
- [python>=3.6](https://www.python.org/downloads/)
- [gotify/server](https://gotify.net/docs/install)


## Installation

```sh
pip install gotipy
```

## Usage

```py
from gotipy import Gotify

g = Gotify(host_address='https://yourdomain.com')
```

### Create a new application

```py
g.create_app(admin_username='admin',
             admin_password='admin',
             app_name='demo',
             desc='My first app!')
# {
#     'id': 1,
#     'token': 'xxxxxxxxxx',
#     'name': 'demo',
#     'description': 'My first app!',
#     'internal': False,
#     'image': 'static/defaultapp.png'
# }
```

### Push messages to an application

```py
g.push(title='My message',
       message='Hello, World!',
       priority=9,
       token='xxxxxxxxxx')
# {
#     'id': 1,
#     'appid': 1,
#     'message': 'Hello, World!',
#     'title': 'My message',
#     'priority': 9,
#     'date': '2022-05-16T05:25:29.367216435Z'
# }
```


### Notes:

- You can set `GOTIFY_HOST_ADDRESS` as an envionmnt variable instead of passing `host_address` to the class instance.
- If you want to use the same app in all your `push` calls, you can omit `token` from the method, and pass `fixed_token=...` to the class instance or set `GOTIFY_APP_TOKEN` as an envionmnt variable instead.
- If you want to set a fixed priority level for all your `push` calls, pass `fixed_priority` to the class instance.

