academic-refchecker 1.2.67__tar.gz → 1.2.69__tar.gz

{academic_refchecker-1.2.67/academic_refchecker.egg-info → academic_refchecker-1.2.69}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: academic-refchecker
-Version: 1.2.67
+Version: 1.2.69
 Summary: A comprehensive tool for validating reference accuracy in academic papers
 Author-email: Mark Russinovich <markrussinovich@hotmail.com>
 License-Expression: MIT
@@ -186,18 +186,47 @@ Learn about RefChecker's design philosophy and development process in this detai
 
 RefChecker also includes a modern web interface with real-time progress updates, check history, and export options.
 
-### Prerequisites
+![RefChecker Web UI](assets/webui.png)
 
-- **Python 3.8+** with RefChecker installed (`pip install academic-refchecker[webui]`)
-- **Node.js 18+** and npm
+### Option 1: Install from PyPI (Recommended)
 
-### Quick Start (Web UI)
+The simplest way to run the Web UI is using the pip-installed package:
 
 ```bash
-# Install Python dependencies (if not already done)
+# Install RefChecker with Web UI support
 pip install academic-refchecker[llm,webui]
 
-# Install Node.js dependencies
+# Start the web server
+refchecker-webui
+```
+
+Then open **http://localhost:8000** in your browser.
+
+The `refchecker-webui` command starts a complete web server with both the API backend and the pre-built frontend.
+
+**Options:**
+```bash
+refchecker-webui --port 8080      # Use a different port
+refchecker-webui --host 0.0.0.0   # Allow external connections
+```
+
+### Option 2: Run from Cloned Repository (Development)
+
+If you're developing or modifying the Web UI:
+
+**Prerequisites:**
+- **Python 3.8+** with dependencies installed
+- **Node.js 18+** and npm
+
+```bash
+# Clone the repository
+git clone https://github.com/markrussinovich/refchecker.git
+cd refchecker
+
+# Install Python dependencies
+pip install -e ".[llm,webui]"
+
+# Install and run the frontend development server
 cd web-ui
 npm install    # First time only
 npm start      # Starts both backend and frontend
@@ -205,15 +234,14 @@ npm start      # Starts both backend and frontend
 
 Then open **http://localhost:5173** in your browser.
 
-### Alternative: Start Servers Separately
+**Alternative: Start Servers Separately**
 
-**Terminal 1 - Backend:**
+*Terminal 1 - Backend:*
 ```bash
-refchecker-webui --port 8000
-# Or: python -m uvicorn backend.main:app --port 8000
+python -m uvicorn backend.main:app --reload --port 8000
 ```
 
-**Terminal 2 - Frontend:**
+*Terminal 2 - Frontend:*
 ```bash
 cd web-ui
 npm run dev

{academic_refchecker-1.2.67 → academic_refchecker-1.2.69}/README.md

@@ -115,18 +115,47 @@ Learn about RefChecker's design philosophy and development process in this detai
 
 RefChecker also includes a modern web interface with real-time progress updates, check history, and export options.
 
-### Prerequisites
+![RefChecker Web UI](assets/webui.png)
 
-- **Python 3.8+** with RefChecker installed (`pip install academic-refchecker[webui]`)
-- **Node.js 18+** and npm
+### Option 1: Install from PyPI (Recommended)
 
-### Quick Start (Web UI)
+The simplest way to run the Web UI is using the pip-installed package:
 
 ```bash
-# Install Python dependencies (if not already done)
+# Install RefChecker with Web UI support
 pip install academic-refchecker[llm,webui]
 
-# Install Node.js dependencies
+# Start the web server
+refchecker-webui
+```
+
+Then open **http://localhost:8000** in your browser.
+
+The `refchecker-webui` command starts a complete web server with both the API backend and the pre-built frontend.
+
+**Options:**
+```bash
+refchecker-webui --port 8080      # Use a different port
+refchecker-webui --host 0.0.0.0   # Allow external connections
+```
+
+### Option 2: Run from Cloned Repository (Development)
+
+If you're developing or modifying the Web UI:
+
+**Prerequisites:**
+- **Python 3.8+** with dependencies installed
+- **Node.js 18+** and npm
+
+```bash
+# Clone the repository
+git clone https://github.com/markrussinovich/refchecker.git
+cd refchecker
+
+# Install Python dependencies
+pip install -e ".[llm,webui]"
+
+# Install and run the frontend development server
 cd web-ui
 npm install    # First time only
 npm start      # Starts both backend and frontend
@@ -134,15 +163,14 @@ npm start      # Starts both backend and frontend
 
 Then open **http://localhost:5173** in your browser.
 
-### Alternative: Start Servers Separately
+**Alternative: Start Servers Separately**
 
-**Terminal 1 - Backend:**
+*Terminal 1 - Backend:*
 ```bash
