scitex 2.14.0__py3-none-any.whl → 2.15.2__py3-none-any.whl

scitex/scholar/url_finder/.tmp/open_url/_ResolverLinkFinder.py

@@ -0,0 +1,344 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# Timestamp: "2025-07-29 03:10:08 (ywatanabe)"
+# File: /home/ywatanabe/proj/scitex_repo/src/scitex/scholar/open_url/_ResolverLinkFinder.py
+# ----------------------------------------
+from __future__ import annotations
+
+import os
+
+__FILE__ = (
+    "./src/scitex/scholar/open_url/_ResolverLinkFinder.py"
+)
+__DIR__ = os.path.dirname(__FILE__)
+# ----------------------------------------
+
+"""Robust resolver link finder using a prioritized, multi-layered approach.
+
+Priority order:
+1. Link Target (domain matching) - Most reliable
+2. Page Structure (CSS selectors) - Very reliable
+3. Text Patterns - Good fallback
+"""
+
+import re
+from typing import List, Optional
+from urllib.parse import urlparse
+
+from playwright.async_api import ElementHandle, Page
+
+from scitex import logging
+
+logger = logging.getLogger(__name__)
+
+
+class ResolverLinkFinder:
+    """Finds full-text links on resolver pages using multiple strategies."""
+
+    # DOI prefix to publisher domain mapping
+    DOI_TO_DOMAIN = {
+        "10.1038": [
+            "nature.com",
+            "springernature.com",
+        ],  # Nature Publishing Group
+        "10.1016": ["sciencedirect.com", "elsevier.com"],  # Elsevier
+        "10.1002": ["wiley.com", "onlinelibrary.wiley.com"],  # Wiley
+        "10.1007": ["springer.com", "link.springer.com"],  # Springer
+        "10.1126": ["science.org", "sciencemag.org"],  # Science/AAAS
+        "10.1021": ["acs.org", "pubs.acs.org"],  # ACS Publications
+        "10.1111": [
+            "wiley.com",
+            "onlinelibrary.wiley.com",
+        ],  # Wiley (alternative)
+        "10.1080": ["tandfonline.com"],  # Taylor & Francis
+        "10.1177": ["sagepub.com", "journals.sagepub.com"],  # SAGE
+        "10.1093": ["oup.com", "academic.oup.com"],  # Oxford
+        "10.1109": ["ieee.org", "ieeexplore.ieee.org"],  # IEEE
+        "10.1371": ["plos.org", "journals.plos.org"],  # PLOS
+        "10.1073": ["pnas.org"],  # PNAS
+        "10.1136": ["bmj.com"],  # BMJ
+        "10.3389": ["frontiersin.org"],  # Frontiers
+        "10.3390": ["mdpi.com"],  # MDPI
+    }
+
+    # Common resolver page structures
+    STRUCTURE_SELECTORS = [
+        # SFX (ExLibris) - used by many universities
+        "div#fulltext a",
+        "div.sfx-fulltext a",
+        "div.results-title > a",
+        "td.object-cell a",
+        ".getFullTxt a",
+        'div[id*="fulltext"] a',
+        'div[class*="fulltext"] a',
+        # SFX specific selectors for University of Melbourne
+        "a[title*='Wiley Online Library']",
+        "a[href*='wiley.com']",
+        "a[href*='onlinelibrary.wiley.com']",
+        ".sfx-target a",
+        ".target a",
+        "td a[href*='wiley']",
+        # Primo (ExLibris)
+        "prm-full-view-service-container a",
+        "span.availability-status-available a",
+        # Summon (ProQuest)
+        ".summon-fulltext-link",
+        "a.summon-link",
+        # EDS (EBSCO)
+        "a.fulltext-link",
+        ".ft-link a",
+        # Generic patterns
+        "a.full-text-link",
+        "a.fulltext",
+        "a#full-text-link",
+        ".access-link a",
+        ".available-link a",
+    ]
+
+    # Text patterns in priority order
+    TEXT_PATTERNS = [
+        # Most specific
+        "View full text at",
+        "Available from Nature",
+        "Available from ScienceDirect",
+        "Available from Wiley",
+        "Available from Wiley Online Library",
+        "Full text available from",
+        # Common patterns
+        "View full text",
+        "Full Text from Publisher",
+        "Get full text",
+        "Access full text",
+        "Go to article",
+        "Access article",
+        # Generic but reliable
+        "Full Text",
+        "Full text",
+        "Article",
+        "View",
+        "PDF",
+        "Download",
+    ]
+
+    def __init__(self):
+        self._doi_pattern = re.compile(r"10\.\d{4,}/[-._;()/:\w]+")
+
+    def get_expected_domains(self, doi: str) -> List[str]:
+        """Get expected publisher domains for a DOI."""
+        # Extract DOI prefix
+        match = re.match(r"(10\.\d{4,})", doi)
+        if not match:
+            return []
+
+        prefix = match.group(1)
+        return self.DOI_TO_DOMAIN.get(prefix, [])
+
+    async def find_link_async(self, page, doi: str) -> dict:
+        """Find the best full-text link using prioritized strategies."""
+        logger.info(f"Finding resolver link for DOI: {doi}")
+
+        # Strategy 1: Link Target (Most Reliable)
+        link_url = await self._find_by_domain_async(page, doi)
+        if link_url:
+            logger.info("✓ Found link using domain matching (Strategy 1)")
+            return {"success": True, "url": link_url, "method": "domain"}
+
+        # Strategy 2: Page Structure with scoring
+        link_url = await self._find_by_structure_async(page, doi)
+        if link_url:
+            logger.info("✓ Found link using page structure (Strategy 2)")
+            return {"success": True, "url": link_url, "method": "structure"}
+
+        logger.warning("✗ No suitable links found")
+        return {"success": False, "url": None, "method": None}
+
+    async def _find_by_domain_async(self, page: Page, doi: str) -> Optional[str]:
+        """Strategy 1: Find link by expected publisher domain."""
+        expected_domains = self.get_expected_domains(doi)
+        if not expected_domains:
+            logger.debug(f"No known publisher domains for DOI prefix: {doi}")
+            return None
+
+        logger.debug(f"Looking for links to domains: {expected_domains}")
+        all_links = await page.query_selector_all("a[href]")
+
+        for link in all_links:
+            href = await link.get_attribute("href")
+            if not href:
+                continue
+
+            try:
+                parsed = urlparse(href)
+                domain = parsed.netloc.lower()
+
+                for expected in expected_domains:
+                    if expected in domain:
+                        text = await link.inner_text() or ""
+                        logger.info(
+                            f"Found domain match: {domain} (text: '{text[:50]}')"
+                        )
+
+                        if not any(
+                            bad in text.lower()
+                            for bad in ["abstract", "preview", "summary"]
+                        ):
+                            return href
+                        else:
+                            logger.debug(
+                                f"Skipping abstract/preview link: {text}"
+                            )
+            except Exception as e:
+                logger.debug(f"Error parsing URL {href}: {e}")
+
+        return None
+
+    async def _find_by_structure_async(self, page, doi: str):
+        """Find link by page structure with publisher prioritization."""
+        potential_links = []
+        expected_domains = self.get_expected_domains(doi)
+        publisher_keywords = [
+            domain.split(".")[0] for domain in expected_domains
+        ]
+        aggregator_keywords = ["gale", "proquest", "ebsco", "jstor", "onefile"]
+
+        # Gather all possible links
+        for selector in self.STRUCTURE_SELECTORS:
+            try:
+                elements = await page.query_selector_all(selector)
+                logger.debug(
+                    f"Found {len(elements)} elements with selector: {selector}"
+                )
+
+                for element in elements:
+                    if await element.is_visible():
+                        href = await element.get_attribute("href")
+                        text = (await element.inner_text() or "").lower()
+
+                        if href and href.strip():
+                            potential_links.append(
+                                {"href": href, "text": text, "score": 0}
+                            )
+            except Exception as element_error:
+                logger.debug(
+                    f"Error with selector '{selector}': {element_error}"
+                )
+
+        if not potential_links:
+            return None
+
+        # Score the links
+        for link in potential_links:
+            # Highest score for direct publisher match
+            if any(keyword in link["text"] for keyword in publisher_keywords):
+                link["score"] = 3
+            # High score for generic publisher
+            elif "publisher" in link["text"]:
+                link["score"] = 2
+            # Negative score for aggregators
+            elif any(
+                keyword in link["text"] for keyword in aggregator_keywords
+            ):
+                link["score"] = -1
+            # Default neutral score
+            else:
+                link["score"] = 0
+
+        # Sort by score, highest first
+        sorted_links = sorted(
+            potential_links, key=lambda x: x["score"], reverse=True
+        )
+        best_link = sorted_links[0]
+
+        logger.debug(
+            f"Found structural match: '{best_link['text'][:50]}' -> {best_link['href']}"
+        )
+        return best_link["href"]
+
+    async def _find_by_text_async(self, page: Page) -> Optional[str]:
+        """Strategy 3: Find link by text patterns."""
+        for pattern in self.TEXT_PATTERNS:
+            try:
+                selector = f'a:has-text("{pattern}")'
+                link = await page.query_selector(selector)
+                if link and await link.is_visible():
+                    href = await link.get_attribute("href")
+                    if href and href.strip():
+                        logger.debug(
+                            f"Found text match: '{pattern}' -> {href[:100]}"
+                        )
+                        return href
+            except Exception as e:
+                logger.debug(f"Error with text pattern '{pattern}': {e}")
+
+        return None
+
+    async def click_and_wait_async(self, page: Page, link: ElementHandle) -> bool:
+        """Click link and wait for navigation.
+
+        Returns True if navigation succeeded.
+        """
+        initial_url = page.url
+
+        try:
+            # Get link info for logging
+            href = await link.get_attribute("href") or ""
+            text = await link.inner_text() or ""
+            logger.info(f"Clicking link: '{text[:50]}' -> {href[:100]}")
+
+            # Click and wait for navigation
+            await link.click()
+
+            # Wait for either navigation or network idle
+            try:
+                await page.wait_for_load_state("networkidle", timeout=30000)
+            except:
+                # Fallback to domcontentloaded if network doesn't settle
+                await page.wait_for_load_state(
+                    "domcontentloaded", timeout=30000
+                )
+
+            # Additional wait for JavaScript redirects
+            await page.wait_for_timeout(3000)
+
+            # Check if we navigated
+            final_url = page.url
+            if final_url != initial_url:
+                logger.info(
+                    f"Successfully navigated: {initial_url} -> {final_url}"
+                )
+                return True
+            else:
+                logger.warning("No navigation occurred after click")
+                return False
+
+        except Exception as e:
+            logger.error(f"Error during click and navigation: {e}")
+            return False
+
+
+# Convenience function for integration
+async def find_and_click_resolver_link_async(page: Page, doi: str) -> Optional[str]:
+    """Find and click the best resolver link.
+
+    Args:
+        page: Playwright page object
+        doi: Target DOI
+
+    Returns:
+        Final URL after navigation, or None if failed
+    """
+    finder = ResolverLinkFinder()
+
+    # Find link
+    link = await finder.find_link_async(page, doi)
+    if not link:
+        return None
+
+    # Click and navigate
+    success = await finder.click_and_wait_async(page, link)
+    if success:
+        return page.url
+    else:
+        return None
+
+# EOF

