import asyncio
import aioarxiv

async def main():
    # Search for the 10 most recent articles matching the keyword "quantum"
    search = aioarxiv.SearchQuery(
        query="quantum",
        max_results=10,
        sort_by=aioarxiv.SortCriterion.SubmittedDate
    )

    # Initialize the asynchronous API client and fetch results asynchronously
    async with aioarxiv.Client() as client:
        results = client.results(search)

        # Results is an AsyncGenerator, we iterate through the elements
        async for result in results:
            print(result.title)
        # ... or exhaust it into a list
        all_results = [r async for r in results]
        print([r.title for r in all_results])

        # Alternatively, we can access the first element using the 
        # `async_iterator.__anext__()` magic method
        first_result = await results.__anext__()
        # ... or for Python >= 3.10 we can use the builtin anext method
        first_result = await anext(results)
        print(first_result.title)

asyncio.run(main())

import asyncio
import aioarxiv

async def main():
    # Configure async client with custom parameters
    client = aioarxiv.Client(
        page_size=1000,  # Number of results per page
        delay_seconds=10.0,  # Delay between API requests
        num_retries=5  # Number of retry attempts for failed requests
    )

    async with client as _client:
        # Advanced query searching by author and title
        search = aioarxiv.SearchQuery(query="au:del_maestro AND ti:checkerboard")
        results = _client.results(search)
        first_result = await results.__anext__()
        print(first_result)

        # Search by specific paper ID
        search_by_id = aioarxiv.SearchQuery(id_list=["1605.08386v1"])
        results = _client.results(search_by_id)
        paper = await results.__anext__()
        print(paper.title)

        # Iterate through all results
        search = aioarxiv.SearchQuery(query="quantum", max_results=100)
        async for result in _client.results(search):
            print(result.title)

asyncio.run(main())

import asyncio
import aioarxiv

async def main():
    # Initialize the asynchronous API client
    client = aioarxiv.Client()

    # Download a paper by ID
    search = aioarxiv.SearchQuery(id_list=["1605.08386v1"])
    async with client as _client:
        results = _client.results(search)
        paper = await results.__anext__()

        # Download PDF asynchronously
        await paper.download_pdf()
        
        # Download with custom filename and directory
        await paper.download_pdf(
            dirpath="./downloads", 
            filename="quantum-paper.pdf"
        )

        # Download source archive
        await paper.download_source(filename="paper-source.tar.gz")

asyncio.run(main())

import asyncio
import aioarxiv

async def main():
    client = aioarxiv.Client()

    async with client as _client:
        # Get the most recent entries from the RSS feed using RSSQuery
        feed_query = aioarxiv.RSSQuery(query="astro-ph")
        feed_results = _client.results(feed_query)
        
        # Iterate through feed entries
        async for entry in feed_results:
            # Contains largely the same metadata as search results
            # Also includes announcement type info to filter for
            # only new (not updated or cross-posted) entries
            if entry.announce_type == aioarxiv.AnnounceType.New:
                # Print only info for new publications
                print(entry.entry_id, entry.title, entry.authors)

        # Limit the number of results
        limited_feed = aioarxiv.RSSQuery(query="astro-ph", max_results=5)
        feed_entries = [entry async for entry in _client.results(limited_feed)]

        # Get first entry using anext
        first_entry = await anext(feed_results)
        print(first_entry.title)
        
        # Download PDF and source files just like you would search results
        await first_entry.download_pdf(
            dirpath="./downloads",
            filename="latest-quantum-paper.pdf"
        )
        await first_entry.download_source()

asyncio.run(main())

import logging
import aioarxiv

logging.basicConfig(level=logging.DEBUG)