academic-refchecker 2.0.7__py3-none-any.whl

academic_refchecker-2.0.7.dist-info/RECORD

@@ -0,0 +1,64 @@
+academic_refchecker-2.0.7.dist-info/licenses/LICENSE,sha256=Kwrx3fePVCeEFDCZvCW4OuoTNBiSoYbpGBI6qzGhWF0,1067
+backend/__init__.py,sha256=TFVkOx5tSp3abty15RzUbaSwQ9ZD0kfUn7PDh63xkYY,521
+backend/__main__.py,sha256=74V7yUMsRSZaaRyXYm-rZVc3TVUcUgwsoTQTUbV5EqM,211
+backend/cli.py,sha256=xV3l9M5OdNQQYOcrzj2d_7RmCgj7CXP_1oi0TPe6zNo,1672
+backend/concurrency.py,sha256=2KY9I_8dDkyl_HTGx27ZxU4rFXx2vqbGOlo5RrRbPjA,3223
+backend/database.py,sha256=1jLP1m9vNk5sEs4bh_xmX0T5ilZkUTX1c7nOVz5XnNc,30681
+backend/main.py,sha256=ntz5PbEfG65ENFTHVQlY-c8hP5UPM_hdFjl60YMNh78,54371
+backend/models.py,sha256=El2F-RTHgxQ7-WODmiYCpjsTFDpjwF9PBt-JDa_XipE,2591
+backend/refchecker_wrapper.py,sha256=cgJpPFNGAKHaNKxnLY3r3RxlJVT-yRyr3rJFeMxoxAo,51873
+backend/thumbnail.py,sha256=wPFXp3RlmcL9jVKZmSBRB7Pfy9Ti7nCnzNtL4osfNtM,17618
+backend/websocket_manager.py,sha256=l-Wou-rKV6n7t6Gcf5fR6s_4G-mssSrba0davNnYS70,4247
+backend/static/favicon.svg,sha256=R0oQauh16Uy0D7JlT27k-zdjJtrvfPKOe9La5vKYwuM,395
+backend/static/index.html,sha256=eJDL5t98ZJOl85d1_kJNNSUhmgGft_PCKcgbdG0UvCw,598
+backend/static/vite.svg,sha256=SnSK_UQ5GLsWWRyDTEAdrjPoeGGrXbrQgRw6O0qSFPs,1497
+backend/static/assets/index-2P6L_39v.css,sha256=KC3Wa6jfD1qwmEoVpqTovlzf8fsn5oHYz3NKta6BJxw,27469
+backend/static/assets/index-hk21nqxR.js,sha256=z2agP8ZFYw4AfYi-GJ5E_8_k-lPF-frXOJtPk-I0hDs,369533
+refchecker/__init__.py,sha256=Pg5MrtLxDBRcNYcI02N-bv3tzURVd1S3nQ8IyF7Zw7E,322
+refchecker/__main__.py,sha256=agBbT9iKN0g2xXtRNCoh29Nr7z2n5vU-r0MCVJKi4tI,232
+refchecker/__version__.py,sha256=xuLub_DO4RmCl3zDtU20SXDlj6XT8dJRz8nB_qv8LRo,65
+refchecker/checkers/__init__.py,sha256=T0PAHTFt6UiGvn-WGoJU8CdhXNmf6zaHmcGVoWHhmJQ,533
+refchecker/checkers/crossref.py,sha256=88moAyTudBqf9SKqTQkNAq1yyuRe95f8r4EpmJznupQ,20937
+refchecker/checkers/enhanced_hybrid_checker.py,sha256=2jIeUX7hankPok3M4de9o2bsJZ17ZomuLkdfdr9EV0s,28671
+refchecker/checkers/github_checker.py,sha256=YJ2sLj22qezw3uWjA0jhtDO0fOW4HUwcVbv2DQ4LjR0,14277
+refchecker/checkers/local_semantic_scholar.py,sha256=c-KUTh99s-Di71h-pzdrwlPgoSTwB-tgVAZnCrMFXmw,21011
+refchecker/checkers/openalex.py,sha256=WEjEppQMbutPs8kWOSorCIoXWqpJ9o1CXUicThHSWYU,20120
+refchecker/checkers/openreview_checker.py,sha256=0IHZe4Nscy8fle28rmhy1hhsofR5g0FFSakk8FFH_0A,40540
+refchecker/checkers/pdf_paper_checker.py,sha256=lrg09poNJBz9FNMrUoEjQ6CJbdYZAVANw0bCaTSb5oo,19904
+refchecker/checkers/semantic_scholar.py,sha256=yvatQM5fXdW0qagqrTUpgotd0RbT7N_pqaRNGfmQjJs,35613
+refchecker/checkers/webpage_checker.py,sha256=A_d5kg3OOsyliC00OVq_l0J-RJ4Ln7hUoURk21aO2fs,43653
+refchecker/config/__init__.py,sha256=r7sONsX2-ITviUJRU1KEz76uAuTRqZlzU-TVkvFRGYY,15
+refchecker/config/logging.conf,sha256=r1tP0ApLHtlz7rV-oKS1MVO7oXJOgahbZFTtYmKnf9U,687
+refchecker/config/settings.py,sha256=-vODFoXbWbGPUElpmchE5zbCj_n4Vtxr8HU1hQDFp_c,6164
+refchecker/core/__init__.py,sha256=1T2MSQyDk0u_PupbHvm4CvNNN--dxsw78fqKUrqoYrM,157
+refchecker/core/db_connection_pool.py,sha256=XRiOdehikkSz3obH4WKgf8woa3694if50Q15rBT-4XQ,4697
+refchecker/core/parallel_processor.py,sha256=HpVFEMwPBiP2FRjvGqlaXpjV5S0qP-hxdB_Wdl_lACo,17704
+refchecker/core/refchecker.py,sha256=nX8guDXFL1ZdT-K6KUJT_3iZjuoYsWj4e0rKrqd5VZA,287117
+refchecker/database/__init__.py,sha256=mEuVHlEBuS44t_2ZT_JnvQQrlRCjo1SJq1NmaJ6r8OY,125
+refchecker/database/download_semantic_scholar_db.py,sha256=waN4I97KC_36YMiPbiBDUUmgfzu1nub5yeKdAsIR2aw,75276
+refchecker/llm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+refchecker/llm/base.py,sha256=uMF-KOqZ9ZQ7rccOQLpKJiW9sEMMxr7ePXBSF0yYDJY,16782
+refchecker/llm/providers.py,sha256=RhsYbUqHV5YznJcJ8vTa6M-nUKltdREeG5mYrLdBS2c,40992
+refchecker/scripts/__init__.py,sha256=xJwo6afG8s7S888BK2Bxw2d7FX8aLkbl0l_ZoJOFibE,37
+refchecker/scripts/start_vllm_server.py,sha256=ZepWp2y2cKFW0Kgsoima2RbmF02fTU29UFcLLpsBhFU,4213
+refchecker/services/__init__.py,sha256=jGi9S74Msak3YR-C4Qb68VU7HB4oLaX9o1rlVAFpOFI,187
+refchecker/services/pdf_processor.py,sha256=7i5x043qfnyzE5EQmytfy_uPjbeCJp4Ka5OPyH-bwOE,10577
+refchecker/utils/__init__.py,sha256=SKTEQeKpLOFFMIzZiakzctsW9zGe_J7LDNJlygWV6RY,1221
+refchecker/utils/arxiv_utils.py,sha256=C7wqoCy9FZUQpoF92vLeJyrK1-6XoMmmL6u_hfDV3ro,18031
+refchecker/utils/author_utils.py,sha256=DLTo1xsxef2wxoe4s_MWrh36maj4fgnvFlsDLpDE-qQ,5507
+refchecker/utils/biblatex_parser.py,sha256=IKRUMtRsjdXIktyk9XGArt_ms0asmqP549uhFvvumuE,25581
+refchecker/utils/bibliography_utils.py,sha256=d6kqDOQou_PX6WQkOzrGyN5GpzaOjhu54w9wGfBRQZw,11760
+refchecker/utils/bibtex_parser.py,sha256=xY0dEqT8lBZF-W21YRpG28lp_F2ikLan7nK70WiCU2o,15286
+refchecker/utils/config_validator.py,sha256=rxf7K3DYmJ-BNPsmtaCNipY2BTVT-pJZ7wN-M9Y3GC8,11167
+refchecker/utils/db_utils.py,sha256=_wSupfBlm0ILFvntQTvoj7tLDCbrYPRQrp9NDvphF_E,6281
+refchecker/utils/doi_utils.py,sha256=_7YvQ0DTOQBMIujUE0SdJicjPiAR3VETLU668GIji24,6094
+refchecker/utils/error_utils.py,sha256=8TcfRUD6phZ7viPJrezQ4jKf_vE65lqEXZq5707eU6s,15425
+refchecker/utils/mock_objects.py,sha256=QxU-UXyHSY27IZYN8Sb8ei0JtNkpGSdMXoErrRLHXvE,6437
+refchecker/utils/text_utils.py,sha256=v5beDt_fyx4ETfTXLYrDMp3CuUGoDoLs7-d1H2GdySE,228585
+refchecker/utils/unicode_utils.py,sha256=-WBKarXO756p7fd7gCeNsMag4ztDNURwFX5IVniOtwY,10366
+refchecker/utils/url_utils.py,sha256=7b0rWCQJSajzqOvD7ghsBZPejiq6mUIz6SGhvU_WGDs,9441
+academic_refchecker-2.0.7.dist-info/METADATA,sha256=weaQGma4FfzxrEhRbcbJYz9OcAdygsrDHGVYmkf4uc4,26477
+academic_refchecker-2.0.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+academic_refchecker-2.0.7.dist-info/entry_points.txt,sha256=9cREsaKwlp05Ql0CBIjKrNHk5IG2cHY5LvJPsV2-SxA,108
+academic_refchecker-2.0.7.dist-info/top_level.txt,sha256=FfNvrvpj25gfpUBjW0epvz7Qrdejhups5Za_DBiSRu4,19
+academic_refchecker-2.0.7.dist-info/RECORD,,

