litloop 1.18.3__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- litloop/__init__.py +89 -0
- litloop/__main__.py +6 -0
- litloop/_source_hygiene.py +158 -0
- litloop/agents/__init__.py +13 -0
- litloop/agents/client.py +164 -0
- litloop/agents/runner.py +123 -0
- litloop/agents/system.py +54 -0
- litloop/agents/tools.py +142 -0
- litloop/app_server.py +8 -0
- litloop/browser/__init__.py +1 -0
- litloop/browser/backend.py +1009 -0
- litloop/browser/camofox_api.py +368 -0
- litloop/browser/chrome_copy.py +136 -0
- litloop/browser/cloakbrowser_compat.py +72 -0
- litloop/browser/cookies.py +347 -0
- litloop/browser/engine.py +965 -0
- litloop/browser/login.py +636 -0
- litloop/browser/pdf.py +263 -0
- litloop/browser/profile_health.py +167 -0
- litloop/browser/runtime.py +210 -0
- litloop/cache.py +104 -0
- litloop/citations/__init__.py +1 -0
- litloop/citations/bib_import.py +102 -0
- litloop/citations/bibtex_crossref.py +143 -0
- litloop/citations/formats.py +225 -0
- litloop/citations/paper_list.py +200 -0
- litloop/citations/session_export.py +94 -0
- litloop/cli/__init__.py +12 -0
- litloop/cli/_utils.py +267 -0
- litloop/cli/commands.py +1098 -0
- litloop/cli/doctor.py +141 -0
- litloop/cli/main.py +1173 -0
- litloop/cli/web.py +190 -0
- litloop/config.py +413 -0
- litloop/data/VARCON-LICENSE.txt +62 -0
- litloop/data/elements.tsv +119 -0
- litloop/data/institutional_identity_policy.json +165 -0
- litloop/data/publisher_access_catalog.json +969 -0
- litloop/data/publisher_carsi.json +105 -0
- litloop/data/spelling_search.tsv.gz +0 -0
- litloop/data/spelling_us.tsv.gz +0 -0
- litloop/data/webvpn.dat +0 -0
- litloop/data/webvpn.json +603 -0
- litloop/db.py +1922 -0
- litloop/deps.py +128 -0
- litloop/desktop/__init__.py +1 -0
- litloop/desktop/agent_runner.py +537 -0
- litloop/desktop/download_jobs.py +571 -0
- litloop/desktop/error_text.py +192 -0
- litloop/desktop/server.py +999 -0
- litloop/desktop/settings.py +552 -0
- litloop/desktop/translate.py +103 -0
- litloop/diagnostics.py +126 -0
- litloop/download/__init__.py +1 -0
- litloop/download/doi_check.py +44 -0
- litloop/download/fetcher.py +975 -0
- litloop/download/markdown.py +130 -0
- litloop/download/pdf.py +454 -0
- litloop/download/pipeline.py +1166 -0
- litloop/download/progress.py +312 -0
- litloop/download/rename.py +211 -0
- litloop/extractors/__init__.py +0 -0
- litloop/extractors/html_extractor.py +31 -0
- litloop/extractors/pdf_extractor.py +151 -0
- litloop/extractors/publisher_adapters/__init__.py +0 -0
- litloop/extractors/publisher_adapters/acs.py +167 -0
- litloop/extractors/publisher_adapters/elsevier.py +178 -0
- litloop/extractors/publisher_adapters/generic.py +191 -0
- litloop/extractors/publisher_adapters/nature.py +204 -0
- litloop/extractors/publisher_adapters/rsc.py +154 -0
- litloop/extractors/publisher_adapters/tandfonline.py +154 -0
- litloop/extractors/publisher_adapters/wiley.py +160 -0
- litloop/http_utils.py +57 -0
- litloop/identifiers.py +134 -0
- litloop/institutional/__init__.py +1 -0
- litloop/institutional/auth.py +576 -0
- litloop/institutional/carsi_login.py +569 -0
- litloop/institutional/config_adapter.py +63 -0
- litloop/institutional/proxy_check.py +98 -0
- litloop/institutional/remote_assist.py +274 -0
- litloop/institutional/schools.py +102 -0
- litloop/institutional/session_heal.py +73 -0
- litloop/institutional/session_store.py +105 -0
- litloop/log.py +47 -0
- litloop/models.py +269 -0
- litloop/network.py +417 -0
- litloop/optional.py +310 -0
- litloop/publishers/__init__.py +1 -0
- litloop/publishers/access.py +232 -0
- litloop/publishers/pdf_router.py +451 -0
- litloop/publishers/profiles.py +899 -0
- litloop/publishers/strategies/__init__.py +122 -0
- litloop/publishers/strategies/_core.py +2340 -0
- litloop/publishers/strategies/_elsevier_api.py +578 -0
- litloop/publishers/strategies/acm.py +27 -0
- litloop/publishers/strategies/acs.py +42 -0
- litloop/publishers/strategies/aip.py +27 -0
- litloop/publishers/strategies/aps.py +29 -0
- litloop/publishers/strategies/asce.py +28 -0
- litloop/publishers/strategies/base.py +108 -0
- litloop/publishers/strategies/copernicus.py +24 -0
- litloop/publishers/strategies/elsevier.py +66 -0
- litloop/publishers/strategies/generic.py +39 -0
- litloop/publishers/strategies/ieee.py +28 -0
- litloop/publishers/strategies/iop.py +27 -0
- litloop/publishers/strategies/nature.py +27 -0
- litloop/publishers/strategies/oxford.py +27 -0
- litloop/publishers/strategies/registry.py +83 -0
- litloop/publishers/strategies/royalsociety.py +28 -0
- litloop/publishers/strategies/rsc.py +27 -0
- litloop/publishers/strategies/sage.py +30 -0
- litloop/publishers/strategies/science.py +27 -0
- litloop/publishers/strategies/springer.py +34 -0
- litloop/publishers/strategies/tandfonline.py +32 -0
- litloop/publishers/strategies/wiley.py +32 -0
- litloop/publishers/supplementary.py +219 -0
- litloop/quota.py +202 -0
- litloop/search/__init__.py +1 -0
- litloop/search/abstracts.py +291 -0
- litloop/search/deep.py +1216 -0
- litloop/search/quick.py +1102 -0
- litloop/search/scansci_find.py +410 -0
- litloop/search/screening.py +225 -0
- litloop/search/title_to_doi.py +163 -0
- litloop/search/watches.py +124 -0
- litloop/server.py +1731 -0
- litloop/sources/__init__.py +1339 -0
- litloop/sources/_batch.py +529 -0
- litloop/sources/_index.py +221 -0
- litloop/sources/_routes.py +290 -0
- litloop/sources/altcha.py +90 -0
- litloop/sources/arxiv.py +45 -0
- litloop/sources/attempt.py +91 -0
- litloop/sources/carsi.py +74 -0
- litloop/sources/core_api.py +46 -0
- litloop/sources/crossref.py +162 -0
- litloop/sources/elsevier_api.py +620 -0
- litloop/sources/elsevier_check.py +274 -0
- litloop/sources/europepmc.py +81 -0
- litloop/sources/ezproxy.py +317 -0
- litloop/sources/instsci.py +1295 -0
- litloop/sources/libgen.py +116 -0
- litloop/sources/nature.py +39 -0
- litloop/sources/oa_discovery.py +135 -0
- litloop/sources/openaire.py +122 -0
- litloop/sources/openalex.py +100 -0
- litloop/sources/publishers.py +684 -0
- litloop/sources/sage_cn.py +139 -0
- litloop/sources/scibban.py +10 -0
- litloop/sources/scihub.py +1379 -0
- litloop/sources/scihub_domains.py +203 -0
- litloop/sources/scihub_speed.py +187 -0
- litloop/sources/scoring.py +250 -0
- litloop/sources/semantic_scholar.py +146 -0
- litloop/sources/springer_tdm.py +172 -0
- litloop/sources/unpaywall.py +116 -0
- litloop/sources/vpnsci.py +38 -0
- litloop/store.py +264 -0
- litloop/templates/index.html +347 -0
- litloop/terms/__init__.py +1 -0
- litloop/terms/glossary.py +422 -0
- litloop/terms/spelling.py +89 -0
- litloop/terms/text.py +106 -0
- litloop/tor/__init__.py +1 -0
- litloop/tor/embedded.py +371 -0
- litloop/tor/proxy.py +110 -0
- litloop/updates.py +148 -0
- litloop/zotero/__init__.py +1 -0
- litloop/zotero/bridge.py +309 -0
- litloop/zotero/client.py +317 -0
- litloop-1.18.3.dist-info/METADATA +347 -0
- litloop-1.18.3.dist-info/RECORD +176 -0
- litloop-1.18.3.dist-info/WHEEL +5 -0
- litloop-1.18.3.dist-info/entry_points.txt +2 -0
- litloop-1.18.3.dist-info/licenses/LICENSE +197 -0
- litloop-1.18.3.dist-info/top_level.txt +1 -0
litloop/cli/doctor.py
ADDED
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
"""Setup diagnostic: detect system environment and provide install commands."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import platform
|
|
6
|
+
import shutil
|
|
7
|
+
import socket
|
|
8
|
+
from typing import Any
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def detect_system() -> dict[str, Any]:
|
|
12
|
+
"""Detect OS, arch, and relevant system info."""
|
|
13
|
+
sys_info: dict[str, Any] = {
|
|
14
|
+
"os": platform.system(),
|
|
15
|
+
"os_version": platform.version(),
|
|
16
|
+
"arch": platform.machine(),
|
|
17
|
+
"python": platform.python_version(),
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
# Windows edition
|
|
21
|
+
if sys_info["os"] == "Windows":
|
|
22
|
+
try:
|
|
23
|
+
import ctypes
|
|
24
|
+
is_64 = ctypes.sizeof(ctypes.c_voidp) == 8
|
|
25
|
+
sys_info["windows_arch"] = "64-bit" if is_64 else "32-bit"
|
|
26
|
+
except Exception:
|
|
27
|
+
pass
|
|
28
|
+
|
|
29
|
+
return sys_info
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
def check_tor() -> dict[str, Any]:
|
|
33
|
+
"""Check Tor installation and connectivity."""
|
|
34
|
+
result: dict[str, Any] = {"installed": False, "running": False, "port": 1080, "embedded": False}
|
|
35
|
+
|
|
36
|
+
# Check embedded Tor binary
|
|
37
|
+
from ..config import load_config
|
|
38
|
+
config = load_config()
|
|
39
|
+
from ..tor.embedded import _tor_binary
|
|
40
|
+
embedded = _tor_binary(config)
|
|
41
|
+
if embedded:
|
|
42
|
+
result["installed"] = True
|
|
43
|
+
result["embedded"] = True
|
|
44
|
+
result["path"] = str(embedded)
|
|
45
|
+
|
|
46
|
+
# Check if tor binary exists in system PATH
|
|
47
|
+
tor_path = shutil.which("tor")
|
|
48
|
+
if tor_path:
|
|
49
|
+
result["installed"] = True
|
|
50
|
+
result["path"] = tor_path
|
|
51
|
+
|
|
52
|
+
# Check if Tor is listening on common ports
|
|
53
|
+
for port in (1080, 9050, 9150):
|
|
54
|
+
try:
|
|
55
|
+
with socket.create_connection(("127.0.0.1", port), timeout=2):
|
|
56
|
+
result["running"] = True
|
|
57
|
+
result["port"] = port
|
|
58
|
+
break
|
|
59
|
+
except (ConnectionRefusedError, OSError):
|
|
60
|
+
pass
|
|
61
|
+
|
|
62
|
+
return result
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
def check_browser() -> dict[str, Any]:
|
|
66
|
+
"""Check CloakBrowser connectivity."""
|
|
67
|
+
result: dict[str, Any] = {"running": False}
|
|
68
|
+
try:
|
|
69
|
+
from ..browser.engine import is_available
|
|
70
|
+
from ..config import load_config
|
|
71
|
+
result["running"] = is_available(load_config())
|
|
72
|
+
except Exception:
|
|
73
|
+
pass
|
|
74
|
+
return result
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
def get_install_commands(sys_info: dict[str, Any], tor: dict) -> dict[str, Any]:
|
|
78
|
+
"""Return system-specific installation commands for missing components."""
|
|
79
|
+
os_name = sys_info["os"]
|
|
80
|
+
commands: dict[str, Any] = {}
|
|
81
|
+
|
|
82
|
+
if not tor["running"]:
|
|
83
|
+
# Recommend embedded Tor (no Docker needed)
|
|
84
|
+
commands["tor"] = {
|
|
85
|
+
"method": "embedded",
|
|
86
|
+
"reason": "自动下载 Tor Expert Bundle 到 ~/.litloop/tor/,无需 Docker 或系统安装",
|
|
87
|
+
"steps": [
|
|
88
|
+
"1. 运行 litloop_tor_install 自动下载 Tor",
|
|
89
|
+
"2. 运行 litloop_tor_start 启动 Tor SOCKS5 代理",
|
|
90
|
+
"3. 下载时使用 use_tor=true",
|
|
91
|
+
],
|
|
92
|
+
"bridges": "在受限网络中,使用 litloop_tor_start(use_bridges=true) 启用 obfs4 桥接",
|
|
93
|
+
"alternatives": [],
|
|
94
|
+
}
|
|
95
|
+
if os_name == "Darwin":
|
|
96
|
+
commands["tor"]["alternatives"].append({
|
|
97
|
+
"method": "homebrew",
|
|
98
|
+
"steps": ["brew install tor", "brew services start tor"],
|
|
99
|
+
})
|
|
100
|
+
elif os_name != "Windows":
|
|
101
|
+
commands["tor"]["alternatives"].append({
|
|
102
|
+
"method": "apt",
|
|
103
|
+
"steps": ["sudo apt install tor", "sudo systemctl enable --now tor"],
|
|
104
|
+
})
|
|
105
|
+
elif os_name == "Windows":
|
|
106
|
+
commands["tor"]["alternatives"].append({
|
|
107
|
+
"method": "manual",
|
|
108
|
+
"steps": ["下载 Tor Expert Bundle: https://www.torproject.org/download/tor/"],
|
|
109
|
+
})
|
|
110
|
+
|
|
111
|
+
return commands
|
|
112
|
+
|
|
113
|
+
|
|
114
|
+
def setup_check() -> dict[str, Any]:
|
|
115
|
+
"""Full setup diagnostic. (Docker is not checked: the Docker setup was removed
|
|
116
|
+
on 2026-10-23, as a container cannot show the user the browser to log in.)"""
|
|
117
|
+
sys_info = detect_system()
|
|
118
|
+
tor = check_tor()
|
|
119
|
+
browser = check_browser()
|
|
120
|
+
|
|
121
|
+
commands = get_install_commands(sys_info, tor)
|
|
122
|
+
|
|
123
|
+
# Overall readiness
|
|
124
|
+
issues = []
|
|
125
|
+
if not tor["running"]:
|
|
126
|
+
issues.append("Tor 未运行,Sci-Hub/LibGen 通过 Tor 访问受限")
|
|
127
|
+
if not browser["running"]:
|
|
128
|
+
issues.append("CloakBrowser 未运行,Cloudflare 防护可能无法绕过")
|
|
129
|
+
|
|
130
|
+
readiness = "ready" if not issues else "partial"
|
|
131
|
+
if not tor["running"] and not browser["running"]:
|
|
132
|
+
readiness = "limited"
|
|
133
|
+
|
|
134
|
+
return {
|
|
135
|
+
"system": sys_info,
|
|
136
|
+
"tor": tor,
|
|
137
|
+
"browser": browser,
|
|
138
|
+
"install_commands": commands,
|
|
139
|
+
"issues": issues,
|
|
140
|
+
"readiness": readiness,
|
|
141
|
+
}
|