Metadata-Version: 2.1
Name: domeneshop-bots
Version: 0.0.2
Summary: Bot for domeneshop.no to keep your dns records updated with correct ip for your self hosting sites and services
Home-page: https://github.com/larsensolutions/domeneshop-bots
Author: Erik Larsen
Author-email: eriklarsen.post@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: jsonschema
Requires-Dist: schedule
Requires-Dist: domeneshop

# Domeneshop.no DNS boot
Bot for users of domeneshop.no. Keep your dns records updated with public ip for your self hosted sites and services.

**Only IP will be updated by the bot; record type, ttl and hostname will remain the same**

* Built upon [domeneshop.no's own python API](https://github.com/domeneshop/python-domeneshop). 
* Using https://api.ipify.org to get the public IP

# Installation
```
pip3 install domeneshop-bots
```

## Usage

See the documentation at https://api.domeneshop.no/docs/ for help on how to acquire your API credentials.

### 1. Fill inn API credentials and domains to track
```json
{
   "api":{
      "token":"<your-domeneshop.no-token>",
      "secret":"<your-domeneshop.no-secret>"
  },
  "track": [
    {
      "domain": "yourdomainA.com",
      "hosts": ["subdomainA", "subdomainB", "subdomainC"]
    },
    { "domain": "yourdomainB.com", 
      "hosts": ["@", "www"] 
    },
    { "domain": "yourdomainC.com", 
      "hosts": ["@", "www", "subdomain"] 
    }
  ]
}
```
#### Hostname defaults
* "@" -> https://domain.com : domeneshop.no uses '@' to indicate root domain
* "www" -> https://www.domain.com : in case you have added a 'www' dns to root domain as well

* "subdomain" -> https://subdomain.domain.com : only subdomain should be specified

### 2. Fire the bot up, example loading json from file
```python
import json
from domeneshop_bots import DNSBot


if __name__ == "__main__":
    with open("./config.json", 'r') as file:
        config = json.loads(file.read())
        bot = DNSBot(config)
        bot.start()

```
### 3. Set up a cron job, and you are done!

Or not. In any case you know what to do!

## Authors

* **Erik Larsen** - [Grizzlyfrog](https://grizzlyfrog.com)

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details

## Acknowledgments

Thanks to [domeneshop.no](https://domenesho.no) for creating an API!!

