neewer-cli 0.1.1__tar.gz

neewer_cli-0.1.1/CODE_OF_CONDUCT.md

@@ -0,0 +1,27 @@
+# Code of Conduct
+
+## Our Standards
+
+Participants in this project are expected to:
+
+- be respectful and constructive
+- focus on technical substance
+- accept and provide feedback professionally
+- avoid harassment, personal attacks, and discriminatory language
+
+## Scope
+
+This Code of Conduct applies to:
+
+- repository issues, pull requests, and discussions
+- project-related communication spaces
+
+## Enforcement
+
+Project maintainers may remove comments, reject contributions, or restrict participation for behavior that violates this Code of Conduct.
+
+## Reporting
+
+Report unacceptable behavior privately to the maintainer via GitHub direct contact:
+
+- https://github.com/SergeDubovsky

neewer_cli-0.1.1/CONTRIBUTING.md

@@ -0,0 +1,38 @@
+# Contributing
+
+Thanks for contributing to `neewer-cli`.
+
+## Local Setup
+
+```bash
+git clone https://github.com/SergeDubovsky/neewer-cli.git
+cd neewer-cli
+python -m pip install -U pip
+python -m pip install ".[dev]"
+```
+
+## Run Checks
+
+```bash
+python -m ruff check .
+python -m pytest -q
+python -m build
+python -m twine check dist/*
+```
+
+## Scope
+
+- Keep changes focused and testable.
+- Add/adjust tests for logic changes.
+- For BLE behavior changes, prefer preserving compatibility with existing Neewer models.
+- Use PRs against `main` (direct pushes should be avoided for normal changes).
+
+## Developer Docs
+
+- [docs/developer-guide.md](docs/developer-guide.md)
+- [docs/wiki/Configuration.md](docs/wiki/Configuration.md)
+
+## Attribution
+
+This project is derived from NeewerLite-Python by Zach Glenwright.
+Please preserve attribution and licensing metadata when changing related code.

neewer_cli-0.1.1/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2021-2022 Zach Glenwright
+Copyright (c) 2026 Sergei Dubovsky
+
+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.

neewer_cli-0.1.1/MANIFEST.in

@@ -0,0 +1,10 @@
+include README.md
+include CONTRIBUTING.md
+include RELEASING.md
+include SECURITY.md
+include SUPPORT.md
+include CODE_OF_CONDUCT.md
+include LICENSE
+include NOTICE
+include neewer.example.json
+recursive-include docs *.md

neewer_cli-0.1.1/NOTICE

@@ -0,0 +1,8 @@
+This project contains work derived from:
+
+NeewerLite-Python
+Copyright (c) 2021-2022 Zach Glenwright
+https://github.com/taburineagle/NeewerLite-Python
+
+Modifications and standalone CLI refactor:
+Copyright (c) 2026 Sergei Dubovsky

neewer_cli-0.1.1/PKG-INFO

