wnm 0.0.8__tar.gz → 0.0.10__tar.gz

wnm-0.0.10/PKG-INFO

@@ -0,0 +1,316 @@
+Metadata-Version: 2.4
+Name: wnm
+Version: 0.0.10
+Summary: Manager for Autonomi nodes
+Author-email: Troy Johnson <troy@weave.sh>
+License: GPL-3.0
+Project-URL: Repository, https://github.com/iweave/weave-node-manager.git
+Project-URL: Issues, https://github.com/iweave/weave-node-manager/issues
+Keywords: Autonomi,antnode,weave,xd7
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Distributed Computing
+Requires-Python: >=3.12.3
+Description-Content-Type: text/markdown
+Requires-Dist: python-dotenv
+Requires-Dist: requests
+Requires-Dist: packaging
+Requires-Dist: sqlalchemy
+Requires-Dist: alembic
+Requires-Dist: json-fix
+Requires-Dist: psutil
+Requires-Dist: configargparse
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.12.0; extra == "dev"
+Requires-Dist: pytest-docker>=3.1.0; extra == "dev"
+Requires-Dist: docker>=7.0.0; extra == "dev"
+
+# Weave Node Manager
+
+## Overview
+Weave Node Manager (wnm) is a Python application designed to manage Autonomi nodes on Linux and macOS systems.
+
+**Platforms**:
+- **Linux**: systemd or setsid for process management, UFW for firewall
+- **macOS**: launchd for process management (native support)
+- **Python 3.12.3+** required
+
+## Features
+- Automatic node lifecycle management (create, start, stop, upgrade, remove)
+- Resource-based decision engine (CPU, memory, disk, I/O, load average thresholds)
+- Platform-specific process management (systemd on Linux, launchd on macOS)
+- Per-node binary copies for independent upgrades
+- SQLite database for configuration and state tracking
+- Support for configuration via environment variables, config files, or command-line parameters
+
+## Warning - Alpha Software
+
+This code is Alpha. On Linux, it can migrate from an existing [anm](https://github.com/safenetforum-community/NTracking/tree/main/anm) installation. On macOS, it provides native development and testing support using launchd.
+
+## Installation
+
+### macOS (Development & Testing)
+
+macOS support uses launchd for process management and is ideal for development and testing.
+
+#### 1. Install antup (Autonomi binary manager)
+```bash
+curl -sSL https://raw.githubusercontent.com/maidsafe/antup/main/install.sh | bash
+```
+
+#### 2. Download antnode binary
+```bash
+~/.local/bin/antup node
+```
+
+#### 3. Install WNM from PyPI
+```bash
+pip3 install weave-node-manager
+```
+
+#### 4. Or install from source
+```bash
+git clone https://github.com/dawn-code/weave-node-manager.git
+cd weave-node-manager
+pip3 install -e .
+```
+
+#### 5. Initialize and configure
+```bash
+# Initialize with your rewards address
+wnm --init --rewards_address 0xYourEthereumAddress
+
+# Run in dry-run mode to test
+wnm --dry_run
+
+# Or run normally to start managing nodes
+wnm
+```
+
+#### 6. Optional: Add to cron for automatic management
+```bash
+# Add to crontab (runs every minute)
+crontab -e
+
+# Add this line:
+*/1 * * * * /usr/local/bin/wnm >> ~/Library/Logs/autonomi/wnm-cron.log 2>&1
+```
+
+**macOS Notes:**
+- Uses `~/Library/Application Support/autonomi/node/` for data
+- Uses `~/Library/Logs/autonomi/` for logs
+- Nodes managed via launchd (`~/Library/LaunchAgents/`)
+- No root/sudo access required
+
+### Linux (User-Level, Recommended)
+
+Non-root installation using setsid for process management.
+
+#### 1. Install antup (Autonomi binary manager)
+```bash
+curl -sSL https://raw.githubusercontent.com/maidsafe/antup/main/install.sh | bash
+```
+
+#### 2. Download antnode binary
+```bash
+~/.local/bin/antup node
+```
+
+#### 3. Install WNM from PyPI
+```bash
+pip3 install weave-node-manager
+```
+
+#### 4. Or install from source
+```bash
+git clone https://github.com/dawn-code/weave-node-manager.git
+cd weave-node-manager
+pip3 install -e .
+```
+
+#### 5. Initialize and configure
+```bash
+# Initialize with your rewards address
+wnm --init --rewards_address 0xYourEthereumAddress
+
+# Run in dry-run mode to test
+wnm --dry_run
+
+# Or run normally
+wnm
+```
+
+#### 6. Optional: Add to cron
+```bash
+crontab -e
+
+# Add this line:
+*/1 * * * * ~/.local/bin/wnm >> ~/.local/share/autonomi/logs/wnm-cron.log 2>&1
+```
+
+**Linux User-Level Notes:**
+- Uses `~/.local/share/autonomi/node/` for data (XDG spec)
+- Uses `~/.local/share/autonomi/logs/` for logs
+- Nodes run as background processes (setsid)
+- No root/sudo required
+
+### Linux (Root-Level, Production)
+
+Root installation using systemd for process management.
+
+#### 1. Install system dependencies
+```bash
+sudo apt install -y python3.12-venv python3-pip
+```
+
+#### 2. Install antup and antnode
+```bash
+curl -sSL https://raw.githubusercontent.com/maidsafe/antup/main/install.sh | bash
+~/.local/bin/antup node
+sudo cp ~/.local/bin/antnode /usr/local/bin/
+```
+
+#### 3. Install WNM
+```bash
+sudo pip3 install weave-node-manager
+```
+
+#### 4. Initialize as root
+```bash
+# Migrate from existing anm installation
+sudo wnm --init --migrate_anm
+
+# Or initialize fresh
+sudo wnm --init --rewards_address 0xYourEthereumAddress
+```
+
+#### 5. Add to cron
+```bash
+sudo crontab -e
+
+# Add this line:
+*/1 * * * * /usr/local/bin/wnm >> /var/log/antnode/wnm-cron.log 2>&1
+```
+
+**Linux Root-Level Notes:**
+- Uses `/var/antctl/` for data (legacy anm compatibility)
+- Uses `/var/log/antnode/` for logs
+- Nodes managed via systemd (`/etc/systemd/system/`)
+- Requires root/sudo access
+- Supports migration from anm
+
+## Configuration
+
+Configuration follows a multi-layer priority system (highest to lowest):
+
+1. **Command-line arguments**: `wnm --cpu_less_than 70 --node_cap 50`
+2. **Environment variables**: Set in `.env` file or shell
+3. **Config files**:
+   - macOS: `~/Library/Application Support/autonomi/config`
+   - Linux (user): `~/.local/share/autonomi/config`
+   - Linux (root): `/var/antctl/config`
+4. **Database-stored config**: Persisted in `colony.db` after initialization
+5. **Default values**: Built-in defaults
+
+### Key Configuration Parameters
+
+Resource thresholds control when nodes are added or removed:
+
+- `--cpu_less_than` / `--cpu_remove`: CPU percentage thresholds (default: 70% / 80%)
+- `--mem_less_than` / `--mem_remove`: Memory percentage thresholds (default: 70% / 80%)
+- `--hd_less_than` / `--hd_remove`: Disk usage percentage thresholds (default: 70% / 80%)
+- `--desired_load_average` / `--max_load_average_allowed`: Load average thresholds
+- `--node_cap`: Maximum number of nodes (default: 50)
+- `--rewards_address`: Ethereum address for node rewards (required)
+- `--node_storage`: Root directory for node data (auto-detected per platform)
+
+### anm Migration (Linux Only)
+
+Upon finding an existing [anm](https://github.com/safenetforum-community/NTracking/tree/main/anm) installation, wnm will:
+1. Disable anm by removing `/etc/cron.d/anm`
+2. Import configuration from `/var/antctl/config`
+3. Discover and import existing nodes from systemd
+4. Take over management of the cluster
+
+Use `wnm --init --migrate_anm` to trigger migration.
+
+## Usage
+
+### Run Once
+```bash
+# macOS or Linux
+wnm
+
+# With dry-run (no actual changes)
+wnm --dry_run
+
+# Initialize first time
+wnm --init --rewards_address 0xYourEthereumAddress
+```
+
+### Run via Cron (Recommended)
+
+WNM is designed to run every minute via cron, making one decision per cycle:
+
+**macOS:**
+```bash
+crontab -e
+# Add: */1 * * * * /usr/local/bin/wnm >> ~/Library/Logs/autonomi/wnm-cron.log 2>&1
+```
+
+**Linux (user):**
+```bash
+crontab -e
+# Add: */1 * * * * ~/.local/bin/wnm >> ~/.local/share/autonomi/logs/wnm-cron.log 2>&1
+```
+
+**Linux (root):**
+```bash
+sudo crontab -e
+# Add: */1 * * * * /usr/local/bin/wnm >> /var/log/antnode/wnm-cron.log 2>&1
+```
+
+### Development Mode
+
+For development with live code reloading:
+
+**macOS (native):**
+```bash
+python3 -m wnm --dry_run
+```
+
+**Linux (Docker):**
+```bash
+./scripts/dev.sh
+# Inside container:
+python3 -m wnm --dry_run
+```
+
+See `DOCKER-DEV.md` for comprehensive Docker development workflow.
+
+## Platform Support
+
+See `PLATFORM-SUPPORT.md` for detailed information about:
+- Platform-specific process managers (systemd, launchd, setsid)
+- Firewall management (UFW, null)
+- Path conventions per platform
+- Binary management and upgrades
+- Testing strategies
+
+## Contributing
+Contributions are welcome! Please submit a pull request or open an issue for any enhancements or bug fixes.
+
+## License
+This project is licensed under the MIT License. See the LICENSE file for more details.

wnm-0.0.10/README.md

@@ -0,0 +1,277 @@
+# Weave Node Manager
+
+## Overview
+Weave Node Manager (wnm) is a Python application designed to manage Autonomi nodes on Linux and macOS systems.
+
+**Platforms**:
+- **Linux**: systemd or setsid for process management, UFW for firewall
+- **macOS**: launchd for process management (native support)
+- **Python 3.12.3+** required
+
+## Features
+- Automatic node lifecycle management (create, start, stop, upgrade, remove)
+- Resource-based decision engine (CPU, memory, disk, I/O, load average thresholds)
+- Platform-specific process management (systemd on Linux, launchd on macOS)
+- Per-node binary copies for independent upgrades
+- SQLite database for configuration and state tracking
+- Support for configuration via environment variables, config files, or command-line parameters
+
+## Warning - Alpha Software
+
+This code is Alpha. On Linux, it can migrate from an existing [anm](https://github.com/safenetforum-community/NTracking/tree/main/anm) installation. On macOS, it provides native development and testing support using launchd.
+
+## Installation
+
+### macOS (Development & Testing)
+
+macOS support uses launchd for process management and is ideal for development and testing.
+
+#### 1. Install antup (Autonomi binary manager)
+```bash
+curl -sSL https://raw.githubusercontent.com/maidsafe/antup/main/install.sh | bash
+```
+
+#### 2. Download antnode binary
+```bash
+~/.local/bin/antup node
+```
+
+#### 3. Install WNM from PyPI
+```bash
+pip3 install weave-node-manager
+```
+
+#### 4. Or install from source
+```bash
+git clone https://github.com/dawn-code/weave-node-manager.git
+cd weave-node-manager
+pip3 install -e .
+```
+
+#### 5. Initialize and configure
+```bash
+# Initialize with your rewards address
+wnm --init --rewards_address 0xYourEthereumAddress
+
+# Run in dry-run mode to test
+wnm --dry_run
+
+# Or run normally to start managing nodes
+wnm
+```
+
+#### 6. Optional: Add to cron for automatic management
+```bash
+# Add to crontab (runs every minute)
+crontab -e
+
+# Add this line:
+*/1 * * * * /usr/local/bin/wnm >> ~/Library/Logs/autonomi/wnm-cron.log 2>&1
+```
+
+**macOS Notes:**
+- Uses `~/Library/Application Support/autonomi/node/` for data
+- Uses `~/Library/Logs/autonomi/` for logs
+- Nodes managed via launchd (`~/Library/LaunchAgents/`)
+- No root/sudo access required
+
+### Linux (User-Level, Recommended)
+
+Non-root installation using setsid for process management.
+
+#### 1. Install antup (Autonomi binary manager)
+```bash
+curl -sSL https://raw.githubusercontent.com/maidsafe/antup/main/install.sh | bash
+```
+
+#### 2. Download antnode binary
+```bash
+~/.local/bin/antup node
+```
+
+#### 3. Install WNM from PyPI
+```bash
+pip3 install weave-node-manager
+```
+
+#### 4. Or install from source
+```bash
+git clone https://github.com/dawn-code/weave-node-manager.git
+cd weave-node-manager
+pip3 install -e .
+```
+
+#### 5. Initialize and configure
+```bash
+# Initialize with your rewards address
+wnm --init --rewards_address 0xYourEthereumAddress
+
+# Run in dry-run mode to test
+wnm --dry_run
+
+# Or run normally
+wnm
+```
+
+#### 6. Optional: Add to cron
+```bash
+crontab -e
+
+# Add this line:
+*/1 * * * * ~/.local/bin/wnm >> ~/.local/share/autonomi/logs/wnm-cron.log 2>&1
+```
+
+**Linux User-Level Notes:**
+- Uses `~/.local/share/autonomi/node/` for data (XDG spec)
+- Uses `~/.local/share/autonomi/logs/` for logs
+- Nodes run as background processes (setsid)
+- No root/sudo required
+
+### Linux (Root-Level, Production)
+
+Root installation using systemd for process management.
+
+#### 1. Install system dependencies
+```bash
+sudo apt install -y python3.12-venv python3-pip
+```
+
+#### 2. Install antup and antnode
+```bash
+curl -sSL https://raw.githubusercontent.com/maidsafe/antup/main/install.sh | bash
+~/.local/bin/antup node
+sudo cp ~/.local/bin/antnode /usr/local/bin/
+```
+
+#### 3. Install WNM
+```bash
+sudo pip3 install weave-node-manager
+```
+
+#### 4. Initialize as root
+```bash
+# Migrate from existing anm installation
+sudo wnm --init --migrate_anm
+
+# Or initialize fresh
+sudo wnm --init --rewards_address 0xYourEthereumAddress
+```
+
+#### 5. Add to cron
+```bash
+sudo crontab -e
+
+# Add this line:
+*/1 * * * * /usr/local/bin/wnm >> /var/log/antnode/wnm-cron.log 2>&1
+```
+
+**Linux Root-Level Notes:**
+- Uses `/var/antctl/` for data (legacy anm compatibility)
+- Uses `/var/log/antnode/` for logs
+- Nodes managed via systemd (`/etc/systemd/system/`)
+- Requires root/sudo access
+- Supports migration from anm
+
+## Configuration
+
+Configuration follows a multi-layer priority system (highest to lowest):
+
+1. **Command-line arguments**: `wnm --cpu_less_than 70 --node_cap 50`
+2. **Environment variables**: Set in `.env` file or shell
+3. **Config files**:
+   - macOS: `~/Library/Application Support/autonomi/config`
+   - Linux (user): `~/.local/share/autonomi/config`
+   - Linux (root): `/var/antctl/config`
+4. **Database-stored config**: Persisted in `colony.db` after initialization
+5. **Default values**: Built-in defaults
+
+### Key Configuration Parameters
+
+Resource thresholds control when nodes are added or removed:
+
+- `--cpu_less_than` / `--cpu_remove`: CPU percentage thresholds (default: 70% / 80%)
+- `--mem_less_than` / `--mem_remove`: Memory percentage thresholds (default: 70% / 80%)
+- `--hd_less_than` / `--hd_remove`: Disk usage percentage thresholds (default: 70% / 80%)
+- `--desired_load_average` / `--max_load_average_allowed`: Load average thresholds
+- `--node_cap`: Maximum number of nodes (default: 50)
+- `--rewards_address`: Ethereum address for node rewards (required)
+- `--node_storage`: Root directory for node data (auto-detected per platform)
+
+### anm Migration (Linux Only)
+
+Upon finding an existing [anm](https://github.com/safenetforum-community/NTracking/tree/main/anm) installation, wnm will:
+1. Disable anm by removing `/etc/cron.d/anm`
+2. Import configuration from `/var/antctl/config`
+3. Discover and import existing nodes from systemd
+4. Take over management of the cluster
+
+Use `wnm --init --migrate_anm` to trigger migration.
+
+## Usage
+
+### Run Once
+```bash
+# macOS or Linux
+wnm
+
+# With dry-run (no actual changes)
+wnm --dry_run
+
+# Initialize first time
+wnm --init --rewards_address 0xYourEthereumAddress
+```
+
+### Run via Cron (Recommended)
+
+WNM is designed to run every minute via cron, making one decision per cycle:
+
+**macOS:**
+```bash
+crontab -e
+# Add: */1 * * * * /usr/local/bin/wnm >> ~/Library/Logs/autonomi/wnm-cron.log 2>&1
+```
+
+**Linux (user):**
+```bash
+crontab -e
+# Add: */1 * * * * ~/.local/bin/wnm >> ~/.local/share/autonomi/logs/wnm-cron.log 2>&1
+```
+
+**Linux (root):**
+```bash
+sudo crontab -e
+# Add: */1 * * * * /usr/local/bin/wnm >> /var/log/antnode/wnm-cron.log 2>&1
+```
+
+### Development Mode
+
+For development with live code reloading:
+
+**macOS (native):**
+```bash
+python3 -m wnm --dry_run
+```
+
+**Linux (Docker):**
+```bash
+./scripts/dev.sh
+# Inside container:
+python3 -m wnm --dry_run
+```
+
+See `DOCKER-DEV.md` for comprehensive Docker development workflow.
+
+## Platform Support
+
+See `PLATFORM-SUPPORT.md` for detailed information about:
+- Platform-specific process managers (systemd, launchd, setsid)
+- Firewall management (UFW, null)
+- Path conventions per platform
+- Binary management and upgrades
+- Testing strategies
+
+## Contributing
+Contributions are welcome! Please submit a pull request or open an issue for any enhancements or bug fixes.
+
+## License
+This project is licensed under the MIT License. See the LICENSE file for more details.

{wnm-0.0.8 → wnm-0.0.10}/pyproject.toml

@@ -11,7 +11,7 @@ description = "Manager for Autonomi nodes"
 license = {text = "GPL-3.0"}
 keywords = ["Autonomi", "antnode", "weave", "xd7"]
 dynamic = ["version", "dependencies", "optional-dependencies"]
-readme = "README.md"
+readme = {file = "README.md", content-type = "text/markdown"}
 requires-python = ">=3.12.3"
 classifiers = [
     "Development Status :: 3 - Alpha",
@@ -24,6 +24,9 @@ classifiers = [
     "Topic :: System :: Distributed Computing",
 ]
 
+[project.urls]
+Repository = "https://github.com/iweave/weave-node-manager.git"
+Issues = "https://github.com/iweave/weave-node-manager/issues"
 
 [project.scripts]
 wnm = "wnm.__main__:main"
@@ -34,5 +37,18 @@ optional-dependencies.dev = { file = ["requirements-dev.txt"] }
 version = {attr = "wnm.__version__"}
 
 [tool.setuptools.packages.find]
-where = ["."]
+where = ["src"]
 
+[tool.black]
+line-length = 88
+
+[tool.isort]
+profile = "black"
+
+[tool.pytest.ini_options]
+markers = [
+    "linux_only: tests that require Linux (systemd, ufw, etc.)",
+    "macos_only: tests that require macOS (launchctl, etc.)",
+    "requires_docker: tests that require Docker",
+    "integration: integration tests (slow)",
+]

wnm-0.0.10/requirements-dev.txt

@@ -0,0 +1,10 @@
+black
+isort
+build
+twine
+pytest>=8.0.0
+pytest-cov>=4.1.0
+pytest-asyncio>=0.23.0
+pytest-mock>=3.12.0
+pytest-docker>=3.1.0
+docker>=7.0.0

{wnm-0.0.8 → wnm-0.0.10}/requirements.txt

@@ -5,3 +5,4 @@ sqlalchemy
 alembic
 json-fix
 psutil
+configargparse

{wnm-0.0.8 → wnm-0.0.10}/setup.cfg

@@ -1,6 +1,3 @@
-[options]
-packages = find:
-
 [egg_info]
 tag_build = 
 tag_date = 0

{wnm-0.0.8 → wnm-0.0.10/src}/wnm/__init__.py

@@ -1,3 +1,3 @@
 """A service to manage a cluster of decentralized Autonomi nodes"""
 
-__version__ = "0.0.8"
+__version__ = "0.0.10"