Metadata-Version: 2.1
Name: PyStaffo
Version: 0.0.dev3
Summary: A Staffomatic API Python wrapper
Home-page: http://github.com/perrydunn/PyStaffo
Author: Peregrine Dunn
Author-email: perrydunn@hotmail.co.uk
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 1 - Planning
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Scheduling
Description-Content-Type: text/markdown
Requires-Dist: pytz
Requires-Dist: requests (>=2.4.2)

# PyStaffo
*PyStaffo* is a Python wrapper library for the Staffomatic/Easypep API that simplifies many common tasks.

## Installation
Either from PyPi:

```
$ pip install PyStaffo
```

Or from GitHub:

```
$ pip install git+https://github.com/perrydunn/PyStaffo
```

## Requirements
* Python 3 except 3.2 (untested on Python 2)
* You need a Staffomatic account! A Staffomatic account includes a sub-domain name, and login details as a username and password.

## Basic Use
```
from pystaffo import staffo

subdomain = '<subdomain>'
username = '<username>'
password = '<password>'

account = staffo.StaffoAccount(subdomain=subdomain, username=username, password=password)

# The locations and departments are cached as attributes of the class instance.
# Return dictionary of {'department_name': department_id, ...}:
account.locations

# Return the information of a particular location:
account.get_location('Westway')
```

## Nuts and Bolts
A ```StaffoAccount()``` instance has various ```GET```, ```PUT``` and ```POST``` API calls expressed as methods: these will be added to. So far there are no ```DELETE``` calls.

Please refer to the ```staffo.py``` for the methods currently available, and feel free to add some more!

### Timezone Handling
PyStaffo handles timezones for you, using the timezone detailed in your account. If there are timezone issues you may need to look "under the hood". Please suggest improvements/alternatives.

### Aknowledgements
- [**Staffomatic API Documentation**](https://github.com/staffomatic/staffomatic-api-documentation)