academic_refchecker-2.0.7.dist-info/WHEEL

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

academic_refchecker-2.0.7.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+academic-refchecker = refchecker.core.refchecker:main
+refchecker-webui = backend.cli:main

academic_refchecker-2.0.7.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 RefChecker
+
+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.

academic_refchecker-2.0.7.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+backend
+refchecker

backend/__init__.py

@@ -0,0 +1,21 @@
+# Backend package for RefChecker Web UI
+"""
+RefChecker Web UI Backend
+
+This package provides the FastAPI backend for the RefChecker Web UI,
+including WebSocket support for real-time progress updates.
+
+Usage:
+    # As a command line tool (after pip install):
+    refchecker-webui --host 0.0.0.0 --port 8000
+    
+    # As a Python module:
+    python -m backend --host 0.0.0.0 --port 8000
+    
+    # With uvicorn directly:
+    uvicorn backend.main:app --host 0.0.0.0 --port 8000
+"""
+
+from .main import app
+
+__all__ = ["app"]

backend/__main__.py

@@ -0,0 +1,11 @@
+#!/usr/bin/env python3
+"""
+Allow running backend as a module: python -m backend
+
+This provides a clean entry point for the WebUI backend server.
+"""
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()

backend/cli.py

@@ -0,0 +1,64 @@
+#!/usr/bin/env python3
+"""
+CLI entry point for RefChecker Web UI backend server.
+
+This module provides the console script entry point for the refchecker-webui command.
+"""
+
+import sys
+import argparse
+from pathlib import Path
+
+
+def main():
+    """Main entry point for the refchecker-webui command."""
+    parser = argparse.ArgumentParser(
+        description="Start the RefChecker Web UI server"
+    )
+    parser.add_argument(
+        "--host", 
+        default="0.0.0.0", 
+        help="Host to bind to (default: 0.0.0.0)"
+    )
+    parser.add_argument(
+        "--port", 
+        type=int, 
+        default=8000, 
+        help="Port to listen on (default: 8000)"
+    )
+    parser.add_argument(
+        "--reload",
+        action="store_true",
+        help="Enable auto-reload for development"
+    )
+    
+    args = parser.parse_args()
+    
+    try:
+        import uvicorn
+    except ImportError:
+        print("Error: uvicorn is not installed.")
+        print("Install it with: pip install 'academic-refchecker[webui]'")
+        sys.exit(1)
+    
+    # Check if static frontend is bundled
+    static_dir = Path(__file__).parent / "static"
+    has_frontend = static_dir.exists() and (static_dir / "index.html").exists()
+    
+    print(f"Starting RefChecker Web UI on http://{args.host}:{args.port}")
+    if has_frontend:
+        print(f"Open http://localhost:{args.port} in your browser")
+    else:
+        print("Note: Frontend not bundled. Start it separately: cd web-ui && npm run dev")
+    print()
+    
+    uvicorn.run(
+        "backend.main:app",
+        host=args.host,
+        port=args.port,
+        reload=args.reload
+    )
+
+
+if __name__ == "__main__":
+    main()