scitex/scholar/url_finder/.tmp/open_url/__init__.py

@@ -0,0 +1,24 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# Timestamp: "2025-07-31 00:53:24 (ywatanabe)"
+# File: /home/ywatanabe/proj/scitex_repo/src/scitex/scholar/open_url/__init__.py
+# ----------------------------------------
+from __future__ import annotations
+
+import os
+
+__FILE__ = (
+    "./src/scitex/scholar/open_url/__init__.py"
+)
+__DIR__ = os.path.dirname(__FILE__)
+# ----------------------------------------
+
+from ._DOIToURLResolver import DOIToURLResolver
+from ._OpenURLResolver import OpenURLResolver
+
+__all__ = [
+    "OpenURLResolver",
+    "DOIToURLResolver",
+]
+
+# EOF

scitex/security/README.md

@@ -14,7 +14,7 @@ Reusable security utilities for the SciTeX ecosystem. Works everywhere: local, c
 The module is part of the `scitex` package (editable install):
 
 ```bash
-cd ~/proj/scitex-code
+cd ~/proj/scitex-python
 pip install -e .
 ```
 
@@ -162,7 +162,7 @@ Total open alerts: 2
 ```yaml
 - name: Check Security
   run: |
-    pip install -e ~/proj/scitex-code
+    pip install -e ~/proj/scitex-python
     python -m scitex.security.cli check --save
 ```
 
