odoo-plugin-manager 0.1.0__tar.gz

odoo_plugin_manager-0.1.0/LICENSE

@@ -0,0 +1,23 @@
+GNU GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright (C) 2025 Ahmet Atakan
+
+Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+Preamble
+
+The GNU General Public License is a free, copyleft license for software and other kinds of works.
+
+The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program–to make sure it remains free software for all its users.
+
+When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things.
+
+To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others.
+
+For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.
+
+Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it.
+
+For the full text of the GNU General Public License v3, please see:
+https://www.gnu.org/licenses/gpl-3.0.en.html

odoo_plugin_manager-0.1.0/MANIFEST.in

@@ -0,0 +1,20 @@
+# -------------------------------
+# MANIFEST.in — OPM packaging rules
+# -------------------------------
+
+# Include essential project metadata
+include README.md
+include LICENSE*
+include pyproject.toml
+
+# Exclude local/dev artifacts
+exclude setup.sh
+exclude opm.yaml
+prune .opm
+
+# Exclude Odoo addons (not part of CLI)
+exclude addons
+prune addons
+
+exclude .env
+exclude .env.*

odoo_plugin_manager-0.1.0/PKG-INFO

@@ -0,0 +1,247 @@
+Metadata-Version: 2.4
+Name: odoo-plugin-manager
+Version: 0.1.0
+Summary: OPM - Plugin Manager for Odoo (CLI)
+Author: Ahmet Atakan
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://example.com/opm
+Project-URL: Source, https://example.com/opm/repo
+Project-URL: Issues, https://example.com/opm/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12.3
+Requires-Dist: rich>=13.7.1
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: watchdog>=4.0.2
+Requires-Dist: requests>=2.32.0
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Dynamic: license-file
+
+# 🧩 OPM — Odoo Plugin Manager (CLI)
+
+**OPM** is a modern and lightweight command-line tool for Odoo developers.
+It streamlines development and testing by providing smart automation for cache refreshes,
+module testing, and environment management — without restarting Odoo.
+
+Designed for developers who want to work faster and cleaner with **Odoo 14 → 17+**.
+
+---
+
+## ⚙️ Installation
+
+Install from PyPI:
+
+```bash
+pip install opm
+```
+
+---
+
+## 📁 Configuration
+
+When you first run OPM, it automatically creates an `opm.yaml` configuration file in your working directory.
+This file defines your Odoo connection details and development environment.
+
+Example:
+
+```yaml
+runtime:
+  odoo_url: "http://localhost:10017"
+  db: "main"
+  user: "admin"
+  pass: "admin"
+  addons:
+    - "/path/to/odoo/addons"
+  container: "odoo17"
+```
+
+> OPM automatically reads this file for every command.
+> No manual setup or environment variables required.
+
+---
+
+## 🚀 Commands
+
+### 🪄 `opm init`
+
+Initializes a new OPM project by generating a sample `opm.yaml` configuration file.
+You can edit this file to match your Odoo environment (URL, DB, user, etc.).
+
+```bash
+opm init
+```
+
+Example output:
+
+```
+[opm] Creating opm.yaml configuration...
+[opm] ✅ Configuration created successfully at ./opm.yaml
+```
+
+After running `opm init`, you can immediately start developing with:
+
+```bash
+opm dev
+```
+
+---
+
+### 🔧 `opm dev`
+
+Starts **development mode**, watching your Odoo addons directory for changes.
+Whenever you modify an XML, JS, or QWeb file, OPM triggers an automatic cache flush through RPC —
+instantly reflecting UI and view updates without restarting Odoo.
+
+```bash
+opm dev
+```
+
+Example output:
+
+```
+[opm] Connected to Odoo environment 'runtime'
+[opm] Watching for changes in: /addons
+[opm] Asset/template changed: queue_job/views/menu.xml → flush caches
+```
+
+> ⚠️ Note: This is **not full hot reload** — Python code changes still require a manual reload.
+> XML, QWeb, and JS updates are applied live through Odoo’s cache system.
+
+---
+
+### 🧪 `opm test <module>`
+
+Runs tests for the specified Odoo module.
+If the module is not yet installed, OPM automatically installs or upgrades it before running tests.
+
+```bash
+opm test my_module
+```
+
+Example:
+
+```
+[opm] Odoo binary detected: /usr/bin/odoo
+[opm] Running tests for module: my_module
+✅ Tests finished successfully.
+```
+
+If something goes wrong:
+
+```
+❌ Tests failed. See .opm/artifacts/test_last.log for details.
+```
+
+All test outputs and logs are automatically saved to:
+
+```
+.opm/artifacts/
+```
+
+> The test command is ideal for CI/CD pipelines or quick module validation
+> without manually launching Odoo.
+
+---
+
+### 🩺 `opm diagnose`
+
+Runs a quick environment diagnostic to ensure OPM and Odoo are properly connected.
+
+```bash
+opm diagnose
+```
+
+Example output:
+
+```
+[opm] 🔍 Running environment diagnostics...
+[opm] Docker CLI: ✅ Found
+[opm] Odoo binary: ✅ Found (/usr/bin/odoo)
+[opm] Testing Odoo URL: http://localhost:10017
+[opm] ✅ Odoo instance reachable.
+[opm] 🏁 Diagnose complete.
+```
+
+---
+
+## 🧩 Features
+
+| Feature                        | Description                                                         |
+| ------------------------------ | ------------------------------------------------------------------- |
+| ⚙️ **Automatic Cache Refresh** | Detects XML, QWeb, or JS changes and flushes Odoo caches instantly. |
+| 🧪 **Module Install/Upgrade**  | Automatically installs or upgrades modules before running tests.    |
+| 🗱 **Docker Integration**      | Detects and executes inside Odoo containers automatically.          |
+| 📦 **Artifact Logging**        | Saves logs and test outputs under `.opm/artifacts/`.                |
+| ⚡ **YAML Config System**       | Uses a single `opm.yaml` file for all environment details.          |
+| 🧠 **RPC-Based Architecture**  | Works with Odoo via XML-RPC — no code injection or patching needed. |
+
+---
+
+## 🔮 Future Roadmap
+
+These are upcoming features currently under development:
+
+* 🔁 **Hot Reload** — true live reload support for Odoo front-end assets
+* 🧩 **Advanced Helper Addon (`opm_dev_helper`)** — deeper cache and UI refresh controls
+* 📊 **Improved Test Reporting** — detailed test result summaries and coverage integration
+
+---
+
+## 🧠 Technical Overview
+
+| Key                    | Details                                             |
+| ---------------------- | --------------------------------------------------- |
+| **Language**           | Python 3.10+                                        |
+| **Dependencies**       | typer, rich, watchdog, requests, pyyaml, websockets |
+| **Odoo Compatibility** | 14 → 17+                                            |
+| **Platforms**          | macOS / Linux                                       |
+| **Configuration File** | `opm.yaml` (auto-created on first run)              |
+
+---
+
+## 🦦 Example Workflow
+
+A simple developer workflow might look like this:
+
+```bash
+# 1️⃣ Initialize config
+opm init
+
+# 2️⃣ Check your setup
+opm diagnose
+
+# 3️⃣ Start development mode (watch for file changes)
+opm dev
+
+# 4️⃣ Run tests for your module
+opm test my_module
+```
+
+This setup keeps your Odoo instance responsive
+and your local development cycle short — no manual restarts needed.
+
+---
+
+## 📜 License
+
+Licensed under the **GNU General Public License v3 (GPL-3.0-or-later)**.
+The OPM CLI is open source.
+Future Odoo-specific helper addons may be released under a separate commercial license.
+
+---
+
+© 2025 Ahmet Atakan — Crafted for real Odoo developers who build faster, smarter, and cleaner.

