devnomads-cli 0.3.0__py3-none-any.whl

devnomads_cli-0.3.0.dist-info/METADATA

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: devnomads-cli
+Version: 0.3.0
+Summary: Manage your DevNomads services from the command line
+Author-email: DevNomads <support@devnomads.nl>
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13
+Requires-Dist: cryptography>=42
+Requires-Dist: devnomads>=0.1
+Provides-Extra: cert
+Requires-Dist: devnomads[acme]>=0.1; extra == "cert"
+Dynamic: license-file
+
+# dncli
+
+Manage your [DevNomads](https://devnomads.nl) services from the
+command line: inspect your services, manage DNS zones and records,
+and move zones over from other providers - from a shell or a script.
+
+The command is **`dncli`** - named to avoid clashing with the macOS
+`dnctl` traffic-shaper at `/usr/sbin/dnctl`. Install it from PyPI
+as **`devnomads-cli`**.
+
+## Install
+
+```sh
+pip install devnomads-cli
+```
+
+For a global, isolated install (recommended on workstations), use
+[uv](https://docs.astral.sh/uv/) or pipx instead - same result, no
+interference with system packages:
+
+```sh
+uv tool install devnomads-cli   # or: pipx install devnomads-cli
+```
+
+Enable shell completion (bash, zsh, fish, PowerShell):
+
+```sh
+dncli --install-completion
+```
+
+## Getting started
+
+Create an API key in the [DevNomads
+portal](https://portal.devnomads.nl) under **Profiel -> API
+Sleutels**, then store it:
+
+```sh
+dncli configure
+```
+
+The key is written to `~/.config/dnctl/credentials`, readable only
+by you. From here every command works:
+
+```sh
+dncli services list
+dncli domains list
+dncli containers show <id>
+```
+
+Every DevNomads product has its own command group - `apps`,
+`buckets`, `containers`, `databases`, `domains`, `emails`,
+`forwards`, `proxies`, `servers`, `sites` and more. Explore with
+`dncli --help` and `dncli <group> --help`.
+
+Commands accept any unambiguous prefix: `dncli e l` is `dncli emails
+list`. An ambiguous prefix lists the candidates.
+
+## Managing DNS
+
+```sh
+dncli dns zones list
+dncli dns zones show example.com
+dncli dns records list example.com
+dncli dns records set example.com www A 192.0.2.1 --ttl 3600
+dncli dns records delete example.com www A
+```
+
+## Moving a zone from another provider
+
+`dncli dns transfer` copies a zone from your current DNS provider
+into DevNomads. It reads the records at the source (never writes
+there), shows you the changes, and applies them after confirmation:
+
+```sh
+dncli configure --provider transip       # store source credentials
+dncli dns transfer --from transip --zone example.com --dry-run
+dncli dns transfer --from transip --zone example.com
+```
+
+Supported source providers: TransIP and AuroraDNS. The zone must
+already exist at DevNomads; register or transfer the domain in the
+portal first.
+
+## Multiple accounts
+
+Store each account as a named profile and select it per command or
+per shell:
+
+```sh
+dncli configure --profile acme
+dncli services list --profile acme
+export DN_PROFILE=acme
+```
+
+## Scripting
+
+Output is a human-readable table on a terminal and JSON when piped,
+so pipelines get parseable output without any flags; `--output
+json|table` forces either. Data goes to stdout, everything else
+(warnings, prompts, status messages) to stderr, so `dncli ... | jq .`
+is always safe.
+
+In CI and pipelines, skip the credentials file and pass the key via
+the environment:
+
+```sh
+export DN_API_KEY=...        # beats any stored profile
+dncli services list | jq -r '.[].entity'
+```
+
+## Certificates
+
+The `cert` extra adds Let's Encrypt issuance over DNS-01 and HTTP-01:
+
+```sh
+uv tool install "devnomads-cli[cert]"
+dncli cert issue example.com -d "*.example.com"
+```
+
+A dehydrated-compatible DNS-01 hook ships as `dncli-dns-hook`:
+
+```sh
+# dehydrated/config
+CHALLENGETYPE="dns-01"
+HOOK="dncli-dns-hook"
+```
+
+## License
+
+MIT.

devnomads_cli-0.3.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+dncli.py,sha256=ko7wnAVzPtKB5SqOSPcDi3KnlAYUkVHxWBoeBzEVuhg,108715
+devnomads_cli-0.3.0.dist-info/licenses/LICENSE,sha256=WPXQ_lmpr3tVzTD9Z6VTiBgFnFey-cEwEYoG4HlmbxY,1066
+devnomads_cli-0.3.0.dist-info/METADATA,sha256=1FCMVmmB4zdSQkXFIODUkmz8BD3DyKQu0G_JoJdtizI,3797
+devnomads_cli-0.3.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+devnomads_cli-0.3.0.dist-info/entry_points.txt,sha256=irLaKiGtIzEKi87exmXAg0srUmoDK31fL0SlqJasAEU,69
+devnomads_cli-0.3.0.dist-info/top_level.txt,sha256=rFWIJDQgL3jA2q6b2GAqZgCknDED4WLxNcHTktuWS1I,6
+devnomads_cli-0.3.0.dist-info/RECORD,,

devnomads_cli-0.3.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

devnomads_cli-0.3.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+dncli = dncli:run
+dncli-dns-hook = dncli:hook_main

devnomads_cli-0.3.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DevNomads
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

devnomads_cli-0.3.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+dncli