Metadata-Version: 2.1
Name: python-zilore
Version: 0.0.3
Summary: Zilore DNS API Wrapper
Home-page: https://github.com/clyang/python-zilore
Author: clyang
Author-email: clyang@clyang.net
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Internet :: WWW/HTTP
Description-Content-Type: text/markdown
Requires-Dist: requests

# python-zilore
[Zilore DNS](https://zilore.com/en/dns) API Python Wrapper. Currently it supports the following functionalities:

## Installaion
The easiest way to install `python-zilore` and get updates is by using `pip`

```bash
$ pip install python-zilore
```

## Test installation
You can test your install by using following steps:

1. Log into Zilore DNS management console via Browser
2. Get your own API key in `Setting` page
3. Test if your API key is working with the following Python code

	```python
	import ziloreapi

	zdns = ziloreapi.Api('YOUR_API_KEY')
	result = zdns.test_login()
	print(result)
	```

4. Once you see `True` on console, you're all set and ready to rock 'n' roll.

## Usage
It's simple to use the library to interact witgh Zilore DNS.

* Creating a `doamin` called `example.com`

	```python
	import ziloreapi

	zdns = ziloreapi.Api('YOUR_API_KEY')
	result = zdns.add_domain('example.com')
	print(result)
	```

* Creating an A record called `test.example.com` with `TTL = 600 seconds` and point it to `10.0.0.1`

	```python
	import ziloreapi

	zdns = ziloreapi.Api('YOUR_API_KEY')
	result = zdns.add_record('example.com', 'A', 600,'test', '10.0.0.1')
	print(result)
	```

* Creating a CNAME record called `cname.example.com` with `TTL = 300 seconds` and point it to `www.google.com`

	```python
	import ziloreapi

	zdns = ziloreapi.Api('YOUR_API_KEY')
	result = zdns.add_record('example.com', 'CNAME', 300,'cname', 'www.google.com')
	print(result)
	```



* Changing A record `test.example.com` value. Set TTL to 3600 and re-pointing to `192.168.1.1`

	```python
	import ziloreapi

	zdns = ziloreapi.Api('YOUR_API_KEY')
	result = zdns.update_record('csie.io', RECORD_ID, 'A', 3600, 'test', '192.168.1.1')
	print(result)
	```

## Current supported API
Unfortunately, I can only afford for using Personal Plan. Hence, I'm able to implement and test some interesting features such as `Geo Records`.

* DOMAINS
	* list_domains
	* list_tlds
	* list_nameservers
	* list_statistics
	* add_domain
	* delete_domain

* RECORDS
	* list_records
	* list_valid_record_ttl
	* add_record
	* update_record
	* update_record_status
	* delete_record
* SNAPSHOTS
	* list_snapshots
	* list_snapshots_records
	* restore_snapshot

## License
MIT License	