odoo_plugin_manager-0.1.0/README.md

@@ -0,0 +1,214 @@
+# 🧩 OPM — Odoo Plugin Manager (CLI)
+
+**OPM** is a modern and lightweight command-line tool for Odoo developers.
+It streamlines development and testing by providing smart automation for cache refreshes,
+module testing, and environment management — without restarting Odoo.
+
+Designed for developers who want to work faster and cleaner with **Odoo 14 → 17+**.
+
+---
+
+## ⚙️ Installation
+
+Install from PyPI:
+
+```bash
+pip install opm
+```
+
+---
+
+## 📁 Configuration
+
+When you first run OPM, it automatically creates an `opm.yaml` configuration file in your working directory.
+This file defines your Odoo connection details and development environment.
+
+Example:
+
+```yaml
+runtime:
+  odoo_url: "http://localhost:10017"
+  db: "main"
+  user: "admin"
+  pass: "admin"
+  addons:
+    - "/path/to/odoo/addons"
+  container: "odoo17"
+```
+
+> OPM automatically reads this file for every command.
+> No manual setup or environment variables required.
+
+---
+
+## 🚀 Commands
+
+### 🪄 `opm init`
+
+Initializes a new OPM project by generating a sample `opm.yaml` configuration file.
+You can edit this file to match your Odoo environment (URL, DB, user, etc.).
+
+```bash
+opm init
+```
+
+Example output:
+
+```
+[opm] Creating opm.yaml configuration...
+[opm] ✅ Configuration created successfully at ./opm.yaml
+```
+
+After running `opm init`, you can immediately start developing with:
+
+```bash
+opm dev
+```
+
+---
+
+### 🔧 `opm dev`
+
+Starts **development mode**, watching your Odoo addons directory for changes.
+Whenever you modify an XML, JS, or QWeb file, OPM triggers an automatic cache flush through RPC —
+instantly reflecting UI and view updates without restarting Odoo.
+
+```bash
+opm dev
+```
+
+Example output:
+
+```
+[opm] Connected to Odoo environment 'runtime'
+[opm] Watching for changes in: /addons
+[opm] Asset/template changed: queue_job/views/menu.xml → flush caches
+```
+
+> ⚠️ Note: This is **not full hot reload** — Python code changes still require a manual reload.
+> XML, QWeb, and JS updates are applied live through Odoo’s cache system.
+
+---
+
+### 🧪 `opm test <module>`
+
+Runs tests for the specified Odoo module.
+If the module is not yet installed, OPM automatically installs or upgrades it before running tests.
+
+```bash
+opm test my_module
+```
+
+Example:
+
+```
+[opm] Odoo binary detected: /usr/bin/odoo
+[opm] Running tests for module: my_module
+✅ Tests finished successfully.
+```
+
+If something goes wrong:
+
+```
+❌ Tests failed. See .opm/artifacts/test_last.log for details.
+```
+
+All test outputs and logs are automatically saved to:
+
+```
+.opm/artifacts/
+```
+
+> The test command is ideal for CI/CD pipelines or quick module validation
+> without manually launching Odoo.
+
+---
+
+### 🩺 `opm diagnose`
+
+Runs a quick environment diagnostic to ensure OPM and Odoo are properly connected.
+
+```bash
+opm diagnose
+```
+
+Example output:
+
+```
+[opm] 🔍 Running environment diagnostics...
+[opm] Docker CLI: ✅ Found
+[opm] Odoo binary: ✅ Found (/usr/bin/odoo)
+[opm] Testing Odoo URL: http://localhost:10017
+[opm] ✅ Odoo instance reachable.
+[opm] 🏁 Diagnose complete.
+```
+
+---
+
+## 🧩 Features
+
+| Feature                        | Description                                                         |
+| ------------------------------ | ------------------------------------------------------------------- |
+| ⚙️ **Automatic Cache Refresh** | Detects XML, QWeb, or JS changes and flushes Odoo caches instantly. |
+| 🧪 **Module Install/Upgrade**  | Automatically installs or upgrades modules before running tests.    |
+| 🗱 **Docker Integration**      | Detects and executes inside Odoo containers automatically.          |
+| 📦 **Artifact Logging**        | Saves logs and test outputs under `.opm/artifacts/`.                |
+| ⚡ **YAML Config System**       | Uses a single `opm.yaml` file for all environment details.          |
+| 🧠 **RPC-Based Architecture**  | Works with Odoo via XML-RPC — no code injection or patching needed. |
+
+---
+
+## 🔮 Future Roadmap
+
+These are upcoming features currently under development:
+
+* 🔁 **Hot Reload** — true live reload support for Odoo front-end assets
+* 🧩 **Advanced Helper Addon (`opm_dev_helper`)** — deeper cache and UI refresh controls
+* 📊 **Improved Test Reporting** — detailed test result summaries and coverage integration
+
+---
+
+## 🧠 Technical Overview
+
+| Key                    | Details                                             |
+| ---------------------- | --------------------------------------------------- |
+| **Language**           | Python 3.10+                                        |
+| **Dependencies**       | typer, rich, watchdog, requests, pyyaml, websockets |
+| **Odoo Compatibility** | 14 → 17+                                            |
+| **Platforms**          | macOS / Linux                                       |
+| **Configuration File** | `opm.yaml` (auto-created on first run)              |
+
+---
+
+## 🦦 Example Workflow
+
+A simple developer workflow might look like this:
+
+```bash
+# 1️⃣ Initialize config
+opm init
+
+# 2️⃣ Check your setup
+opm diagnose
+
+# 3️⃣ Start development mode (watch for file changes)
+opm dev
+
+# 4️⃣ Run tests for your module
+opm test my_module
+```
+
+This setup keeps your Odoo instance responsive
+and your local development cycle short — no manual restarts needed.
+
+---
+
+## 📜 License
+
+Licensed under the **GNU General Public License v3 (GPL-3.0-or-later)**.
+The OPM CLI is open source.
+Future Odoo-specific helper addons may be released under a separate commercial license.
+
+---
+
+© 2025 Ahmet Atakan — Crafted for real Odoo developers who build faster, smarter, and cleaner.

