nbpl 0.1.0__py3-none-any.whl

nbpl/__init__.py

@@ -0,0 +1,25 @@
+"""检测运行中的 Python 脚本，并打开对应的视频。"""
+
+from .watcher import (
+    BILIBILI_URL,
+    YOUTUBE_URL,
+    ScriptProcess,
+    detect_country_code,
+    find_running_python_scripts,
+    maybe_open_for_current_python_script,
+    open_video_for_country,
+    run_once,
+    watch,
+)
+
+__all__ = [
+    "BILIBILI_URL",
+    "YOUTUBE_URL",
+    "ScriptProcess",
+    "detect_country_code",
+    "find_running_python_scripts",
+    "maybe_open_for_current_python_script",
+    "open_video_for_country",
+    "run_once",
+    "watch",
+]

nbpl/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+main()

nbpl/cli.py

@@ -0,0 +1,25 @@
+"""nbpl 的命令行入口。"""
+
+from __future__ import annotations
+
+import argparse
+
+from .watcher import watch
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        description="检测到 Python 脚本运行时，按所在地区打开对应的视频。"
+    )
+    parser.add_argument(
+        "--interval",
+        type=float,
+        default=1.0,
+        help="进程检查间隔（秒），默认：1",
+    )
+    parser.add_argument(
+        "--country-code",
+        help="覆盖公网 IP 地区检测，适合测试，例如 CN",
+    )
+    args = parser.parse_args()
+    watch(interval=args.interval, country_code=args.country_code)

nbpl/watcher.py

@@ -0,0 +1,128 @@
+"""nbpl 的进程监控与地区检测逻辑。"""
+
+from __future__ import annotations
+
+import os
+import sys
+import time
+import webbrowser
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Callable, Optional
+
+BILIBILI_URL = "https://www.bilibili.com/video/BV1GJ411x7h7"
+YOUTUBE_URL = "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
+IP_API_URL = "https://ipapi.co/json/"
+
+
+@dataclass(frozen=True)
+class ScriptProcess:
+    """一个关联到 Python 源文件的运行中 Python 解释器。"""
+
+    pid: int
+    script: str
+
+
+def _is_python_interpreter(executable: str) -> bool:
+    name = Path(executable).name.lower()
+    return name.startswith("python") or name in {"py", "py.exe"}
+
+
+def _script_from_cmdline(cmdline: list[str]) -> Optional[str]:
+    """从 Python 解释器的命令行中返回第一个直接传入的源文件。"""
+    if not cmdline or not _is_python_interpreter(cmdline[0]):
+        return None
+
+    for argument in cmdline[1:]:
+        if argument.lower().endswith((".py", ".pyw")):
+            return argument
+    return None
+
+
+def find_running_python_scripts() -> list[ScriptProcess]:
+    """列出正在执行 Python 源文件的其他进程。"""
+    try:
+        import psutil
+    except ImportError as exc:
+        raise RuntimeError("nbpl 依赖 psutil，请重新安装本包") from exc
+
+    found: list[ScriptProcess] = []
+    this_pid = os.getpid()
+    for process in psutil.process_iter(["pid", "cmdline"]):
+        try:
+            info = process.info
+            pid = info["pid"]
+            if pid == this_pid:
+                continue
+            script = _script_from_cmdline(info.get("cmdline") or [])
+            if script:
+                found.append(ScriptProcess(pid=pid, script=script))
+        except (psutil.AccessDenied, psutil.NoSuchProcess, psutil.ZombieProcess):
+            continue
+    return found
+
+
+def detect_country_code(timeout: float = 5.0) -> Optional[str]:
+    """返回公网 IP 的国家/地区代码；无法判断时返回 None。"""
+    try:
+        import requests
+    except ImportError as exc:
+        raise RuntimeError("nbpl 依赖 requests，请重新安装本包") from exc
+
+    try:
+        response = requests.get(IP_API_URL, timeout=timeout)
+        response.raise_for_status()
+        country_code = response.json().get("country_code")
+        return country_code.upper() if isinstance(country_code, str) else None
+    except (requests.RequestException, ValueError):
+        return None
+
+
+def open_video_for_country(country_code: Optional[str]) -> str:
+    """按国家/地区代码打开并返回相应的视频 URL。"""
+    url = BILIBILI_URL if country_code == "CN" else YOUTUBE_URL
+    webbrowser.open(url)
+    return url
+
+
+def maybe_open_for_current_python_script() -> Optional[str]:
+    """当前解释器执行 Python 源文件时自动打开视频。
+
+    设置环境变量 NBPL_DISABLE_AUTO_OPEN=1 可关闭自动行为。
+    """
+    if os.environ.get("NBPL_DISABLE_AUTO_OPEN") == "1":
+        return None
+    script = sys.argv[0] if sys.argv else ""
+    if not script.lower().endswith((".py", ".pyw")):
+        return None
+    return open_video_for_country(detect_country_code())
+
+
+def run_once(country_code: Optional[str] = None) -> Optional[str]:
+    """发现其他 Python 脚本正在运行时，仅打开一次视频。
+
+    可传入 country_code 以方便测试；未传入时会通过公网 IP 检测。
+    """
+    if not find_running_python_scripts():
+        return None
+    return open_video_for_country(
+        detect_country_code() if country_code is None else country_code
+    )
+
+
+def watch(
+    interval: float = 1.0,
+    country_code: Optional[str] = None,
+    on_open: Optional[Callable[[str], None]] = None,
+) -> None:
+    """等待 Python 脚本出现，打开视频后返回。"""
+    if interval <= 0:
+        raise ValueError("interval 必须大于零")
+
+    while True:
+        url = run_once(country_code=country_code)
+        if url:
+            if on_open:
+                on_open(url)
+            return
+        time.sleep(interval)

