hvbrowser 0.1.0__tar.gz

hvbrowser-0.1.0/.Codex/hooks/finalize-markdown.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -eu
+
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+exec "$repo_root/scripts/hooks/finalize-markdown.sh"

hvbrowser-0.1.0/.Codex/hooks/finalize-python.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -eu
+
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+exec "$repo_root/scripts/hooks/finalize-python.sh"

hvbrowser-0.1.0/.claude/settings.local.json

@@ -0,0 +1,46 @@
+{
+  "permissions": {
+    "allow": [
+      "Read(**/*)",
+      "Write(**/*)",
+      "Edit(**/*)",
+      "Bash(docker:*)",
+      "Bash(ls:*)",
+      "Bash(mkdir:*)",
+      "Bash(tree:*)",
+      "Bash(find:*)",
+      "Bash(uv:*)",
+      "Bash(grep:*)",
+      "Bash(xargs cat)",
+      "Bash(git diff:*)",
+      "Bash(git -C * diff:*)",
+      "Bash(cat > *)",
+      "Bash(git add *)",
+      "Bash(git commit -m ' *)",
+      "Bash(uv run *)",
+      "Bash(uv run python -c ' *)",
+      "Bash(python3 -)",
+      "Bash(python3 -c ' *)",
+      "Bash(echo \"exit: $?\")"
+    ],
+    "additionalDirectories": [
+      "/tmp"
+    ]
+  },
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "scripts/hooks/finalize-python.sh"
+          },
+          {
+            "type": "command",
+            "command": "scripts/hooks/finalize-markdown.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

hvbrowser-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,63 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches: [main]
+    paths: [pyproject.toml]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Install version checker
+        run: python -m pip install packaging
+
+      - name: Check version bump
+        id: version
+        run: |
+          CURRENT=$(python -c "
+          import tomllib
+          with open('pyproject.toml', 'rb') as f:
+              print(tomllib.load(f)['project']['version'])
+          ")
+          if git cat-file -e HEAD~1:pyproject.toml 2>/dev/null; then
+            PREVIOUS=$(git show HEAD~1:pyproject.toml | python -c "
+          import tomllib, sys
+          print(tomllib.load(sys.stdin.buffer)['project']['version'])
+            ")
+          else
+            PREVIOUS=""
+          fi
+          echo "current=$CURRENT" >> "$GITHUB_OUTPUT"
+          echo "previous=$PREVIOUS" >> "$GITHUB_OUTPUT"
+          if [ -z "$PREVIOUS" ]; then
+            echo "bumped=true" >> "$GITHUB_OUTPUT"
+          elif [ "$CURRENT" != "$PREVIOUS" ]; then
+            python -c "
+          from packaging.version import Version
+          current, previous = Version('$CURRENT'), Version('$PREVIOUS')
+          exit(0 if current > previous else 1)
+          "
+            echo "bumped=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "bumped=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Build
+        if: steps.version.outputs.bumped == 'true'
+        run: pip install build && python -m build
+
+      - name: Publish
+        if: steps.version.outputs.bumped == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1

hvbrowser-0.1.0/.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+  "recommendations": [
+    "ms-python.python",
+    "charliermarsh.ruff",
+    "ms-python.black-formatter",
+    "ms-python.mypy-type-checker",
+    "DavidAnson.vscode-markdownlint"
+  ]
+}

hvbrowser-0.1.0/.vscode/settings.json

@@ -0,0 +1,28 @@
+{
+  "python.analysis.typeCheckingMode": "off",
+  "python.analysis.diagnosticSeverityOverrides": {
+    "reportMissingModuleSource": "none",
+    "reportMissingImports": "none"
+  },
+  "editor.formatOnSave": true,
+  "[python]": {
+    "editor.defaultFormatter": "ms-python.black-formatter",
+    "editor.codeActionsOnSave": {
+      "source.fixAll.ruff": "always"
+    }
+  },
+  "black-formatter.importStrategy": "fromEnvironment",
+  "ruff.importStrategy": "fromEnvironment",
+  "[markdown]": {
+    "editor.defaultFormatter": "DavidAnson.vscode-markdownlint"
+  },
+  "files.trimTrailingWhitespace": true,
+  "files.insertFinalNewline": true,
+  "editor.rulers": [
+    88
+  ],
+  "mypy-type-checker.importStrategy": "fromEnvironment",
+  "mypy-type-checker.args": [
+    "--config-file=mypy.ini"
+  ]
+}

hvbrowser-0.1.0/AGENTS.md

@@ -0,0 +1,12 @@
+# Agent Instructions
+
+The repository keeps provider-neutral finalization scripts in `scripts/hooks/`.
+Do not create separate copies under an individual agent's configuration
+directory.
+
+- Before development, create a clean environment with
+  `bash scripts/rebuild-env.sh`.
+- After changing Python, run `bash scripts/hooks/finalize-python.sh`.
+- After changing Markdown, run `bash scripts/hooks/finalize-markdown.sh`.
+- Keep the committed dependency source for `hbrowser` on PyPI. Install a local
+  editable checkout manually only after rebuilding the environment.

hvbrowser-0.1.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: hvbrowser
+Version: 0.1.0
+Summary: Browser automation APIs for HentaiVerse.
+Project-URL: Homepage, https://github.com/Kuan-Lun/hvbrowser
+Project-URL: Tracker, https://github.com/Kuan-Lun/hvbrowser/issues
+Author: Kuan-Lun Wang
+License: GNU Affero General Public License v3
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: <3.15,>=3.14
+Requires-Dist: hbrowser<0.36,>=0.35.0
+Provides-Extra: dev
+Requires-Dist: black>=26.5.1; extra == 'dev'
+Requires-Dist: mypy>=2.1.0; extra == 'dev'
+Requires-Dist: pymarkdownlnt>=0.9.38; extra == 'dev'
+Requires-Dist: pytest>=9.1.1; extra == 'dev'
+Requires-Dist: ruff>=0.15.20; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# HVBrowser
+
+HVBrowser provides browser automation APIs for HentaiVerse. It builds on
+`hbrowser` for the shared authenticated browser session.
+
+The package was extracted from the historical combined `hbrowser`
+distribution. Battle-domain APIs live in the separate `hvbattle` package.
+
+## Development
+
+Build a clean environment backed by the PyPI release of `hbrowser`:
+
+```bash
+bash scripts/rebuild-env.sh
+```
+
+For coordinated local development, overlay the clean environment manually:
+
+```bash
+uv pip install --python .venv/bin/python --reinstall --no-deps --editable \
+  /Users/kuanlun_wang/Desktop/git-repo/hbrowser.clone
+```
+
+Commands that must preserve this editable overlay use `uv run --no-sync`.
+
+## Read-only Market inspection
+
+Market inspection and sale planning are non-mutating by default:
+
+```python
+import asyncio
+
+from hvbrowser import HVDriver, SellItems
+
+
+async def main() -> None:
+    async with HVDriver(headless=True) as driver:
+        snapshot = await driver.inspect_market()
+        plan = await driver.marketcheck(SellItems(materials=["Low-Grade Metals"]))
+        print(len(snapshot.items), plan.total_units)
+
+
+asyncio.run(main())
+```
+
+The compatibility `marketcheck()` call requires `commit=True` before it can
+request submission. Submission is currently blocked by a fail-closed runtime
+gate until the current quote selector and pricing semantics have been confirmed
+with the read-only live probe. The guarded implementation never deposits
+credits and never re-lists unrelated orders.
+
+## Guarded live smoke test
+
+The surrounding `hentaiverse` workspace owns account selection. This smoke
+probe only refuses to construct a browser unless credentials are supplied
+indirectly through the environment. It stops when an active battle is detected
+and contains no click, submit, repair, recovery, lottery, monster-lab, or battle
+call:
+
+```bash
+uv run --no-sync python scripts/live_readonly_smoke.py \
+  --inspect-market-form
+```

hvbrowser-0.1.0/README.md

@@ -0,0 +1,63 @@
+# HVBrowser
+
+HVBrowser provides browser automation APIs for HentaiVerse. It builds on
+`hbrowser` for the shared authenticated browser session.
+
+The package was extracted from the historical combined `hbrowser`
+distribution. Battle-domain APIs live in the separate `hvbattle` package.
+
+## Development
+
+Build a clean environment backed by the PyPI release of `hbrowser`:
+
+```bash
+bash scripts/rebuild-env.sh
+```
+
+For coordinated local development, overlay the clean environment manually:
+
+```bash
+uv pip install --python .venv/bin/python --reinstall --no-deps --editable \
+  /Users/kuanlun_wang/Desktop/git-repo/hbrowser.clone
+```
+
+Commands that must preserve this editable overlay use `uv run --no-sync`.
+
+## Read-only Market inspection
+
+Market inspection and sale planning are non-mutating by default:
+
+```python
+import asyncio
+
+from hvbrowser import HVDriver, SellItems
+
+
+async def main() -> None:
+    async with HVDriver(headless=True) as driver:
+        snapshot = await driver.inspect_market()
+        plan = await driver.marketcheck(SellItems(materials=["Low-Grade Metals"]))
+        print(len(snapshot.items), plan.total_units)
+
+
+asyncio.run(main())
+```
+
+The compatibility `marketcheck()` call requires `commit=True` before it can
+request submission. Submission is currently blocked by a fail-closed runtime
+gate until the current quote selector and pricing semantics have been confirmed
+with the read-only live probe. The guarded implementation never deposits
+credits and never re-lists unrelated orders.
+
+## Guarded live smoke test
+
+The surrounding `hentaiverse` workspace owns account selection. This smoke
+probe only refuses to construct a browser unless credentials are supplied
+indirectly through the environment. It stops when an active battle is detected
+and contains no click, submit, repair, recovery, lottery, monster-lab, or battle
+call:
+
+```bash
+uv run --no-sync python scripts/live_readonly_smoke.py \
+  --inspect-market-form
+```

hvbrowser-0.1.0/mypy.ini

@@ -0,0 +1,16 @@
+[mypy]
+python_version = 3.14
+warn_unused_configs = True
+disallow_untyped_defs = True
+check_untyped_defs = True
+warn_redundant_casts = True
+warn_unused_ignores = True
+no_implicit_optional = True
+strict_equality = True
+warn_return_any = True
+disallow_any_generics = True
+disallow_subclassing_any = True
+disallow_untyped_calls = True
+disallow_incomplete_defs = True
+disallow_untyped_decorators = True
+no_implicit_reexport = True

hvbrowser-0.1.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hvbrowser"
+version = "0.1.0"
+description = "Browser automation APIs for HentaiVerse."
+readme = "README.md"
+authors = [{ name = "Kuan-Lun Wang" }]
+license = { text = "GNU Affero General Public License v3" }
+requires-python = ">=3.14,<3.15"
+dependencies = [
+    "hbrowser>=0.35.0,<0.36",
+]
+
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)",
+    "Programming Language :: Python :: 3.14",
+]
+
+[project.optional-dependencies]
+dev = [
+    "black>=26.5.1",
+    "ruff>=0.15.20",
+    "mypy>=2.1.0",
+    "pymarkdownlnt>=0.9.38",
+    "pytest>=9.1.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/Kuan-Lun/hvbrowser"
+Tracker = "https://github.com/Kuan-Lun/hvbrowser/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hvbrowser"]
+
+[tool.ruff]
+line-length = 88
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]
+extend-ignore = ["E203", "E226", "E501"]