-refchecker-webui --port 8000
-# Or: python -m uvicorn backend.main:app --port 8000
+python -m uvicorn backend.main:app --reload --port 8000
 ```
 
-**Terminal 2 - Frontend:**
+*Terminal 2 - Frontend:*
 ```bash
 cd web-ui
 npm run dev

{academic_refchecker-1.2.67 → academic_refchecker-1.2.69/academic_refchecker.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: academic-refchecker
-Version: 1.2.67
+Version: 1.2.69
 Summary: A comprehensive tool for validating reference accuracy in academic papers
 Author-email: Mark Russinovich <markrussinovich@hotmail.com>
 License-Expression: MIT
@@ -186,18 +186,47 @@ Learn about RefChecker's design philosophy and development process in this detai
 
 RefChecker also includes a modern web interface with real-time progress updates, check history, and export options.
 
-### Prerequisites
+![RefChecker Web UI](assets/webui.png)
 
-- **Python 3.8+** with RefChecker installed (`pip install academic-refchecker[webui]`)
-- **Node.js 18+** and npm
+### Option 1: Install from PyPI (Recommended)
 
-### Quick Start (Web UI)
+The simplest way to run the Web UI is using the pip-installed package:
 
 ```bash
-# Install Python dependencies (if not already done)
+# Install RefChecker with Web UI support
 pip install academic-refchecker[llm,webui]
 
-# Install Node.js dependencies
+# Start the web server
+refchecker-webui
+```
+
+Then open **http://localhost:8000** in your browser.
+
+The `refchecker-webui` command starts a complete web server with both the API backend and the pre-built frontend.
+
+**Options:**
+```bash
+refchecker-webui --port 8080      # Use a different port
+refchecker-webui --host 0.0.0.0   # Allow external connections
+```
+
+### Option 2: Run from Cloned Repository (Development)
+
+If you're developing or modifying the Web UI:
+
+**Prerequisites:**
+- **Python 3.8+** with dependencies installed
+- **Node.js 18+** and npm
+
+```bash
+# Clone the repository
+git clone https://github.com/markrussinovich/refchecker.git
+cd refchecker
+
+# Install Python dependencies
+pip install -e ".[llm,webui]"
+
+# Install and run the frontend development server
 cd web-ui
 npm install    # First time only
 npm start      # Starts both backend and frontend
@@ -205,15 +234,14 @@ npm start      # Starts both backend and frontend
 
 Then open **http://localhost:5173** in your browser.
 
-### Alternative: Start Servers Separately
+**Alternative: Start Servers Separately**
 
-**Terminal 1 - Backend:**
+*Terminal 1 - Backend:*
 ```bash
-refchecker-webui --port 8000
-# Or: python -m uvicorn backend.main:app --port 8000
+python -m uvicorn backend.main:app --reload --port 8000
 ```
 
-**Terminal 2 - Frontend:**
+*Terminal 2 - Frontend:*
 ```bash
 cd web-ui
 npm run dev

{academic_refchecker-1.2.67 → academic_refchecker-1.2.69}/backend/refchecker_wrapper.py

@@ -171,18 +171,18 @@ class ProgressRefChecker:
                 "is_warning": is_warning,  # Preserve warning_type as warning flag
             })
 
-        # Determine status - items with warning_type or certain error types are warnings, not errors
-        warning_types = ['year', 'venue', 'author']
+        # Determine status - items originally from warning_type are warnings, items from error_type are errors
         # Items originally from info_type are suggestions, not errors
         # Items originally from warning_type are warnings, not errors
+        # Items with error_type (including year/venue/author when missing) are errors
         has_errors = any(
-            e.get('error_type') not in ['unverified', 'info'] + warning_types 
+            e.get('error_type') not in ['unverified', 'info'] 
             and not e.get('is_suggestion')
             and not e.get('is_warning')
             for e in sanitized
         )
         has_warnings = any(
-            (e.get('error_type') in warning_types or e.get('is_warning'))
+            e.get('is_warning')
             and not e.get('is_suggestion') 
             for e in sanitized
         )
@@ -252,8 +252,8 @@ class ProgressRefChecker:
                     "suggestion_type": err.get('error_type') or 'info',
                     "suggestion_details": err.get('error_details', '')
                 })
-            elif err.get('is_warning') or err.get('error_type') in ['year', 'venue', 'author']:
-                # Items with is_warning flag or known warning types go to warnings
+            elif err.get('is_warning'):
+                # Only items with is_warning flag (originally warning_type) go to warnings
                 formatted_warnings.append(err_obj)
             elif err.get('error_type') == 'unverified':
                 formatted_errors.append({**err_obj, "error_type": 'unverified'})

academic_refchecker-1.2.69/src/refchecker/__version__.py

@@ -0,0 +1,3 @@
+"""Version information for RefChecker."""
+
+__version__ = "1.2.69"

