academic-refchecker 1.2.53__py3-none-any.whl → 1.2.55__py3-none-any.whl

{academic_refchecker-1.2.53.dist-info → academic_refchecker-1.2.55.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: academic-refchecker
-Version: 1.2.53
+Version: 1.2.55
 Summary: A comprehensive tool for validating reference accuracy in academic papers
 Author-email: Mark Russinovich <markrussinovich@hotmail.com>
 License-Expression: MIT
@@ -156,17 +156,17 @@ Learn about RefChecker's design philosophy and development process in this detai
 
 1. **Check a famous paper:**
    ```bash
-   python refchecker.py --paper 1706.03762
+   python run_refchecker.py --paper 1706.03762
    ```
 
 2. **Check your own PDF:**
    ```bash
-   python refchecker.py --paper /path/to/your/paper.pdf
+   python run_refchecker.py --paper /path/to/your/paper.pdf
    ```
 
 3. **For faster processing with local database** (see [Local Database Setup](#local-database-setup)):
    ```bash
-   python refchecker.py --paper 1706.03762 --db-path semantic_scholar_db/semantic_scholar.db
+   python run_refchecker.py --paper 1706.03762 --db-path semantic_scholar_db/semantic_scholar.db
    ```
 
 > **⚡ Performance Tip**: Reference verification takes 5-10 seconds per reference without a Semantic Scholar API key due to rate limiting. With an API key, verification speeds up to 1-2 seconds per reference. Set `SEMANTIC_SCHOLAR_API_KEY` environment variable or use `--semantic-scholar-api-key` for faster processing.
@@ -192,13 +192,13 @@ RefChecker supports AI-powered bibliography parsing using Large Language Models
    export REFCHECKER_LLM_PROVIDER=anthropic
    export ANTHROPIC_API_KEY=your_api_key_here
    
-   python refchecker.py --paper 1706.03762
+   python run_refchecker.py --paper 1706.03762
    ```
 
 2. **Using Command Line Arguments**:
    ```bash
    # Enable LLM with specific provider and model
-   python refchecker.py --paper 1706.03762 \
+   python run_refchecker.py --paper 1706.03762 \
      --llm-provider anthropic \
      --llm-model claude-sonnet-4-20250514 \
    ```
@@ -211,7 +211,7 @@ RefChecker supports AI-powered bibliography parsing using Large Language Models
 With `OPENAI_API_KEY` environment variable: 
 
 ```bash
-python refchecker.py --paper /path/to/paper.pdf \
+python run_refchecker.py --paper /path/to/paper.pdf \
   --llm-provider openai \
   --llm-model gpt-4o \
 ```
@@ -221,7 +221,7 @@ python refchecker.py --paper /path/to/paper.pdf \
 With `ANTHROPIC_API_KEY` environment variable: 
 
 ```bash
-python refchecker.py --paper https://arxiv.org/abs/1706.03762 \
+python run_refchecker.py --paper https://arxiv.org/abs/1706.03762 \
   --llm-provider anthropic \
   --llm-model claude-sonnet-4-20250514 \
 ```
@@ -229,7 +229,7 @@ python refchecker.py --paper https://arxiv.org/abs/1706.03762 \
 #### Google Gemini
 
 ```bash
-python refchecker.py --paper paper.tex \
+python run_refchecker.py --paper paper.tex \
   --llm-provider google \
   --llm-model gemini-2.5-flash
 ```
@@ -237,7 +237,7 @@ python refchecker.py --paper paper.tex \
 #### Azure OpenAI
 
 ```bash
-python refchecker.py --paper paper.txt \
+python run_refchecker.py --paper paper.txt \
   --llm-provider azure \
   --llm-model gpt-4 \
   --llm-endpoint https://your-resource.openai.azure.com/
@@ -249,7 +249,7 @@ For running models locally:
 
 ```bash
 # automatic Huggingface model download with VLLM server launch 
-python refchecker.py --paper paper.pdf \
+python run_refchecker.py --paper paper.pdf \
   --llm-provider vllm \
   --llm-model meta-llama/Llama-3.1-8B-Instruct 
 ```
@@ -319,43 +319,43 @@ Check papers in various formats and online locations:
 
 ```bash
 # Check a specific ArXiv paper by ID
-python refchecker.py --paper 1706.03762
+python run_refchecker.py --paper 1706.03762
 
 # Check by ArXiv URL
-python refchecker.py --paper https://arxiv.org/abs/1706.03762
+python run_refchecker.py --paper https://arxiv.org/abs/1706.03762
 
 # Check by ArXiv PDF URL
-python refchecker.py --paper https://arxiv.org/pdf/1706.03762.pdf
+python run_refchecker.py --paper https://arxiv.org/pdf/1706.03762.pdf
 ```
 
 #### Local PDF Files
 
 ```bash
 # Check a local PDF file
-python refchecker.py --paper /path/to/your/paper.pdf
+python run_refchecker.py --paper /path/to/your/paper.pdf
 
 # Check with offline database for faster processing
-python refchecker.py --paper /path/to/your/paper.pdf --db-path semantic_scholar_db/semantic_scholar.db
+python run_refchecker.py --paper /path/to/your/paper.pdf --db-path semantic_scholar_db/semantic_scholar.db
 ```
 
 #### LaTeX Files
 
 ```bash
 # Check a LaTeX document
-python refchecker.py --paper /path/to/your/paper.tex
+python run_refchecker.py --paper /path/to/your/paper.tex
 
 # Check with debug mode for detailed processing info
-python refchecker.py --paper /path/to/your/paper.tex --debug
+python run_refchecker.py --paper /path/to/your/paper.tex --debug
 ```
 
 #### Text Files
 
 ```bash
 # Check a plain text file containing paper content
-python refchecker.py --paper /path/to/your/paper.txt
+python run_refchecker.py --paper /path/to/your/paper.txt
 
 # Combine with local database for offline verification
-python refchecker.py --paper /path/to/your/paper.txt --db-path semantic_scholar_db/semantic_scholar.db
+python run_refchecker.py --paper /path/to/your/paper.txt --db-path semantic_scholar_db/semantic_scholar.db
 ```
 
 
@@ -367,10 +367,10 @@ By default, no files are generated. To save detailed results, use the `--output-
 
 ```bash
 # Save to default filename (reference_errors.txt)
-python refchecker.py --paper 1706.03762 --output-file
+python run_refchecker.py --paper 1706.03762 --output-file
 
 # Save to custom filename
-python refchecker.py --paper 1706.03762 --output-file my_errors.txt
+python run_refchecker.py --paper 1706.03762 --output-file my_errors.txt
 ```
 
 The output file contains a detailed report of references with errors and warnings, including corrected references.
@@ -574,7 +574,7 @@ python download_semantic_scholar_db.py \
 
 ## 🧪 Testing
 
-RefChecker includes a comprehensive test suite with 124 tests covering unit, integration, and end-to-end scenarios. The tests ensure reliability across all components and provide examples of how to use the system.
+RefChecker includes a comprehensive test suite with **490+ tests** covering unit, integration, and end-to-end scenarios. The tests ensure reliability across all components and provide examples of how to use the system.
 
 ### Quick Test Run
 

academic_refchecker-1.2.55.dist-info/RECORD

@@ -0,0 +1,49 @@
+academic_refchecker-1.2.55.dist-info/licenses/LICENSE,sha256=Kwrx3fePVCeEFDCZvCW4OuoTNBiSoYbpGBI6qzGhWF0,1067
+refchecker/__init__.py,sha256=Pg5MrtLxDBRcNYcI02N-bv3tzURVd1S3nQ8IyF7Zw7E,322
+refchecker/__main__.py,sha256=agBbT9iKN0g2xXtRNCoh29Nr7z2n5vU-r0MCVJKi4tI,232
+refchecker/__version__.py,sha256=Xg3VGFPggqe_vQC3vz8fNW_FXpXAhzc4wLE7rwOBHjw,89
+refchecker/checkers/__init__.py,sha256=T0PAHTFt6UiGvn-WGoJU8CdhXNmf6zaHmcGVoWHhmJQ,533
+refchecker/checkers/crossref.py,sha256=5BeSCK8K_S_-iwgQaNAbxZGNsxaxOyBzUQ3AD0Rc6nU,20433
+refchecker/checkers/enhanced_hybrid_checker.py,sha256=c5I_h8w6xD7XkBNkbneffeAnrO8B-uXH99edWBJvDMo,27788
+refchecker/checkers/github_checker.py,sha256=YJ2sLj22qezw3uWjA0jhtDO0fOW4HUwcVbv2DQ4LjR0,14277
+refchecker/checkers/local_semantic_scholar.py,sha256=nrAJhm0VNEl4RwJWAEOGNCRE31h7CneLc9zSqY5zrHY,21092
+refchecker/checkers/openalex.py,sha256=omMQbZOnkDndMJSl9SQVtiETzpv1w1pt93YjlFTq8WA,19616
+refchecker/checkers/openreview_checker.py,sha256=0IHZe4Nscy8fle28rmhy1hhsofR5g0FFSakk8FFH_0A,40540
+refchecker/checkers/pdf_paper_checker.py,sha256=lrg09poNJBz9FNMrUoEjQ6CJbdYZAVANw0bCaTSb5oo,19904
+refchecker/checkers/semantic_scholar.py,sha256=CCrOMdOCfazX8bkikU209dz0xsV_xkeeYcmxO-K9-6I,35072
+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=IAxetrSC0Z7EzVR5coIL2g8MqhWlsZzQiDnceDE4_uc,287102
+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=A0usJpprCO5D-VX0hqaQzBfi4DG3rdjA39vu02XJsGw,40092
+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=vu_JnhFGZY6jFVbDbPvG-mlQojvB-3Dzc8_946KVV2E,9427
+refchecker/utils/__init__.py,sha256=1RrGoIIn1_gVzxd56b6a7HeAS-wu7uDP-nxLbR3fJ-8,1199
+refchecker/utils/arxiv_utils.py,sha256=idlCzkTApYwH-kdTiH9nrfo4GMmwdtUAv7cAGtoEG-0,19799
+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=ezUiRnYRpoO0U_Rqgxv1FxqmeTwPh6X8gLgSDbqg5sY,4874
+refchecker/utils/error_utils.py,sha256=Mm4ZqP_4FCRT9x4J_2IKSIAKRWaGLym-wbZqhj1wYzc,12512
+refchecker/utils/mock_objects.py,sha256=QxU-UXyHSY27IZYN8Sb8ei0JtNkpGSdMXoErrRLHXvE,6437
+refchecker/utils/text_utils.py,sha256=d_X4r1nVvkL7i0DhxfLaVK3CzbMP2oZvqX3kxfDudQw,220978
+refchecker/utils/unicode_utils.py,sha256=-WBKarXO756p7fd7gCeNsMag4ztDNURwFX5IVniOtwY,10366
+refchecker/utils/url_utils.py,sha256=HdxIO8QvciP6Jp8Wd4sTSrS8JQrOMwgM7pxdUC8RJb4,9176
+academic_refchecker-1.2.55.dist-info/METADATA,sha256=q0soTYffNjsEJBWQVvIXMGqqVeQn-1ayHP4EOhTFDvk,23345
+academic_refchecker-1.2.55.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+academic_refchecker-1.2.55.dist-info/entry_points.txt,sha256=kG6k2JwFIRvmKe0oZTr2RYStyfl79BirJxyaO6kjIxA,72
+academic_refchecker-1.2.55.dist-info/top_level.txt,sha256=ZdIg_PFHiATpVT5Uvp4L17Q0d8mk8ZBsINXKf1tE0bo,11
+academic_refchecker-1.2.55.dist-info/RECORD,,

academic_refchecker-1.2.55.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+academic-refchecker = refchecker.core.refchecker:main

academic_refchecker-1.2.55.dist-info/top_level.txt

@@ -0,0 +1 @@
+refchecker

refchecker/__init__.py

@@ -0,0 +1,13 @@
+"""
+RefChecker - Academic Paper Reference Validation Tool
+
+A comprehensive tool for validating reference accuracy in academic papers.
+"""
+
+__version__ = "1.2.1"
+__author__ = "RefChecker Team"
+__email__ = "markrussinovich@hotmail.com"
+
+from .core.refchecker import ArxivReferenceChecker
+
+__all__ = ["ArxivReferenceChecker"]

refchecker/__main__.py

@@ -0,0 +1,11 @@
+#!/usr/bin/env python3
+"""
+Allow running refchecker as a module: python -m refchecker
+
+This provides a clean entry point without import collision issues.
+"""
+
+from .core.refchecker import main
+
+if __name__ == "__main__":
+    main()

refchecker/__version__.py

@@ -0,0 +1,5 @@
+"""Version information for RefChecker."""
+
+__version__ = "1.2.55"
+
+__version__ = "1.2.55"

{checkers → refchecker/checkers}/crossref.py

@@ -30,9 +30,9 @@ import logging
 import re
 from typing import Dict, List, Tuple, Optional, Any, Union
 from urllib.parse import quote_plus
-from utils.text_utils import normalize_text, clean_title_basic, find_best_match, is_name_match, compare_authors, clean_title_for_search
-from utils.error_utils import format_year_mismatch, format_doi_mismatch
-from config.settings import get_config
+from refchecker.utils.text_utils import normalize_text, clean_title_basic, find_best_match, is_name_match, compare_authors, clean_title_for_search
+from refchecker.utils.error_utils import format_year_mismatch, format_doi_mismatch
+from refchecker.config.settings import get_config
 
 # Set up logging
 logger = logging.getLogger(__name__)
@@ -358,7 +358,7 @@ class CrossRefReferenceChecker:
         # Check for DOI
         doi = work_data.get('DOI')
         if doi:
-            from utils.doi_utils import construct_doi_url
+            from refchecker.utils.doi_utils import construct_doi_url
             doi_url = construct_doi_url(doi)
             logger.debug(f"Generated DOI URL: {doi_url}")
             return doi_url
@@ -487,7 +487,7 @@ class CrossRefReferenceChecker:
         work_doi = work_data.get('DOI')
         if doi and work_doi:
             # Compare DOIs using the proper comparison function
-            from utils.doi_utils import compare_dois
+            from refchecker.utils.doi_utils import compare_dois
             if not compare_dois(doi, work_doi):
                 errors.append({
                     'error_type': 'doi',

{checkers → refchecker/checkers}/enhanced_hybrid_checker.py

@@ -542,7 +542,7 @@ class EnhancedHybridReferenceChecker:
         """
         Compare author lists (delegates to shared utility)
         """
-        from utils.text_utils import compare_authors
+        from refchecker.utils.text_utils import compare_authors
         return compare_authors(cited_authors, correct_authors)
 
 # Backward compatibility alias

{checkers → refchecker/checkers}/github_checker.py

@@ -5,7 +5,7 @@ import re
 import logging
 from urllib.parse import urlparse
 from typing import Dict, Optional, Tuple, List, Any
-from utils.text_utils import strip_latex_commands
+from refchecker.utils.text_utils import strip_latex_commands
 
 logger = logging.getLogger(__name__)
 
@@ -170,7 +170,7 @@ class GitHubChecker:
             if cited_title:
                 title_match = self._check_title_match(cited_title, actual_name, actual_description)
                 if not title_match:
-                    from utils.error_utils import format_title_mismatch
+                    from refchecker.utils.error_utils import format_title_mismatch
                     # Clean the cited title for display (remove LaTeX commands like {LLM}s -> LLMs)
                     clean_cited_title = strip_latex_commands(cited_title)
                     details = format_title_mismatch(clean_cited_title, actual_name)
@@ -188,7 +188,7 @@ class GitHubChecker:
                 author_str = ', '.join(cited_authors) if isinstance(cited_authors, list) else str(cited_authors)
                 author_match = self._check_author_match(author_str, actual_owner, actual_owner_name)
                 if not author_match:
-                    from utils.error_utils import format_three_line_mismatch
+                    from refchecker.utils.error_utils import format_three_line_mismatch
                     left = author_str
                     right = f"{actual_owner} ({actual_owner_name})" if actual_owner_name else actual_owner
                     details = format_three_line_mismatch("Author mismatch", left, right)
@@ -203,7 +203,7 @@ class GitHubChecker:
                 try:
                     cited_year_int = int(cited_year)
                     if cited_year_int < creation_year:
-                        from utils.error_utils import format_year_mismatch
+                        from refchecker.utils.error_utils import format_year_mismatch
                         errors.append({
                             "warning_type": "year",
                             "warning_details": format_year_mismatch(cited_year, creation_year),

{checkers → refchecker/checkers}/local_semantic_scholar.py

@@ -35,12 +35,12 @@ import sys
 import os
 sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 
-from utils.doi_utils import extract_doi_from_url, compare_dois, construct_doi_url
-from utils.error_utils import create_author_error, create_year_warning, create_doi_error
-from utils.text_utils import normalize_author_name, normalize_paper_title, is_name_match, compare_authors, calculate_title_similarity, extract_arxiv_id_from_url
-from utils.db_utils import process_semantic_scholar_result, process_semantic_scholar_results
-from utils.url_utils import get_best_available_url
-from config.settings import get_config
+from refchecker.utils.doi_utils import extract_doi_from_url, compare_dois, construct_doi_url
+from refchecker.utils.error_utils import create_author_error, create_year_warning, create_doi_error
+from refchecker.utils.text_utils import normalize_author_name, normalize_paper_title, is_name_match, compare_authors, calculate_title_similarity, extract_arxiv_id_from_url
+from refchecker.utils.db_utils import process_semantic_scholar_result, process_semantic_scholar_results
+from refchecker.utils.url_utils import get_best_available_url
+from refchecker.config.settings import get_config
 
 # Set up logging
 logger = logging.getLogger(__name__)
@@ -471,7 +471,7 @@ class LocalNonArxivReferenceChecker:
         
         # First try to get the Semantic Scholar URL since that's what we used for verification
         if external_ids.get('CorpusId'):
-            from utils.url_utils import construct_semantic_scholar_url
+            from refchecker.utils.url_utils import construct_semantic_scholar_url
             paper_url = construct_semantic_scholar_url(external_ids['CorpusId'])
             logger.debug(f"Using Semantic Scholar URL for verification: {paper_url}")
         else:

{checkers → refchecker/checkers}/openalex.py

@@ -32,9 +32,9 @@ import logging
 import re
 from typing import Dict, List, Tuple, Optional, Any, Union
 from urllib.parse import quote_plus
-from utils.text_utils import normalize_text, clean_title_basic, find_best_match, is_name_match, compare_authors, clean_title_for_search
-from utils.error_utils import format_year_mismatch, format_doi_mismatch
-from config.settings import get_config
+from refchecker.utils.text_utils import normalize_text, clean_title_basic, find_best_match, is_name_match, compare_authors, clean_title_for_search
+from refchecker.utils.error_utils import format_year_mismatch, format_doi_mismatch
+from refchecker.config.settings import get_config
 
 # Set up logging
 logger = logging.getLogger(__name__)
@@ -343,7 +343,7 @@ class OpenAlexReferenceChecker:
         # Fall back to DOI URL
         doi = work_data.get('doi')
         if doi:
-            from utils.doi_utils import construct_doi_url
+            from refchecker.utils.doi_utils import construct_doi_url
             doi_url = construct_doi_url(doi)
             logger.debug(f"Generated DOI URL: {doi_url}")
             return doi_url
@@ -351,7 +351,7 @@ class OpenAlexReferenceChecker:
         # Check ids for other identifiers
         ids = work_data.get('ids', {})
         if ids.get('doi'):
-            from utils.doi_utils import construct_doi_url
+            from refchecker.utils.doi_utils import construct_doi_url
             doi_url = construct_doi_url(ids['doi'])
             logger.debug(f"Generated DOI URL from ids: {doi_url}")
             return doi_url
@@ -460,7 +460,7 @@ class OpenAlexReferenceChecker:
         
         if doi and work_doi:
             # Compare DOIs using the proper comparison function
-            from utils.doi_utils import compare_dois
+            from refchecker.utils.doi_utils import compare_dois
             if not compare_dois(doi, work_doi):
                 errors.append({
                     'error_type': 'doi',

{checkers → refchecker/checkers}/openreview_checker.py

@@ -32,7 +32,7 @@ import json
 from typing import Dict, List, Tuple, Optional, Any, Union
 from urllib.parse import urlparse, parse_qs
 from bs4 import BeautifulSoup
-from utils.text_utils import (
+from refchecker.utils.text_utils import (
     normalize_text, clean_title_basic, is_name_match, 
     calculate_title_similarity, compare_authors, 
     clean_title_for_search, are_venues_substantially_different,
@@ -426,7 +426,7 @@ class OpenReviewReferenceChecker:
         if cited_title and paper_title:
             similarity = compare_titles_with_latex_cleaning(cited_title, paper_title)
             if similarity < 0.7:  # Using a reasonable threshold
-                from utils.error_utils import format_title_mismatch
+                from refchecker.utils.error_utils import format_title_mismatch
                 # Clean the cited title for display (remove LaTeX commands like {LLM}s -> LLMs)
                 clean_cited_title = strip_latex_commands(cited_title)
                 details = format_title_mismatch(clean_cited_title, paper_title) + f" (similarity: {similarity:.2f})"
@@ -465,7 +465,7 @@ class OpenReviewReferenceChecker:
                 
                 is_different, year_message = is_year_substantially_different(cited_year_int, paper_year_int)
                 if is_different and year_message:
-                    from utils.error_utils import format_year_mismatch
+                    from refchecker.utils.error_utils import format_year_mismatch
                     errors.append({
                         "warning_type": "year",
                         "warning_details": format_year_mismatch(cited_year_int, paper_year_int)
@@ -479,7 +479,7 @@ class OpenReviewReferenceChecker:
         
         if cited_venue and paper_venue:
             if are_venues_substantially_different(cited_venue, paper_venue):
-                from utils.error_utils import format_venue_mismatch
+                from refchecker.utils.error_utils import format_venue_mismatch
                 errors.append({
                     "warning_type": "venue",
                     "warning_details": format_venue_mismatch(cited_venue, paper_venue)
@@ -552,7 +552,7 @@ class OpenReviewReferenceChecker:
         if cited_title and paper_title:
             similarity = compare_titles_with_latex_cleaning(cited_title, paper_title)
             if similarity < 0.8:  # Slightly higher threshold for search results
-                from utils.error_utils import format_title_mismatch
+                from refchecker.utils.error_utils import format_title_mismatch
                 # Clean the cited title for display (remove LaTeX commands like {LLM}s -> LLMs)
                 clean_cited_title = strip_latex_commands(cited_title)
                 details = format_title_mismatch(clean_cited_title, paper_title) + f" (similarity: {similarity:.2f})"
@@ -591,7 +591,7 @@ class OpenReviewReferenceChecker:
                 
                 is_different, year_message = is_year_substantially_different(cited_year_int, paper_year_int)
                 if is_different and year_message:
-                    from utils.error_utils import format_year_mismatch
+                    from refchecker.utils.error_utils import format_year_mismatch
                     errors.append({
                         "warning_type": "year",
                         "warning_details": format_year_mismatch(cited_year_int, paper_year_int)
@@ -605,7 +605,7 @@ class OpenReviewReferenceChecker:
         
         if cited_venue and paper_venue:
             if are_venues_substantially_different(cited_venue, paper_venue):
-                from utils.error_utils import format_venue_mismatch
+                from refchecker.utils.error_utils import format_venue_mismatch
                 errors.append({
                     "warning_type": "venue",
                     "warning_details": format_venue_mismatch(cited_venue, paper_venue)
@@ -931,7 +931,7 @@ class OpenReviewReferenceChecker:
         
         # Use similarity calculation from text_utils
         try:
-            from utils.text_utils import calculate_title_similarity
+            from refchecker.utils.text_utils import calculate_title_similarity
             similarity = calculate_title_similarity(search_title, found_title)
             return similarity >= threshold
         except ImportError:

{checkers → refchecker/checkers}/pdf_paper_checker.py

@@ -15,7 +15,7 @@ from pypdf import PdfReader
 from fuzzywuzzy import fuzz
 from bs4 import BeautifulSoup
 
-from utils.text_utils import normalize_text, calculate_title_similarity
+from refchecker.utils.text_utils import normalize_text, calculate_title_similarity
 
 logger = logging.getLogger(__name__)
 

{checkers → refchecker/checkers}/semantic_scholar.py

@@ -28,9 +28,9 @@ import time
 import logging
 import re
 from typing import Dict, List, Tuple, Optional, Any, Union
-from utils.text_utils import normalize_text, clean_title_basic, find_best_match, is_name_match, are_venues_substantially_different, calculate_title_similarity, compare_authors, clean_title_for_search, strip_latex_commands, compare_titles_with_latex_cleaning
-from utils.error_utils import format_title_mismatch
-from config.settings import get_config
+from refchecker.utils.text_utils import normalize_text, clean_title_basic, find_best_match, is_name_match, are_venues_substantially_different, calculate_title_similarity, compare_authors, clean_title_for_search, strip_latex_commands, compare_titles_with_latex_cleaning
+from refchecker.utils.error_utils import format_title_mismatch
+from refchecker.config.settings import get_config
 
 # Set up logging
 logger = logging.getLogger(__name__)
@@ -523,12 +523,12 @@ class NonArxivReferenceChecker:
                     arxiv_id_match = (cited_arxiv_id == found_arxiv_id)
             
             # Use flexible year validation
-            from utils.text_utils import is_year_substantially_different
+            from refchecker.utils.text_utils import is_year_substantially_different
             context = {'arxiv_match': arxiv_id_match}
             is_different, warning_message = is_year_substantially_different(year, paper_year, context)
             
             if is_different and warning_message:
-                from utils.error_utils import format_year_mismatch
+                from refchecker.utils.error_utils import format_year_mismatch
                 errors.append({
                     'warning_type': 'year',
                     'warning_details': format_year_mismatch(year, paper_year),
@@ -549,7 +549,7 @@ class NonArxivReferenceChecker:
         if cited_venue and paper_venue:
             # Use the utility function to check if venues are substantially different
             if are_venues_substantially_different(cited_venue, paper_venue):
-                from utils.error_utils import create_venue_warning
+                from refchecker.utils.error_utils import create_venue_warning
                 errors.append(create_venue_warning(cited_venue, paper_venue))
         elif not cited_venue and paper_venue:
             # Original reference has the venue in raw text but not parsed correctly
@@ -597,9 +597,9 @@ class NonArxivReferenceChecker:
             paper_doi = external_ids['DOI']
             
             # Compare DOIs using the proper comparison function
-            from utils.doi_utils import compare_dois
+            from refchecker.utils.doi_utils import compare_dois
             if doi and paper_doi and not compare_dois(doi, paper_doi):
-                from utils.error_utils import format_doi_mismatch
+                from refchecker.utils.error_utils import format_doi_mismatch
                 errors.append({
                     'error_type': 'doi',
                     'error_details': format_doi_mismatch(doi, paper_doi),
@@ -614,13 +614,13 @@ class NonArxivReferenceChecker:
         # Return the Semantic Scholar URL that was actually used for verification
         # First priority: Semantic Scholar URL since that's what we used for verification
         if external_ids.get('CorpusId'):
-            from utils.url_utils import construct_semantic_scholar_url
+            from refchecker.utils.url_utils import construct_semantic_scholar_url
             paper_url = construct_semantic_scholar_url(external_ids['CorpusId'])
             logger.debug(f"Using Semantic Scholar URL for verification: {paper_url}")
         
         # Second priority: DOI URL (if this was verified through DOI)
         elif external_ids.get('DOI'):
-            from utils.doi_utils import construct_doi_url
+            from refchecker.utils.doi_utils import construct_doi_url
             paper_url = construct_doi_url(external_ids['DOI'])
             logger.debug(f"Using DOI URL for verification: {paper_url}")
         

{checkers → refchecker/checkers}/webpage_checker.py

@@ -7,7 +7,7 @@ from urllib.parse import urlparse, urljoin
 from typing import Dict, Optional, Tuple, List, Any
 from bs4 import BeautifulSoup
 import time
-from utils.text_utils import strip_latex_commands
+from refchecker.utils.text_utils import strip_latex_commands
 
 logger = logging.getLogger(__name__)
 
@@ -185,7 +185,7 @@ class WebPageChecker:
             # Check title match
             if cited_title and page_title:
                 if not self._check_title_match(cited_title, page_title, page_description):
-                    from utils.error_utils import format_title_mismatch
+                    from refchecker.utils.error_utils import format_title_mismatch
                     # Clean the cited title for display (remove LaTeX commands like {LLM}s -> LLMs)
                     clean_cited_title = strip_latex_commands(cited_title)
                     errors.append({
@@ -207,7 +207,7 @@ class WebPageChecker:
             if cited_authors:
                 author_str = ', '.join(cited_authors) if isinstance(cited_authors, list) else str(cited_authors)
                 if not self._check_author_match(author_str, site_info, web_url):
-                    from utils.error_utils import format_three_line_mismatch
+                    from refchecker.utils.error_utils import format_three_line_mismatch
                     left = author_str
                     right = site_info.get('organization', 'unknown')
                     details = format_three_line_mismatch("Author/organization mismatch", left, right)

{core → refchecker/core}/parallel_processor.py

@@ -13,7 +13,7 @@ from threading import Thread, Lock
 from concurrent.futures import ThreadPoolExecutor, as_completed
 from dataclasses import dataclass
 from typing import List, Dict, Any, Optional, Tuple, Callable
-from utils.text_utils import deduplicate_urls
+from refchecker.utils.text_utils import deduplicate_urls
 
 logger = logging.getLogger(__name__)
 
@@ -277,15 +277,15 @@ class ParallelReferenceProcessor:
         # Print reference info in the same format as sequential mode
         raw_title = reference.get('title', 'Untitled')
         # Clean LaTeX commands from title for display
-        from utils.text_utils import strip_latex_commands
+        from refchecker.utils.text_utils import strip_latex_commands
         title = strip_latex_commands(raw_title)
-        from utils.text_utils import format_authors_for_display
+        from refchecker.utils.text_utils import format_authors_for_display
         authors = format_authors_for_display(reference.get('authors', []))
         year = reference.get('year', '')
         # Get venue from either 'venue' or 'journal' field and clean it up
         venue = reference.get('venue', '') or reference.get('journal', '')
         if venue:
-            from utils.error_utils import clean_venue_for_comparison
+            from refchecker.utils.error_utils import clean_venue_for_comparison
             venue = clean_venue_for_comparison(venue)
         url = reference.get('url', '')
         doi = reference.get('doi', '')
@@ -331,7 +331,7 @@ class ParallelReferenceProcessor:
             
             # Show DOI URL if available and different from what's already shown
             if external_ids.get('DOI'):
-                from utils.doi_utils import construct_doi_url
+                from refchecker.utils.doi_utils import construct_doi_url
                 doi_url = construct_doi_url(external_ids['DOI'])
                 if doi_url != verified_url_to_show and doi_url != url:
                     print(f"       DOI URL: {doi_url}")
@@ -355,7 +355,7 @@ class ParallelReferenceProcessor:
                     error_type = error.get('error_type') or error.get('warning_type') or error.get('info_type')
                     error_details = error.get('error_details') or error.get('warning_details') or error.get('info_details', 'Unknown error')
                     
-                    from utils.error_utils import print_labeled_multiline
+                    from refchecker.utils.error_utils import print_labeled_multiline
 
                     if error_type == 'arxiv_id':
                         # Keep existing style for arXiv ID errors