@@ -245,7 +245,7 @@ Get path to latest alerts file.
 ## Testing
 
 ```bash
-cd ~/proj/scitex-code
+cd ~/proj/scitex-python
 pytest tests/test_security.py
 ```
 

scitex/session/README.md

@@ -1,7 +1,7 @@
 <!-- ---
 !-- Timestamp: 2025-11-18 10:14:48
 !-- Author: ywatanabe
-!-- File: /home/ywatanabe/proj/scitex-code/src/scitex/session/README.md
+!-- File: /home/ywatanabe/proj/scitex-python/src/scitex/session/README.md
 !-- --- -->
 
 # scitex.session

scitex/session/__init__.py

@@ -1,9 +1,9 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 # Timestamp: "2025-08-21 20:36:45 (ywatanabe)"
 # File: /home/ywatanabe/proj/SciTeX-Code/src/scitex/session/__init__.py
 # ----------------------------------------
 from __future__ import annotations
+
 import os
 
 __FILE__ = __file__
@@ -20,27 +20,46 @@ Usage:
     import sys
     import matplotlib.pyplot as plt
     from scitex import session
-    
+
     # Start a session
     CONFIG, sys.stdout, sys.stderr, plt, COLORS, rng = session.start(sys, plt)
-    
+
     # Your experiment code here
