donazopy 1.0.10__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (161) hide show
  1. donazopy-1.0.10/.gitignore +98 -0
  2. donazopy-1.0.10/.omc/project-memory.json +45 -0
  3. donazopy-1.0.10/.omc/sessions/38641a3e-a0d9-49e5-af0e-cfcdc91f4459.json +8 -0
  4. donazopy-1.0.10/.omc/sessions/4adfdba4-08c5-4b70-b609-17e740b4f798.json +8 -0
  5. donazopy-1.0.10/.omc/sessions/5f3125bd-6391-428b-bfb2-161b90f076e2.json +8 -0
  6. donazopy-1.0.10/.omc/sessions/6d6d70cd-4780-408f-acfc-6cb2d0e99ac4.json +8 -0
  7. donazopy-1.0.10/AGENTS.md +46 -0
  8. donazopy-1.0.10/CHANGELOG.md +117 -0
  9. donazopy-1.0.10/CLAUDE.md +1 -0
  10. donazopy-1.0.10/IDEA.md +32 -0
  11. donazopy-1.0.10/LICENSE +201 -0
  12. donazopy-1.0.10/PKG-INFO +400 -0
  13. donazopy-1.0.10/PLAN.md +97 -0
  14. donazopy-1.0.10/README.md +174 -0
  15. donazopy-1.0.10/TODO.md +72 -0
  16. donazopy-1.0.10/agentdb.rvf +0 -0
  17. donazopy-1.0.10/agentdb.rvf.lock +0 -0
  18. donazopy-1.0.10/build.sh +5 -0
  19. donazopy-1.0.10/docs/404.html +602 -0
  20. donazopy-1.0.10/docs/architecture/index.html +985 -0
  21. donazopy-1.0.10/docs/architecture/index.md +94 -0
  22. donazopy-1.0.10/docs/assets/images/favicon.png +0 -0
  23. donazopy-1.0.10/docs/assets/javascripts/bundle.1a8646e9.min.js +16 -0
  24. donazopy-1.0.10/docs/assets/javascripts/bundle.1a8646e9.min.js.map +7 -0
  25. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.ar.min.js +1 -0
  26. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.da.min.js +18 -0
  27. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.de.min.js +18 -0
  28. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.du.min.js +18 -0
  29. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.el.min.js +1 -0
  30. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.es.min.js +18 -0
  31. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.fi.min.js +18 -0
  32. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.fr.min.js +18 -0
  33. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.he.min.js +1 -0
  34. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.hi.min.js +1 -0
  35. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.hu.min.js +18 -0
  36. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.hy.min.js +1 -0
  37. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.it.min.js +18 -0
  38. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.ja.min.js +1 -0
  39. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.jp.min.js +1 -0
  40. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.kn.min.js +1 -0
  41. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.ko.min.js +1 -0
  42. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.multi.min.js +1 -0
  43. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.nl.min.js +18 -0
  44. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.no.min.js +18 -0
  45. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.pt.min.js +18 -0
  46. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.ro.min.js +18 -0
  47. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.ru.min.js +18 -0
  48. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.sa.min.js +1 -0
  49. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.stemmer.support.min.js +1 -0
  50. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.sv.min.js +18 -0
  51. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.ta.min.js +1 -0
  52. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.te.min.js +1 -0
  53. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.th.min.js +1 -0
  54. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.tr.min.js +18 -0
  55. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.vi.min.js +1 -0
  56. donazopy-1.0.10/docs/assets/javascripts/lunr/min/lunr.zh.min.js +1 -0
  57. donazopy-1.0.10/docs/assets/javascripts/lunr/tinyseg.js +206 -0
  58. donazopy-1.0.10/docs/assets/javascripts/lunr/wordcut.js +6708 -0
  59. donazopy-1.0.10/docs/assets/javascripts/workers/search.2c215733.min.js +42 -0
  60. donazopy-1.0.10/docs/assets/javascripts/workers/search.2c215733.min.js.map +7 -0
  61. donazopy-1.0.10/docs/assets/stylesheets/main.5cda52a2.min.css +1 -0
  62. donazopy-1.0.10/docs/assets/stylesheets/main.5cda52a2.min.css.map +1 -0
  63. donazopy-1.0.10/docs/assets/stylesheets/palette.d7242098.min.css +1 -0
  64. donazopy-1.0.10/docs/assets/stylesheets/palette.d7242098.min.css.map +1 -0
  65. donazopy-1.0.10/docs/changelog/index.html +779 -0
  66. donazopy-1.0.10/docs/changelog/index.md +33 -0
  67. donazopy-1.0.10/docs/cli/index.html +1386 -0
  68. donazopy-1.0.10/docs/cli/index.md +324 -0
  69. donazopy-1.0.10/docs/contributing/index.html +975 -0
  70. donazopy-1.0.10/docs/contributing/index.md +88 -0
  71. donazopy-1.0.10/docs/css/extra.css +28 -0
  72. donazopy-1.0.10/docs/index.html +870 -0
  73. donazopy-1.0.10/docs/index.md +44 -0
  74. donazopy-1.0.10/docs/installation/index.html +870 -0
  75. donazopy-1.0.10/docs/installation/index.md +76 -0
  76. donazopy-1.0.10/docs/llms-full.txt +1244 -0
  77. donazopy-1.0.10/docs/llms.txt +25 -0
  78. donazopy-1.0.10/docs/providers/index.html +1534 -0
  79. donazopy-1.0.10/docs/providers/index.md +207 -0
  80. donazopy-1.0.10/docs/quickstart/index.html +950 -0
  81. donazopy-1.0.10/docs/quickstart/index.md +124 -0
  82. donazopy-1.0.10/docs/search/search_index.json +1 -0
  83. donazopy-1.0.10/docs/sitemap.xml +53 -0
  84. donazopy-1.0.10/docs/sitemap.xml.gz +0 -0
  85. donazopy-1.0.10/docs/targets/index.html +998 -0
  86. donazopy-1.0.10/docs/targets/index.md +97 -0
  87. donazopy-1.0.10/docs/zonefiles/index.html +1103 -0
  88. donazopy-1.0.10/docs/zonefiles/index.md +138 -0
  89. donazopy-1.0.10/docs.sh +40 -0
  90. donazopy-1.0.10/issues/203.md +57 -0
  91. donazopy-1.0.10/mkdocs/mkdocs.yml +109 -0
  92. donazopy-1.0.10/publish.sh +7 -0
  93. donazopy-1.0.10/pyproject.toml +106 -0
  94. donazopy-1.0.10/pyrightconfig.json +6 -0
  95. donazopy-1.0.10/ruvector.db +0 -0
  96. donazopy-1.0.10/spec/00-toc.md +49 -0
  97. donazopy-1.0.10/spec/01.md +24 -0
  98. donazopy-1.0.10/spec/02.md +27 -0
  99. donazopy-1.0.10/spec/03.md +28 -0
  100. donazopy-1.0.10/spec/04.md +27 -0
  101. donazopy-1.0.10/spec/05.md +23 -0
  102. donazopy-1.0.10/spec/06.md +24 -0
  103. donazopy-1.0.10/spec/07.md +23 -0
  104. donazopy-1.0.10/spec/08.md +24 -0
  105. donazopy-1.0.10/spec/09.md +23 -0
  106. donazopy-1.0.10/spec/10.md +23 -0
  107. donazopy-1.0.10/spec/11.md +23 -0
  108. donazopy-1.0.10/spec/12.md +35 -0
  109. donazopy-1.0.10/src/donazopy/__init__.py +11 -0
  110. donazopy-1.0.10/src/donazopy/__main__.py +15 -0
  111. donazopy-1.0.10/src/donazopy/_version.py +24 -0
  112. donazopy-1.0.10/src/donazopy/cli.py +305 -0
  113. donazopy-1.0.10/src/donazopy/models.py +29 -0
  114. donazopy-1.0.10/src/donazopy/providers/__init__.py +6 -0
  115. donazopy-1.0.10/src/donazopy/providers/aws.py +12 -0
  116. donazopy-1.0.10/src/donazopy/providers/azure.py +12 -0
  117. donazopy-1.0.10/src/donazopy/providers/base.py +211 -0
  118. donazopy-1.0.10/src/donazopy/providers/bluehost.py +12 -0
  119. donazopy-1.0.10/src/donazopy/providers/cloudflare.py +231 -0
  120. donazopy-1.0.10/src/donazopy/providers/digitalocean.py +12 -0
  121. donazopy-1.0.10/src/donazopy/providers/dnsimple.py +12 -0
  122. donazopy-1.0.10/src/donazopy/providers/dynadot.py +14 -0
  123. donazopy-1.0.10/src/donazopy/providers/gandi.py +14 -0
  124. donazopy-1.0.10/src/donazopy/providers/godaddy.py +205 -0
  125. donazopy-1.0.10/src/donazopy/providers/google_cloud.py +12 -0
  126. donazopy-1.0.10/src/donazopy/providers/hetzner.py +12 -0
  127. donazopy-1.0.10/src/donazopy/providers/hosting_com.py +12 -0
  128. donazopy-1.0.10/src/donazopy/providers/hostinger.py +12 -0
  129. donazopy-1.0.10/src/donazopy/providers/ionos.py +209 -0
  130. donazopy-1.0.10/src/donazopy/providers/joker.py +215 -0
  131. donazopy-1.0.10/src/donazopy/providers/linode.py +12 -0
  132. donazopy-1.0.10/src/donazopy/providers/namecheap.py +12 -0
  133. donazopy-1.0.10/src/donazopy/providers/porkbun.py +14 -0
  134. donazopy-1.0.10/src/donazopy/providers/registry.py +66 -0
  135. donazopy-1.0.10/src/donazopy/providers/vercel.py +12 -0
  136. donazopy-1.0.10/src/donazopy/providers/vultr.py +14 -0
  137. donazopy-1.0.10/src/donazopy/target.py +238 -0
  138. donazopy-1.0.10/src/donazopy/zonefile.py +406 -0
  139. donazopy-1.0.10/src_docs/_partials/.gitkeep +0 -0
  140. donazopy-1.0.10/src_docs/md/architecture.md +137 -0
  141. donazopy-1.0.10/src_docs/md/changelog.md +57 -0
  142. donazopy-1.0.10/src_docs/md/cli.md +373 -0
  143. donazopy-1.0.10/src_docs/md/contributing.md +127 -0
  144. donazopy-1.0.10/src_docs/md/css/extra.css +28 -0
  145. donazopy-1.0.10/src_docs/md/index.md +74 -0
  146. donazopy-1.0.10/src_docs/md/installation.md +92 -0
  147. donazopy-1.0.10/src_docs/md/providers.md +281 -0
  148. donazopy-1.0.10/src_docs/md/quickstart.md +147 -0
  149. donazopy-1.0.10/src_docs/md/targets.md +127 -0
  150. donazopy-1.0.10/src_docs/md/zonefiles.md +182 -0
  151. donazopy-1.0.10/tests/test_cli.py +319 -0
  152. donazopy-1.0.10/tests/test_cloudflare_provider.py +235 -0
  153. donazopy-1.0.10/tests/test_godaddy_provider.py +168 -0
  154. donazopy-1.0.10/tests/test_ionos_provider.py +175 -0
  155. donazopy-1.0.10/tests/test_joker_provider.py +162 -0
  156. donazopy-1.0.10/tests/test_package.py +8 -0
  157. donazopy-1.0.10/tests/test_provider_base.py +57 -0
  158. donazopy-1.0.10/tests/test_registry.py +18 -0
  159. donazopy-1.0.10/tests/test_target.py +158 -0
  160. donazopy-1.0.10/tests/test_zonefile.py +121 -0
  161. donazopy-1.0.10/uv.lock +807 -0
