navcli 0.1.0__py3-none-any.whl

navcli/utils/selector.py

@@ -0,0 +1,88 @@
+"""CSS selector parsing and building utilities."""
+
+import re
+from typing import Optional
+
+
+def parse_selector(selector: str) -> dict:
+    """Parse a CSS selector into components.
+
+    Args:
+        selector: CSS selector string
+
+    Returns:
+        Dict with tag, id, classes, attrs
+    """
+    result = {
+        'tag': None,
+        'id': None,
+        'classes': [],
+        'attrs': {}
+    }
+
+    # Match tag
+    tag_match = re.match(r'^([a-zA-Z][a-zA-Z0-9-]*)', selector)
+    if tag_match:
+        result['tag'] = tag_match.group(1)
+        selector = selector[tag_match.end():]
+
+    # Match id
+    id_match = re.match(r'#([a-zA-Z0-9_-]+)', selector)
+    if id_match:
+        result['id'] = id_match.group(1)
+        selector = selector[id_match.end():]
+
+    # Match classes
+    class_matches = re.findall(r'\.([a-zA-Z0-9_-]+)', selector)
+    result['classes'] = class_matches
+
+    # Match attributes
+    attr_matches = re.findall(r'\[([^\]]+)\]', selector)
+    for attr in attr_matches:
+        if '=' in attr:
+            key, value = attr.split('=', 1)
+            result['attrs'][key] = value.strip('"\'')
+        else:
+            # Attribute without value (e.g., [disabled])
+            result['attrs'][attr] = ''
+
+    return result
+
+
+def build_selector(
+    tag: Optional[str] = None,
+    id: Optional[str] = None,
+    classes: Optional[list] = None,
+    attrs: Optional[dict] = None,
+    text: Optional[str] = None
+) -> str:
+    """Build a CSS selector from components.
+
+    Args:
+        tag: HTML tag name
+        id: Element id
+        classes: List of class names
+        attrs: Dict of attributes
+        text: Text content (used for :text pseudo-selector)
+
+    Returns:
+        CSS selector string
+    """
+    parts = []
+
+    if tag:
+        parts.append(tag)
+    if id:
+        parts.append(f'#{id}')
+    if classes:
+        parts.extend(f'.{c}' for c in classes)
+    if attrs:
+        for k, v in attrs.items():
+            if v:
+                parts.append(f'[{k}="{v}"]')
+            else:
+                parts.append(f'[{k}]')
+    if text:
+        parts.append(f':text-is("{text}")')
+
+    return ''.join(parts) or '*'

navcli/utils/text.py

@@ -0,0 +1,17 @@
+"""Text processing utilities."""
+
+
+def parse_key_value(s: str, sep: str = '=') -> tuple:
+    """Parse a key-value pair from string.
+
+    Args:
+        s: String in format "key=value"
+        sep: Separator character
+
+    Returns:
+        Tuple of (key, value)
+    """
+    if sep in s:
+        key, value = s.split(sep, 1)
+        return key.strip(), value.strip()
+    return s.strip(), ''

navcli/utils/time.py

@@ -0,0 +1,46 @@
+"""Time and timeout utilities."""
+
+import time
+from typing import Callable
+
+
+def wait_for_condition(
+    condition: Callable[[], bool],
+    timeout: float = 10.0,
+    interval: float = 0.1,
+    error_msg: str = "Condition not met"
+) -> bool:
+    """Wait for a condition to become true.
+
+    Args:
+        condition: Callable that returns True when condition is met
+        timeout: Maximum time to wait in seconds
+        interval: Polling interval in seconds
+        error_msg: Error message for timeout
+
+    Returns:
+        True if condition was met
+
+    Raises:
+        TimeoutError: If condition is not met within timeout
+    """
+    start = time.time()
+    while time.time() - start < timeout:
+        if condition():
+            return True
+        time.sleep(interval)
+    raise TimeoutError(f"{error_msg} within {timeout}s")
+
+
+def format_timeout(seconds: float) -> str:
+    """Format seconds into human readable timeout.
+
+    Args:
+        seconds: Time in seconds
+
+    Returns:
+        Formatted string like "3s" or "500ms"
+    """
+    if seconds >= 1:
+        return f"{int(seconds)}s" if seconds == int(seconds) else f"{seconds}s"
+    return f"{int(seconds * 1000)}ms"