hvbrowser-0.1.0/scripts/hooks/finalize-markdown.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# Shared finalizer for Markdown changes.
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+cd "$REPO_ROOT"
+
+MD_FILES=()
+while IFS= read -r file; do
+    MD_FILES+=("$file")
+done < <(
+    find . -maxdepth 2 -type f -name "*.md" \
+        -not -path "./.venv/*" \
+        -not -path "./node_modules/*" \
+        -not -path "./.pytest_cache/*" \
+        -not -path "./.*" \
+        | sort
+)
+
+if [ ${#MD_FILES[@]} -eq 0 ]; then
+    exit 0
+fi
+
+uv run --no-sync pymarkdown fix "${MD_FILES[@]}" >/dev/null 2>&1 || true
+
+if ! uv run --no-sync ruff format --preview "${MD_FILES[@]}" >&2; then
+    exit 2
+fi

hvbrowser-0.1.0/scripts/hooks/finalize-python.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+# Shared finalizer for Python changes. `--no-sync` preserves a manually
+# installed editable hbrowser checkout in the project environment.
+
+set -eu
+trap 'exit 2' ERR
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+cd "$REPO_ROOT"
+
+FORMAT_PATHS=(src/hvbrowser tests scripts/live_readonly_smoke.py)
+TYPE_PATHS=(src/hvbrowser scripts/live_readonly_smoke.py)
+
+uv run --no-sync black "${FORMAT_PATHS[@]}" >&2
+uv run --no-sync ruff check --fix "${FORMAT_PATHS[@]}" >&2
+uv run --no-sync black "${FORMAT_PATHS[@]}" >&2
+uv run --no-sync mypy "${TYPE_PATHS[@]}" >&2

hvbrowser-0.1.0/scripts/live_readonly_smoke.py

@@ -0,0 +1,25 @@
+#!/usr/bin/env python3
+"""Run the guarded, non-mutating HentaiVerse smoke probe."""
+
+import argparse
+import asyncio
+import json
+from dataclasses import asdict
+
+from hvbrowser.live_probe import run_live_probe
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument(
+        "--inspect-market-form",
+        action="store_true",
+        help="Inspect one sell form and its public quote without clicking it",
+    )
+    args = parser.parse_args()
+    result = asyncio.run(run_live_probe(inspect_market_form=args.inspect_market_form))
+    print(json.dumps(asdict(result), indent=2))
+
+
+if __name__ == "__main__":
+    main()

hvbrowser-0.1.0/scripts/rebuild-env.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Rebuild a clean development environment whose hbrowser dependency comes
+# from PyPI. Install a local editable hbrowser checkout manually afterwards
+# when cross-repository development is required.
+
+set -euo pipefail
+cd "$(dirname "$0")/.."
+
+rm -rf .venv .mypy_cache .ruff_cache .pytest_cache
+find . -type d -name __pycache__ -exec rm -rf {} +
+uv cache clean --force
+uv venv --python 3.14
+uv pip install -e ".[dev]"

hvbrowser-0.1.0/src/hvbrowser/__init__.py

@@ -0,0 +1,32 @@
+__all__ = [
+    "HVDriver",
+    "SellItems",
+    "MarketCategory",
+    "MarketClient",
+    "MarketItem",
+    "MarketPageError",
+    "MarketSale",
+    "MarketSalePlan",
+    "MarketSaleQuote",
+    "MarketSaleReport",
+    "MarketSnapshot",
+    "MarketSubmissionError",
+    "HENTAIVERSE_ISEKAI_ROOT_URL",
+    "HENTAIVERSE_ROOT_URL",
+]
+
+
+from .hv import HVDriver, SellItems
+from .market import (
+    MarketCategory,
+    MarketClient,
+    MarketItem,
+    MarketPageError,
+    MarketSale,
+    MarketSalePlan,
+    MarketSaleQuote,
+    MarketSaleReport,
+    MarketSnapshot,
+    MarketSubmissionError,
+)
+from .urls import HENTAIVERSE_ISEKAI_ROOT_URL, HENTAIVERSE_ROOT_URL