vlan-probe 0.1.0__tar.gz

vlan_probe-0.1.0/.github/dependabot.yml

@@ -0,0 +1,18 @@
+version: 2
+updates:
+- package-ecosystem: uv
+  directory: /
+  schedule:
+    interval: weekly
+  assignees:
+  - hellqvio86
+  cooldown:
+    default-days: 3
+- package-ecosystem: github-actions
+  directory: /
+  schedule:
+    interval: weekly
+  assignees:
+  - hellqvio86
+  cooldown:
+    default-days: 3

vlan_probe-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,169 @@
+name: CI/CD
+
+permissions:
+  contents: read
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      job:
+        description: 'Select which job to run'
+        required: true
+        default: 'all'
+        type: choice
+        options:
+          - all
+          - lint
+          - test
+          - draft-release
+          - publish
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    if: |
+      github.event_name != 'workflow_dispatch' ||
+      inputs.job == 'all' ||
+      inputs.job == 'lint'
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run ruff check
+        run: uv run ruff check .
+
+      - name: Run ruff format check
+        run: uv run ruff format --check .
+
+      - name: Run mypy type check
+        run: uv run mypy src
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    if: |
+      github.event_name != 'workflow_dispatch' ||
+      inputs.job == 'all' ||
+      inputs.job == 'test'
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run tests
+        run: |
+          uv run pytest --cov=src/vlan_probe --cov-report=term-missing
+
+  draft-release:
+    name: Draft Release
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    if: github.event_name == 'workflow_dispatch' && (inputs.job == 'all' || inputs.job == 'draft-release')
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Build distribution
+        run: uv build
+
+      - name: Get package version
+        id: version
+        run: echo "version=$(grep -m1 '^version' pyproject.toml | cut -d' ' -f3 | tr -d '\"')" >> "$GITHUB_OUTPUT"
+
+      - name: Create draft release
+        id: release
+        uses: softprops/action-gh-release@v3
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: v${{ steps.version.outputs.version }}
+          name: Release v${{ steps.version.outputs.version }}
+          draft: true
+          prerelease: false
+          files: dist/*
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && (inputs.job == 'all' || inputs.job == 'publish'))
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Build distribution
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

vlan_probe-0.1.0/.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+*.pyc
+vlan_probe.toml
+.coverage

vlan_probe-0.1.0/LICENSE

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

vlan_probe-0.1.0/Makefile

@@ -0,0 +1,34 @@
+.PHONY: venv lint test clean format build publish run install
+
+.venv: pyproject.toml
+	if [ ! -d .venv ]; then uv venv; fi
+	uv pip install -e . --group dev
+
+venv: .venv
+
+lint: .venv
+	.venv/bin/ruff check .
+	.venv/bin/ruff format --check .
+
+format: .venv
+	.venv/bin/ruff format .
+
+test: .venv
+	.venv/bin/mypy src
+	.venv/bin/pytest --cov=src/vlan_probe --cov-report=term-missing
+
+run: .venv
+	.venv/bin/python3 -m vlan_probe $(ARGS)
+
+install:
+	uv tool install --force .
+
+build: .venv
+	uv build
+
+publish: build
+	uv publish
+
+clean:
+	rm -rf .venv __pycache__ .pytest_cache .ruff_cache dist
+

vlan_probe-0.1.0/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.5
+Name: vlan-probe
+Version: 0.1.0
+Summary: VLAN Isolation & Network Permission Probe Tool
+Project-URL: Homepage, https://github.com/hellqvio86/vlan-probe
+Project-URL: Repository, https://github.com/hellqvio86/vlan-probe
+Author: hellqvio
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: tomli>=1.2.0; python_version < '3.11'
+Description-Content-Type: text/markdown
+
+# vlan-probe
+
+VLAN Isolation & Network Permission Probe Tool — standalone project extracted
+from the Ansible role in ansible-home-baseline.
+
+`vlan-probe` is a command-line tool. Install it with [pipx](https://pipx.pypa.io/)
+so it runs in an isolated environment and the `vlan-probe` command is available
+on your `PATH`.
+
+## Requirements
+
+- Python 3.10 or newer
+
+## Installation
+
+### Install with pipx (recommended)
+
+```bash
+pipx install vlan-probe
+```
+
+Upgrade to a newer release:
+
+```bash
+pipx upgrade vlan-probe
+```
+
+If you do not already have pipx, install it first (macOS/Homebrew, Debian/Ubuntu
+or Arch examples; see the [pipx docs](https://pipx.pypa.io/) for other systems):
+
+```bash
+brew install pipx && pipx ensurepath
+# or
+apt install pipx && pipx ensurepath
+# or
+pacman -S python-pipx && pipx ensurepath
+```
+
+### Install from source
+
+```bash
+# with pipx
+pipx install .
+
+# with uv (alternative)
+uv tool install .
+
+# or install directly into your environment
+pip install .
+```
+
+## Usage
+
+1. Install or copy to a host.
+2. Create a TOML config at `/etc/vlan_probe.toml` or pass `-c` to point to a different file.
+3. Run `vlan-probe -f table` or `python -m vlan_probe -f table`.
+
+### Configuration
+
+Configuration uses TOML format for easy human readability and simplicity:
+
+```toml
+[[targets]]
+name = "Internal - Device A SSH"
+vlan = "Internal"
+ip = "192.168.1.10"
+port = 22
+protocol = "tcp"
+expected_blocked = true
+
+[[targets]]
+name = "Internal - Gateway HTTP"
+vlan = "Internal"
+ip = "192.168.2.1"
+port = 80
+protocol = "tcp"
+expected_blocked = true
+
+[[targets]]
+name = "External - Public DNS"
+vlan = "External"
+ip = "8.8.8.8"
+port = 53
+protocol = "udp"
+expected_blocked = false
+```
+
+### Options
+
+```
+-c, --config PATH         Path to config TOML file (default: /etc/vlan_probe.toml)
+-f, --format FORMAT       Output format: ndjson, json, or table (default: ndjson)
+-t, --timeout SECONDS     Socket connection timeout (default: 2.0)
+-s, --strict              Exit with code 1 if any violations occur
+--color [auto|always|never]  Colorize output (default: auto)
+```
+
+### Examples
+
+```bash
+# Display as table
+vlan-probe -c ./vlan_probe.toml -f table
+
+# Output JSON
+vlan-probe -f json
+
+# Strict mode with custom timeout
+vlan-probe -s -t 5.0
+
+# No color output
+vlan-probe -f table --color never
+```
+
+## Development
+
+```bash
+uv sync          # install dev dependencies
+uv run pytest    # run tests
+uv run ruff check . && uv run ruff format --check .   # lint
+uv run mypy src  # type check
+```
+
+## License
+
+MIT (see LICENSE)

vlan_probe-0.1.0/README.md

@@ -0,0 +1,125 @@
+# vlan-probe
+
+VLAN Isolation & Network Permission Probe Tool — standalone project extracted
+from the Ansible role in ansible-home-baseline.
+
+`vlan-probe` is a command-line tool. Install it with [pipx](https://pipx.pypa.io/)
+so it runs in an isolated environment and the `vlan-probe` command is available
+on your `PATH`.
+
+## Requirements
+
+- Python 3.10 or newer
+
+## Installation
+
+### Install with pipx (recommended)
+
+```bash
+pipx install vlan-probe
+```
+
+Upgrade to a newer release:
+
+```bash
+pipx upgrade vlan-probe
+```
+
+If you do not already have pipx, install it first (macOS/Homebrew, Debian/Ubuntu
+or Arch examples; see the [pipx docs](https://pipx.pypa.io/) for other systems):
+
+```bash
+brew install pipx && pipx ensurepath
+# or
+apt install pipx && pipx ensurepath
+# or
+pacman -S python-pipx && pipx ensurepath
+```
+
+### Install from source
+
+```bash
+# with pipx
+pipx install .
+
+# with uv (alternative)
+uv tool install .
+
+# or install directly into your environment
+pip install .
+```
+
+## Usage
+
+1. Install or copy to a host.
+2. Create a TOML config at `/etc/vlan_probe.toml` or pass `-c` to point to a different file.
+3. Run `vlan-probe -f table` or `python -m vlan_probe -f table`.
+
+### Configuration
+
+Configuration uses TOML format for easy human readability and simplicity:
+
+```toml
+[[targets]]
+name = "Internal - Device A SSH"
+vlan = "Internal"
+ip = "192.168.1.10"
+port = 22
+protocol = "tcp"
+expected_blocked = true
+
+[[targets]]
+name = "Internal - Gateway HTTP"
+vlan = "Internal"
+ip = "192.168.2.1"
+port = 80
+protocol = "tcp"
+expected_blocked = true
+
+[[targets]]
+name = "External - Public DNS"
+vlan = "External"
+ip = "8.8.8.8"
+port = 53
+protocol = "udp"
+expected_blocked = false
+```
+
+### Options
+
+```
+-c, --config PATH         Path to config TOML file (default: /etc/vlan_probe.toml)
+-f, --format FORMAT       Output format: ndjson, json, or table (default: ndjson)
+-t, --timeout SECONDS     Socket connection timeout (default: 2.0)
+-s, --strict              Exit with code 1 if any violations occur
+--color [auto|always|never]  Colorize output (default: auto)
+```
+
+### Examples
+
+```bash
+# Display as table
+vlan-probe -c ./vlan_probe.toml -f table
+
+# Output JSON
+vlan-probe -f json
+
+# Strict mode with custom timeout
+vlan-probe -s -t 5.0
+
+# No color output
+vlan-probe -f table --color never
+```
+
+## Development
+
+```bash
+uv sync          # install dev dependencies
+uv run pytest    # run tests
+uv run ruff check . && uv run ruff format --check .   # lint
+uv run mypy src  # type check
+```
+
+## License
+
+MIT (see LICENSE)

vlan_probe-0.1.0/pyproject.toml

@@ -0,0 +1,61 @@
+[project]
+name = "vlan-probe"
+version = "0.1.0"
+description = "VLAN Isolation & Network Permission Probe Tool"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    {name = "hellqvio"}
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    'tomli>=1.2.0;python_version<"3.11"',
+]
+
+[project.urls]
+Homepage = "https://github.com/hellqvio86/vlan-probe"
+Repository = "https://github.com/hellqvio86/vlan-probe"
+
+[project.scripts]
+vlan-probe = "vlan_probe.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/vlan_probe"]
+
+[dependency-groups]
+dev = [
+    "pytest>=7.0.0",
+    "ruff>=0.3.0",
+    "pytest-cov>=4.0.0",
+    "mypy>=2.3.0",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I"]
+ignore = []
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["test"]
+python_files = "test_*.py"
+addopts = "-v --tb=short"

vlan_probe-0.1.0/src/vlan_probe/__init__.py

@@ -0,0 +1,11 @@
+"""
+VLAN Isolation & Network Permission Probe Tool.
+
+Probes target VLAN subnets, IPs, and ports from the host environment to verify
+isolation policies and detect unauthorized inter-VLAN access violations.
+"""
+
+__version__ = "0.1.0"
+__all__ = ["probe_target", "get_local_ips"]
+
+from .probe import get_local_ips, probe_target

vlan_probe-0.1.0/src/vlan_probe/__main__.py

@@ -0,0 +1,6 @@
+"""Module entrypoint for vlan_probe package."""
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()