fvpnctl 0.2.0__tar.gz → 0.2.2__tar.gz

{fvpnctl-0.2.0 → fvpnctl-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fvpnctl
-Version: 0.2.0
+Version: 0.2.2
 Summary: Control your FortiClient VPN from the macOS command line.
 Project-URL: Homepage, https://github.com/mpasternak/fortivpn-cli
 Project-URL: Repository, https://github.com/mpasternak/fortivpn-cli
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: System :: Networking
 Requires-Python: >=3.11
+Requires-Dist: setuptools<0; sys_platform == 'win32'
 Description-Content-Type: text/markdown
 
 # fvpnctl — control your FortiClient VPN from the macOS command line
@@ -31,7 +32,9 @@ handy for scripts, automation, and headless or over-SSH use. It works with a For
 already have running, talking to it over a local debugging port.
 
 - Zero runtime dependencies (Python standard library only).
-- Python ≥ 3.11, macOS only.
+- **macOS only** (Python ≥ 3.11). There is **no Windows support** — it drives the
+  macOS FortiClient.app, so `pip` / `uv` / `uvx` deliberately **refuse to install on
+  Windows**, and running it from a source checkout there exits with a clear error.
 - Attach-only by default: commands attach to a running FortiClient; the one explicit
   exception is `fvpnctl startserver`, an opt-in launcher you invoke yourself.
 
@@ -113,7 +116,10 @@ uv tool install .       # install the `fvpnctl` command from the local tree
 uv run fvpnctl list       # or run it in place, without installing
 ```
 
-Requirements: macOS, Python ≥ 3.11.
+Requirements: macOS, Python ≥ 3.11. **Windows is not supported** — installation on
+Windows fails on purpose (the package declares an unsatisfiable `win32` requirement),
+and there is no Linux support for the runtime either (the CLI talks to macOS
+FortiClient.app). Linux is used only by CI to run the mocked test suite.
 
 ---
 

{fvpnctl-0.2.0 → fvpnctl-0.2.2}/README.md

@@ -8,7 +8,9 @@ handy for scripts, automation, and headless or over-SSH use. It works with a For
 already have running, talking to it over a local debugging port.
 
 - Zero runtime dependencies (Python standard library only).
-- Python ≥ 3.11, macOS only.
+- **macOS only** (Python ≥ 3.11). There is **no Windows support** — it drives the
+  macOS FortiClient.app, so `pip` / `uv` / `uvx` deliberately **refuse to install on
+  Windows**, and running it from a source checkout there exits with a clear error.
 - Attach-only by default: commands attach to a running FortiClient; the one explicit
   exception is `fvpnctl startserver`, an opt-in launcher you invoke yourself.
 
@@ -90,7 +92,10 @@ uv tool install .       # install the `fvpnctl` command from the local tree
 uv run fvpnctl list       # or run it in place, without installing
 ```
 
-Requirements: macOS, Python ≥ 3.11.
+Requirements: macOS, Python ≥ 3.11. **Windows is not supported** — installation on
+Windows fails on purpose (the package declares an unsatisfiable `win32` requirement),
+and there is no Linux support for the runtime either (the CLI talks to macOS
+FortiClient.app). Linux is used only by CI to run the mocked test suite.
 
 ---
 

fvpnctl-0.2.2/pyproject.toml

@@ -0,0 +1,84 @@
+[project]
+name = "fvpnctl"
+version = "0.2.2"
+requires-python = ">=3.11"
+readme = "README.md"
+description = "Control your FortiClient VPN from the macOS command line."
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Michał Pasternak" }]
+keywords = ["forticlient", "fortinet", "vpn", "ipsec", "macos", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: System Administrators",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: System :: Networking",
+]
+# Zero runtime dependencies is a hard design requirement on supported platforms:
+# the tool uses only the Python standard library (socket, json, urllib,
+# subprocess, argparse). See the design spec sections 2 and 8 for the rationale
+# (no third-party attack surface, trivially auditable, runs against any stock
+# Python 3.11+).
+#
+# The single entry below is NOT a real dependency. fvpnctl is macOS-only (it
+# drives the FortiClient.app debug port) and has no Windows support, so this is an
+# intentionally unsatisfiable requirement gated to win32: on Windows pip/uv/uvx
+# fail fast instead of installing something that cannot work. On macOS — and on
+# Linux, where CI runs the platform-agnostic mocked test suite — the marker is
+# false, so the dependency set stays empty.
+#
+# IMPORTANT: the constraint pins a PyPA-owned package (setuptools) to an
+# impossible version, NOT a made-up package name. A non-existent placeholder name
+# would be a dependency-confusion hole: an attacker could register that name on
+# PyPI, and then `pip install fvpnctl` on Windows would *succeed* and pull in
+# their code instead of failing. No PEP 440 version is < 0, so `setuptools<0` can
+# never be satisfied by anyone — setuptools is PyPA-controlled and cannot be
+# squatted — making this a permanently safe, unsatisfiable gate. cli.main() also
+# refuses to run on win32 as a runtime backstop.
+dependencies = [
+    "setuptools<0; sys_platform == 'win32'",
+]
+
+[project.urls]
+Homepage = "https://github.com/mpasternak/fortivpn-cli"
+Repository = "https://github.com/mpasternak/fortivpn-cli"
+Issues = "https://github.com/mpasternak/fortivpn-cli/issues"
+
+[project.scripts]
+fvpnctl = "fvpnctl.cli:main"
+
+[dependency-groups]
+# Installed by default on `uv sync` so the test suite + lint/format run out of the
+# box and reproducibly in CI (ruff is a real dev dep, not relied on from PATH).
+dev = ["pytest>=8", "ruff>=0.13"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/fvpnctl"]
+
+[tool.uv]
+# fvpnctl is macOS-only; CI additionally resolves on Linux to run the mocked,
+# platform-agnostic test suite. Restrict universal locking to these so `uv lock`
+# does not try (and fail) to resolve the intentionally-unsatisfiable win32 install
+# guard declared in [project].dependencies.
+environments = ["sys_platform == 'darwin'", "sys_platform == 'linux'"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+# E/W pycodestyle, F pyflakes, I import sorting, UP pyupgrade, B bugbear.
+select = ["E", "F", "I", "UP", "B", "W"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"

{fvpnctl-0.2.0 → fvpnctl-0.2.2}/src/fvpnctl/__init__.py

@@ -1,3 +1,3 @@
 """fvpnctl — control FortiClient IPsec VPN on macOS via the Chrome DevTools Protocol."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"

{fvpnctl-0.2.0 → fvpnctl-0.2.2}/src/fvpnctl/cli.py

@@ -479,6 +479,16 @@ def main(argv: list[str] | None = None) -> int:
     """
     global _VERBOSE
 
+    if sys.platform == "win32":
+        # fvpnctl drives the macOS FortiClient.app debug port; there is no Windows
+        # support. The packaging metadata already refuses to *install* on win32
+        # (see pyproject.toml), but a source checkout run via `python -m` / `uv run`
+        # can still reach here — fail fast with a clear message instead of a
+        # confusing "FortiClient not found" later. (win32-only so the Linux CI that
+        # runs the mocked test suite via main() is unaffected.)
+        print("fvpnctl is macOS-only and has no Windows support.", file=sys.stderr)
+        return 1
+
     parser = _build_parser()
     args = parser.parse_args(argv)
 

{fvpnctl-0.2.0 → fvpnctl-0.2.2}/uv.lock

@@ -1,28 +1,28 @@
 version = 1
 revision = 3
 requires-python = ">=3.11"
-
-[[package]]
-name = "colorama"
-version = "0.4.6"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+resolution-markers = [
+    "sys_platform == 'darwin'",
+    "sys_platform == 'linux'",
+]
+supported-markers = [
+    "sys_platform == 'darwin'",
+    "sys_platform == 'linux'",
 ]
 
 [[package]]
 name = "fvpnctl"
-version = "0.2.0"
+version = "0.2.2"
 source = { editable = "." }
 
 [package.dev-dependencies]
 dev = [
-    { name = "pytest" },
-    { name = "ruff" },
+    { name = "pytest", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "ruff", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
 ]
 
 [package.metadata]
+requires-dist = [{ name = "setuptools", marker = "sys_platform == 'win32'", specifier = "<0" }]
 
 [package.metadata.requires-dev]
 dev = [
@@ -71,11 +71,10 @@ name = "pytest"
 version = "9.1.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "colorama", marker = "sys_platform == 'win32'" },
-    { name = "iniconfig" },
-    { name = "packaging" },
-    { name = "pluggy" },
-    { name = "pygments" },
+    { name = "iniconfig", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "pluggy", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "pygments", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/e4/47/b9efed96c114afcfa3c9d3fe98a76a1d14c74a9e266d397cf6eb64be5e01/pytest-9.1.1.tar.gz", hash = "sha256:1088fbde8f2b49d95a549a195707afa7a76a3ce9bcadc26b6d71f0ffda5fe313", size = 1636369, upload-time = "2026-06-19T10:58:32.857Z" }
 wheels = [
@@ -102,7 +101,4 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/f5/d1/5cf5909329fedb5d39d555ee818ba5cf4638e1a301b89785d34f2905bfcb/ruff-0.15.18-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:a81beadbbff2c9c245561ae3f77b16709d87f35eec650d0501679239d3449b22", size = 10693187, upload-time = "2026-06-18T18:25:08.245Z" },
     { url = "https://files.pythonhosted.org/packages/fd/44/ff6c635cf2c4f4e7b618b6640da057376baa36014695487d88aed4794268/ruff-0.15.18-py3-none-musllinux_1_2_i686.whl", hash = "sha256:2186d9e940ae332ab293623a75b5f4fe49565f449954d50a72a046683aa6b809", size = 11208721, upload-time = "2026-06-18T18:25:41.327Z" },
     { url = "https://files.pythonhosted.org/packages/88/d9/5baa2a30861adfb7022cf33c1e35b2fc18085b08c16f83eff4c7b99a5f48/ruff-0.15.18-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:5c2abf140438032bc77b2284a6c9944ecd8a19e5f1c7b52b1b8e4a0a80d19a7a", size = 11678599, upload-time = "2026-06-18T18:25:13.607Z" },
-    { url = "https://files.pythonhosted.org/packages/c3/1a/0725a7cfdc32ff769efb96ee782bec882e16448c5d9e3be947ec4c04ce27/ruff-0.15.18-py3-none-win32.whl", hash = "sha256:02299e6e9fa5b297a3f6d5d10d7bcd655c925b028bb8b9d4588214549c6b9ec4", size = 10901903, upload-time = "2026-06-18T18:25:24.755Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/51/805d9f6fb7970505c3504794a5ec350f605361b807fef4dcf214ebd35e72/ruff-0.15.18-py3-none-win_amd64.whl", hash = "sha256:dac80dc8d26b2257dbefabed62f5d255c3937b4ccb122da1fc634794fa3578b3", size = 12041189, upload-time = "2026-06-18T18:25:17.915Z" },
-    { url = "https://files.pythonhosted.org/packages/29/4c/67bb45e41609eb4726f1bfeb59e083cf91d14c696d4bd14c234a980be93d/ruff-0.15.18-py3-none-win_arm64.whl", hash = "sha256:b2c9257fcbd4a3e5b977a1904e6facca016bafe2edc17df24db67cfaee03b4e4", size = 11329958, upload-time = "2026-06-18T18:25:43.686Z" },
 ]

fvpnctl-0.2.0/pyproject.toml

@@ -1,58 +0,0 @@
-[project]
-name = "fvpnctl"
-version = "0.2.0"
-requires-python = ">=3.11"
-readme = "README.md"
-description = "Control your FortiClient VPN from the macOS command line."
-license = "MIT"
-license-files = ["LICENSE"]
-authors = [{ name = "Michał Pasternak" }]
-keywords = ["forticlient", "fortinet", "vpn", "ipsec", "macos", "cli"]
-classifiers = [
-    "Development Status :: 4 - Beta",
-    "Environment :: Console",
-    "Intended Audience :: System Administrators",
-    "Operating System :: MacOS",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Topic :: System :: Networking",
-]
-# Zero runtime dependencies is a hard design requirement: the tool uses only the
-# Python standard library (socket, json, urllib, subprocess, argparse). See the
-# design spec sections 2 and 8 for the rationale (no third-party attack surface,
-# trivially auditable, runs against any stock Python 3.11+).
-dependencies = []
-
-[project.urls]
-Homepage = "https://github.com/mpasternak/fortivpn-cli"
-Repository = "https://github.com/mpasternak/fortivpn-cli"
-Issues = "https://github.com/mpasternak/fortivpn-cli/issues"
-
-[project.scripts]
-fvpnctl = "fvpnctl.cli:main"
-
-[dependency-groups]
-# Installed by default on `uv sync` so the test suite + lint/format run out of the
-# box and reproducibly in CI (ruff is a real dev dep, not relied on from PATH).
-dev = ["pytest>=8", "ruff>=0.13"]
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/fvpnctl"]
-
-[tool.ruff]
-line-length = 100
-target-version = "py311"
-
-[tool.ruff.lint]
-# E/W pycodestyle, F pyflakes, I import sorting, UP pyupgrade, B bugbear.
-select = ["E", "F", "I", "UP", "B", "W"]
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
-addopts = "-q"