warmpath 0.1.0__tar.gz → 0.2.0__tar.gz

warmpath-0.2.0/AGENTS.md

@@ -0,0 +1,7 @@
+# Agent Instructions
+
+## Verification
+
+- Run `task check` after important code or configuration changes.
+- Report any failures from `task check`, or explain why it could not be run.
+- Do not claim that verification succeeded unless `task check` completed successfully.

{warmpath-0.1.0 → warmpath-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: warmpath
-Version: 0.1.0
+Version: 0.2.0
 Summary: Local LinkedIn visible-connections scraper.
 Requires-Python: >=3.10
 Requires-Dist: open-linkedin-api>=2.3.1

{warmpath-0.1.0 → warmpath-0.2.0}/README.md

@@ -17,6 +17,27 @@ Find LinkedIn mutuals and warm paths using your logged-in LinkedIn cookies.
 
 Warmpath needs the `li_at` and `JSESSIONID` cookies. Keep this file private; it lives outside the repository.
 
+## Development
+
+[go-task](https://taskfile.dev/) is required to run the repository checks. Install it with Homebrew on macOS:
+
+```sh
+brew install go-task
+```
+
+For other platforms, follow the [go-task installation guide](https://taskfile.dev/docs/installation). Verify that the `task` command is available before running any checks:
+
+```sh
+task --version
+```
+
+Then install the Python development dependencies and run the full check suite:
+
+```sh
+uv sync
+task check
+```
+
 ## Usage
 
 ### Company

warmpath-0.2.0/Taskfile.yaml

@@ -0,0 +1,37 @@
+version: 3
+
+env:
+  UV_CACHE_DIR: .uv-cache
+
+tasks:
+  typecheck:
+    run: once
+    desc: Type-check Python with Pyright.
+    cmd: uv run python -m pyright warmpath
+
+  test:
+    run: once
+    desc: Run Python unit and live integration tests.
+    cmd: uv run pytest
+
+  check:
+    run: once
+    deps:
+      - typecheck
+      - test
+
+  build:
+    desc: Build source and wheel distributions.
+    cmds:
+      - rm -rf dist
+      - UV_CACHE_DIR="${TMPDIR:-/tmp}/warmpath-uv-cache" uv build --no-sources
+
+  outdated:
+    desc: Print outdated project dependencies.
+    cmd: uv tree --outdated
+
+  release:
+    desc: Check, build, tag, publish, and smoke-test a committed version.
+    deps:
+      - check
+    cmd: scripts/release.sh

{warmpath-0.1.0 → warmpath-0.2.0}/pyproject.toml

@@ -1,21 +1,15 @@
 [project]
 name = "warmpath"
-version = "0.1.0"
+version = "0.2.0"
 description = "Local LinkedIn visible-connections scraper."
 requires-python = ">=3.10"
-dependencies = [
-    "open-linkedin-api>=2.3.1",
-]
+dependencies = ["open-linkedin-api>=2.3.1"]
 
 [dependency-groups]
-dev = [
-    "pytest>=8.4.1",
-    "pytest-xdist>=3.8.0",
-    "pyright>=1.1.402",
-]
+dev = ["pytest>=8.4.1", "pytest-xdist>=3.8.0", "pyright>=1.1.411"]
 
 [tool.pytest.ini_options]
-addopts = "-n auto"
+addopts = "-n auto --dist loadgroup"
 testpaths = ["tests"]
 
 [project.scripts]

warmpath-0.2.0/scripts/release.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env sh
+set -eu
+
+PACKAGE="warmpath"
+TOKEN_FILE="${PYPI_TOKEN_FILE:-.pypi-token}"
+export UV_CACHE_DIR="${RELEASE_UV_CACHE_DIR:-${TMPDIR:-/tmp}/warmpath-uv-cache}"
+
+if test "$#" -ne 0; then
+  echo "usage: $0" >&2
+  exit 2
+fi
+
+version="$(uv version --short)"
+tag="v${version}"
+
+if ! test -f "$TOKEN_FILE"; then
+  echo "$TOKEN_FILE is required for publishing." >&2
+  exit 1
+fi
+
+token="$(tr -d '\r\n\t ' < "$TOKEN_FILE")"
+test -n "$token"
+case "$token" in
+  pypi-*) ;;
+  *) echo "$TOKEN_FILE must contain a PyPI token." >&2; exit 1 ;;
+esac
+
+rm -rf dist
+if test -n "$(git status --porcelain --untracked-files=all)"; then
+  echo "Working tree is not clean; commit before release." >&2
+  exit 1
+fi
+
+if git show-ref --verify --quiet "refs/tags/$tag"; then
+  echo "Tag $tag already exists locally." >&2
+  exit 1
+fi
+
+remote_tag="$(git ls-remote --tags origin "refs/tags/$tag")"
+if test -n "$remote_tag"; then
+  echo "Tag $tag already exists on origin." >&2
+  exit 1
+fi
+
+echo "Building artifacts"
+uv build --no-sources
+
+sdist="dist/${PACKAGE}-${version}.tar.gz"
+wheel="dist/${PACKAGE}-${version}-py3-none-any.whl"
+
+echo "Verifying artifacts"
+test -f "$sdist"
+test -f "$wheel"
+
+tar tf "$sdist" | grep -q "^${PACKAGE}-${version}/${PACKAGE}/cli.py$"
+uv run python -m zipfile -l "$wheel" | grep -q "${PACKAGE}/cli.py"
+
+if tar tf "$sdist" | grep -q '\.pypi-token'; then
+  echo ".pypi-token leaked into sdist." >&2
+  exit 1
+fi
+
+if tar tf "$sdist" | grep -q '\.uv-cache'; then
+  echo ".uv-cache leaked into sdist." >&2
+  exit 1
+fi
+
+if uv run python -m zipfile -l "$wheel" | grep -q '\.pypi-token'; then
+  echo ".pypi-token leaked into wheel." >&2
+  exit 1
+fi
+
+if uv run python -m zipfile -l "$wheel" | grep -q '\.uv-cache'; then
+  echo ".uv-cache leaked into wheel." >&2
+  exit 1
+fi
+
+echo "Tagging ${PACKAGE} ${version}"
+git tag -a "$tag" -m "${PACKAGE} ${version}"
+git push origin "$tag"
+
+echo "Publishing ${PACKAGE} ${version}"
+UV_PUBLISH_TOKEN="$token" uv publish
+
+echo "Smoke-testing uvx ${PACKAGE}"
+uvx --refresh-package "$PACKAGE" "$PACKAGE" --help

warmpath-0.2.0/tests/test_cli_commands.py

@@ -0,0 +1,219 @@
+import subprocess
+import sys
+from importlib.metadata import version as distribution_version
+from pathlib import Path
+
+import pytest
+
+from warmpath import cli
+
+
+ROOT = Path(__file__).resolve().parents[1]
+RUSLAN_URL = "https://www.linkedin.com/in/ruslan-gilemzianov/"
+VIOLETTA_URL = "https://www.linkedin.com/in/violetta-shmatkova-844a0986/"
+TIMUR_URL = "https://www.linkedin.com/in/timur-pokayonkov/"
+
+
+def run_cli(*args: str, timeout: int = 30) -> subprocess.CompletedProcess[str]:
+    return subprocess.run(
+        [
+            sys.executable,
+            "-m",
+            "warmpath.cli",
+            *args,
+        ],
+        cwd=ROOT,
+        text=True,
+        capture_output=True,
+        timeout=timeout,
+        check=False,
+    )
+
+
+def linkedin_cookie_file() -> Path:
+    cookie_file = cli.DEFAULT_COOKIE_FILE
+    if not cookie_file.exists() or cookie_file.stat().st_size == 0:
+        pytest.skip("LinkedIn cookies are required for live integration tests")
+    return cookie_file
+
+
+def run_live_cli(
+    tmp_path: Path,
+    *args: str,
+    timeout: int = 180,
+) -> subprocess.CompletedProcess[str]:
+    return run_cli(
+        *args,
+        "--cache-dir",
+        str(tmp_path),
+        "--cookie-file",
+        str(linkedin_cookie_file()),
+        "--refresh-cache",
+        timeout=timeout,
+    )
+
+
+def require_live_linkedin_result(result: subprocess.CompletedProcess[str]) -> None:
+    unavailable_errors = (
+        "ConnectionError",
+        "JSONDecodeError",
+        "NameResolutionError",
+        "nodename nor servname provided",
+    )
+    if result.returncode != 0 and any(
+        error in result.stderr for error in unavailable_errors
+    ):
+        pytest.skip("LinkedIn API is unavailable")
+
+    assert result.returncode == 0, result.stderr
+    if "No reachable employees found" in result.stdout:
+        pytest.skip("LinkedIn company search returned no live results")
+    if "No reachable profiles found" in result.stdout:
+        pytest.skip("LinkedIn skill search returned no live results")
+
+
+def test_top_level_help_shows_command_shapes() -> None:
+    result = run_cli("--help")
+
+    assert result.returncode == 0
+    assert "human PROFILE_URL" in result.stdout
+    assert "company COMPANY" in result.stdout
+    assert "skill SKILL" in result.stdout
+    assert f"human {RUSLAN_URL}" in result.stdout
+    assert "company https://www.linkedin.com/company/ozon-tech" in result.stdout
+    assert "skill Flutter" in result.stdout
+    assert "--version" in result.stdout
+
+
+def test_top_level_version_uses_distribution_metadata() -> None:
+    result = run_cli("--version")
+
+    assert result.returncode == 0
+    assert result.stdout == f"warmpath {distribution_version('warmpath')}\n"
+    assert result.stderr == ""
+
+
+def test_profile_flag_is_not_a_top_level_command() -> None:
+    result = run_cli("--profile", "mitchellh")
+
+    assert result.returncode != 0
+    assert "unrecognized arguments" in result.stderr
+
+
+def test_connections_is_not_a_command() -> None:
+    result = run_cli("connections", "--help")
+
+    assert result.returncode != 0
+    assert "Unknown command: connections" in result.stderr
+
+
+def test_human_is_the_profile_mutuals_command() -> None:
+    result = run_cli("human", "--help")
+
+    assert result.returncode == 0
+    assert "profile URL" in result.stdout
+
+
+def test_company_is_the_company_command() -> None:
+    result = run_cli("company", "--help")
+
+    assert result.returncode == 0
+    assert "LinkedIn /company/ URL" in result.stdout
+    assert "Default: 5." in result.stdout
+    assert "company-path" not in result.stdout
+
+
+def test_skill_is_the_skill_command() -> None:
+    result = run_cli("skill", "--help")
+
+    assert result.returncode == 0
+    assert "skill name to search for" in result.stdout
+    assert "Default: 2." in result.stdout
+    assert "Default: 5." in result.stdout
+
+
+def test_company_default_limit_is_five() -> None:
+    args = cli.parse_company_args(["https://www.linkedin.com/company/binance/"])
+
+    assert args.limit == 5
+
+
+def test_default_paths_use_user_directories() -> None:
+    args = cli.parse_company_args(["https://www.linkedin.com/company/binance/"])
+
+    assert (
+        args.cookie_file
+        == Path.home() / ".config" / "warmpath" / "linkedin.cookies"
+    )
+    assert args.cache_dir == Path.home() / ".cache" / "warmpath"
+
+
+def test_resolve_path_expands_home() -> None:
+    assert cli.resolve_path(Path("~/warmpath-test")) == Path.home() / "warmpath-test"
+
+
+@pytest.mark.xdist_group(name="linkedin")
+def test_company_yadro_excludes_out_of_network_profile(tmp_path) -> None:
+    result = run_live_cli(
+        tmp_path,
+        "company",
+        "yadro",
+        "--limit",
+        "10",
+        "--max-degree",
+        "2",
+        timeout=120,
+    )
+
+    require_live_linkedin_result(result)
+    assert "https://www.linkedin.com/in/egorkazachkov/" not in result.stdout
+
+
+@pytest.mark.xdist_group(name="linkedin")
+def test_company_avito_large_search_includes_expected_second_degree_profile(
+    tmp_path,
+) -> None:
+    result = run_live_cli(
+        tmp_path,
+        "company",
+        "Avito",
+        "--limit",
+        "500",
+        timeout=240,
+    )
+
+    require_live_linkedin_result(result)
+    assert VIOLETTA_URL in result.stdout
+
+
+def test_skill_default_max_depth_is_two() -> None:
+    args = cli.parse_skill_args(["Flutter"])
+
+    assert args.max_depth == 2
+
+
+def test_skill_default_limit_is_five() -> None:
+    args = cli.parse_skill_args(["Flutter"])
+
+    assert args.limit == 5
+
+
+def test_company_path_is_not_a_command() -> None:
+    result = run_cli("company-path", "--help")
+
+    assert result.returncode != 0
+    assert "Unknown command: company-path" in result.stderr
+
+
+@pytest.mark.xdist_group(name="linkedin")
+def test_skill_leadership_large_search_includes_expected_profile(tmp_path) -> None:
+    result = run_live_cli(
+        tmp_path,
+        "skill",
+        "Leadership",
+        "--limit",
+        "25",
+    )
+
+    require_live_linkedin_result(result)
+    assert TIMUR_URL in result.stdout

{warmpath-0.1.0 → warmpath-0.2.0}/tests/test_mutual_connections.py

@@ -1,7 +1,6 @@
 from warmpath.cli import (
     company_path_candidate,
     connection_result_row,
-    fetch_mutual_connection_rows,
     render_company_path_result,
 )
 
@@ -84,55 +83,6 @@ def test_second_degree_candidate_renders_visible_mutual_connections() -> None:
     assert "unknown introducer" not in rendered
 
 
-def test_fetch_mutual_connection_rows_searches_first_degree_connections(
-    tmp_path,
-) -> None:
-    class FakeApi:
-        params = None
-        limit = None
-
-        def search(self, params, limit):
-            self.params = params
-            self.limit = limit
-            return [
-                {
-                    "entityUrn": "urn:li:fsd_profile:ACoAACeBStkBoUxCGfrnXFevZJkQ-UX6eHu4deU",
-                    "entityCustomTrackingInfo": {"memberDistance": "DISTANCE_1"},
-                    "title": {"text": "Anastasiia Krivobokova"},
-                    "primarySubtitle": {"text": "Senior HR Business Partner"},
-                    "secondarySubtitle": {"text": "Amsterdam"},
-                    "navigationUrl": "https://www.linkedin.com/in/anastasiaandreewnaa/",
-                },
-                {
-                    "entityUrn": "urn:li:fsd_profile:ACoAACJd_TgBcn1VPQemkT4e3qsSPkR9WjEYhy8",
-                    "entityCustomTrackingInfo": {"memberDistance": "DISTANCE_1"},
-                    "title": {"text": "Andrey Zhuchkov"},
-                    "primarySubtitle": {"text": "/"},
-                    "secondarySubtitle": {"text": "Russia"},
-                    "navigationUrl": "https://www.linkedin.com/in/a-zhuchkov/",
-                },
-            ]
-
-    api = FakeApi()
-    rows = fetch_mutual_connection_rows(
-        api,
-        "ACoAABaR-MoBLHrbfL3jmaglgQoONjPGWrfmTSE",
-        limit=2,
-        cache_dir=tmp_path,
-        refresh_cache=True,
-    )
-
-    assert "connectionOf,value:List(ACoAABaR-MoBLHrbfL3jmaglgQoONjPGWrfmTSE)" in api.params[
-        "filters"
-    ]
-    assert "network,value:List(F)" in api.params["filters"]
-    assert api.limit == 2
-    assert [row["name"] for row in rows] == [
-        "Anastasiia Krivobokova",
-        "Andrey Zhuchkov",
-    ]
-
-
 def test_second_degree_candidate_without_mutuals_keeps_unresolved_status() -> None:
     row = {
         "name": "Ruslan Gilemzianov",

{warmpath-0.1.0 → warmpath-0.2.0}/uv.lock

@@ -143,7 +143,7 @@ name = "exceptiongroup"
 version = "1.3.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
 wheels = [
@@ -315,15 +315,15 @@ wheels = [
 
 [[package]]
 name = "pyright"
-version = "1.1.410"
+version = "1.1.411"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "nodeenv" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/10/53/e4d8ea1391bd4355231be6f91bf239479aa0014260ed3fb5526eeb12a1f2/pyright-1.1.410.tar.gz", hash = "sha256:07a073b8ba6749826773c1269773efa11b93440d9a6aa60419d9a3172d6dc488", size = 4062013, upload-time = "2026-06-01T17:35:48.894Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/7e/ab/265f7dc69d28113ebba19092e57b075f41543b2ed048429c5f56e2b88eac/pyright-1.1.411.tar.gz", hash = "sha256:d885a0551f2e763b089a02702174e7f4ba77548cddabc972ab86d1f7f1b0f998", size = 4112861, upload-time = "2026-06-25T02:14:06.37Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/d7/33/288b5868fa00846dacf249633719d747893e54aebd196b9968ac1878a5d3/pyright-1.1.410-py3-none-any.whl", hash = "sha256:5e961bed37cacf96b3f7cd7b1da39b350a9239aa2e69138d0e88f728cfaf296c", size = 6082448, upload-time = "2026-06-01T17:35:46.387Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/49/385be530a6a5b78d1cbcd5c2e38debc8959a2fc6bdb716f4e581002979fc/pyright-1.1.411-py3-none-any.whl", hash = "sha256:dc7c72a8e2700c55baa127554040e067041ea53ccfd50bf96308cc4291c7d5d9", size = 6181526, upload-time = "2026-06-25T02:14:04.691Z" },
 ]
 
 [[package]]
@@ -455,7 +455,7 @@ wheels = [
 
 [[package]]
 name = "warmpath"
-version = "0.1.0"
+version = "0.2.0"
 source = { editable = "." }
 dependencies = [
     { name = "open-linkedin-api" },
@@ -473,7 +473,7 @@ requires-dist = [{ name = "open-linkedin-api", specifier = ">=2.3.1" }]
 
 [package.metadata.requires-dev]
 dev = [
-    { name = "pyright", specifier = ">=1.1.402" },
+    { name = "pyright", specifier = ">=1.1.411" },
     { name = "pytest", specifier = ">=8.4.1" },
     { name = "pytest-xdist", specifier = ">=3.8.0" },
 ]