## Gandi v5 API provider for octoDNS
An [octoDNS](https://github.com/octodns/octodns/) provider that targets [Gandi](https://docs.gandi.net/en/domain_names/common_operations/dns_records.html).
### Installation
#### Command line
```
pip install octodns-gandi
```
#### requirements.txt/setup.py
Pinning specific versions or SHAs is recommended to avoid unplanned upgrades.
##### Versions
```
# Start with the latest versions and don't just copy what's here
octodns==0.9.14
octodns-gandi==0.0.1
```
##### SHAs
```
# Start with the latest/specific versions and don't just copy what's here
-e git+https://git@github.com/octodns/octodns.git@9da19749e28f68407a1c246dfdf65663cdc1c422#egg=octodns
-e git+https://git@github.com/octodns/octodns-gandi.git@ec9661f8b335241ae4746eea467a8509205e6a30#egg=octodns_gandi
```
### Configuration
```yaml
providers:
gandi:
class: octodns_gandi.GandiProvider
# Your personal access token (required)
token: env/GANDI_TOKEN
```
The minimum permissions your Personal Access Token must have are
* See and renew domain names
* Manage domain name technical configurations
### Support Information
#### Records
GandiProvider suports AAAA, ALIAS, CAA, CNAME, DNAME, MX, NS, PTR, SPF, SRV, SSHFP, TLSA, and TXT
#### Dynamic
GandiProvider does not support dynamic records.
### Development
See the [/script/](/script/) directory for some tools to help with the development process. They generally follow the [Script to rule them all](https://github.com/github/scripts-to-rule-them-all) pattern. Most useful is `./script/bootstrap` which will create a venv and install both the runtime and development related requirements. It will also hook up a pre-commit hook that covers most of what's run by CI.
Raw data
{
"_id": null,
"home_page": "https://github.com/octodns/octodns-gandi",
"name": "octodns-gandi",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "",
"author": "Ross McFarland",
"author_email": "rwmcfa1@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ac/44/e64068acaf67b4183e2b7adcbbbda33604d0add4535e025b088b28d754ec/octodns-gandi-0.0.3.tar.gz",
"platform": null,
"description": "## Gandi v5 API provider for octoDNS\n\nAn [octoDNS](https://github.com/octodns/octodns/) provider that targets [Gandi](https://docs.gandi.net/en/domain_names/common_operations/dns_records.html).\n\n### Installation\n\n#### Command line\n\n```\npip install octodns-gandi\n```\n\n#### requirements.txt/setup.py\n\nPinning specific versions or SHAs is recommended to avoid unplanned upgrades.\n\n##### Versions\n\n```\n# Start with the latest versions and don't just copy what's here\noctodns==0.9.14\noctodns-gandi==0.0.1\n```\n\n##### SHAs\n\n```\n# Start with the latest/specific versions and don't just copy what's here\n-e git+https://git@github.com/octodns/octodns.git@9da19749e28f68407a1c246dfdf65663cdc1c422#egg=octodns\n-e git+https://git@github.com/octodns/octodns-gandi.git@ec9661f8b335241ae4746eea467a8509205e6a30#egg=octodns_gandi\n```\n\n### Configuration\n\n```yaml\nproviders:\n gandi:\n class: octodns_gandi.GandiProvider\n # Your personal access token (required)\n token: env/GANDI_TOKEN\n```\n\nThe minimum permissions your Personal Access Token must have are\n\n* See and renew domain names\n* Manage domain name technical configurations\n\n### Support Information\n\n#### Records\n\nGandiProvider suports AAAA, ALIAS, CAA, CNAME, DNAME, MX, NS, PTR, SPF, SRV, SSHFP, TLSA, and TXT\n\n#### Dynamic\n\nGandiProvider does not support dynamic records.\n\n### Development\n\nSee the [/script/](/script/) directory for some tools to help with the development process. They generally follow the [Script to rule them all](https://github.com/github/scripts-to-rule-them-all) pattern. Most useful is `./script/bootstrap` which will create a venv and install both the runtime and development related requirements. It will also hook up a pre-commit hook that covers most of what's run by CI.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Gandi v5 API provider for octoDNS",
"version": "0.0.3",
"project_urls": {
"Homepage": "https://github.com/octodns/octodns-gandi"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "503b59b744b16d1f14554676622d0e973a669a7a912f7e534ddd349c3499f247",
"md5": "c1372e36cd987db877940acea94547f0",
"sha256": "c78864749ae992d98e54abc608fd5d71a31099a9b967cac1c938ff54c8ab2f37"
},
"downloads": -1,
"filename": "octodns_gandi-0.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c1372e36cd987db877940acea94547f0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 6043,
"upload_time": "2024-02-19T22:06:41",
"upload_time_iso_8601": "2024-02-19T22:06:41.815224Z",
"url": "https://files.pythonhosted.org/packages/50/3b/59b744b16d1f14554676622d0e973a669a7a912f7e534ddd349c3499f247/octodns_gandi-0.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ac44e64068acaf67b4183e2b7adcbbbda33604d0add4535e025b088b28d754ec",
"md5": "560f9cf25784cc89ff5be568c54b0a71",
"sha256": "781e9b7e87bf52af4ed2a25cef213a9fda5e1d5551bedc107a1dd3213cd3ece9"
},
"downloads": -1,
"filename": "octodns-gandi-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "560f9cf25784cc89ff5be568c54b0a71",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 9285,
"upload_time": "2024-02-19T22:06:45",
"upload_time_iso_8601": "2024-02-19T22:06:45.670778Z",
"url": "https://files.pythonhosted.org/packages/ac/44/e64068acaf67b4183e2b7adcbbbda33604d0add4535e025b088b28d754ec/octodns-gandi-0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-19 22:06:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "octodns",
"github_project": "octodns-gandi",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "octodns-gandi"
}
JSON
