Metadata-Version: 2.0
Name: ozholiday
Version: 0.1.1
Summary: A simple function to check if a given date a public holiday in Australia
Home-page: https://github.com/zhongdai/ozholiday
Author: Zhong Dai
Author-email: zhongdai.au@gmail.com
License: BSD license
Keywords: ozholiday
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6

# OZ Holiday

A simple function to check a given date a public holiday or not in Australia, really easy to use.

- Use the data from [data.gov.au](https://data.gov.au/dataset/australian-holidays-machine-readable-dataset)
- Only use Python standard libraries
- Only one function - keep it simple

## Installation
```bash
pip install ozholiday
```

Or

```bash
git clone https://github.com/zhongdai/ozholiday.git
cd ozholiday
python setup.py install
```

## Usage
```python
In [1]: from ozholiday import isholiday

In [2]: isholiday('20170101')
Out[2]: True

In [3]: isholiday('20170101',detail=True)
Out[3]:
{'Applicable To': 'NAT',
 'Date': '20170101',
 'Holiday Name': "New Year's Day",
 'Information': "New Year's Day is the first day of the calendar year and is celebrated each January 1st",
 'More Information': '',
 '_id': 1}

In [5]: isholiday('20170103')
Out[5]: False

In [9]: isholiday('20190102')
ValueError: The date 20190102 is not in current list published by data.gov.au,
 Check here https://data.gov.au/dataset/australian-holidays-machine-readable-dataset
 ```


=======
History
=======

0.1.0 (2018-03-02)
------------------

* First release on PyPI.


