Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dnsimple/dnsimple-python
The DNSimple API client for Python.
https://github.com/dnsimple/dnsimple-python
api api-client dnsimple dnsimple-api dnsimple-policy-eng dnsimple-policy-group-apiclient dnsimple-policy-triage-application python
Last synced: 3 months ago
JSON representation
The DNSimple API client for Python.
- Host: GitHub
- URL: https://github.com/dnsimple/dnsimple-python
- Owner: dnsimple
- License: mit
- Created: 2010-10-08T16:53:43.000Z (about 14 years ago)
- Default Branch: main
- Last Pushed: 2024-04-04T12:44:18.000Z (7 months ago)
- Last Synced: 2024-04-14T09:03:49.132Z (7 months ago)
- Topics: api, api-client, dnsimple, dnsimple-api, dnsimple-policy-eng, dnsimple-policy-group-apiclient, dnsimple-policy-triage-application, python
- Language: Python
- Homepage: https://developer.dnsimple.com/
- Size: 627 KB
- Stars: 65
- Watchers: 12
- Forks: 44
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# DNSimple Python Client
A Python client for the [DNSimple API v2](https://developer.dnsimple.com/v2/).
[](https://github.com/dnsimple/dnsimple-python/actions/workflows/ci.yml)
## Documentation
- [dnsimple PyPI](https://pypi.org/project/dnsimple/)
- [DNSimple API documentation](https://developer.dnsimple.com/)
- [DNSimple API examples repository](https://github.com/dnsimple/dnsimple-api-examples)
- [DNSimple support documentation](https://support.dnsimple.com/)
## Requirements
- Python 3.12 - Note later versions of Python may be supported, but we make no guarantees as they are not tracked in our CI.
## Installation
Where `` denotes the version of the client you want to install.
To install the latest version:
```shell
pip install dnsimple
```
To install a specific version:
```shell
pip install dnsimple==2.0.1
```
## Usage
This library is a Python client you can use to interact with the [DNSimple API v2](https://developer.dnsimple.com/v2/). Here are some examples.
```python
from dnsimple import Client
client = Client(access_token='a1b2c3')
# Fetch your details
response = client.identity.whoami() # execute the call
data = response.data # extract the relevant data from the response or
account = client.identity.whoami().data.account # execute the call and get the data in one line
```
### Sandbox Environment
We highly recommend testing against our [sandbox environment](https://developer.dnsimple.com/sandbox/) before using our
production environment. This will allow you to avoid real purchases, live charges on your credit card, and reduce the
chance of your running up against rate limits.
The client supports both the production and sandbox environment. To switch to sandbox pass the sandbox API host using
the `base_url` option when you construct the client:
```python
from dnsimple import Client
client = Client(base_url='https://api.sandbox.dnsimple.com', access_token="a1b2c3")
```
You can also set the sandbox environment like so:
```python
from dnsimple import Client
client = Client(sandbox=True, access_token='a1b2c3')
```
You will need to ensure that you are using an access token created in the sandbox environment.
Production tokens will *not* work in the sandbox environment.
### Define an account ID
```python
from dnsimple import Client
client = Client(access_token='a1b2c3')
account_id = 1010
# You can also fetch it from the whoami response
# as long as you authenticate with an Account access token
whoami = client.identity.whoami().data
account_id = whoami.account.id
```
### List your domains
```python
from dnsimple import Client
client = Client(access_token='a1b2c3')
account_id = client.identity.whoami().data.account.id
domains = client.domains.list_domains(account_id).data # Domains from the 1010 account (first page)
client.domains.list_domains(account_id, sort='expires_on:asc').data # Domains from the 1010 account in ascending order by domain expiration date
client.domains.list_domains(account_id, filter={'name_like': 'example'}).data # Domains from the 1010 account filtered by the domain name name
```
### Create a domain
```python
from dnsimple import Client
client = Client(access_token='a1b2c3')
account_id = client.identity.whoami().data.account.id
response = client.domains.create_domain(account_id, 'example.com')
domain = response.data # The newly created domain
```
### Get a domain
```python
from dnsimple import Client
client = Client(access_token='a1b2c3')
account_id = client.identity.whoami().data.account.id
domain_id = client.domains.list_domains(account_id).data[0].id
domain = client.domains.get_domain(account_id, domain_id).data # The domain you are looking for
```
## Setting a custom `User-Agent` header
You customize the `User-Agent` header for the calls made to the DNSimple API:
```python
from dnsimple import Client
client = Client(user_agent="my-app")
```
The value you provide will be appended to the default `User-Agent` the client uses.
For example, if you use `my-app`, the final header value will be `my-app dnsimple-python/0.1.0` (note that it will vary depending on the client version).
## Contributing
Contibutions are welcomed. Please open an issue to discuss the changes before opening a PR. For more details on how to do development please refer to [CONTRIBUTING.md](CONTRIBUTING.md)
## License
Copyright (c) 2022 DNSimple Corporation. This is Free Software distributed under the MIT license.