odoo_plugin_manager-0.1.0/pyproject.toml

@@ -0,0 +1,65 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "odoo-plugin-manager"
+version = "0.1.0"
+description = "OPM - Plugin Manager for Odoo (CLI)"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "Ahmet Atakan" }]
+license = "GPL-3.0-or-later"
+
+dependencies = [
+  "typer>=0.12.3",
+  "rich>=13.7.1",
+  "pyyaml>=6.0.1",
+  "watchdog>=4.0.2",
+  "requests>=2.32.0",
+  "python-dotenv>=1.0.1",
+  "websockets>=12.0"
+]
+
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Operating System :: OS Independent"
+]
+
+[project.urls]
+Homepage = "https://example.com/opm"
+Source = "https://example.com/opm/repo"
+Issues = "https://example.com/opm/issues"
+
+[project.scripts]
+opm = "opm.cli.__main__:app"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+include-package-data = true
+license-files = ["LICENSE"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["opm*"]
+exclude = ["opm.tests*"]
+
+[tool.setuptools.package-data]
+opm = [
+  "**/*.yaml", "**/*.yml",
+  "**/*.jinja", "**/*.j2", "**/*.tmpl",
+  "**/*.json", "**/*.txt"
+]
+
+[project.optional-dependencies]
+dev = [
+  "build",
+  "twine",
+  "pytest",
+  "black",
+  "ruff",
+  "mypy"
+]

odoo_plugin_manager-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+