thronetools 1.0.4__py3-none-any.whl
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.
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: thronetools
|
|
3
|
+
Version: 1.0.4
|
|
4
|
+
Summary: Cross-platform installer and management CLI for Throne
|
|
5
|
+
Project-URL: Homepage, https://github.com/arian24b/thronetools
|
|
6
|
+
Project-URL: Repository, https://github.com/arian24b/thronetools
|
|
7
|
+
Project-URL: Issues, https://github.com/arian24b/thronetools/issues
|
|
8
|
+
Author-email: Arian Omrani <arian24b@gmail.com>
|
|
9
|
+
License-Expression: MIT
|
|
10
|
+
Keywords: cli,hotspot,installer,proxy,throne
|
|
11
|
+
Classifier: Development Status :: 5 - Production/Stable
|
|
12
|
+
Classifier: Intended Audience :: Developers
|
|
13
|
+
Classifier: Operating System :: OS Independent
|
|
14
|
+
Classifier: Programming Language :: Python :: 3
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
20
|
+
Requires-Python: >=3.10
|
|
21
|
+
Requires-Dist: typer>=0.24.0
|
|
22
|
+
Description-Content-Type: text/markdown
|
|
23
|
+
|
|
24
|
+
# ThroneTools
|
|
25
|
+
|
|
26
|
+
Cross-platform CLI to install, reinstall, uninstall, and manage configuration for **Throne** and **NekoRay** on Linux, macOS, and Windows.
|
|
27
|
+
|
|
28
|
+
## Requirements
|
|
29
|
+
|
|
30
|
+
- Python 3.10+
|
|
31
|
+
- [uv](https://docs.astral.sh/uv/)
|
|
32
|
+
|
|
33
|
+
## Quick Start (uv)
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
# from repo root
|
|
37
|
+
uv sync
|
|
38
|
+
uv run thronetools --help
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
### Interactive mode
|
|
42
|
+
|
|
43
|
+
Run without subcommands to open the interactive menu:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
uv run python thronetools.py
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Commands
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
thronetools install
|
|
53
|
+
thronetools backup --app {throne|nekoray} [--output <path-or-dir>]
|
|
54
|
+
thronetools restore --app {throne|nekoray} --zip <backup.zip>
|
|
55
|
+
thronetools remove --app {throne|nekoray}
|
|
56
|
+
thronetools reinstall --app {throne|nekoray} [--backup] [--output <path-or-dir>] [--force]
|
|
57
|
+
thronetools info --app {throne|nekoray}
|
|
58
|
+
thronetools hotspot enable [--iface <iface>] [--ssid <name>] [--password <pass>] [--dry-run]
|
|
59
|
+
thronetools hotspot disable [--dry-run]
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
## Common Examples
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
# Install Throne
|
|
66
|
+
uv run thronetools install
|
|
67
|
+
|
|
68
|
+
# Backup Throne config to current directory
|
|
69
|
+
uv run thronetools backup --app throne
|
|
70
|
+
|
|
71
|
+
# Backup NekoRay config to a specific folder
|
|
72
|
+
uv run thronetools backup --app nekoray --output ~/Backups
|
|
73
|
+
|
|
74
|
+
# Restore Throne config
|
|
75
|
+
uv run thronetools restore --app throne --zip ~/Backups/throne-backup-2026-02-17.zip
|
|
76
|
+
|
|
77
|
+
# Reinstall with backup + restore flow
|
|
78
|
+
uv run thronetools reinstall --app throne --backup
|
|
79
|
+
|
|
80
|
+
# Show installed app details
|
|
81
|
+
uv run thronetools info --app throne
|
|
82
|
+
|
|
83
|
+
# Preview hotspot commands without applying changes
|
|
84
|
+
uv run thronetools hotspot enable --iface wlp2s0 --dry-run
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## Notes
|
|
88
|
+
|
|
89
|
+
- `hotspot` commands are supported on Linux and macOS. On Windows, hotspot subcommands are not available.
|
|
90
|
+
- Some operations require elevated privileges depending on platform/package manager.
|
|
91
|
+
|
|
92
|
+
## Development
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
# Lint/format (Ruff is configured in pyproject.toml)
|
|
96
|
+
uv run ruff check .
|
|
97
|
+
uv run ruff format .
|
|
98
|
+
|
|
99
|
+
# Build package
|
|
100
|
+
uv build
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
## Install as a tool (optional)
|
|
104
|
+
|
|
105
|
+
If you want a globally available command via `uv`:
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
uv tool install .
|
|
109
|
+
thronetools --help
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
To update later:
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
uv tool upgrade thronetools
|
|
116
|
+
```
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
thronetools.py,sha256=kTxLcVCm-ONcs6TSOMa2ZEOqimGdT9tiFe0LG_VGvIQ,54525
|
|
2
|
+
thronetools-1.0.4.dist-info/METADATA,sha256=yWKlSG_QqI3jYHNJS196ljesb49HQMtx1m6AZnFL0Bo,3073
|
|
3
|
+
thronetools-1.0.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
|
|
4
|
+
thronetools-1.0.4.dist-info/entry_points.txt,sha256=iEHEEs383maMGoAamlzfRRqA9oLlHacvH2V1oBj7aus,49
|
|
5
|
+
thronetools-1.0.4.dist-info/RECORD,,
|