navcli/utils/url.py

@@ -0,0 +1,16 @@
+"""URL utilities."""
+
+
+def normalize_url(url: str) -> str:
+    """Normalize a URL.
+
+    Args:
+        url: URL to normalize
+
+    Returns:
+        Normalized URL with scheme
+    """
+    url = url.strip()
+    if not url.startswith(('http://', 'https://')):
+        url = 'https://' + url
+    return url

navcli-0.1.0.dist-info/METADATA

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: navcli
+Version: 0.1.0
+Summary: 可交互、可探索的浏览器命令行工具，专为 AI Agent 设计
+Author: NavCLI Team
+License: MIT
+Project-URL: Homepage, https://github.com/navcli/navcli
+Project-URL: Repository, https://github.com/navcli/navcli
+Project-URL: Issues, https://github.com/navcli/navcli/issues
+Keywords: browser,cli,automation,ai-agent,playwright
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: cmd2>=2.4.0
+Requires-Dist: fastapi>=0.109.0
+Requires-Dist: uvicorn<1.0.0,>=0.25.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: cssify>=1.0.0
+Requires-Dist: aiohttp>=3.9.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+
+# NavCLI - 目标与愿景
+
+## 核心目标
+
+**让 AI Agent 能够像人类一样浏览网页。**
+
+现有方案（HTTP API、无头浏览器脚本、Playwright MCP）存在局限：
+- 不支持 JS 渲染的 SPA
+- 无会话状态持久化
+- 缺乏交互式探索能力
+
+NavCLI 的定位：**可交互、可探索的浏览器命令行工具**
+
+## 核心价值
+
+| 特性 | NavCLI 解决的问题 |
+|------|------------------|
+| JS 渲染支持 | 完整支持 SPA 应用 |
+| 会话持久化 | cookies、session 保持 |
+| 交互式 CLI | Agent 可边探索边操作 |
+| Token 优化 | 轻量 elements + 按需 text/html |
+
+## 典型工作流
+
+```bash
+> g https://example.com          # 导航
+> elements                       # 查看可操作元素
+> c .btn-login                   # 点击登录
+> t #email "test@example.com"    # 输入邮箱
+> t #password "123456"           # 输入密码
+> c button[type="submit"]        # 提交
+> text                           # 确认结果
+```
+
+Agent 可以：**导航 → 观察 → 交互 → 反馈 → 继续**
+
+## 愿景
+
+成为 AI Agent 的**标准浏览器交互层**，让任何 Agent 都能通过命令式界面控制浏览器，完成：
+- 表单填写、登录认证
+- 信息抓取、内容探索
+- 复杂多步业务流程
+
+## 相关文档
+
+- [PRD 产品需求文档](./NAVCLI_PRD.md)

navcli-0.1.0.dist-info/RECORD

