tizen-tool 0.1.0__tar.gz

tizen_tool-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+.tmp/
+.tizen-tool/
+.venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+build/
+dist/
+*.egg-info/
+.env
+__pycache__/

tizen_tool-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ruslan Khasanshin
+
+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.

tizen_tool-0.1.0/PKG-INFO

@@ -0,0 +1,240 @@
+Metadata-Version: 2.4
+Name: tizen-tool
+Version: 0.1.0
+Summary: tizen-tool is a small CLI for building, re-signing, and installing Tizen web packages through a Dockerized Tizen Studio environment
+Project-URL: Homepage, https://github.com/hu553in/tizen-tool
+Project-URL: Repository, https://github.com/hu553in/tizen-tool
+Project-URL: Issues, https://github.com/hu553in/tizen-tool/issues
+Project-URL: Changelog, https://github.com/hu553in/tizen-tool/releases
+Author: Ruslan Khasanshin
+Maintainer: Ruslan Khasanshin
+License-Expression: MIT
+License-File: LICENSE
+Keywords: automation,cli,deployment,developer-tools,docker,packaging,samsung-tv,signing,tizen,tizen-studio,tizen-tv,web-app,wgt
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: defusedxml==0.7.1
+Requires-Dist: pathspec==1.0.4
+Requires-Dist: pydantic-settings==2.13.1
+Requires-Dist: typer==0.24.1
+Description-Content-Type: text/markdown
+
+# Tizen tool
+
+[![CI](https://github.com/hu553in/tizen-tool/actions/workflows/ci.yml/badge.svg)](https://github.com/hu553in/tizen-tool/actions/workflows/ci.yml)
+
+- [License](./LICENSE)
+- [How to contribute](./CONTRIBUTING.md)
+- [Code of conduct](./CODE_OF_CONDUCT.md)
+
+`tizen-tool` is a small CLI for building, re-signing, and installing Tizen web packages
+through a Dockerized Tizen Studio environment.
+
+It provides:
+
+- a reproducible Tizen Studio setup inside Docker
+- `build`, `resign`, and `install` commands
+- strict configuration loading from CLI arguments and `.env`
+- installer checksum verification
+- Docker image reuse keyed by the tool version, required packages, and bundled Docker resources
+
+The project is intentionally small. It is designed to remain predictable, easy to audit,
+and simple to run from a single working directory.
+
+---
+
+## What it does
+
+- Builds a `.wgt` package from a Tizen web app directory
+- Re-signs an existing `.wgt` package with a configured profile
+- Installs a `.wgt` package on a TV over `sdb`
+- Builds and reuses a local Docker image with Tizen Studio and the required Tizen packages
+
+Typical workflow:
+
+1. Configure `.env`
+2. Build or re-sign a package
+3. Install it on a TV
+
+---
+
+## Requirements
+
+- Python 3.10 or newer
+- Docker with Linux image support
+- [uv](https://docs.astral.sh/uv/)
+- a valid Tizen signing profile directory containing `profiles.xml`
+
+The default local development version is Python 3.14, as defined in
+[`.python-version`](./.python-version). CI also runs on Python 3.14.
+
+---
+
+## Installation
+
+### Install as a tool
+
+```bash
+uv tool install tizen-tool
+```
+
+You can also use `pipx`:
+
+```bash
+pipx install tizen-tool
+```
+
+### Local development
+
+```bash
+make install_deps
+```
+
+---
+
+## Configuration
+
+The tool reads `.env` from the current working directory. CLI arguments override `.env` values.
+
+| Name                                                               | Required         | Description                                                                                          |
+| ------------------------------------------------------------------ | ---------------- | ---------------------------------------------------------------------------------------------------- |
+| `TIZEN_VERSION`                                                    | Yes              | Tizen Studio version used to resolve the installer URL.                                              |
+| `REQUIRED_PACKAGES`                                                | Yes              | JSON array of Tizen package IDs installed into the Docker image.                                     |
+| `TIZEN_INSTALLER_SHA256`                                           | Yes              | Expected SHA-256 checksum for the installer binary.                                                  |
+| `PROFILES_DIR`                                                     | Build / resign   | Directory containing `profiles.xml`. Relative paths are resolved from the current working directory. |
+| `PROFILE`                                                          | Build / resign   | Signing profile name from `profiles.xml`.                                                            |
+| `TV_IP`                                                            | Install          | TV address or serial. Accepted forms: `host`, `host:port`, `IPv4`, or `[IPv6]:port`.                 |
+| `BUILD_SRC_DIR` or `SRC_DIR`                                       | Build fallback   | Source directory for the app when not passed on the CLI.                                             |
+| `BUILDIGNORE_FILE` or `BUILD_IGNORE_FILE`                          | Build fallback   | Optional gitignore-style exclude file for the build copy step.                                       |
+| `BUILD_REBUILD`, `INSTALL_REBUILD`, `RESIGN_REBUILD`, or `REBUILD` | No               | Forces Docker image rebuilding for the corresponding command.                                        |
+| `INSTALL_PACKAGE_FILE` or `PACKAGE_FILE`                           | Install fallback | `.wgt` package path used when not passed on the CLI.                                                 |
+| `RESIGN_PACKAGE_FILE` or `PACKAGE_FILE`                            | Resign fallback  | `.wgt` package path used when not passed on the CLI.                                                 |
+
+See [`.env.example`](./.env.example) for a complete example.
+
+---
+
+## Commands
+
+Build a package:
+
+```bash
+tizen-tool build /path/to/app
+```
+
+Build with explicit package overrides:
+
+```bash
+tizen-tool build /path/to/app \
+  --required-package TV-Samsung_Public_6.0 \
+  --required-package TV-Samsung_Wearable_6.0
+```
+
+Re-sign a package:
+
+```bash
+tizen-tool resign /path/to/app.wgt
+```
+
+Install a package on the configured TV:
+
+```bash
+tizen-tool install /path/to/app.wgt
+```
+
+Override the TV target from the CLI:
+
+```bash
+tizen-tool install /path/to/app.wgt --tv-ip 192.168.1.100
+```
+
+Force rebuilding the Docker image:
+
+```bash
+tizen-tool build /path/to/app --rebuild
+```
+
+You can also run the package directly from a checkout:
+
+```bash
+uv run tizen-tool --help
+```
+
+---
+
+## Outputs and runtime behavior
+
+- `build` copies the app into a temporary directory, runs `tizen build-web`,
+  and writes the final `.wgt` to `dist/` inside the source directory
+- `resign` writes the new package to `resigned/` next to the source package
+- `install` mounts the package directory read-only and installs by package name over `sdb`
+- temporary files are stored under `.tizen-tool/tmp/` in the current working directory
+- the Docker image is reused unless its identifying labels no longer match the requested configuration
+
+During image build, the installer helper tries both known Tizen installer URL patterns
+and stops at the first successful match.
+
+---
+
+## Development
+
+Useful commands:
+
+```bash
+make install_deps
+make lint
+make check_types
+make check
+make check_deps_updates
+make check_deps_vuln
+make build
+```
+
+The development toolchain uses:
+
+- `ruff`
+- `ty`
+- `prek`
+- `pysentry-rs`
+- `bandit`
+
+Run the full local check suite:
+
+```bash
+make check
+```
+
+---
+
+## Release
+
+Create a release from the `main` branch with a clean working tree:
+
+```bash
+make release V=0.1.0
+```
+
+The `release` target:
+
+- installs dependencies
+- runs the local checks
+- builds distributions
+- updates the version if `V` differs from the current project version
+- commits and pushes the version bump when needed
+- creates and pushes the annotated tag `v<V>`
+
+GitHub Actions publishes tagged releases to PyPI from
+[`.github/workflows/ci.yml`](./.github/workflows/ci.yml).

tizen_tool-0.1.0/README.md

@@ -0,0 +1,206 @@
+# Tizen tool
+
+[![CI](https://github.com/hu553in/tizen-tool/actions/workflows/ci.yml/badge.svg)](https://github.com/hu553in/tizen-tool/actions/workflows/ci.yml)
+
+- [License](./LICENSE)
+- [How to contribute](./CONTRIBUTING.md)
+- [Code of conduct](./CODE_OF_CONDUCT.md)
+
+`tizen-tool` is a small CLI for building, re-signing, and installing Tizen web packages
+through a Dockerized Tizen Studio environment.
+
+It provides:
+
+- a reproducible Tizen Studio setup inside Docker
+- `build`, `resign`, and `install` commands
+- strict configuration loading from CLI arguments and `.env`
+- installer checksum verification
+- Docker image reuse keyed by the tool version, required packages, and bundled Docker resources
+
+The project is intentionally small. It is designed to remain predictable, easy to audit,
+and simple to run from a single working directory.
+
+---
+
+## What it does
+
+- Builds a `.wgt` package from a Tizen web app directory
+- Re-signs an existing `.wgt` package with a configured profile
+- Installs a `.wgt` package on a TV over `sdb`
+- Builds and reuses a local Docker image with Tizen Studio and the required Tizen packages
+
+Typical workflow:
+
+1. Configure `.env`
+2. Build or re-sign a package
+3. Install it on a TV
+
+---
+
+## Requirements
+
+- Python 3.10 or newer
+- Docker with Linux image support
+- [uv](https://docs.astral.sh/uv/)
+- a valid Tizen signing profile directory containing `profiles.xml`
+
+The default local development version is Python 3.14, as defined in
+[`.python-version`](./.python-version). CI also runs on Python 3.14.
+
+---
+
+## Installation
+
+### Install as a tool
+
+```bash
+uv tool install tizen-tool
+```
+
+You can also use `pipx`:
+
+```bash
+pipx install tizen-tool
+```
+
+### Local development
+
+```bash
+make install_deps
+```
+
+---
+
+## Configuration
+
+The tool reads `.env` from the current working directory. CLI arguments override `.env` values.
+
+| Name                                                               | Required         | Description                                                                                          |
+| ------------------------------------------------------------------ | ---------------- | ---------------------------------------------------------------------------------------------------- |
+| `TIZEN_VERSION`                                                    | Yes              | Tizen Studio version used to resolve the installer URL.                                              |
+| `REQUIRED_PACKAGES`                                                | Yes              | JSON array of Tizen package IDs installed into the Docker image.                                     |
+| `TIZEN_INSTALLER_SHA256`                                           | Yes              | Expected SHA-256 checksum for the installer binary.                                                  |
+| `PROFILES_DIR`                                                     | Build / resign   | Directory containing `profiles.xml`. Relative paths are resolved from the current working directory. |
+| `PROFILE`                                                          | Build / resign   | Signing profile name from `profiles.xml`.                                                            |
+| `TV_IP`                                                            | Install          | TV address or serial. Accepted forms: `host`, `host:port`, `IPv4`, or `[IPv6]:port`.                 |
+| `BUILD_SRC_DIR` or `SRC_DIR`                                       | Build fallback   | Source directory for the app when not passed on the CLI.                                             |
+| `BUILDIGNORE_FILE` or `BUILD_IGNORE_FILE`                          | Build fallback   | Optional gitignore-style exclude file for the build copy step.                                       |
+| `BUILD_REBUILD`, `INSTALL_REBUILD`, `RESIGN_REBUILD`, or `REBUILD` | No               | Forces Docker image rebuilding for the corresponding command.                                        |
+| `INSTALL_PACKAGE_FILE` or `PACKAGE_FILE`                           | Install fallback | `.wgt` package path used when not passed on the CLI.                                                 |
+| `RESIGN_PACKAGE_FILE` or `PACKAGE_FILE`                            | Resign fallback  | `.wgt` package path used when not passed on the CLI.                                                 |
+
+See [`.env.example`](./.env.example) for a complete example.
+
+---
+
+## Commands
+
+Build a package:
+
+```bash
+tizen-tool build /path/to/app
+```
+
+Build with explicit package overrides:
+
+```bash
+tizen-tool build /path/to/app \
+  --required-package TV-Samsung_Public_6.0 \
+  --required-package TV-Samsung_Wearable_6.0
+```
+
+Re-sign a package:
+
+```bash
+tizen-tool resign /path/to/app.wgt
+```
+
+Install a package on the configured TV:
+
+```bash
+tizen-tool install /path/to/app.wgt
+```
+
+Override the TV target from the CLI:
+
+```bash
+tizen-tool install /path/to/app.wgt --tv-ip 192.168.1.100
+```
+
+Force rebuilding the Docker image:
+
+```bash
+tizen-tool build /path/to/app --rebuild
+```
+
+You can also run the package directly from a checkout:
+
+```bash
+uv run tizen-tool --help
+```
+
+---
+
+## Outputs and runtime behavior
+
+- `build` copies the app into a temporary directory, runs `tizen build-web`,
+  and writes the final `.wgt` to `dist/` inside the source directory
+- `resign` writes the new package to `resigned/` next to the source package
+- `install` mounts the package directory read-only and installs by package name over `sdb`
+- temporary files are stored under `.tizen-tool/tmp/` in the current working directory
+- the Docker image is reused unless its identifying labels no longer match the requested configuration
+
+During image build, the installer helper tries both known Tizen installer URL patterns
+and stops at the first successful match.
+
+---
+
+## Development
+
+Useful commands:
+
+```bash
+make install_deps
+make lint
+make check_types
+make check
+make check_deps_updates
+make check_deps_vuln
+make build
+```
+
+The development toolchain uses:
+
+- `ruff`
+- `ty`
+- `prek`
+- `pysentry-rs`
+- `bandit`
+
+Run the full local check suite:
+
+```bash
+make check
+```
+
+---
+
+## Release
+
+Create a release from the `main` branch with a clean working tree:
+
+```bash
+make release V=0.1.0
+```
+
+The `release` target:
+
+- installs dependencies
+- runs the local checks
+- builds distributions
+- updates the version if `V` differs from the current project version
+- commits and pushes the version bump when needed
+- creates and pushes the annotated tag `v<V>`
+
+GitHub Actions publishes tagged releases to PyPI from
+[`.github/workflows/ci.yml`](./.github/workflows/ci.yml).

tizen_tool-0.1.0/pyproject.toml

@@ -0,0 +1,98 @@
+[project]
+name = "tizen-tool"
+version = "0.1.0"
+description = "tizen-tool is a small CLI for building, re-signing, and installing Tizen web packages through a Dockerized Tizen Studio environment"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Ruslan Khasanshin" }]
+maintainers = [{ name = "Ruslan Khasanshin" }]
+
+keywords = [
+  "tizen",
+  "tizen-studio",
+  "tizen-tv",
+  "samsung-tv",
+  "cli",
+  "docker",
+  "wgt",
+  "web-app",
+  "packaging",
+  "signing",
+  "deployment",
+  "developer-tools",
+  "automation",
+]
+
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development",
+  "Topic :: Software Development :: Build Tools",
+  "Topic :: Utilities",
+]
+
+dependencies = [
+  "defusedxml==0.7.1",
+  "pathspec==1.0.4",
+  "pydantic-settings==2.13.1",
+  "typer==0.24.1",
+]
+
+[project.scripts]
+tizen-tool = "tizen_tool.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/hu553in/tizen-tool"
+Repository = "https://github.com/hu553in/tizen-tool"
+Issues = "https://github.com/hu553in/tizen-tool/issues"
+Changelog = "https://github.com/hu553in/tizen-tool/releases"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tizen_tool"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src/tizen_tool", "/README.md", "/LICENSE", "/pyproject.toml"]
+
+[dependency-groups]
+dev = [
+  "bandit==1.9.4",
+  "prek==0.3.6",
+  "pysentry-rs==0.4.3",
+  "ruff==0.15.7",
+  "ty==0.0.24",
+]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+extend-exclude = [".venv"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "ARG", "PL", "RUF"]
+
+[tool.ruff.lint.isort]
+split-on-trailing-comma = false
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = true
+
+[tool.pysentry.defaults]
+sources = "pypa,pypi,osv"
+fail_on = "low"

tizen_tool-0.1.0/src/tizen_tool/__init__.py

@@ -0,0 +1 @@
+"""Tizen tool."""

tizen_tool-0.1.0/src/tizen_tool/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

tizen_tool-0.1.0/src/tizen_tool/bundled_resources.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+import hashlib
+from importlib.resources import files
+from pathlib import Path
+
+RESOURCE_PACKAGE = "tizen_tool.resources"
+
+
+def resource_bytes(relative_path: str) -> bytes:
+    return files(RESOURCE_PACKAGE).joinpath(relative_path).read_bytes()
+
+
+def build_context_fingerprint() -> str:
+    hasher = hashlib.sha256()
+    for relative_path in ("Dockerfile", "install_tizen_studio.py"):
+        content = resource_bytes(relative_path)
+        hasher.update(relative_path.encode("utf-8"))
+        hasher.update(b"\0")
+        hasher.update(content)
+        hasher.update(b"\0")
+    return hasher.hexdigest()
+
+
+def materialize_build_context(target_dir: Path) -> None:
+    target_dir.mkdir(parents=True, exist_ok=True)
+    (target_dir / "Dockerfile").write_bytes(resource_bytes("Dockerfile"))
+    (target_dir / "install_tizen_studio.py").write_bytes(resource_bytes("install_tizen_studio.py"))