-    
-    # Close the session  
+
+    # Close the session
     session.close(CONFIG)
 
     # Session manager for advanced use cases
     manager = session.SessionManager()
     active_sessions = manager.get_active_sessions()
+
+    # Using INJECTED sentinel for decorator parameters
+    @stx.session
+    def main(CONFIG=stx.session.INJECTED, plt=stx.session.INJECTED):
+        ...
 """
 
+
+# Sentinel object for decorator-injected parameters
+class _InjectedSentinel:
+    """Sentinel value indicating a parameter will be injected by a decorator."""
+
+    def __repr__(self):
+        return "<INJECTED>"
+
+
+INJECTED = _InjectedSentinel()
+
+
 # Import session management functionality
+from ._decorator import run, session
+from ._lifecycle import close, running2finished, start
 from ._manager import SessionManager
-from ._lifecycle import start, close, running2finished
-from ._decorator import session, run
 
 # Export public API
 __all__ = [
+    # Sentinel for injected parameters
+    "INJECTED",
     # Session lifecycle (main functions)
     "start",
     "close",

scitex/session/_decorator.py

@@ -21,7 +21,7 @@ import sys as sys_module
 
 from ._lifecycle import start, close
 from scitex.logging import getLogger
-from scitex import INJECTED
+from . import INJECTED  # Use local INJECTED from session module
 
 # Internal logger for the decorator itself
 _decorator_logger = getLogger(__name__)

scitex/sh/README.md

@@ -1,7 +1,7 @@
 <!-- ---
 !-- Timestamp: 2025-10-29 07:23:56
 !-- Author: ywatanabe
-!-- File: /home/ywatanabe/proj/scitex-code/src/scitex/sh/README.md
+!-- File: /home/ywatanabe/proj/scitex-python/src/scitex/sh/README.md
 !-- --- -->
 
 # scitex.sh - Shell Command Execution Module

scitex/sh/__init__.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 from __future__ import annotations
+
 import os
 
 __FILE__ = __file__
@@ -8,9 +8,9 @@ __DIR__ = os.path.dirname(__FILE__)
 
 from typing import Union
 
-from ._types import CommandInput, ReturnFormat, ShellResult
-from ._security import quote, validate_command
 from ._execute import execute
+from ._security import quote, validate_command
+from ._types import CommandInput, ReturnFormat, ShellResult
 
 
 def sh(
@@ -88,6 +88,9 @@ def sh_run(command: CommandInput, verbose: bool = True) -> ShellResult:
     return execute(command, verbose=verbose)
 
 
-__all__ = ["sh", "sh_run", "quote"]
+# Legacy functions moved from gen module
+from ._shell_legacy import run_shellcommand, run_shellscript
+
+__all__ = ["sh", "sh_run", "quote", "run_shellcommand", "run_shellscript"]
 
 # EOF

scitex/social/__init__.py

@@ -0,0 +1,155 @@
+#!/usr/bin/env python3
+# Timestamp: 2026-01-22
+# File: /home/ywatanabe/proj/scitex-code/src/scitex/social/__init__.py
+
+"""SciTeX Social - Unified social media management.
+
+This module provides a thin wrapper around socialia, the core social media
+integration package. It uses scitex branding and environment variable prefixes.
+
+Features
+--------
+- Twitter/X posting and analytics
+- LinkedIn posting
+- Reddit posting
+- YouTube analytics
+- Google Analytics integration
+
+Environment Variables
+---------------------
+Credentials use SCITEX_SOCIAL_ prefix (falls back to SOCIALIA_):
+- SCITEX_SOCIAL_X_CONSUMER_KEY, SCITEX_SOCIAL_X_CONSUMER_KEY_SECRET
+- SCITEX_SOCIAL_X_ACCESS_TOKEN, SCITEX_SOCIAL_X_ACCESS_TOKEN_SECRET
+- SCITEX_SOCIAL_X_BEARER_TOKEN
+- SCITEX_SOCIAL_LINKEDIN_CLIENT_ID, SCITEX_SOCIAL_LINKEDIN_CLIENT_SECRET
+- SCITEX_SOCIAL_LINKEDIN_ACCESS_TOKEN
+- SCITEX_SOCIAL_REDDIT_CLIENT_ID, SCITEX_SOCIAL_REDDIT_CLIENT_SECRET
+- SCITEX_SOCIAL_YOUTUBE_API_KEY
+- SCITEX_SOCIAL_GOOGLE_ANALYTICS_PROPERTY_ID
+
+Usage
+-----
+    import scitex as stx
+
+    # Twitter/X
+    x = stx.social.Twitter()
+    x.post("Hello from SciTeX!")
+
+    # LinkedIn
+    linkedin = stx.social.LinkedIn()
+    linkedin.post("Research update", visibility="public")
+
+    # YouTube analytics
+    yt = stx.social.YouTube()
+    stats = yt.get_channel_stats()
+
+    # Google Analytics
+    ga = stx.social.GoogleAnalytics()
+    report = ga.get_report(start_date="7daysAgo")
+
+See Also
+--------
+- socialia: https://github.com/ywatanabe1989/socialia
+- scitex: https://scitex.ai
+"""
+
+import os as _os
+
+# Set branding BEFORE importing socialia
+_os.environ.setdefault("SOCIALIA_BRAND", "scitex.social")
+_os.environ.setdefault("SOCIALIA_ENV_PREFIX", "SCITEX_SOCIAL")
+
+# Check socialia availability
+try:
+    import socialia as _socialia
+
+    # Re-export platform clients
+    from socialia import (
+        # Content strategies for MCP
+        PLATFORM_STRATEGIES,
+        # Base class
+        BasePoster,
+        GoogleAnalytics,
+        LinkedIn,
+        LinkedInPoster,
+        Reddit,
+        RedditPoster,
+        # Platform clients (preferred names)
+        Twitter,
+        # Backward compatibility aliases
+        TwitterPoster,
+        YouTube,
+        YouTubePoster,
+    )
+    from socialia import __version__ as _socialia_version
+
+    SOCIALIA_AVAILABLE = True
+    __socialia_version__ = _socialia_version
+
+except ImportError:
+    SOCIALIA_AVAILABLE = False
+    __socialia_version__ = None
+
+    # Provide helpful error on access
+    class _SocialiaNotAvailable:
+        """Placeholder when socialia is not installed."""
+
+        def __init__(self, *args, **kwargs):
+            raise ImportError(
+                "socialia is required for scitex.social. "
+                "Install with: pip install socialia"
+            )
+
+        def __getattr__(self, name):
+            raise ImportError(
+                "socialia is required for scitex.social. "
+                "Install with: pip install socialia"
+            )
+
+    BasePoster = _SocialiaNotAvailable
+    Twitter = _SocialiaNotAvailable
+    LinkedIn = _SocialiaNotAvailable
+    Reddit = _SocialiaNotAvailable
+    YouTube = _SocialiaNotAvailable
+    GoogleAnalytics = _SocialiaNotAvailable
+    TwitterPoster = _SocialiaNotAvailable
+    LinkedInPoster = _SocialiaNotAvailable
+    RedditPoster = _SocialiaNotAvailable
+    YouTubePoster = _SocialiaNotAvailable
+    PLATFORM_STRATEGIES = ""
+
+
+def has_socialia() -> bool:
+    """Check if socialia is available.
+
+    Returns
+    -------
+    bool
+        True if socialia is installed and importable.
+    """
+    return SOCIALIA_AVAILABLE
+
+
+__all__ = [
+    # Availability check
+    "SOCIALIA_AVAILABLE",
+    "has_socialia",
+    "__socialia_version__",
+    # Base class
+    "BasePoster",
+    # Platform clients (preferred names)
+    "Twitter",
+    "LinkedIn",
+    "Reddit",
+    "YouTube",
+    "GoogleAnalytics",
+    # Backward compatibility aliases
+    "TwitterPoster",
+    "LinkedInPoster",
+    "RedditPoster",
+    "YouTubePoster",
+    # Content strategies
+    "PLATFORM_STRATEGIES",
+]
+
+# EOF