@@ -0,0 +1,39 @@
+navcli/cli/__init__.py,sha256=SE3EeeJ5Hku0o_rbXHVG3cPDxZaLkrLVcH57wFJOtXI,117
+navcli/cli/app.py,sha256=wYEVsUjp4BE_MJDu2v75av1bT5x7EvF4_ssdpH2Q2VQ,3072
+navcli/cli/client.py,sha256=qYdMNMLnXlsMq0bkKJgAiXHpxnqTErehjAF0GRRAG7E,9138
+navcli/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+navcli/cli/commands/base.py,sha256=b8hsB43lUaD0b-5nErtunBGPOFPfKq_sdFEMmynjFRE,1596
+navcli/cli/commands/control.py,sha256=JbAUNXgxZFmEO96TbhtS2CHw2jH2HZUk3EOIU_RwUBY,3253
+navcli/cli/commands/explore.py,sha256=p1p4i2Z-GISmFIikdpQ0mEnpPArSKVA3OIo1Xu42Njg,3664
+navcli/cli/commands/interaction.py,sha256=39CSeWW-Sb_z1w3i2kkmvJ515DL7WLdJPGCwUpri4aQ,3701
+navcli/cli/commands/navigation.py,sha256=ksIyoaCFzkF076C4K8qbl4OI-15UWOjhd47Hm7dGAkI,2265
+navcli/cli/commands/query.py,sha256=zWp-tiCr6xGeIlrsaK1ufoBOTk5L5n8CzGtkIkcnRAs,4630
+navcli/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+navcli/core/models/__init__.py,sha256=-LEFzktT5xBaOMa_UXlNR_c0O9gVTfv5Bp-3IZb43Q4,295
+navcli/core/models/dom.py,sha256=vZzEpzLEOlCnUJWBWx0-gmHj8WBxorsnPsZJgUW3UOE,1160
+navcli/core/models/element.py,sha256=6L8PnY7h_-_MFweq6NU6gdG1g5_r_AHlW1bYTuUBNoM,747
+navcli/core/models/feedback.py,sha256=K67nc7fCiAAfeYKDppNEnHtM41fSdF-Ai7IMhvAv7PY,689
+navcli/core/models/state.py,sha256=iyn6GvGpONGRP6WwiE0PYird4owJleK03Gk-jWExfGg,657
+navcli/server/__init__.py,sha256=l7As1ZOyGRO_BX5agyhirw8XNm8Jc6qDez0ugAwXFoA,1795
+navcli/server/app.py,sha256=zNWYPGRGVWmoyiZX1g9i6LNqSagJirwzEi8eqsYUUqs,1320
+navcli/server/browser.py,sha256=XEqTUFgw7fLQDIjdahYn1dDDu-IlpaggEiUbH5divjk,10604
+navcli/server/middleware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+navcli/server/routes/__init__.py,sha256=LCd1lCcBCqJmFchr9OTvKJvCTQNLETAljdPaou-fd3I,180
+navcli/server/routes/control.py,sha256=ysoszU2OjhVH4BW3oahJ5-28l3yheQ-vhdqI-I8EVEU,1071
+navcli/server/routes/explore.py,sha256=7leV1LgTLurqDnLIOhDJhA5XEEGBxHkUOV8SgHJxYxc,11862
+navcli/server/routes/interaction.py,sha256=Daq-6Rp7FlWjyMK-HHYGKwQLHDBYWzC0GLq1q346Zxw,8562
+navcli/server/routes/navigation.py,sha256=ZDcblrKnOTDn8aeBKwWgZYHQke6Hmrm_NNtTNSC3MQU,3440
+navcli/server/routes/query.py,sha256=Lgp9lA7lUgXsxvI_1G-fymkIkiCwKpTFOW7SB_NWVJk,7699
+navcli/server/routes/session.py,sha256=gzwQKm8CkJTXcm6-5IYfzm44JF50l7Vhk-0SaLAt754,4701
+navcli/utils/__init__.py,sha256=g3CIjq_xybpmanja9A7oyQMtf9emS6qdHJIJ6BJx6t0,521
+navcli/utils/image.py,sha256=e30zNrOd3wi9UWesiQZJ5n62wIOfrGZnJFCMFKnFOD0,681
+navcli/utils/js.py,sha256=-OenTrj4Nh4s-zjUvjJnN3XSncX8b03tNrgY_nhPRxo,334
+navcli/utils/selector.py,sha256=E_8E5bjjL1gDn524l3bH3XzK3egn9IyoYEb7zXsTwTQ,2146
+navcli/utils/text.py,sha256=wCFCKCn6Ibi8GjAeGXBHT5CfS8BCs7X9qVxDq4eR1tE,389
+navcli/utils/time.py,sha256=bAjJ59rp02MkIfoCT1TzmFd_oGaGlOI-5RPiKSqT-kI,1181
+navcli/utils/url.py,sha256=UG71w8ArYJlqjl2XslwAN-Kk9GJOPK3k5fg6CxXE5js,301
+navcli-0.1.0.dist-info/METADATA,sha256=WyNy3vFZJjHwSR5RYa6rQZYbMR5LhYbepmg4rkztBvA,2607
+navcli-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+navcli-0.1.0.dist-info/entry_points.txt,sha256=J26RwbEYUO5UbuhH0aXF_tvQFCOCatAR80blaSn5oWk,72
+navcli-0.1.0.dist-info/top_level.txt,sha256=dwTN5Lw7STNP3zhL2-RDElX3EslzM2sbYYLfuszQSO4,7
+navcli-0.1.0.dist-info/RECORD,,

navcli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

navcli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+nav = navcli.cli:main
+nav-server = navcli.server:main

navcli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+navcli