scista 0.1.0

A library for fetching scientific articles from various sources

Scista

Scista - это Python library for searching and downloading scientific articles from various sources, including OpenAlex, CORE and Unpaywall.

Installation

pip install scista

Requirements

• Python 3.7+
• API key for CORE (get it on CORE API)
• Email for Unpaywall

Search Filters

The library provides several optional search filters that can be used individually or in combination:

articles = fetcher.fetch_articles(
    topic="quantum computing",     # Search by topic in title
    num_articles=5,               # Number of articles to fetch (default: 5)
    categories=["Physics"],       # Filter by scientific categories
    from_date="2023-01-01",      # Start date (format: YYYY-MM-DD)
    to_date="2023-12-31",        # End date (format: YYYY-MM-DD)
    sort_by_date=True,           # Sort by date (newest first if True)
    journals=["1234-5678"]       # Filter by journal ISSN(s)
)

All filters are optional. You can use any combination of them:

# Search only by topic
articles = fetcher.fetch_articles(topic="quantum computing")

# Search by category and date range
articles = fetcher.fetch_articles(
    categories=["Physics"],
    from_date="2023-01-01",
    to_date="2023-12-31"
)

# Get latest articles from specific journals
articles = fetcher.fetch_articles(
    journals=["1234-5678", "8765-4321"],
    sort_by_date=True,
    num_articles=10
)

Filter Details

• topic: Search for articles with this topic in the title
• num_articles: Maximum number of articles to fetch (default: 5)
• categories: Scientific categories to filter by. Can be a single category or a list
• from_date: Start date in YYYY-MM-DD format
• to_date: End date in YYYY-MM-DD format
• sort_by_date: If True, sorts by date descending (newest first)
• journals: Filter by journal ISSN(s). Can be a single ISSN or a list

Usage

import logging
from scista import ArticleFetcher

# Configure logging (optional)
logging.basicConfig(
    level=logging.INFO,  # Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)

# Initialize with your API keys
fetcher = ArticleFetcher(
    core_api_key="your_core_api_key",
    email_for_unpaywall="[e-mail]"
)

# Search for articles
articles = fetcher.fetch_articles(
    topic="quantum computing",  # Topic to search
    num_articles=5,            # Number of articles
    categories=["Physics"],    # Category
    from_date="2023-01-01",   # Start date
    to_date="2023-12-31",     # End date
    sort_by_date=True         # Sort by date
)

# Process results
for i, article in enumerate(articles, 1):
    print(f"\nArticle {i}:")
    print(article)
    
    # Save PDF if available
    if article.pdf_url:
        article.save_pdf(f"article_{i}.pdf")

Logging

The library uses the standard logging Python module. You can configure logging to your needs:

import logging

# Базовая настройка
logging.basicConfig(
    level=logging.INFO,  # Уровень логирования
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)

# Or more complex configuration
logger = logging.getLogger('scista')
handler = logging.FileHandler('scista.log')
handler.setFormatter(logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'))
logger.addHandler(handler)
logger.setLevel(logging.DEBUG)

Logging levels:

• DEBUG: Detailed debug information
• INFO: Confirmation of successful operations
• WARNING: Warnings about potential problems
• ERROR: Errors that do not interrupt the program
• CRITICAL: Critical errors

Functionality

• Search for articles by topic, category and date
• Get article metadata (title, authors, DOI, etc.)
• Download full texts and PDF versions of articles
• Support for multiple data sources

License

MIT License

Author

AlestackOverglow