{academic_refchecker-1.2.67 → academic_refchecker-1.2.69}/src/refchecker/checkers/local_semantic_scholar.py

@@ -36,7 +36,7 @@ import os
 sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 
 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.error_utils import create_author_error, create_doi_error
 from refchecker.utils.text_utils import normalize_author_name, normalize_paper_title, is_name_match, compare_authors, calculate_title_similarity
 from refchecker.utils.url_utils import extract_arxiv_id_from_url, get_best_available_url
 from refchecker.utils.db_utils import process_semantic_scholar_result, process_semantic_scholar_results
@@ -432,20 +432,24 @@ class LocalNonArxivReferenceChecker:
         
         # Verify year (with tolerance)
         paper_year = paper_data.get('year')
-        if year and paper_year:
-            # Get year tolerance from config (default to 1 if not available)
-            year_tolerance = 1  # Default tolerance
-            try:
-                from config.settings import get_config
-                config = get_config()
-                year_tolerance = config.get('text_processing', {}).get('year_tolerance', 1)
-            except (ImportError, Exception):
-                pass  # Use default if config not available
-            
-            # Only flag as mismatch if the difference is greater than tolerance
-            if abs(year - paper_year) > year_tolerance:
-                logger.debug(f"Local DB: Year mismatch - cited: {year}, actual: {paper_year}")
-                errors.append(create_year_warning(year, paper_year))
+        # Get year tolerance from config (default to 1 if not available)
+        year_tolerance = 1  # Default tolerance
+        try:
+            from config.settings import get_config
+            config = get_config()
+            year_tolerance = config.get('text_processing', {}).get('year_tolerance', 1)
+        except (ImportError, Exception):
+            pass  # Use default if config not available
+        
+        from refchecker.utils.error_utils import validate_year
+        year_warning = validate_year(
+            cited_year=year,
+            paper_year=paper_year,
+            year_tolerance=year_tolerance
+        )
+        if year_warning:
+            logger.debug(f"Local DB: Year issue - {year_warning.get('warning_details', '')}")
+            errors.append(year_warning)
         
         # Verify DOI
         paper_doi = None

{academic_refchecker-1.2.67 → academic_refchecker-1.2.69}/src/refchecker/checkers/semantic_scholar.py

@@ -511,29 +511,25 @@ class NonArxivReferenceChecker:
         
         # Verify year using flexible validation
         paper_year = paper_data.get('year')
-        if year and paper_year:
-            # Check if we have an exact ArXiv ID match for additional context
-            arxiv_id_match = False
-            if url and 'arxiv.org/abs/' in url:
-                arxiv_match = re.search(r'arxiv\.org/abs/([^\s/?#]+)', url)
-                if arxiv_match:
-                    cited_arxiv_id = arxiv_match.group(1)
-                    external_ids = paper_data.get('externalIds', {})
-                    found_arxiv_id = external_ids.get('ArXiv')
-                    arxiv_id_match = (cited_arxiv_id == found_arxiv_id)
-            
-            # Use flexible year validation
-            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 refchecker.utils.error_utils import format_year_mismatch
-                errors.append({
-                    'warning_type': 'year',
-                    'warning_details': format_year_mismatch(year, paper_year),
-                    'ref_year_correct': paper_year
-                })
+        # Check if we have an exact ArXiv ID match for additional context
+        arxiv_id_match = False
+        if url and 'arxiv.org/abs/' in url:
+            arxiv_match = re.search(r'arxiv\.org/abs/([^\s/?#]+)', url)
+            if arxiv_match:
+                cited_arxiv_id = arxiv_match.group(1)
+                external_ids = paper_data.get('externalIds', {})
+                found_arxiv_id = external_ids.get('ArXiv')
+                arxiv_id_match = (cited_arxiv_id == found_arxiv_id)
+        
+        from refchecker.utils.error_utils import validate_year
+        year_warning = validate_year(
+            cited_year=year,
+            paper_year=paper_year,
+            use_flexible_validation=True,
+            context={'arxiv_match': arxiv_id_match}
+        )
+        if year_warning:
+            errors.append(year_warning)
         
         # Verify venue
         cited_venue = reference.get('journal', '') or reference.get('venue', '')
@@ -573,10 +569,10 @@ class NonArxivReferenceChecker:
                 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:
-            # Reference has no venue but paper has one - always warn about missing venue
+            # Reference has no venue but paper has one - error for missing venue
             errors.append({
-                'warning_type': 'venue',
-                'warning_details': f"Venue missing: should include '{paper_venue}'",
+                'error_type': 'venue',
+                'error_details': f"Venue missing: should include '{paper_venue}'",
                 'ref_venue_correct': paper_venue
             })
 

{academic_refchecker-1.2.67 → academic_refchecker-1.2.69}/src/refchecker/core/refchecker.py