backend/concurrency.py

@@ -0,0 +1,100 @@
+"""
+Global concurrency limiter for reference checking across all papers.
+
+This module provides a system-wide semaphore that limits the total number
+of concurrent reference checks, regardless of how many papers are being
+checked simultaneously.
+"""
+import asyncio
+from typing import Optional
+import logging
+
+logger = logging.getLogger(__name__)
+
+# Default max concurrent reference checks
+DEFAULT_MAX_CONCURRENT = 6
+
+class GlobalConcurrencyLimiter:
+    """
+    System-wide concurrency limiter for reference checks.
+    
+    Uses a semaphore to limit total concurrent operations across
+    all paper checks.
+    """
+    
+    def __init__(self, max_concurrent: int = DEFAULT_MAX_CONCURRENT):
+        self._max_concurrent = max_concurrent
+        self._semaphore = asyncio.Semaphore(max_concurrent)
+        self._active_count = 0
+        self._lock = asyncio.Lock()
+    
+    @property
+    def max_concurrent(self) -> int:
+        return self._max_concurrent
+    
+    @property
+    def active_count(self) -> int:
+        return self._active_count
+    
+    async def set_max_concurrent(self, value: int):
+        """
+        Update the max concurrent limit.
+        
+        Note: This recreates the semaphore, so it should only be called
+        when no operations are in progress, or the caller should be aware
+        that current limits may temporarily exceed the new value.
+        """
+        if value < 1:
+            value = 1
+        if value > 50:
+            value = 50
+        
+        async with self._lock:
+            old_value = self._max_concurrent
+            self._max_concurrent = value
+            self._semaphore = asyncio.Semaphore(value)
+            logger.info(f"Global concurrency limit changed from {old_value} to {value}")
+    
+    async def acquire(self):
+        """Acquire a slot in the concurrency pool."""
+        await self._semaphore.acquire()
+        async with self._lock:
+            self._active_count += 1
+            logger.debug(f"Acquired slot, active: {self._active_count}/{self._max_concurrent}")
+    
+    def release(self):
+        """Release a slot back to the concurrency pool."""
+        self._semaphore.release()
+        # Note: can't use async lock in sync context, so we do best-effort count
+        self._active_count = max(0, self._active_count - 1)
+        logger.debug(f"Released slot, active: {self._active_count}/{self._max_concurrent}")
+    
+    async def __aenter__(self):
+        await self.acquire()
+        return self
+    
+    async def __aexit__(self, exc_type, exc_val, exc_tb):
+        self.release()
+        return False
+
+
+# Global singleton instance
+_limiter: Optional[GlobalConcurrencyLimiter] = None
+
+
+def get_limiter() -> GlobalConcurrencyLimiter:
+    """Get the global concurrency limiter instance."""
+    global _limiter
+    if _limiter is None:
+        _limiter = GlobalConcurrencyLimiter()
+    return _limiter
+
+
+async def init_limiter(max_concurrent: int = DEFAULT_MAX_CONCURRENT):
+    """Initialize or reinitialize the global limiter with a specific limit."""
+    global _limiter
+    if _limiter is None:
+        _limiter = GlobalConcurrencyLimiter(max_concurrent)
+    else:
+        await _limiter.set_max_concurrent(max_concurrent)
+    return _limiter