Add pyproject packaging + viralens command; ignore build artifacts

- Add pyproject.toml (PEP 621): metadata, dependencies (mirrors
  requirements.txt), requires-python>=3.10, MIT license, and a
  `[project.scripts] viralens = "viralens:main"` console entry point.
  viralens.py is installed as a top-level module via package-dir = scripts;
  the worker scripts stay co-located and are still launched as files by the
  subprocess dispatcher, so the pipeline behaviour is unchanged.
- scripts/viralens.py: insert scripts/ onto sys.path so the in-process
  creators.py / config_local.py imports resolve whether the tool is run as a
  file (`python scripts/viralens.py`) or via the installed `viralens` command.
- .github/workflows/ci.yml: install editable, compile all scripts, and
  smoke-test `viralens --help`.
- README: lead install with `pip install -e .` (the `viralens` command).
- .gitignore: ignore *.egg-info/, build/, dist/, __pycache__/.

Verified in a clean venv: `pip install -e .` builds, `viralens --help` works
from any cwd, and a no-arg run reaches the preflight self-check with no
ImportError. Not published to PyPI; install is from source.

Author: HarryXin0919

.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install (editable, deps from pyproject)
+        run: pip install -e .
+      - name: Syntax check (compile all scripts)
+        run: python -m compileall scripts
+      - name: Smoke test (console entry point)
+        run: viralens --help

.gitignore

@@ -16,3 +16,8 @@ __pycache__/
 *.pyo
 .venv/
 venv/
+
+# python build artifacts
+*.egg-info/
+build/
+dist/

README.md

@@ -136,7 +136,7 @@ because `play_per_day` inflates new uploads) caught two real declines: **a lifes
 ```bash
 git clone https://github.com/HarryXin0919/viralens.git
 cd viralens
-pip install -r requirements.txt
+pip install -e .   # installs deps + the `viralens` command; not on PyPI yet
 
 # 1. add your API credentials (kept out of git — see Security below)
 cp scripts/config_local.example.py scripts/config_local.py

pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "viralens"
+version = "0.1.0"
+description = "Fetch + hypothesis-driven analysis for Bilibili & YouTube creators: pull video data and see which content form actually drives views."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Harry Xin" }]
+keywords = ["bilibili", "youtube", "creator-analytics", "data-analysis", "content-strategy"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+]
+dependencies = [
+    "bilibili-api-python>=17.0.0",
+    "jieba>=0.42.1",
+    "matplotlib>=3.7.0",
+    "Pillow>=9.0.0",
+    "numpy>=1.23.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/HarryXin0919/viralens"
+Repository = "https://github.com/HarryXin0919/viralens"
+
+[project.scripts]
+viralens = "viralens:main"
+
+# The tool is a pipeline of co-located scripts dispatched by viralens.py via
+# subprocess; we install viralens.py as the top-level module that exposes the CLI.
+# The worker scripts live next to it in scripts/ and are run as files.
+[tool.setuptools]
+py-modules = ["viralens"]
+
+[tool.setuptools.package-dir]
+"" = "scripts"

scripts/viralens.py

@@ -27,6 +27,11 @@
 DATA = ROOT / "data"
 REPORT = ROOT / "reports" / "index.html"
 
+# 让同目录的 creators.py / config_local.py 等无论以何种方式启动(直接跑文件 or
+# 安装为 `viralens` 命令)都能被 import 到。
+if str(HERE) not in sys.path:
+    sys.path.insert(0, str(HERE))
+
 HELP = __doc__