@@ -1928,25 +1928,24 @@ class ArxivReferenceChecker:
         
         # Verify year (with tolerance)
         paper_year = paper_data.get('year')
-        if year and paper_year:
-            # Get year tolerance from config (default to 1 if not available)
-            year_tolerance = 1  # Default tolerance
-            try:
-                from config.settings import get_config
-                config = get_config()
-                year_tolerance = config.get('text_processing', {}).get('year_tolerance', 1)
-            except (ImportError, Exception):
-                pass  # Use default if config not available
-            
-            # Only flag as mismatch if the difference is greater than tolerance
-            if abs(year - paper_year) > year_tolerance:
-                logger.debug(f"DB Verification: Year mismatch - cited: {year}, actual: {paper_year}")
-                from refchecker.utils.error_utils import format_year_mismatch
-                errors.append({
-                    'warning_type': 'year',
-                    'warning_details': format_year_mismatch(year, paper_year),
-                    'ref_year_correct': paper_year
-                })
+        # Get year tolerance from config (default to 1 if not available)
+        year_tolerance = 1  # Default tolerance
+        try:
+            from config.settings import get_config
+            config = get_config()
+            year_tolerance = config.get('text_processing', {}).get('year_tolerance', 1)
+        except (ImportError, Exception):
+            pass  # Use default if config not available
+        
+        from refchecker.utils.error_utils import validate_year
+        year_warning = validate_year(
+            cited_year=year,
+            paper_year=paper_year,
+            year_tolerance=year_tolerance
+        )
+        if year_warning:
+            logger.debug(f"DB Verification: Year issue - {year_warning.get('warning_details', '')}")
+            errors.append(year_warning)
         
         # Verify DOI
         if doi and external_ids.get('DOI'):

{academic_refchecker-1.2.67 → academic_refchecker-1.2.69}/src/refchecker/utils/error_utils.py

@@ -124,6 +124,67 @@ def create_year_warning(cited_year: int, correct_year: int) -> Dict[str, Any]:
     }
 
 
+def create_year_missing_error(correct_year: int) -> Dict[str, Any]:
+    """
+    Create a standardized error for missing year in reference.
+    
+    Args:
+        correct_year: Correct year from database
+        
+    Returns:
+        Standardized error dictionary
+    """
+    return {
+        'error_type': 'year',
+        'error_details': f"Year missing: should include '{correct_year}'",
+        'ref_year_correct': correct_year
+    }
+
+
+def validate_year(cited_year: Optional[int], paper_year: Optional[int], 
+                  year_tolerance: int = 1, use_flexible_validation: bool = False,
+                  context: Optional[Dict[str, Any]] = None) -> Optional[Dict[str, Any]]:
+    """
+    Validate year field and return appropriate warning if needed.
+    
+    This function handles:
+    - Year mismatch (with configurable tolerance)
+    - Missing year in reference
+    
+    Args:
+        cited_year: Year as cited in the reference (may be None)
+        paper_year: Correct year from database/API (may be None)
+        year_tolerance: Maximum allowed difference between years (default 1)
+        use_flexible_validation: If True, use is_year_substantially_different for more context-aware checking
+        context: Optional context dict for flexible validation (e.g., {'arxiv_match': True})
+        
+    Returns:
+        Warning dictionary if year issue found, None otherwise
+    """
+    if not paper_year:
+        # Can't validate without a known correct year
+        return None
+    
+    if cited_year and paper_year:
+        if use_flexible_validation:
+            # Use the more sophisticated validation from text_utils
+            from refchecker.utils.text_utils import is_year_substantially_different
+            is_different, warning_message = is_year_substantially_different(
+                cited_year, paper_year, context or {}
+            )
+            if is_different and warning_message:
+                return create_year_warning(cited_year, paper_year)
+        else:
+            # Simple tolerance-based validation
+            if abs(cited_year - paper_year) > year_tolerance:
+                return create_year_warning(cited_year, paper_year)
+    elif not cited_year and paper_year:
+        # Reference is missing a year but paper has one
+        return create_year_missing_error(paper_year)
+    
+    return None
+
+
 def create_doi_error(cited_doi: str, correct_doi: str) -> Optional[Dict[str, str]]:
     """
     Create a standardized DOI error or warning dictionary.
@@ -220,8 +281,8 @@ def create_venue_warning(cited_venue: str, correct_venue: str) -> Dict[str, str]
     # If cited venue cleans to empty, treat as missing venue instead of mismatch
     if not clean_cited and clean_correct:
         return {
-            'warning_type': 'venue',
-            'warning_details': format_missing_venue(clean_correct),
+            'error_type': 'venue',
+            'error_details': format_missing_venue(clean_correct),
             'ref_venue_correct': correct_venue
         }
 

academic_refchecker-1.2.67/src/refchecker/__version__.py

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