@@ -0,0 +1,251 @@
+Metadata-Version: 2.4
+Name: neewer-cli
+Version: 0.1.1
+Summary: Standalone Neewer BLE CLI utility
+Author: Sergei Dubovsky
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/SergeDubovsky/neewer-cli
+Project-URL: Repository, https://github.com/SergeDubovsky/neewer-cli
+Project-URL: Issues, https://github.com/SergeDubovsky/neewer-cli/issues
+Keywords: neewer,ble,bluetooth,lighting,cli
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Environment :: Console
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: bleak>=0.20
+Provides-Extra: yaml
+Requires-Dist: PyYAML>=6.0; extra == "yaml"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Dynamic: license-file
+
+# neewer-cli
+
+[![CI](https://github.com/SergeDubovsky/neewer-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/SergeDubovsky/neewer-cli/actions/workflows/ci.yml)
+[![Release](https://github.com/SergeDubovsky/neewer-cli/actions/workflows/release.yml/badge.svg)](https://github.com/SergeDubovsky/neewer-cli/actions/workflows/release.yml)
+[![License: MIT](https://img.shields.io/github/license/SergeDubovsky/neewer-cli)](LICENSE)
+
+Standalone Neewer BLE command-line utility focused on fast and reliable control without a GUI.
+
+## Why This Tool
+
+- CLI-only workflow for scripting and automation.
+- Reliability controls for unstable BLE environments (retries, passes, bounded parallelism).
+- Fast fixed-rig operation with config-driven `--skip-discovery`.
+- Presets, groups, and per-light command overrides keyed by MAC.
+
+## Attribution
+
+This project is based on and derives protocol/model support from:
+
+- **NeewerLite-Python** by **Zach Glenwright**
+- https://github.com/taburineagle/NeewerLite-Python
+
+## Requirements
+
+- Python `3.9+`
+- Bluetooth adapter with BLE support
+
+The runtime BLE dependency (`bleak`) is installed automatically by package install commands below.
+
+## Installation
+
+Current recommended install (GitHub source):
+
+```bash
+# one-time install of pipx
+python -m pip install --user pipx
+python -m pipx ensurepath
+
+# install neewer-cli from GitHub
+pipx install git+https://github.com/SergeDubovsky/neewer-cli.git
+```
+
+Alternative user install:
+
+```bash
+python -m pip install --user git+https://github.com/SergeDubovsky/neewer-cli.git
+```
+
+After install:
+
+```bash
+neewer-cli --help
+neewer-cli --version
+```
+
+PyPI publishing is handled by GitHub Actions using Trusted Publishing (OIDC).
+
+## Quick Start
+
+```bash
+# 1) discover lights
+neewer-cli --list
+
+# 2) copy example config to default config path
+# Windows (PowerShell/CMD)
+copy neewer.example.json %USERPROFILE%\.neewer
+
+# macOS/Linux
+cp neewer.example.json ~/.neewer
+
+# 3) run presets
+neewer-cli --preset all_on
+neewer-cli --preset all_off
+neewer-cli --preset key_cct_5600_30
+```
+
+## Common Commands
+
+```bash
+# turn configured lights on/off quickly
+neewer-cli --preset all_on
+neewer-cli --preset all_off
+
+# send direct command to specific MACs
+neewer-cli --light D2:E2:75:8B:36:45,F8:46:85:EF:47:70 --mode CCT --temp 5600 --bri 30
+
+# fast fixed-rig mode (no scan)
+neewer-cli --light group:studio --preset all_on --skip-discovery
+
+# persistent low-latency mode (keep connections open)
+neewer-cli --serve --light group:studio --skip-discovery --debug
+```
+
+## Configuration
+
+Default config path:
+
+- `~/.neewer` (Windows: `%USERPROFILE%\.neewer`)
+
+Top-level config keys:
+
+- `defaults`: default CLI flags
+- `lights`: per-MAC metadata (`name`, `cct_only`, `infinity_mode`, `hw_mac`, optional feature flags)
+- `groups`: named MAC sets
+- `presets`: reusable command sets
+- `presets.<name>.per_light`: per-light command overrides in one run
+
+Optional per-light feature flags in `lights`:
+
+- `supports_status_query`: override model detection for `--status` query commands
+- `supports_extended_scene`: override model detection for extended scene payloads
+
+Reference material:
+
+- Example config: [neewer.example.json](neewer.example.json)
+- Wiki configuration guide: https://github.com/SergeDubovsky/neewer-cli/wiki/Configuration
+
+## Reliability Tuning
+
+For flaky BLE environments, tune:
+
+- `--scan-attempts`
+- `--resolve-timeout` (short BLE handle resolve scan for `--skip-discovery`)
+- `--connect-retries`
+- `--write-retries`
+- `--passes` (adaptive retries for failed lights only)
+- `--parallel`
+
+For stable fixed setups, keep `lights` fully defined in config and use `--skip-discovery` to reduce latency.
+
+## Advanced Protocol (Experimental)
+
+Advanced commands are opt-in behind feature flags and still gated by per-model support.
+
+Status query (power/channel):
+
+```bash
+neewer-cli --light group:studio --status --enable-status-query --skip-discovery
+```
+
+Extended scene arguments (supported models only):
+
+```bash
+neewer-cli --light group:studio --mode SCENE --scene 12 --bri 40 \
+  --scene-hue-min 20 --scene-hue-max 240 --scene-speed 7 \
+  --enable-extended-scene
+```
+
+If auto-detection is wrong for a specific light, set `supports_status_query` or
+`supports_extended_scene` for that MAC in config.
+
+### Serve Mode
+
+`--serve` keeps BLE connections open and accepts commands from stdin:
+
+```bash
+neewer-cli --serve --light group:studio --skip-discovery --debug
+```
+
+Interactive commands:
+
+- `on`
+- `off`
+- `cct <temp> <bri> [gm]`
+- `hsi <hue> <sat> <bri>`
+- `scene <effect> <bri>`
+- `preset <name>`
+- `help`
+- `exit`
+
+## Security
+
+- Private vulnerability reporting is enabled.
+- Code scanning (CodeQL) is enabled for `python` and `actions`.
+- Secret scanning and push protection are enabled.
+
+Please report security issues privately per [SECURITY.md](SECURITY.md).
+
+## Releases
+
+GitHub releases include wheel and source distribution artifacts:
+
+- https://github.com/SergeDubovsky/neewer-cli/releases
+
+Maintainer release flow:
+
+1. Update `version` in `pyproject.toml`.
+2. Run local checks (`ruff`, `pytest`, `build`, `twine check`).
+3. Commit and push to `main`.
+4. Tag and push (`git tag vX.Y.Z && git push origin vX.Y.Z`).
+5. Release workflow:
+   - builds + tests
+   - publishes to TestPyPI (`testpypi` environment)
+   - publishes to PyPI (`pypi` environment)
+   - creates a GitHub Release with built artifacts
+
+Trusted Publishing setup requirement:
+
+- In both TestPyPI and PyPI project settings, add this repository/workflow as a Trusted Publisher for:
+  - owner/repo: `SergeDubovsky/neewer-cli`
+  - workflow: `.github/workflows/release.yml`
+  - environments: `testpypi` and `pypi`
+
+## Project Docs
+
+- Wiki home: https://github.com/SergeDubovsky/neewer-cli/wiki
+- Developer guide: https://github.com/SergeDubovsky/neewer-cli/wiki/Developer-Guide
+- Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)
+- Release process: [RELEASING.md](RELEASING.md)
+- Security policy: [SECURITY.md](SECURITY.md)
+- Support policy: [SUPPORT.md](SUPPORT.md)
+- Code of conduct: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT. See [LICENSE](LICENSE).

neewer_cli-0.1.1/README.md

@@ -0,0 +1,216 @@
+# neewer-cli
+
+[![CI](https://github.com/SergeDubovsky/neewer-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/SergeDubovsky/neewer-cli/actions/workflows/ci.yml)
+[![Release](https://github.com/SergeDubovsky/neewer-cli/actions/workflows/release.yml/badge.svg)](https://github.com/SergeDubovsky/neewer-cli/actions/workflows/release.yml)
+[![License: MIT](https://img.shields.io/github/license/SergeDubovsky/neewer-cli)](LICENSE)
+
+Standalone Neewer BLE command-line utility focused on fast and reliable control without a GUI.
+
+## Why This Tool
+
+- CLI-only workflow for scripting and automation.
+- Reliability controls for unstable BLE environments (retries, passes, bounded parallelism).
+- Fast fixed-rig operation with config-driven `--skip-discovery`.
+- Presets, groups, and per-light command overrides keyed by MAC.
+
+## Attribution
+
+This project is based on and derives protocol/model support from:
+
+- **NeewerLite-Python** by **Zach Glenwright**
+- https://github.com/taburineagle/NeewerLite-Python
+
+## Requirements
+
+- Python `3.9+`
+- Bluetooth adapter with BLE support
+
+The runtime BLE dependency (`bleak`) is installed automatically by package install commands below.
+
+## Installation
+
+Current recommended install (GitHub source):
+
+```bash
+# one-time install of pipx
+python -m pip install --user pipx
+python -m pipx ensurepath
+
+# install neewer-cli from GitHub
+pipx install git+https://github.com/SergeDubovsky/neewer-cli.git
+```
+
+Alternative user install:
+
+```bash
+python -m pip install --user git+https://github.com/SergeDubovsky/neewer-cli.git
+```
+
+After install:
+
+```bash
+neewer-cli --help
+neewer-cli --version
+```
+
+PyPI publishing is handled by GitHub Actions using Trusted Publishing (OIDC).
+
+## Quick Start
+
+```bash
+# 1) discover lights
+neewer-cli --list
+
+# 2) copy example config to default config path
+# Windows (PowerShell/CMD)
+copy neewer.example.json %USERPROFILE%\.neewer
+
+# macOS/Linux
+cp neewer.example.json ~/.neewer
+
+# 3) run presets
+neewer-cli --preset all_on
+neewer-cli --preset all_off
+neewer-cli --preset key_cct_5600_30
+```
+
+## Common Commands
+
+```bash
+# turn configured lights on/off quickly
+neewer-cli --preset all_on
+neewer-cli --preset all_off
+
+# send direct command to specific MACs
+neewer-cli --light D2:E2:75:8B:36:45,F8:46:85:EF:47:70 --mode CCT --temp 5600 --bri 30
+
+# fast fixed-rig mode (no scan)
+neewer-cli --light group:studio --preset all_on --skip-discovery
+
+# persistent low-latency mode (keep connections open)
+neewer-cli --serve --light group:studio --skip-discovery --debug
+```
+
+## Configuration
+
+Default config path:
+
+- `~/.neewer` (Windows: `%USERPROFILE%\.neewer`)
+
+Top-level config keys:
+
+- `defaults`: default CLI flags
+- `lights`: per-MAC metadata (`name`, `cct_only`, `infinity_mode`, `hw_mac`, optional feature flags)
+- `groups`: named MAC sets
+- `presets`: reusable command sets
+- `presets.<name>.per_light`: per-light command overrides in one run
+
+Optional per-light feature flags in `lights`:
+
+- `supports_status_query`: override model detection for `--status` query commands
+- `supports_extended_scene`: override model detection for extended scene payloads
+
+Reference material:
+
+- Example config: [neewer.example.json](neewer.example.json)
+- Wiki configuration guide: https://github.com/SergeDubovsky/neewer-cli/wiki/Configuration
+
+## Reliability Tuning
+
+For flaky BLE environments, tune:
+
+- `--scan-attempts`
+- `--resolve-timeout` (short BLE handle resolve scan for `--skip-discovery`)
+- `--connect-retries`
+- `--write-retries`
+- `--passes` (adaptive retries for failed lights only)
+- `--parallel`
+
+For stable fixed setups, keep `lights` fully defined in config and use `--skip-discovery` to reduce latency.
+
+## Advanced Protocol (Experimental)
+
+Advanced commands are opt-in behind feature flags and still gated by per-model support.
+
+Status query (power/channel):
+
+```bash
+neewer-cli --light group:studio --status --enable-status-query --skip-discovery
+```
+
+Extended scene arguments (supported models only):
+
+```bash
+neewer-cli --light group:studio --mode SCENE --scene 12 --bri 40 \
+  --scene-hue-min 20 --scene-hue-max 240 --scene-speed 7 \
+  --enable-extended-scene
+```
+
+If auto-detection is wrong for a specific light, set `supports_status_query` or
+`supports_extended_scene` for that MAC in config.
+
+### Serve Mode
+
+`--serve` keeps BLE connections open and accepts commands from stdin:
+
+```bash
+neewer-cli --serve --light group:studio --skip-discovery --debug
+```
+
+Interactive commands:
+
+- `on`
+- `off`
+- `cct <temp> <bri> [gm]`
+- `hsi <hue> <sat> <bri>`
+- `scene <effect> <bri>`
+- `preset <name>`
+- `help`
+- `exit`
+
+## Security
+
+- Private vulnerability reporting is enabled.
+- Code scanning (CodeQL) is enabled for `python` and `actions`.
+- Secret scanning and push protection are enabled.
+
+Please report security issues privately per [SECURITY.md](SECURITY.md).
+
+## Releases
+
+GitHub releases include wheel and source distribution artifacts:
+
+- https://github.com/SergeDubovsky/neewer-cli/releases
+
+Maintainer release flow:
+
+1. Update `version` in `pyproject.toml`.
+2. Run local checks (`ruff`, `pytest`, `build`, `twine check`).
+3. Commit and push to `main`.
+4. Tag and push (`git tag vX.Y.Z && git push origin vX.Y.Z`).
+5. Release workflow:
+   - builds + tests
+   - publishes to TestPyPI (`testpypi` environment)
+   - publishes to PyPI (`pypi` environment)
+   - creates a GitHub Release with built artifacts
+
+Trusted Publishing setup requirement:
+
+- In both TestPyPI and PyPI project settings, add this repository/workflow as a Trusted Publisher for:
+  - owner/repo: `SergeDubovsky/neewer-cli`
+  - workflow: `.github/workflows/release.yml`
+  - environments: `testpypi` and `pypi`
+
+## Project Docs
+
+- Wiki home: https://github.com/SergeDubovsky/neewer-cli/wiki
+- Developer guide: https://github.com/SergeDubovsky/neewer-cli/wiki/Developer-Guide
+- Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)
+- Release process: [RELEASING.md](RELEASING.md)
+- Security policy: [SECURITY.md](SECURITY.md)
+- Support policy: [SUPPORT.md](SUPPORT.md)
+- Code of conduct: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT. See [LICENSE](LICENSE).

neewer_cli-0.1.1/RELEASING.md

@@ -0,0 +1,43 @@
+# Releasing
+
+## 1) Bump Version
+
+Update `version` in `pyproject.toml`.
+
+## 2) Validate Locally
+
+```bash
+python -m ruff check .
+python -m pytest -q
+python -m build
+python -m twine check dist/*
+```
+
+## 3) Publish Source Changes
+
+```bash
+git add .
+git commit -m "Release vX.Y.Z"
+git push origin main
+```
+
+## 4) Create Tag
+
+```bash
+git tag vX.Y.Z
+git push origin vX.Y.Z
+```
+
+## 5) Verify GitHub Actions
+
+- `CI` workflow passes on `main`
+- `Release` workflow passes on tag (or manual dispatch with required `tag` input)
+- GitHub release contains:
+  - wheel (`.whl`)
+  - source dist (`.tar.gz`)
+
+## 6) Verify Repository Guards
+
+- `main` branch protection is enabled
+- PR review requirement is enabled
+- required status checks include CI matrix jobs

neewer_cli-0.1.1/SECURITY.md

@@ -0,0 +1,49 @@
+# Security Policy
+
+## Supported Versions
+
+Security fixes are provided for the latest released version and the current `main` branch.
+
+| Version | Supported |
+| --- | --- |
+| `main` | Yes |
+| Latest release | Yes |
+| Older releases | No |
+
+## Reporting a Vulnerability
+
+Do not open public issues for security vulnerabilities.
+
+Please report privately via:
+
+- GitHub Security Advisories: https://github.com/SergeDubovsky/neewer-cli/security/advisories/new
+
+Include:
+
+- affected version
+- reproduction steps
+- expected and actual behavior
+- potential impact
+
+## Triage and Response Targets
+
+- Initial acknowledgment: within 72 hours
+- Triage outcome and severity assessment: within 7 days
+- Remediation timeline: shared after triage
+
+Severity is assessed using impact, exploitability, and affected surface area.
+
+## Disclosure Policy
+
+- Please allow time for a fix before public disclosure.
+- After a fix is available, maintainers will publish a coordinated advisory.
+- Credit is given to reporters unless they request anonymity.
+
+## Scope
+
+This project is a local BLE CLI utility. Security reports are most useful when they involve:
+
+- unsafe handling of untrusted input/config
+- credential/token leakage risks
+- supply chain risks in build/release workflows
+- command execution or privilege escalation paths

neewer_cli-0.1.1/SUPPORT.md

@@ -0,0 +1,22 @@
+# Support
+
+## Usage Questions
+
+Open a GitHub Discussion or Issue:
+
+- Discussions: https://github.com/SergeDubovsky/neewer-cli/discussions
+- Issues: https://github.com/SergeDubovsky/neewer-cli/issues
+
+## Bug Reports
+
+Please include:
+
+- OS and Python version
+- CLI command used
+- sanitized config snippet
+- `--debug` output
+- expected vs actual behavior
+
+## Security Issues
+
+Use the private security reporting flow in `SECURITY.md`.