nbpl-0.1.0.dist-info/METADATA

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: nbpl
+Version: 0.1.0
+Summary: 检测正在运行的 Python 脚本，并按地区打开对应视频。
+Author: hekuo5310
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: psutil>=5.9
+Requires-Dist: requests>=2.28
+Dynamic: license-file
+
+# nbpl
+
+安装 nbpl 后，不需要在任何脚本中导入它。它会通过 Python 的 sitecustomize 启动钩子，在执行 Python 源文件时自动使用系统默认浏览器打开一个视频：
+
+| 公网 IP 所在国家/地区代码 | 打开的链接 |
+| --- | --- |
+| CN（中国大陆） | https://www.bilibili.com/video/BV1GJ411x7h7 |
+| 其他代码，或定位失败 | https://www.youtube.com/watch?v=dQw4w9WgXcQ |
+
+地区查询使用 https://ipapi.co/json/。本包仅会读取进程命令行并发起一次 IP 地理位置查询；不会上传检测到的脚本路径。
+
+## 安装
+
+~~~bash
+pip install nbpl
+~~~
+
+也可以直接从本仓库安装：
+
+~~~bash
+pip install git+https://github.com/hekuo5310/nbpl.git
+~~~
+
+## 自动使用
+
+安装后，直接运行任意 Python 文件即可自动触发：
+
+~~~bash
+python app.py
+~~~
+
+如果只想作为独立监控器使用，仍可运行：
+
+~~~bash
+nbpl
+~~~
+
+独立监控器默认每秒检查一次；发现其他 Python 脚本后打开对应链接并退出。修改检查间隔：
+
+~~~bash
+nbpl --interval 2
+~~~
+
+本地测试时可跳过 IP 查询，直接指定地区：
+
+~~~bash
+nbpl --country-code CN
+~~~
+
+## 临时关闭自动触发
+
+为避免自动打开浏览器，可在运行命令前设置环境变量：
+
+~~~bash
+NBPL_DISABLE_AUTO_OPEN=1 python app.py
+~~~
+
+Windows PowerShell：
+
+~~~powershell
+$env:NBPL_DISABLE_AUTO_OPEN = "1"; python app.py
+~~~
+
+## Python API
+
+~~~python
+from nbpl import run_once, watch
+
+run_once()  # 仅当已有其他 Python 脚本在运行时才打开链接
+watch(interval=1.0)  # 等待脚本出现，打开链接后返回
+~~~

nbpl-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+sitecustomize.py,sha256=CPEL8xVzOw_J_MYYCOKieZ3syNVaAGBStr8OiTgxZ0g,273
+nbpl/__init__.py,sha256=S3DQWho0BkbavEr3nYIvAM4yuyXNYDGC2uEFe4iFkNg,542
+nbpl/__main__.py,sha256=bYt9eEaoRQWdejEHFD8REx9jxVEdZptECFsV7F49Ink,30
+nbpl/cli.py,sha256=jQoxbkS5dxQI27O4SlvcQnOnfZImurPbAuRvv6USLLo,654
+nbpl/watcher.py,sha256=jzjPXp2kOM2nKuf__9HfpIbg6-fpgMkN9KMf4ivWYgc,4081
+nbpl-0.1.0.dist-info/licenses/LICENSE,sha256=nPn8ikjQJsLFY8JnSqwps8ud39e1GGiIax5cXA00R5w,1066
+nbpl-0.1.0.dist-info/METADATA,sha256=YIVSKcFLQvwJyZ2965pa1hHg7rRRDHvNjk5YIRpuvr4,1948
+nbpl-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+nbpl-0.1.0.dist-info/entry_points.txt,sha256=0S2Q9Oiyvjx-atubBXxeRpee2iF1RZC5oJYNTSscqRI,39
+nbpl-0.1.0.dist-info/top_level.txt,sha256=gfBXdr3y2pLYiwRzq3o9dB3ZDtSLAWWVak2xTVoNFN4,19
+nbpl-0.1.0.dist-info/RECORD,,

nbpl-0.1.0.dist-info/WHEEL

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

nbpl-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+nbpl = nbpl.cli:main

nbpl-0.1.0.dist-info/licenses/LICENSE

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

nbpl-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+nbpl
+sitecustomize

sitecustomize.py

@@ -0,0 +1,9 @@
+"""Python 启动钩子：无需在脚本中导入 nbpl。"""
+
+try:
+    from nbpl.watcher import maybe_open_for_current_python_script
+
+    maybe_open_for_current_python_script()
+except Exception:
+    # 启动钩子不能阻止用户的 Python 程序正常运行。
+    pass