drupal-scout 3.0.0__tar.gz → 3.0.2__tar.gz

{drupal_scout-3.0.0/drupal_scout.egg-info → drupal_scout-3.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drupal-scout
-Version: 3.0.0
+Version: 3.0.2
 Summary: Scout out for transitive versions of Drupal modules for the upgrade of the core.
 Author-email: "Andrew [R-Tech] Tsyhaniuk" <in0mad91@gmail.com>
 License: MIT License
@@ -47,6 +47,7 @@ Requires-Dist: packaging
 Requires-Dist: fastmcp
 Requires-Dist: rich>=15.0.0
 Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
 Requires-Dist: nose; extra == "dev"
 Requires-Dist: coverage; extra == "dev"
 Requires-Dist: pipdeptree; extra == "dev"
@@ -57,66 +58,110 @@ Dynamic: license-file
 
 # Drupal Scout
 
-Search for Drupal module entries with transitive core version requirements to help to upgrade the Drupal Core
+Search for Drupal module entries with transitive core version requirements to help to upgrade the Drupal Core.
 
 ## Installation
 
+### Using uv (Recommended)
+
+```bash
+uv tool install drupal-scout
+```
+
+Or run directly without installing:
+
+```bash
+uvx drupal-scout --help
+```
+
+### Using pip
+
+```bash
+pip install drupal-scout
+```
+
+## Quick Start
+
+Get a compatibility report for your current Drupal project:
+
+```bash
+drupal-scout
+```
+
+Scan a specific module for Drupal 11 compatibility:
+
 ```bash
-  pip install drupal-scout
+drupal-scout --core 11.0.0 --modules drupal/webform
 ```
 
 ## Features
 
-- Use asyncio concurrency to speed up the process of searching for Drupal module entries with transitive core version requirements.
-- Quick self-diagnostic check of the environment and dependencies using the `info` command.
-- Choose between three output formats: table, json, and suggest.  
-    - `table` format will output the data in the table format.  
-    Example:
-    ![Table format example](https://raw.githubusercontent.com/rtech91/drupal-scout/main/screenshots/format_table_example.png)
-    - `json` format will output the raw data in the json format.  
-    - `suggest` format will output the suggested composer.json file with the updated module version requirements.  
-    It will also dump the suggested composer.json file to the specified path if the `--save-dump` argument is used.
+- **Asyncio Concurrency**: High-performance parallel module scanning using `asyncio` to speed up dependency analysis.
+- **Rich TUI Integration**: Beautiful terminal output with structured tables and real-time progress bars powered by the `rich` library.
+- **MCP Server Support**: Built-in [Model Context Protocol](https://modelcontextprotocol.io/) server for integration with AI IDEs (like Claude Desktop or Cursor).
+- **Environment Diagnostics**: Quick self-diagnostic check of the environment and dependencies using the `info` command.
+- **Multiple Output Formats**:
+  - `table`: High-fidelity color-coded table for human readability.
+  - `json`: Machine-readable raw data for automation scripts.
+  - `suggest`: Generates a suggested `composer.json` with updated version requirements.
 
 ## Limitations
 
-- The application will only work with Composer-based (Composer v2) Drupal 8+ projects. 
+- **Python 3.11+**: The application requires Python 3.11 or higher.
+- **Composer v2**: The application works with **Composer-based (Composer v2)** Drupal 8+ projects.
 
 ## Usage/Examples
 
-`drupal-scout [-h] [-v] [-d DIRECTORY] [-n] [-l LIMIT] [-f {table,json,suggest}] [-s] [-c CORE] [-m MODULES [MODULES ...]] {info} ...`
+```bash
+drupal-scout [-h] [-v] [-d DIRECTORY] [-n] [-l LIMIT] [-f {table,json,suggest}] [-s] [-c CORE] [-m MODULES [MODULES ...]] {info} ...
+```
 
 ### Arguments
-&dash; `-h, --help` show this help message and exit  
-&ndash; `-v, --version` show program's version number and exit  
-&ndash; `-d DIRECTORY, --directory DIRECTORY`  Directory of the Drupal installation  
-&ndash; `-n, --no-lock` Do not use the composer.lock file to determine the installed versions of the modules  
-&ndash; `-l LIMIT, --limit LIMIT` The concurrency limit for async requests and data parsing. By default, the application uses all available CPU cores.  
-&ndash; `-f {table,json,suggest}, --format {table,json,suggest}` The output format. By default, the application will use the table format.  
-&ndash; `-s, --save-dump` Use in pair with `--format suggest` to dump the suggested composer.json file to the specified path. 
-&ndash; `-c CORE, --core CORE` Optional core version override for targeted scans. If omitted with `--modules`, core is auto-detected from composer metadata in `--directory`.  
-&ndash; `-m MODULES [MODULES ...], --modules MODULES [MODULES ...]` Scan only specific modules. When used, full environment module discovery is skipped. If `composer.lock` exists and `--no-lock` is not set, installed versions are still used for downgrade protection.  
+
+- `-h, --help`: Show help message and exit.
+- `-v, --version`: Show program's version number and exit.
+- `-d DIRECTORY, --directory DIRECTORY`: Directory of the Drupal installation (default: `.`).
+- `-n, --no-lock`: Do not use the `composer.lock` file to determine installed versions.
+- `-l LIMIT, --limit LIMIT`: Concurrency limit for async requests. Default is `10`.
+- `-f {table,json,suggest}, --format {table,json,suggest}`: Output format (default: `table`).
+- `-s, --save-dump`: Use with `--format suggest` to save the suggested `composer.json` to disk.
+- `-c CORE, --core CORE`: Optional Drupal core version override (e.g., `10.0.0`).
+- `-m MODULES [MODULES ...], --modules MODULES [MODULES ...]`: Scan only specific modules, skipping full project discovery.
 
 ### Subcommands
-&ndash; `info` - show diagnostic information about the tool and the current Drupal environment.
+
+- `info`: Show diagnostic information about the tool, `jq` availability, and the current Drupal environment.
+
+### MCP Server Usage
+
+To use Drupal Scout as an MCP server in your AI assistant:
+
+```bash
+drupal-scout-mcp
+```
+
+Or with `uvx`:
+
+```bash
+uvx --from drupal-scout drupal-scout-mcp
+```
 
 ### Targeted Scan Examples
 
-Scan one specific module with explicit core version:
+Scan one specific module with an explicit core version:
 
 ```bash
 drupal-scout --core 10.0.0 --modules drupal/webform
 ```
 
-Scan multiple specific modules and output JSON:
+Scan multiple modules and output JSON:
 
 ```bash
 drupal-scout --core 10.0.0 --modules drupal/webform drupal/ctools --format json
 ```
 
-Scan targeted modules with auto-detected core from local `composer.lock`/`composer.json` in directory:
+Scan modules with auto-detected core from a local directory:
 
 ```bash
 drupal-scout --directory /path/to/drupal --modules drupal/webform
 ```
-
-If core cannot be auto-detected, provide `--core` explicitly.

drupal_scout-3.0.2/README.md

@@ -0,0 +1,109 @@
+# Drupal Scout
+
+Search for Drupal module entries with transitive core version requirements to help to upgrade the Drupal Core.
+
+## Installation
+
+### Using uv (Recommended)
+
+```bash
+uv tool install drupal-scout
+```
+
+Or run directly without installing:
+
+```bash
+uvx drupal-scout --help
+```
+
+### Using pip
+
+```bash
+pip install drupal-scout
+```
+
+## Quick Start
+
+Get a compatibility report for your current Drupal project:
+
+```bash
+drupal-scout
+```
+
+Scan a specific module for Drupal 11 compatibility:
+
+```bash
+drupal-scout --core 11.0.0 --modules drupal/webform
+```
+
+## Features
+
+- **Asyncio Concurrency**: High-performance parallel module scanning using `asyncio` to speed up dependency analysis.
+- **Rich TUI Integration**: Beautiful terminal output with structured tables and real-time progress bars powered by the `rich` library.
+- **MCP Server Support**: Built-in [Model Context Protocol](https://modelcontextprotocol.io/) server for integration with AI IDEs (like Claude Desktop or Cursor).
+- **Environment Diagnostics**: Quick self-diagnostic check of the environment and dependencies using the `info` command.
+- **Multiple Output Formats**:
+  - `table`: High-fidelity color-coded table for human readability.
+  - `json`: Machine-readable raw data for automation scripts.
+  - `suggest`: Generates a suggested `composer.json` with updated version requirements.
+
+## Limitations
+
+- **Python 3.11+**: The application requires Python 3.11 or higher.
+- **Composer v2**: The application works with **Composer-based (Composer v2)** Drupal 8+ projects.
+
+## Usage/Examples
+
+```bash
+drupal-scout [-h] [-v] [-d DIRECTORY] [-n] [-l LIMIT] [-f {table,json,suggest}] [-s] [-c CORE] [-m MODULES [MODULES ...]] {info} ...
+```
+
+### Arguments
+
+- `-h, --help`: Show help message and exit.
+- `-v, --version`: Show program's version number and exit.
+- `-d DIRECTORY, --directory DIRECTORY`: Directory of the Drupal installation (default: `.`).
+- `-n, --no-lock`: Do not use the `composer.lock` file to determine installed versions.
+- `-l LIMIT, --limit LIMIT`: Concurrency limit for async requests. Default is `10`.
+- `-f {table,json,suggest}, --format {table,json,suggest}`: Output format (default: `table`).
+- `-s, --save-dump`: Use with `--format suggest` to save the suggested `composer.json` to disk.
+- `-c CORE, --core CORE`: Optional Drupal core version override (e.g., `10.0.0`).
+- `-m MODULES [MODULES ...], --modules MODULES [MODULES ...]`: Scan only specific modules, skipping full project discovery.
+
+### Subcommands
+
+- `info`: Show diagnostic information about the tool, `jq` availability, and the current Drupal environment.
+
+### MCP Server Usage
+
+To use Drupal Scout as an MCP server in your AI assistant:
+
+```bash
+drupal-scout-mcp
+```
+
+Or with `uvx`:
+
+```bash
+uvx --from drupal-scout drupal-scout-mcp
+```
+
+### Targeted Scan Examples
+
+Scan one specific module with an explicit core version:
+
+```bash
+drupal-scout --core 10.0.0 --modules drupal/webform
+```
+
+Scan multiple modules and output JSON:
+
+```bash
+drupal-scout --core 10.0.0 --modules drupal/webform drupal/ctools --format json
+```
+
+Scan modules with auto-detected core from a local directory:
+
+```bash
+drupal-scout --directory /path/to/drupal --modules drupal/webform
+```

drupal_scout-3.0.2/drupal_scout/tests/conftest.py

@@ -0,0 +1,20 @@
+import pytest
+from unittest.mock import Mock
+from aiohttp.client_reqrep import ClientResponse
+
+
+@pytest.fixture(autouse=True, scope="session")
+def _patch_aiohttp_clientresponse_init_stream_writer():
+    """Ensure tests remain compatible with aiohttp >= 3.14 when stream_writer is required."""
+
+    original_init = ClientResponse.__init__
+
+    def patched_init(self, *args, **kwargs):
+        kwargs.setdefault("stream_writer", Mock())
+        return original_init(self, *args, **kwargs)
+
+    ClientResponse.__init__ = patched_init  # type: ignore[method-assign]
+    try:
+        yield
+    finally:
+        ClientResponse.__init__ = original_init  # type: ignore[method-assign]

{drupal_scout-3.0.0 → drupal_scout-3.0.2/drupal_scout.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drupal-scout
-Version: 3.0.0
+Version: 3.0.2
 Summary: Scout out for transitive versions of Drupal modules for the upgrade of the core.
 Author-email: "Andrew [R-Tech] Tsyhaniuk" <in0mad91@gmail.com>
 License: MIT License
@@ -47,6 +47,7 @@ Requires-Dist: packaging
 Requires-Dist: fastmcp
 Requires-Dist: rich>=15.0.0
 Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
 Requires-Dist: nose; extra == "dev"
 Requires-Dist: coverage; extra == "dev"
 Requires-Dist: pipdeptree; extra == "dev"
@@ -57,66 +58,110 @@ Dynamic: license-file
 
 # Drupal Scout
 
-Search for Drupal module entries with transitive core version requirements to help to upgrade the Drupal Core
+Search for Drupal module entries with transitive core version requirements to help to upgrade the Drupal Core.
 
 ## Installation
 
+### Using uv (Recommended)
+
+```bash
+uv tool install drupal-scout
+```
+
+Or run directly without installing:
+
+```bash
+uvx drupal-scout --help
+```
+
+### Using pip
+
+```bash
+pip install drupal-scout
+```
+
+## Quick Start
+
+Get a compatibility report for your current Drupal project:
+
+```bash
+drupal-scout
+```
+
+Scan a specific module for Drupal 11 compatibility:
+
 ```bash
-  pip install drupal-scout
+drupal-scout --core 11.0.0 --modules drupal/webform
 ```
 
 ## Features
 
-- Use asyncio concurrency to speed up the process of searching for Drupal module entries with transitive core version requirements.
-- Quick self-diagnostic check of the environment and dependencies using the `info` command.
-- Choose between three output formats: table, json, and suggest.  
-    - `table` format will output the data in the table format.  
-    Example:
-    ![Table format example](https://raw.githubusercontent.com/rtech91/drupal-scout/main/screenshots/format_table_example.png)
-    - `json` format will output the raw data in the json format.  
-    - `suggest` format will output the suggested composer.json file with the updated module version requirements.  
-    It will also dump the suggested composer.json file to the specified path if the `--save-dump` argument is used.
+- **Asyncio Concurrency**: High-performance parallel module scanning using `asyncio` to speed up dependency analysis.
+- **Rich TUI Integration**: Beautiful terminal output with structured tables and real-time progress bars powered by the `rich` library.
+- **MCP Server Support**: Built-in [Model Context Protocol](https://modelcontextprotocol.io/) server for integration with AI IDEs (like Claude Desktop or Cursor).
+- **Environment Diagnostics**: Quick self-diagnostic check of the environment and dependencies using the `info` command.
+- **Multiple Output Formats**:
+  - `table`: High-fidelity color-coded table for human readability.
+  - `json`: Machine-readable raw data for automation scripts.
+  - `suggest`: Generates a suggested `composer.json` with updated version requirements.
 
 ## Limitations
 
-- The application will only work with Composer-based (Composer v2) Drupal 8+ projects. 
+- **Python 3.11+**: The application requires Python 3.11 or higher.
+- **Composer v2**: The application works with **Composer-based (Composer v2)** Drupal 8+ projects.
 
 ## Usage/Examples
 
-`drupal-scout [-h] [-v] [-d DIRECTORY] [-n] [-l LIMIT] [-f {table,json,suggest}] [-s] [-c CORE] [-m MODULES [MODULES ...]] {info} ...`
+```bash
+drupal-scout [-h] [-v] [-d DIRECTORY] [-n] [-l LIMIT] [-f {table,json,suggest}] [-s] [-c CORE] [-m MODULES [MODULES ...]] {info} ...
+```
 
 ### Arguments
-&dash; `-h, --help` show this help message and exit  
-&ndash; `-v, --version` show program's version number and exit  
-&ndash; `-d DIRECTORY, --directory DIRECTORY`  Directory of the Drupal installation  
-&ndash; `-n, --no-lock` Do not use the composer.lock file to determine the installed versions of the modules  
-&ndash; `-l LIMIT, --limit LIMIT` The concurrency limit for async requests and data parsing. By default, the application uses all available CPU cores.  
-&ndash; `-f {table,json,suggest}, --format {table,json,suggest}` The output format. By default, the application will use the table format.  
-&ndash; `-s, --save-dump` Use in pair with `--format suggest` to dump the suggested composer.json file to the specified path. 
-&ndash; `-c CORE, --core CORE` Optional core version override for targeted scans. If omitted with `--modules`, core is auto-detected from composer metadata in `--directory`.  
-&ndash; `-m MODULES [MODULES ...], --modules MODULES [MODULES ...]` Scan only specific modules. When used, full environment module discovery is skipped. If `composer.lock` exists and `--no-lock` is not set, installed versions are still used for downgrade protection.  
+
+- `-h, --help`: Show help message and exit.
+- `-v, --version`: Show program's version number and exit.
+- `-d DIRECTORY, --directory DIRECTORY`: Directory of the Drupal installation (default: `.`).
+- `-n, --no-lock`: Do not use the `composer.lock` file to determine installed versions.
+- `-l LIMIT, --limit LIMIT`: Concurrency limit for async requests. Default is `10`.
+- `-f {table,json,suggest}, --format {table,json,suggest}`: Output format (default: `table`).
+- `-s, --save-dump`: Use with `--format suggest` to save the suggested `composer.json` to disk.
+- `-c CORE, --core CORE`: Optional Drupal core version override (e.g., `10.0.0`).
+- `-m MODULES [MODULES ...], --modules MODULES [MODULES ...]`: Scan only specific modules, skipping full project discovery.
 
 ### Subcommands
-&ndash; `info` - show diagnostic information about the tool and the current Drupal environment.
+
+- `info`: Show diagnostic information about the tool, `jq` availability, and the current Drupal environment.
+
+### MCP Server Usage
+
+To use Drupal Scout as an MCP server in your AI assistant:
+
+```bash
+drupal-scout-mcp
+```
+
+Or with `uvx`:
+
+```bash
+uvx --from drupal-scout drupal-scout-mcp
+```
 
 ### Targeted Scan Examples
 
-Scan one specific module with explicit core version:
+Scan one specific module with an explicit core version:
 
 ```bash
 drupal-scout --core 10.0.0 --modules drupal/webform
 ```
 
-Scan multiple specific modules and output JSON:
+Scan multiple modules and output JSON:
 
 ```bash
 drupal-scout --core 10.0.0 --modules drupal/webform drupal/ctools --format json
 ```
 
-Scan targeted modules with auto-detected core from local `composer.lock`/`composer.json` in directory:
+Scan modules with auto-detected core from a local directory:
 
 ```bash
 drupal-scout --directory /path/to/drupal --modules drupal/webform
 ```
-
-If core cannot be auto-detected, provide `--core` explicitly.

{drupal_scout-3.0.0 → drupal_scout-3.0.2}/drupal_scout.egg-info/SOURCES.txt

@@ -23,6 +23,7 @@ drupal_scout/formatters/jsonformatter.py
 drupal_scout/formatters/suggestformatter.py
 drupal_scout/formatters/tableformatter.py
 drupal_scout/tests/__init__.py
+drupal_scout/tests/conftest.py
 drupal_scout/tests/test_application.py
 drupal_scout/tests/test_exceptions.py
 drupal_scout/tests/test_formatterfactory.py

{drupal_scout-3.0.0 → drupal_scout-3.0.2}/drupal_scout.egg-info/requires.txt

@@ -6,6 +6,7 @@ fastmcp
 rich>=15.0.0
 
 [dev]
+pytest
 nose
 coverage
 pipdeptree

{drupal_scout-3.0.0 → drupal_scout-3.0.2}/drupal_scout.egg-info/top_level.txt

@@ -1,4 +1,3 @@
 bin
 dist
 drupal_scout
-screenshots

{drupal_scout-3.0.0 → drupal_scout-3.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "drupal-scout"
-version = "3.0.0"
+version = "3.0.2"
 description = "Scout out for transitive versions of Drupal modules for the upgrade of the core."
 readme = "README.md"
 license = { file = "LICENSE.txt" }
@@ -29,6 +29,7 @@ dependencies = [
 
 [project.optional-dependencies]
 dev = [
+    'pytest',
     'nose',
     'coverage',
     'pipdeptree',

drupal_scout-3.0.0/README.md

@@ -1,65 +0,0 @@
-# Drupal Scout
-
-Search for Drupal module entries with transitive core version requirements to help to upgrade the Drupal Core
-
-## Installation
-
-```bash
-  pip install drupal-scout
-```
-
-## Features
-
-- Use asyncio concurrency to speed up the process of searching for Drupal module entries with transitive core version requirements.
-- Quick self-diagnostic check of the environment and dependencies using the `info` command.
-- Choose between three output formats: table, json, and suggest.  
-    - `table` format will output the data in the table format.  
-    Example:
-    ![Table format example](https://raw.githubusercontent.com/rtech91/drupal-scout/main/screenshots/format_table_example.png)
-    - `json` format will output the raw data in the json format.  
-    - `suggest` format will output the suggested composer.json file with the updated module version requirements.  
-    It will also dump the suggested composer.json file to the specified path if the `--save-dump` argument is used.
-
-## Limitations
-
-- The application will only work with Composer-based (Composer v2) Drupal 8+ projects. 
-
-## Usage/Examples
-
-`drupal-scout [-h] [-v] [-d DIRECTORY] [-n] [-l LIMIT] [-f {table,json,suggest}] [-s] [-c CORE] [-m MODULES [MODULES ...]] {info} ...`
-
-### Arguments
-‐ `-h, --help` show this help message and exit  
-– `-v, --version` show program's version number and exit  
-– `-d DIRECTORY, --directory DIRECTORY`  Directory of the Drupal installation  
-– `-n, --no-lock` Do not use the composer.lock file to determine the installed versions of the modules  
-– `-l LIMIT, --limit LIMIT` The concurrency limit for async requests and data parsing. By default, the application uses all available CPU cores.  
-– `-f {table,json,suggest}, --format {table,json,suggest}` The output format. By default, the application will use the table format.  
-– `-s, --save-dump` Use in pair with `--format suggest` to dump the suggested composer.json file to the specified path. 
-– `-c CORE, --core CORE` Optional core version override for targeted scans. If omitted with `--modules`, core is auto-detected from composer metadata in `--directory`.  
-– `-m MODULES [MODULES ...], --modules MODULES [MODULES ...]` Scan only specific modules. When used, full environment module discovery is skipped. If `composer.lock` exists and `--no-lock` is not set, installed versions are still used for downgrade protection.  
-
-### Subcommands
-– `info` - show diagnostic information about the tool and the current Drupal environment.
-
-### Targeted Scan Examples
-
-Scan one specific module with explicit core version:
-
-```bash
-drupal-scout --core 10.0.0 --modules drupal/webform
-```
-
-Scan multiple specific modules and output JSON:
-
-```bash
-drupal-scout --core 10.0.0 --modules drupal/webform drupal/ctools --format json
-```
-
-Scan targeted modules with auto-detected core from local `composer.lock`/`composer.json` in directory:
-
-```bash
-drupal-scout --directory /path/to/drupal --modules drupal/webform
-```
-
-If core cannot be auto-detected, provide `--core` explicitly.