dnctl 0.1.2__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.
dnctl-0.1.2/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 DevNomads
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
dnctl-0.1.2/PKG-INFO ADDED
@@ -0,0 +1,124 @@
1
+ Metadata-Version: 2.4
2
+ Name: dnctl
3
+ Version: 0.1.2
4
+ Summary: Manage your DevNomads services from the command line
5
+ Author-email: DevNomads <support@devnomads.nl>
6
+ License: MIT
7
+ Requires-Python: >=3.10
8
+ Description-Content-Type: text/markdown
9
+ License-File: LICENSE
10
+ Requires-Dist: typer>=0.12
11
+ Requires-Dist: httpx>=0.27
12
+ Requires-Dist: rich>=13
13
+ Requires-Dist: cryptography>=42
14
+ Dynamic: license-file
15
+
16
+ # dnctl
17
+
18
+ Manage your [DevNomads](https://devnomads.nl) services from the
19
+ command line: inspect your services, manage DNS zones and records,
20
+ and move zones over from other providers - from a shell or a script.
21
+
22
+ ## Install
23
+
24
+ ```sh
25
+ pip install dnctl
26
+ ```
27
+
28
+ For a global, isolated install (recommended on workstations), use
29
+ [uv](https://docs.astral.sh/uv/) or pipx instead - same result, no
30
+ interference with system packages:
31
+
32
+ ```sh
33
+ uv tool install dnctl # or: pipx install dnctl
34
+ ```
35
+
36
+ Enable shell completion (bash, zsh, fish, PowerShell):
37
+
38
+ ```sh
39
+ dnctl --install-completion
40
+ ```
41
+
42
+ ## Getting started
43
+
44
+ Create an API key in the [DevNomads
45
+ portal](https://portal.devnomads.nl) under **Profiel -> API
46
+ Sleutels**, then store it:
47
+
48
+ ```sh
49
+ dnctl configure
50
+ ```
51
+
52
+ The key is written to `~/.config/dnctl/credentials`, readable only
53
+ by you. From here every command works:
54
+
55
+ ```sh
56
+ dnctl services list
57
+ dnctl domains list
58
+ dnctl containers show <id>
59
+ ```
60
+
61
+ Every DevNomads product has its own command group - `apps`,
62
+ `buckets`, `containers`, `databases`, `domains`, `emails`,
63
+ `forwards`, `proxies`, `servers`, `sites` and more. Explore with
64
+ `dnctl --help` and `dnctl <group> --help`.
65
+
66
+ Commands accept any unambiguous prefix: `dnctl e l` is `dnctl emails
67
+ list`. An ambiguous prefix lists the candidates.
68
+
69
+ ## Managing DNS
70
+
71
+ ```sh
72
+ dnctl dns zones list
73
+ dnctl dns zones show example.com
74
+ dnctl dns records list example.com
75
+ dnctl dns records set example.com www A 192.0.2.1 --ttl 3600
76
+ dnctl dns records delete example.com www A
77
+ ```
78
+
79
+ ## Moving a zone from another provider
80
+
81
+ `dnctl dns transfer` copies a zone from your current DNS provider
82
+ into DevNomads. It reads the records at the source (never writes
83
+ there), shows you the changes, and applies them after confirmation:
84
+
85
+ ```sh
86
+ dnctl configure --provider transip # store source credentials
87
+ dnctl dns transfer --from transip --zone example.com --dry-run
88
+ dnctl dns transfer --from transip --zone example.com
89
+ ```
90
+
91
+ Supported source providers: TransIP and AuroraDNS. The zone must
92
+ already exist at DevNomads; register or transfer the domain in the
93
+ portal first.
94
+
95
+ ## Multiple accounts
96
+
97
+ Store each account as a named profile and select it per command or
98
+ per shell:
99
+
100
+ ```sh
101
+ dnctl configure --profile acme
102
+ dnctl services list --profile acme
103
+ export DN_PROFILE=acme
104
+ ```
105
+
106
+ ## Scripting
107
+
108
+ Output is a human-readable table on a terminal and JSON when piped,
109
+ so pipelines get parseable output without any flags; `--output
110
+ json|table` forces either. Data goes to stdout, everything else
111
+ (warnings, prompts, status messages) to stderr, so `dnctl ... | jq .`
112
+ is always safe.
113
+
114
+ In CI and pipelines, skip the credentials file and pass the key via
115
+ the environment:
116
+
117
+ ```sh
118
+ export DN_API_KEY=... # beats any stored profile
119
+ dnctl services list | jq -r '.[].entity'
120
+ ```
121
+
122
+ ## License
123
+
124
+ MIT.
dnctl-0.1.2/README.md ADDED
@@ -0,0 +1,109 @@
1
+ # dnctl
2
+
3
+ Manage your [DevNomads](https://devnomads.nl) services from the
4
+ command line: inspect your services, manage DNS zones and records,
5
+ and move zones over from other providers - from a shell or a script.
6
+
7
+ ## Install
8
+
9
+ ```sh
10
+ pip install dnctl
11
+ ```
12
+
13
+ For a global, isolated install (recommended on workstations), use
14
+ [uv](https://docs.astral.sh/uv/) or pipx instead - same result, no
15
+ interference with system packages:
16
+
17
+ ```sh
18
+ uv tool install dnctl # or: pipx install dnctl
19
+ ```
20
+
21
+ Enable shell completion (bash, zsh, fish, PowerShell):
22
+
23
+ ```sh
24
+ dnctl --install-completion
25
+ ```
26
+
27
+ ## Getting started
28
+
29
+ Create an API key in the [DevNomads
30
+ portal](https://portal.devnomads.nl) under **Profiel -> API
31
+ Sleutels**, then store it:
32
+
33
+ ```sh
34
+ dnctl configure
35
+ ```
36
+
37
+ The key is written to `~/.config/dnctl/credentials`, readable only
38
+ by you. From here every command works:
39
+
40
+ ```sh
41
+ dnctl services list
42
+ dnctl domains list
43
+ dnctl containers show <id>
44
+ ```
45
+
46
+ Every DevNomads product has its own command group - `apps`,
47
+ `buckets`, `containers`, `databases`, `domains`, `emails`,
48
+ `forwards`, `proxies`, `servers`, `sites` and more. Explore with
49
+ `dnctl --help` and `dnctl <group> --help`.
50
+
51
+ Commands accept any unambiguous prefix: `dnctl e l` is `dnctl emails
52
+ list`. An ambiguous prefix lists the candidates.
53
+
54
+ ## Managing DNS
55
+
56
+ ```sh
57
+ dnctl dns zones list
58
+ dnctl dns zones show example.com
59
+ dnctl dns records list example.com
60
+ dnctl dns records set example.com www A 192.0.2.1 --ttl 3600
61
+ dnctl dns records delete example.com www A
62
+ ```
63
+
64
+ ## Moving a zone from another provider
65
+
66
+ `dnctl dns transfer` copies a zone from your current DNS provider
67
+ into DevNomads. It reads the records at the source (never writes
68
+ there), shows you the changes, and applies them after confirmation:
69
+
70
+ ```sh
71
+ dnctl configure --provider transip # store source credentials
72
+ dnctl dns transfer --from transip --zone example.com --dry-run
73
+ dnctl dns transfer --from transip --zone example.com
74
+ ```
75
+
76
+ Supported source providers: TransIP and AuroraDNS. The zone must
77
+ already exist at DevNomads; register or transfer the domain in the
78
+ portal first.
79
+
80
+ ## Multiple accounts
81
+
82
+ Store each account as a named profile and select it per command or
83
+ per shell:
84
+
85
+ ```sh
86
+ dnctl configure --profile acme
87
+ dnctl services list --profile acme
88
+ export DN_PROFILE=acme
89
+ ```
90
+
91
+ ## Scripting
92
+
93
+ Output is a human-readable table on a terminal and JSON when piped,
94
+ so pipelines get parseable output without any flags; `--output
95
+ json|table` forces either. Data goes to stdout, everything else
96
+ (warnings, prompts, status messages) to stderr, so `dnctl ... | jq .`
97
+ is always safe.
98
+
99
+ In CI and pipelines, skip the credentials file and pass the key via
100
+ the environment:
101
+
102
+ ```sh
103
+ export DN_API_KEY=... # beats any stored profile
104
+ dnctl services list | jq -r '.[].entity'
105
+ ```
106
+
107
+ ## License
108
+
109
+ MIT.
@@ -0,0 +1,124 @@
1
+ Metadata-Version: 2.4
2
+ Name: dnctl
3
+ Version: 0.1.2
4
+ Summary: Manage your DevNomads services from the command line
5
+ Author-email: DevNomads <support@devnomads.nl>
6
+ License: MIT
7
+ Requires-Python: >=3.10
8
+ Description-Content-Type: text/markdown
9
+ License-File: LICENSE
10
+ Requires-Dist: typer>=0.12
11
+ Requires-Dist: httpx>=0.27
12
+ Requires-Dist: rich>=13
13
+ Requires-Dist: cryptography>=42
14
+ Dynamic: license-file
15
+
16
+ # dnctl
17
+
18
+ Manage your [DevNomads](https://devnomads.nl) services from the
19
+ command line: inspect your services, manage DNS zones and records,
20
+ and move zones over from other providers - from a shell or a script.
21
+
22
+ ## Install
23
+
24
+ ```sh
25
+ pip install dnctl
26
+ ```
27
+
28
+ For a global, isolated install (recommended on workstations), use
29
+ [uv](https://docs.astral.sh/uv/) or pipx instead - same result, no
30
+ interference with system packages:
31
+
32
+ ```sh
33
+ uv tool install dnctl # or: pipx install dnctl
34
+ ```
35
+
36
+ Enable shell completion (bash, zsh, fish, PowerShell):
37
+
38
+ ```sh
39
+ dnctl --install-completion
40
+ ```
41
+
42
+ ## Getting started
43
+
44
+ Create an API key in the [DevNomads
45
+ portal](https://portal.devnomads.nl) under **Profiel -> API
46
+ Sleutels**, then store it:
47
+
48
+ ```sh
49
+ dnctl configure
50
+ ```
51
+
52
+ The key is written to `~/.config/dnctl/credentials`, readable only
53
+ by you. From here every command works:
54
+
55
+ ```sh
56
+ dnctl services list
57
+ dnctl domains list
58
+ dnctl containers show <id>
59
+ ```
60
+
61
+ Every DevNomads product has its own command group - `apps`,
62
+ `buckets`, `containers`, `databases`, `domains`, `emails`,
63
+ `forwards`, `proxies`, `servers`, `sites` and more. Explore with
64
+ `dnctl --help` and `dnctl <group> --help`.
65
+
66
+ Commands accept any unambiguous prefix: `dnctl e l` is `dnctl emails
67
+ list`. An ambiguous prefix lists the candidates.
68
+
69
+ ## Managing DNS
70
+
71
+ ```sh
72
+ dnctl dns zones list
73
+ dnctl dns zones show example.com
74
+ dnctl dns records list example.com
75
+ dnctl dns records set example.com www A 192.0.2.1 --ttl 3600
76
+ dnctl dns records delete example.com www A
77
+ ```
78
+
79
+ ## Moving a zone from another provider
80
+
81
+ `dnctl dns transfer` copies a zone from your current DNS provider
82
+ into DevNomads. It reads the records at the source (never writes
83
+ there), shows you the changes, and applies them after confirmation:
84
+
85
+ ```sh
86
+ dnctl configure --provider transip # store source credentials
87
+ dnctl dns transfer --from transip --zone example.com --dry-run
88
+ dnctl dns transfer --from transip --zone example.com
89
+ ```
90
+
91
+ Supported source providers: TransIP and AuroraDNS. The zone must
92
+ already exist at DevNomads; register or transfer the domain in the
93
+ portal first.
94
+
95
+ ## Multiple accounts
96
+
97
+ Store each account as a named profile and select it per command or
98
+ per shell:
99
+
100
+ ```sh
101
+ dnctl configure --profile acme
102
+ dnctl services list --profile acme
103
+ export DN_PROFILE=acme
104
+ ```
105
+
106
+ ## Scripting
107
+
108
+ Output is a human-readable table on a terminal and JSON when piped,
109
+ so pipelines get parseable output without any flags; `--output
110
+ json|table` forces either. Data goes to stdout, everything else
111
+ (warnings, prompts, status messages) to stderr, so `dnctl ... | jq .`
112
+ is always safe.
113
+
114
+ In CI and pipelines, skip the credentials file and pass the key via
115
+ the environment:
116
+
117
+ ```sh
118
+ export DN_API_KEY=... # beats any stored profile
119
+ dnctl services list | jq -r '.[].entity'
120
+ ```
121
+
122
+ ## License
123
+
124
+ MIT.
@@ -0,0 +1,16 @@
1
+ LICENSE
2
+ README.md
3
+ dnctl.py
4
+ pyproject.toml
5
+ dnctl.egg-info/PKG-INFO
6
+ dnctl.egg-info/SOURCES.txt
7
+ dnctl.egg-info/dependency_links.txt
8
+ dnctl.egg-info/entry_points.txt
9
+ dnctl.egg-info/requires.txt
10
+ dnctl.egg-info/top_level.txt
11
+ tests/test_cli.py
12
+ tests/test_config.py
13
+ tests/test_generate.py
14
+ tests/test_generated_cli.py
15
+ tests/test_helpers.py
16
+ tests/test_transfer.py
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ dnctl = dnctl:run
@@ -0,0 +1,4 @@
1
+ typer>=0.12
2
+ httpx>=0.27
3
+ rich>=13
4
+ cryptography>=42
@@ -0,0 +1 @@
1
+ dnctl