@@ -0,0 +1,98 @@
1
+ __marimo__/
2
+ __pycache__/
3
+ __pypackages__/
4
+ __version__.py
5
+ _version.py
6
+ .abstra/
7
+ .cache
8
+ .coverage
9
+ .coverage.*
10
+ .dmypy.json
11
+ .DS_Store
12
+ .eggs/
13
+ .env
14
+ .envrc
15
+ .hypothesis/
16
+ .installed.cfg
17
+ .ipynb_checkpoints
18
+ .mypy_cache/
19
+ .nox/
20
+ .pdm-build/
21
+ .pdm-python
22
+ .pixi
23
+ .pybuilder/
24
+ .pypirc
25
+ .pyre/
26
+ .pytest_cache/
27
+ .Python
28
+ .pytype/
29
+ .ropeproject
30
+ .ruff_cache/
31
+ .scrapy
32
+ .spyderproject
33
+ .spyproject
34
+ .streamlit/secrets.toml
35
+ .tox/
36
+ .venv
37
+ .webassets-cache
38
+ *.aof
39
+ *.cover
40
+ *.egg
41
+ *.egg-info/
42
+ *.log
43
+ *.manifest
44
+ *.mo
45
+ *.pid
46
+ *.pot
47
+ *.py.cover
48
+ *.py[codz]
49
+ *.rdb
50
+ *.sage.py
51
+ *.so
52
+ *.spec
53
+ *$py.class
54
+ /site
55
+ activemq-data/
56
+ build/
57
+ celerybeat-schedule
58
+ celerybeat.pid
59
+ cover/
60
+ coverage.xml
61
+ cython_debug/
62
+ db.sqlite3
63
+ db.sqlite3-journal
64
+ develop-eggs/
65
+ dist/
66
+ dmypy.json
67
+ docs/_build/
68
+ downloads/
69
+ eggs/
70
+ env.bak/
71
+ env/
72
+ ENV/
73
+ htmlcov/
74
+ instance/
75
+ ipython_config.py
76
+ lib/
77
+ lib64/
78
+ local_settings.py
79
+ MANIFEST
80
+ marimo/_lsp/
81
+ marimo/_static/
82
+ mnesia/
83
+ nosetests.xml
84
+ parts/
85
+ pip-delete-this-directory.txt
86
+ pip-log.txt
87
+ private/
88
+ profile_default/
89
+ rabbitmq-data/
90
+ rabbitmq/
91
+ sdist/
92
+ share/python-wheels/
93
+ target/
94
+ tempCodeRunnerFile.py
95
+ var/
96
+ venv.bak/
97
+ venv/
98
+ wheels/
@@ -0,0 +1,45 @@
1
+ {
2
+ "version": "1.0.0",
3
+ "lastScanned": 1778605291616,
4
+ "projectRoot": "/Users/adam/Developer/vcs3/github.twardoch/pub/donazopy",
5
+ "techStack": {
6
+ "languages": [],
7
+ "frameworks": [],
8
+ "packageManager": null,
9
+ "runtime": null
10
+ },
11
+ "build": {
12
+ "buildCommand": null,
13
+ "testCommand": null,
14
+ "lintCommand": null,
15
+ "devCommand": null,
16
+ "scripts": {}
17
+ },
18
+ "conventions": {
19
+ "namingStyle": null,
20
+ "importStyle": null,
21
+ "testPattern": null,
22
+ "fileOrganization": null
23
+ },
24
+ "structure": {
25
+ "isMonorepo": false,
26
+ "workspaces": [],
27
+ "mainDirectories": [],
28
+ "gitBranches": {
29
+ "defaultBranch": "main",
30
+ "branchingStrategy": null
31
+ }
32
+ },
33
+ "customNotes": [],
34
+ "directoryMap": {
35
+ "private": {
36
+ "path": "private",
37
+ "purpose": null,
38
+ "fileCount": 0,
39
+ "lastAccessed": 1778605291603,
40
+ "keyFiles": []
41
+ }
42
+ },
43
+ "hotPaths": [],
44
+ "userDirectives": []
45
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "session_id": "38641a3e-a0d9-49e5-af0e-cfcdc91f4459",
3
+ "ended_at": "2026-05-12T17:42:06.320Z",
4
+ "reason": "prompt_input_exit",
5
+ "agents_spawned": 0,
6
+ "agents_completed": 0,
7
+ "modes_used": []
8
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "session_id": "4adfdba4-08c5-4b70-b609-17e740b4f798",
3
+ "ended_at": "2026-05-12T17:02:18.146Z",
4
+ "reason": "prompt_input_exit",
5
+ "agents_spawned": 0,
6
+ "agents_completed": 0,
7
+ "modes_used": []
8
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "session_id": "5f3125bd-6391-428b-bfb2-161b90f076e2",
3
+ "ended_at": "2026-05-12T20:19:29.081Z",
4
+ "reason": "prompt_input_exit",
5
+ "agents_spawned": 3,
6
+ "agents_completed": 3,
7
+ "modes_used": []
8
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "session_id": "6d6d70cd-4780-408f-acfc-6cb2d0e99ac4",
3
+ "ended_at": "2026-05-12T22:21:05.244Z",
4
+ "reason": "other",
5
+ "agents_spawned": 0,
6
+ "agents_completed": 0,
7
+ "modes_used": []
8
+ }
@@ -0,0 +1,46 @@
1
+ # Repository Guidelines
2
+ <!-- this_file: AGENTS.md -->
3
+
4
+ ## Project Structure & Module Organization
5
+
6
+ This repository currently contains the early project definition for `donazopy`, a Python CLI tool for DNS and domain-provider management. Public project notes live in `README.md` and `IDEA.md`; private research material belongs under `private/` and is ignored by git.
7
+
8
+ Expected implementation layout should keep provider integrations isolated:
9
+
10
+ - `src/donazopy/` for application code.
11
+ - `src/donazopy/providers/` for one module per DNS/domain provider, for example `cloudflare.py` or `namecheap.py`.
12
+ - `tests/` for unit and integration tests mirroring `src/`.
13
+ - `spec/` for design specifications when generated from the planning notes.
14
+
15
+ ## Build, Test, and Development Commands
16
+
17
+ The package scaffold is not present yet. Once added, prefer `uv` and Hatch-based workflows:
18
+
19
+ - `uv sync` installs project dependencies from the lockfile.
20
+ - `uvx hatch test` runs the test suite.
21
+ - `./build.sh` should clean and build distributions with `uvx hatch clean` and `uvx hatch build`.
22
+ - `./publish.sh` should clean, update the git-tag-based version, build, then publish with `uv publish`.
23
+
24
+ Do not use bare `pip`; use `uv add <package>` for dependencies.
25
+
26
+ ## Coding Style & Naming Conventions
27
+
28
+ Target Python 3.12+. Use type hints, `pathlib`, dataclasses or Pydantic at I/O boundaries, and concise functions with explicit failure handling. Format with Ruff once configured. Use `snake_case` for modules, functions, and variables; `PascalCase` for classes; and provider modules named after providers in lowercase.
29
+
30
+ Every source file should include a `this_file` marker near the top, for example:
31
+
32
+ ```python
33
+ # this_file: src/donazopy/providers/cloudflare.py
34
+ ```
35
+
36
+ ## Testing Guidelines
37
+
38
+ Write tests before implementation where practical. Use `pytest` via Hatch, with test files named `test_<module>.py` and test functions named `test_<function>_when_<condition>_then_<result>`. Cover normal paths, empty input, invalid DNS data, missing credentials, API errors, and provider-specific edge cases.
39
+
40
+ ## Commit & Pull Request Guidelines
41
+
42
+ Git history is minimal (`Initial commit`, `v1.0.0`), so keep future commits short and imperative, for example `Add Cloudflare provider scaffold`. Pull requests should describe the change, list verification commands run, note provider/API assumptions, and link related issues or spec sections. Include CLI output examples when behavior changes.
43
+
44
+ ## Security & Configuration Tips
45
+
46
+ Never commit credentials, `.env`, `.pypirc`, provider tokens, or private research. Keep secrets in local environment variables or ignored config files. DNS-provider API behavior must be checked against official documentation before implementation.
@@ -0,0 +1,117 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format follows Keep a Changelog, and this project uses git-tag-derived semantic versions through `hatch-vcs`.
6
+
7
+ ## [Unreleased]
8
+
9
+ ### Added — operational GoDaddy, IONOS, and Joker provider adapters
10
+
11
+ - `donazopy providers` (and `status`, target notation, every command) now exposes four operational providers: `cloudflare`, `godaddy`, `ionos`, `joker`.
12
+ - `src/donazopy/providers/godaddy.py`: real `GoDaddyProvider` adapter over the GoDaddy API (`api.godaddy.com/v1`, `Authorization: sso-key {key}:{secret}`). Implements `list_zones` (`GET /domains`), `list_records` / `export_zone` (`GET /domains/{d}/records`, folding GoDaddy's separate `MX`/`SRV` priority/weight/port fields back into BIND rdata, synthesizing a SOA since GoDaddy's SOA carries only the primary nameserver), `import_zone` (`PATCH /domains/{d}/records`, never re-sends the GoDaddy-managed SOA), `delete_all_records` (`DELETE /domains/{d}/records/{type}/{name}` per group, keeping apex NS/SOA), `read_nameservers` (`GET /domains/{d}` → `nameServers`), and a real `assign_nameservers` (`PUT /domains/{d}` with `{"nameServers": [...]}`). Credentials: `GODADDY_API_KEY`, `GODADDY_API_SECRET`.
13
+ - `src/donazopy/providers/ionos.py`: real `IonosProvider` adapter over the IONOS DNS API (`api.hosting.ionos.com/dns/v1`, `X-API-Key: {public}.{secret}`). Implements `list_zones`, `list_records`, `export_zone` (BIND text), `import_zone` (POSTs records, never re-sends the IONOS-managed SOA), `delete_all_records`, `read_nameservers` (apex NS records). `assign_nameservers` raises a clear "not supported" error because the IONOS DNS API cannot change registrar delegation. Credentials: `IONOS_API_PUBLIC`, `IONOS_API_SECRET`.
14
+ - `src/donazopy/providers/joker.py`: real `JokerProvider` adapter over the Joker.com DMAPI (`https://dmapi.joker.com/request/`). Opens a session via `login` with `JOKER_API_KEY` → `Auth-Sid`, then implements `list_zones` (`query-domain-list`), `list_records` / `export_zone` / `import_zone` / `delete_all_records` (`dns-zone-get` / `dns-zone-put`, converting between Joker's `<label> <type> <pri> <target> <ttl>` line format and BIND, synthesizing a placeholder SOA on export since Joker manages it), `read_nameservers` (apex NS), and `assign_nameservers` (`domain-modify` with `ns-list`). Credentials: `JOKER_API_KEY` (replaces the previous `JOKER_USERNAME` / `JOKER_PASSWORD` stub).
15
+ - `src/donazopy/zonefile.py`: added `build_bind_zone(origin, records, *, default_ttl, synthetic_nameserver)` — constructs parseable BIND zone text from generic provider record mappings (handles `MX`/`SRV` priority folding, TXT quoting, FQDN normalization for `CNAME`/`NS`/`PTR`/`DNAME`, SOA mname/rname dotting, treats a partial/short SOA as absent, and synthesizes a missing SOA and/or apex NS so the output always round-trips through `parse_zone_text`).
16
+ - `src/donazopy/providers/registry.py`: `GoDaddyProvider`, `IonosProvider`, and `JokerProvider` registered as operational; `create_dns_provider` / `create_registrar_provider` resolve all four providers via a shared `_PROVIDER_FACTORIES` table.
17
+ - Tests: `tests/test_godaddy_provider.py`, `tests/test_ionos_provider.py`, `tests/test_joker_provider.py` (mocked `httpx.MockTransport` coverage of every adapter method, error paths, and BIND round-trips); updated `tests/test_registry.py` and `tests/test_cli.py` for the four-provider list.
18
+ - Docs: `src_docs/md/providers.md` and `src_docs/md/architecture.md` updated (new operational-provider sections, planned-table trimmed) and the `docs/` site rebuilt; `README.md` provider matrix and credentials section updated.
19
+
20
+ ### Added — `domains` command and bulk nameserver reads
21
+
22
+ - `donazopy domains PROVIDER` lists the domains/zones a provider manages. `PROVIDER` may be a provider key (`ionos`) or a target with a wildcard domain (`ionos/*`).
23
+ - `donazopy nameservers PROVIDER/*` now reads nameservers for every domain the provider manages and returns a `{domain: [nameserver, ...]}` map (previously a wildcard domain errored). Assigning nameservers still requires a single concrete domain.
24
+ - The "target must name a single domain" error now points users at `donazopy domains <provider>`.
25
+
26
+ ### Added — zone creation (`create-zone`, `copy --create`)
27
+
28
+ - `DNSHostingProvider` Protocol gained `create_zone(domain)` (idempotent where supported; `ProviderAPIError` otherwise).
29
+ - `CloudflareProvider.create_zone(domain)` → `POST /zones` (idempotent: returns the existing zone on the "already exists" / code 1061 error). The Cloudflare account is taken from `CLOUDFLARE_DNS_ACCOUNT` when set, otherwise auto-detected via `GET /accounts` when the token spans exactly one account; `CLOUDFLARE_DNS_ACCOUNT` is a new *optional* environment variable.
30
+ - `IonosProvider`, `GoDaddyProvider`, `JokerProvider` `create_zone` raise a clear "not supported" error — those providers create the DNS zone implicitly with the domain registration.
31
+ - New `donazopy create-zone TARGET` command.
32
+ - `donazopy copy SOURCE DEST` now creates the destination zone first when it is missing and the provider supports it (default `--create=True`; pass `--create=False` to skip). Destinations whose DNS zone exists implicitly with the domain registration are tolerated — the create step is skipped, not an error. The `copy` result now includes a `"created"` entry alongside `"replaced"`. Cloudflare's `create_zone` checks for the existing zone first, so `copy` between existing Cloudflare zones does not need account-level token permissions.
33
+
34
+ ### Added (issue 203 — unified target notation, CLI restructure, docs site)
35
+
36
+ #### Unified target notation (`src/donazopy/target.py`)
37
+ - Added new module `src/donazopy/target.py` implementing `parse_target`, `resolve_provider_key`, `looks_like_path`, and the frozen `Target` dataclass.
38
+ - Target notation: `[provider/][domain][:record_type][:host_name][:value]`. Each segment defaults to "no filter"; `*` is also accepted as an explicit wildcard.
39
+ - `example.com` resolves to whichever sole operational provider manages it; if there are multiple, the command errors and asks for an explicit `provider/` prefix.
40
+ - `cloudflare/example.com` (and `:*:*:*` variants) selects that domain on that provider.
41
+ - `cloudflare/*` selects all domains on the provider.
42
+ - Trailing `:TYPE:host:value` segments are record-level filters; `*` means no filter on that field.
43
+ - `looks_like_path` distinguishes local zone-file paths from provider targets by extension, prefix, and path-separator heuristics.
44
+
45
+ #### Simplified and renamed CLI command set
46
+ - Added `donazopy status [TARGET] [--dotenv-path]` (replaces `provider` and `provider-status`).
47
+ - Added `donazopy records TARGET [--dotenv-path]` (replaces `provider-records`).
48
+ - Added `donazopy export TARGET [--output] [--overwrite] [--skip-ns] [--skip-types] [--dotenv-path]` (replaces `provider-export-zone`).
49
+ - Added `donazopy import-zone TARGET PATH [--proxied] [--dotenv-path]` (replaces `provider-import-zone`).
50
+ - Added `donazopy nameservers TARGET [NS...] [--dotenv-path]` (replaces `provider-nameservers`; now also accepts new nameservers as positional args to assign them).
51
+ - Added `donazopy diff A B [--origin] [--dotenv-path]` (replaces `zone-diff`; each side may be a local zone-file path or a provider target).
52
+ - Added `donazopy validate PATH [--origin]` (replaces `validate-zone`).
53
+ - Added `donazopy normalize PATH [--origin] [--output] [--overwrite]` (replaces `zone-normalize` / `zone-dump`).
54
+ - Added `donazopy copy SOURCE DEST [--skip-ns] [--skip-types] [--replace] [--dotenv-path]` — new command, copies a zone from one provider target to another, with optional `--skip-ns` / `--skip-types` filtering and `--replace` to wipe destination records first.
55
+
56
+ #### Export / copy filtering
57
+ - `export` and `copy` both accept `--skip-ns` (drop NS records) and `--skip-types=A,AAAA,...` (drop a comma-separated list of record types).
58
+ - `copy --replace` calls `delete_all_records` on the destination domain before importing.
59
+
60
+ #### Cloudflare provider additions
61
+ - Added `list_zones` to enumerate all zones on the account.
62
+ - Added `delete_all_records(domain)` used by `copy --replace` to wipe destination records.
63
+ - Added `assign_nameservers(domain, nameservers)` — raises a clear "not supported" error because the Cloudflare DNS API cannot set registrar delegation; documented as a placeholder for registrar-capable providers.
64
+
65
+ #### Zone-file helpers
66
+ - Added `filter_zone_text(text, origin, skip_ns, skip_types)` to drop NS or given-type records from raw BIND text.
67
+ - Added `filter_records(records, skip_ns, skip_types)` for record-list filtering.
68
+ - Added `records_from_zone_text(text, origin)` for in-memory zone parsing without a file.
69
+
70
+ #### Documentation site
71
+ - Added ProtoDocs (`properdocs`) + MaterialX (`mkdocs-materialx`) documentation site.
72
+ - Source pages in `src_docs/md/`: index, installation, quickstart, cli, targets, providers, zonefiles, architecture, contributing, changelog.
73
+ - MkDocs config at `mkdocs/mkdocs.yml`.
74
+ - Pre-built static output committed to `docs/`.
75
+ - Build and serve via `./docs.sh build` / `./docs.sh serve`.
76
+ - Docs dependencies added to `pyproject.toml` under `[dependency-groups] docs`.
77
+
78
+ ### Changed (issue 203)
79
+ - CLI is now a single unified `Donazopy` Fire class; all commands use the target notation instead of separate provider/zone command namespaces.
80
+ - `diff` now accepts provider targets as well as local zone file paths on either side.
81
+ - README rewritten to document the new command surface, target notation, and documentation site.
82
+
83
+ ### Removed (issue 203 — clean break from old command names)
84
+ - Removed `provider` (show provider info) — replaced by `status`.
85
+ - Removed `provider-status` — replaced by `status`.
86
+ - Removed `provider-records` — replaced by `records`.
87
+ - Removed `provider-export-zone` — replaced by `export`.
88
+ - Removed `provider-import-zone` — replaced by `import-zone`.
89
+ - Removed `provider-nameservers` — replaced by `nameservers`.
90
+ - Removed `validate-zone` — replaced by `validate`.
91
+ - Removed `zone-normalize` / `zone-dump` — replaced by `normalize`.
92
+ - Removed `zone-diff` — replaced by `diff`.
93
+
94
+ ---
95
+
96
+ ### Added (earlier work)
97
+ - Added the initial Hatch/uv Python package scaffold for `donazopy`.
98
+ - Added Fire-based CLI entry points for version, provider listing, provider information, and zone validation.
99
+ - Added Fire-based CLI entry points for zone normalization, zone dump output, and zone diff planning.
100
+ - Added `python-dotenv` support for provider credential loading from discovered or explicit `.env` files, with real environment variables taking precedence.
101
+ - Added redacted provider credential status output that reports presence and source without printing secret values.
102
+ - Added operational Cloudflare DNS support for record listing, BIND zone export, BIND zone import, and assigned nameserver reads.
103
+ - Added zone-file parsing, validation, normalization, deterministic dump, safe output writing, and before/after diff helpers built on `dnspython`.
104
+ - Added the 12-chapter project specification under `spec/`.
105
+ - Added the implementation task list in `TODO.md`.
106
+ - Added build and publish scripts matching the project brief.
107
+ - Added Pyright configuration and tests for package metadata, operational provider registry behavior, CLI metadata, zone validation, zone normalization, zone diffing, dotenv credential redaction, and Cloudflare API operations with mocked HTTP.
108
+
109
+ ### Changed (earlier work)
110
+ - Limited the runtime provider registry to functional operational providers only; Cloudflare is currently the only exposed provider.
111
+ - Expanded the README into a focused user/developer guide covering dotenv credentials, local zone commands, Cloudflare operations, safety behavior, and the functional provider matrix.
112
+ - Corrected package metadata to use the Apache Software License classifier, matching `LICENSE`.
113
+ - Moved verified-solved setup, zone-engine, dotenv credential-loading, Cloudflare-provider, and documentation tasks out of `TODO.md` so it only tracks remaining work.
114
+
115
+ ### Removed (earlier work)
116
+ - Removed provider dry-run plan and adapter-stub surfaces that advertised behavior without performing real provider operations.
117
+ - Removed nonfunctional providers from the runtime provider list until they have real adapters and tests.
@@ -0,0 +1 @@
1
+ AGENTS.md
@@ -0,0 +1,32 @@
1
+
2
+ # donazopy
3
+
4
+ ## Idea
5
+
6
+ Python CLI tool for managing DNS stuff.
7
+
8
+ - Use Fire CLI
9
+ - Add ./build.sh that does `uvx hatch clean` then `uvx hatch build`
10
+ - Add ./publish.sh that does `uvx hatch clean`, `uvx gitnextver`, `uvx hatch build` and then `uv publish`
11
+ - Add __version__.py and _version.py and .DS_Store and other relevant stuff to .gitignore
12
+ - Must use hatch-vcs for git-tag-based semver
13
+
14
+ ## Prep
15
+
16
+ - Analyze ./private/research/
17
+ - Into ./private/ gather (download, clone etc.) materials, Python repos, documentation, API docs etc. from all the relevant parties. I’m interested in Cloudflare, Vercel, AWS, Azure, Google Cloud, Ionos, Joker, GoDaddy, Namecheap, Hosting.com, Hostinger, Bluehost, and some 5-10 most relevant providers.
18
+ - Into ./spec/00-toc.md write a ToC of a 12-chapter spec of the project. Write a TLDR of each chapter there as well.
19
+ - Into ./spec/01.md .. 12.md write the entire spec.
20
+ - Into ./TODO.md write an actionable tasklist for the implementation based on the spec.
21
+ - Remember: each provider needs to be in a separate module
22
+
23
+ ## Planned functionality
24
+
25
+ - parse and edit DNS zone files
26
+ - interact with domain registry services & APIS
27
+ - interact with DNS services & APIs of the providers
28
+ - assign/reassign the nameservers for a given domain
29
+ - dump DNS configs for a domain to a zone file
30
+ - update DNS configs from a zone file
31
+ - perform other DNS-related editing
32
+
@@ -0,0 +1,201 @@
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity authorized by
13
+ the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all
16
+ other entities that control, are controlled by, or are under common
17
+ control with that entity. For the purposes of this definition,
18
+ "control" means (i) the power, direct or indirect, to cause the
19
+ direction or management of such entity, whether by contract or
20
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
+ outstanding shares, or (iii) beneficial ownership of such entity.
22
+
23
+ "You" (or "Your") shall mean an individual or Legal Entity
24
+ exercising permissions granted by this License.
25
+
26
+ "Source" form shall mean the preferred form for making modifications,
27
+ including but not limited to software source code, documentation
28
+ source, and configuration files.
29
+
30
+ "Object" form shall mean any form resulting from mechanical
31
+ transformation or translation of a Source form, including but
32
+ not limited to compiled object code, generated documentation,
33
+ and conversions to other media types.
34
+
35
+ "Work" shall mean the work of authorship, whether in Source or
36
+ Object form, made available under the License, as indicated by a
37
+ copyright notice that is included in or attached to the work
38
+ (an example is provided in the Appendix below).
39
+
40
+ "Derivative Works" shall mean any work, whether in Source or Object
41
+ form, that is based on (or derived from) the Work and for which the
42
+ editorial revisions, annotations, elaborations, or other modifications
43
+ represent, as a whole, an original work of authorship. For the purposes
44
+ of this License, Derivative Works shall not include works that remain
45
+ separable from, or merely link (or bind by name) to the interfaces of,
46
+ the Work and Derivative Works thereof.
47
+
48
+ "Contribution" shall mean any work of authorship, including
49
+ the original version of the Work and any modifications or additions
50
+ to that Work or Derivative Works thereof, that is intentionally
51
+ submitted to Licensor for inclusion in the Work by the copyright owner
52
+ or by an individual or Legal Entity authorized to submit on behalf of
53
+ the copyright owner. For the purposes of this definition, "submitted"
54
+ means any form of electronic, verbal, or written communication sent
55
+ to the Licensor or its representatives, including but not limited to
56
+ communication on electronic mailing lists, source code control systems,
57
+ and issue tracking systems that are managed by, or on behalf of, the
58
+ Licensor for the purpose of discussing and improving the Work, but
59
+ excluding communication that is conspicuously marked or otherwise
60
+ designated in writing by the copyright owner as "Not a Contribution."
61
+
62
+ "Contributor" shall mean Licensor and any individual or Legal Entity
63
+ on behalf of whom a Contribution has been received by Licensor and
64
+ subsequently incorporated within the Work.
65
+
66
+ 2. Grant of Copyright License. Subject to the terms and conditions of
67
+ this License, each Contributor hereby grants to You a perpetual,
68
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
+ copyright license to reproduce, prepare Derivative Works of,
70
+ publicly display, publicly perform, sublicense, and distribute the
71
+ Work and such Derivative Works in Source or Object form.
72
+
73
+ 3. Grant of Patent License. Subject to the terms and conditions of
74
+ this License, each Contributor hereby grants to You a perpetual,
75
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
+ (except as stated in this section) patent license to make, have made,
77
+ use, offer to sell, sell, import, and otherwise transfer the Work,
78
+ where such license applies only to those patent claims licensable
79
+ by such Contributor that are necessarily infringed by their
80
+ Contribution(s) alone or by combination of their Contribution(s)
81
+ with the Work to which such Contribution(s) was submitted. If You
82
+ institute patent litigation against any entity (including a
83
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
84
+ or a Contribution incorporated within the Work constitutes direct
85
+ or contributory patent infringement, then any patent licenses
86
+ granted to You under this License for that Work shall terminate
87
+ as of the date such litigation is filed.
88
+
89
+ 4. Redistribution. You may reproduce and distribute copies of the
90
+ Work or Derivative Works thereof in any medium, with or without
91
+ modifications, and in Source or Object form, provided that You
92
+ meet the following conditions:
93
+
94
+ (a) You must give any other recipients of the Work or
95
+ Derivative Works a copy of this License; and
96
+
97
+ (b) You must cause any modified files to carry prominent notices
98
+ stating that You changed the files; and
99
+
100
+ (c) You must retain, in the Source form of any Derivative Works
101
+ that You distribute, all copyright, patent, trademark, and
102
+ attribution notices from the Source form of the Work,
103
+ excluding those notices that do not pertain to any part of
104
+ the Derivative Works; and
105
+
106
+ (d) If the Work includes a "NOTICE" text file as part of its
107
+ distribution, then any Derivative Works that You distribute must
108
+ include a readable copy of the attribution notices contained
109
+ within such NOTICE file, excluding those notices that do not
110
+ pertain to any part of the Derivative Works, in at least one
111
+ of the following places: within a NOTICE text file distributed
112
+ as part of the Derivative Works; within the Source form or
113
+ documentation, if provided along with the Derivative Works; or,
114
+ within a display generated by the Derivative Works, if and
115
+ wherever such third-party notices normally appear. The contents
116
+ of the NOTICE file are for informational purposes only and
117
+ do not modify the License. You may add Your own attribution
118
+ notices within Derivative Works that You distribute, alongside
119
+ or as an addendum to the NOTICE text from the Work, provided
120
+ that such additional attribution notices cannot be construed
121
+ as modifying the License.
122
+
123
+ You may add Your own copyright statement to Your modifications and
124
+ may provide additional or different license terms and conditions
125
+ for use, reproduction, or distribution of Your modifications, or
126
+ for any such Derivative Works as a whole, provided Your use,
127
+ reproduction, and distribution of the Work otherwise complies with
128
+ the conditions stated in this License.
129
+
130
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
131
+ any Contribution intentionally submitted for inclusion in the Work
132
+ by You to the Licensor shall be under the terms and conditions of
133
+ this License, without any additional terms or conditions.
134
+ Notwithstanding the above, nothing herein shall supersede or modify
135
+ the terms of any separate license agreement you may have executed
136
+ with Licensor regarding such Contributions.
137
+
138
+ 6. Trademarks. This License does not grant permission to use the trade
139
+ names, trademarks, service marks, or product names of the Licensor,
140
+ except as required for reasonable and customary use in describing the
141
+ origin of the Work and reproducing the content of the NOTICE file.
142
+
143
+ 7. Disclaimer of Warranty. Unless required by applicable law or
144
+ agreed to in writing, Licensor provides the Work (and each
145
+ Contributor provides its Contributions) on an "AS IS" BASIS,
146
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
+ implied, including, without limitation, any warranties or conditions
148
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
+ PARTICULAR PURPOSE. You are solely responsible for determining the
150
+ appropriateness of using or redistributing the Work and assume any
151
+ risks associated with Your exercise of permissions under this License.
152
+
153
+ 8. Limitation of Liability. In no event and under no legal theory,
154
+ whether in tort (including negligence), contract, or otherwise,
155
+ unless required by applicable law (such as deliberate and grossly
156
+ negligent acts) or agreed to in writing, shall any Contributor be
157
+ liable to You for damages, including any direct, indirect, special,
158
+ incidental, or consequential damages of any character arising as a
159
+ result of this License or out of the use or inability to use the
160
+ Work (including but not limited to damages for loss of goodwill,
161
+ work stoppage, computer failure or malfunction, or any and all
162
+ other commercial damages or losses), even if such Contributor
163
+ has been advised of the possibility of such damages.
164
+
165
+ 9. Accepting Warranty or Additional Liability. While redistributing
166
+ the Work or Derivative Works thereof, You may choose to offer,
167
+ and charge a fee for, acceptance of support, warranty, indemnity,
168
+ or other liability obligations and/or rights consistent with this
169
+ License. However, in accepting such obligations, You may act only
170
+ on Your own behalf and on Your sole responsibility, not on behalf
171
+ of any other Contributor, and only if You agree to indemnify,
172
+ defend, and hold each Contributor harmless for any liability
173
+ incurred by, or claims asserted against, such Contributor by reason
174
+ of your accepting any such warranty or additional liability.
175
+
176
+ END OF TERMS AND CONDITIONS
177
+
178
+ APPENDIX: How to apply the Apache License to your work.
179
+
180
+ To apply the Apache License to your work, attach the following
181
+ boilerplate notice, with the fields enclosed by brackets "[]"
182
+ replaced with your own identifying information. (Don't include
183
+ the brackets!) The text should be enclosed in the appropriate
184
+ comment syntax for the file format. We also recommend that a
185
+ file or class name and description of purpose be included on the
186
+ same "printed page" as the copyright notice for easier
187
+ identification within third-party archives.
188
+
189
+ Copyright [yyyy] [name of copyright owner]
190
+
191
+ Licensed under the Apache License, Version 2.0 (the "License");
192
+ you may not use this file except in compliance with the License.
193
+ You may obtain a copy of the License at
194
+
195
+ http://www.apache.org/licenses/LICENSE-2.0
196
+
197
+ Unless required by applicable law or agreed to in writing, software
198
+ distributed under the License is distributed on an "AS IS" BASIS,
199
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
+ See the License for the specific language governing permissions and
201
+ limitations under the License.