arxiv 2.3.2.dev15__tar.gz → 2.4.1__tar.gz

{arxiv-2.3.2.dev15 → arxiv-2.4.1}/.github/workflows/static-analysis.yaml

@@ -7,7 +7,7 @@ on:
   workflow_dispatch:
 
 jobs:
-  quality-checks:
+  static-analysis:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
@@ -22,19 +22,7 @@ jobs:
       run: uv run make lint
     - name: Format check
       run: uv run ruff format --check .
-    - name: Type check (allow failures for now)
-      run: uv run make type-check || echo "Type checking has known issues - skipping for CI"
-      
-  security-audit:
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v4
-    - name: Install UV
-      uses: astral-sh/setup-uv@v4
-      with:
-        enable-cache: true
-        cache-dependency-glob: "uv.lock"
-    - name: Install dependencies
-      run: uv sync --group dev
+    - name: Type check
+      run: uv run make type-check
     - name: Security audit
       run: uv run make audit

{arxiv-2.3.2.dev15 → arxiv-2.4.1}/Makefile

@@ -1,8 +1,7 @@
 source := ${wildcard ./arxiv/*.py}
 tests := ${wildcard tests/*.py}
 
-# UV-based development workflow (assumes UV is installed)
-.PHONY: all install install-dev lint format test audit docs clean sync lock help
+.PHONY: all install install-dev lint format test audit docs clean 
 
 # Default target
 all: lint test docs
@@ -14,12 +13,6 @@ install:
 install-dev:
 	uv sync --group dev
 
-sync:
-	uv sync --group dev
-
-lock:
-	uv lock
-
 # Development tasks
 format: $(source) $(tests)
 	uv run ruff format .
@@ -50,9 +43,3 @@ clean:
 # Convenience commands
 check: lint type-check test
 
-# Release and distribution
-build:
-	uv build
-
-release:
-	./release.sh

{arxiv-2.3.2.dev15 → arxiv-2.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arxiv
-Version: 2.3.2.dev15
+Version: 2.4.1
 Summary: Python wrapper for the arXiv API
 Project-URL: Homepage, https://github.com/lukasschwab/arxiv.py
 Project-URL: Repository, https://github.com/lukasschwab/arxiv.py
@@ -37,7 +37,7 @@ Requires-Dist: pytest>=6.2.2; extra == 'test'
 Description-Content-Type: text/markdown
 
 # arxiv.py
-[![PyPI](https://img.shields.io/pypi/v/arxiv)](https://pypi.org/project/arxiv/) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/arxiv) [![GitHub Workflow Status (branch)](https://img.shields.io/github/actions/workflow/status/lukasschwab/arxiv.py/python-package.yml?branch=master)](https://github.com/lukasschwab/arxiv.py/actions?query=branch%3Amaster) [![Full package documentation](https://img.shields.io/badge/docs-hosted-brightgreen)](https://lukasschwab.me/arxiv.py/index.html)
+[![PyPI](https://img.shields.io/pypi/v/arxiv)](https://pypi.org/project/arxiv/) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/arxiv) [![GitHub Workflow Status (branch)](https://img.shields.io/github/actions/workflow/status/lukasschwab/arxiv.py/python-test.yml?branch=master)](https://github.com/lukasschwab/arxiv.py/actions?query=branch%3Amaster) [![Full package documentation](https://img.shields.io/badge/docs-hosted-brightgreen)](https://lukasschwab.me/arxiv.py/index.html)
 
 Python wrapper for [the arXiv API](https://arxiv.org/help/api/index).
 
@@ -45,28 +45,13 @@ Python wrapper for [the arXiv API](https://arxiv.org/help/api/index).
 
 ## Usage
 
-### Installation
-
-#### For End Users (Recommended)
+Install the package:
 
 ```bash
-$ pip install arxiv
+$ pip install arxiv   # Or `uv add arxiv` or similar.
 ```
 
-#### For Modern Python Development (with UV)
-
-```bash
-$ uv add arxiv
-```
-
-Or for a one-off script:
-```bash
-$ uvx --from arxiv python -c "import arxiv; print('Working!')"
-```
-
-#### Usage
-
-In your Python script, include the line:
+In your Python code, include the line:
 
 ```python
 import arxiv
@@ -74,6 +59,9 @@ import arxiv
 
 ### Examples
 
+> [!TIP]
+> [`arxivql`](https://pypi.org/project/arxivql/) may simplify constructing complex query strings.
+
 #### Fetching results
 
 ```python
@@ -179,31 +167,3 @@ This project uses [UV](https://astral.sh/uv) for development, while maintaining
    cd arxiv.py
    make dev-setup
    ```
-
-3. **Available commands**:
-   ```bash
-   make test      # Run tests
-   make lint      # Run linting  
-   make format    # Format code
-   make docs      # Generate docs
-   make check     # Run lint + test
-   make audit     # Security audit
-   ```
-
-### For End Users
-
-Even though development uses UV, **end users can continue using pip** as always:
-
-```bash
-pip install arxiv  # Still works perfectly!
-```
-
-Both installation methods provide the same functionality - UV just offers a faster development experience.
-
-### Modern Python Packaging
-
-This project uses current Python packaging standards:
-- **`pyproject.toml`** for all configuration (no setup.py)
-- **`uv.lock`** for reproducible development environments
-- **Hatchling** build backend for fast, reliable builds
-- **UV** for lightning-fast dependency management

{arxiv-2.3.2.dev15 → arxiv-2.4.1}/README.md

@@ -1,5 +1,5 @@
 # arxiv.py
-[![PyPI](https://img.shields.io/pypi/v/arxiv)](https://pypi.org/project/arxiv/) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/arxiv) [![GitHub Workflow Status (branch)](https://img.shields.io/github/actions/workflow/status/lukasschwab/arxiv.py/python-package.yml?branch=master)](https://github.com/lukasschwab/arxiv.py/actions?query=branch%3Amaster) [![Full package documentation](https://img.shields.io/badge/docs-hosted-brightgreen)](https://lukasschwab.me/arxiv.py/index.html)
+[![PyPI](https://img.shields.io/pypi/v/arxiv)](https://pypi.org/project/arxiv/) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/arxiv) [![GitHub Workflow Status (branch)](https://img.shields.io/github/actions/workflow/status/lukasschwab/arxiv.py/python-test.yml?branch=master)](https://github.com/lukasschwab/arxiv.py/actions?query=branch%3Amaster) [![Full package documentation](https://img.shields.io/badge/docs-hosted-brightgreen)](https://lukasschwab.me/arxiv.py/index.html)
 
 Python wrapper for [the arXiv API](https://arxiv.org/help/api/index).
 
@@ -7,28 +7,13 @@ Python wrapper for [the arXiv API](https://arxiv.org/help/api/index).
 
 ## Usage
 
-### Installation
-
-#### For End Users (Recommended)
+Install the package:
 
 ```bash
-$ pip install arxiv
+$ pip install arxiv   # Or `uv add arxiv` or similar.
 ```
 
-#### For Modern Python Development (with UV)
-
-```bash
-$ uv add arxiv
-```
-
-Or for a one-off script:
-```bash
-$ uvx --from arxiv python -c "import arxiv; print('Working!')"
-```
-
-#### Usage
-
-In your Python script, include the line:
+In your Python code, include the line:
 
 ```python
 import arxiv
@@ -36,6 +21,9 @@ import arxiv
 
 ### Examples
 
+> [!TIP]
+> [`arxivql`](https://pypi.org/project/arxivql/) may simplify constructing complex query strings.
+
 #### Fetching results
 
 ```python
@@ -141,31 +129,3 @@ This project uses [UV](https://astral.sh/uv) for development, while maintaining
    cd arxiv.py
    make dev-setup
    ```
-
-3. **Available commands**:
-   ```bash
-   make test      # Run tests
-   make lint      # Run linting  
-   make format    # Format code
-   make docs      # Generate docs
-   make check     # Run lint + test
-   make audit     # Security audit
-   ```
-
-### For End Users
-
-Even though development uses UV, **end users can continue using pip** as always:
-
-```bash
-pip install arxiv  # Still works perfectly!
-```
-
-Both installation methods provide the same functionality - UV just offers a faster development experience.
-
-### Modern Python Packaging
-
-This project uses current Python packaging standards:
-- **`pyproject.toml`** for all configuration (no setup.py)
-- **`uv.lock`** for reproducible development environments
-- **Hatchling** build backend for fast, reliable builds
-- **UV** for lightning-fast dependency management

{arxiv-2.3.2.dev15 → arxiv-2.4.1}/arxiv/__init__.py

@@ -38,6 +38,7 @@ if TYPE_CHECKING:
         arxiv_doi: str
         arxiv_primary_category: dict[str, str]
 
+
 logger = logging.getLogger(__name__)
 
 _DEFAULT_TIME = datetime.min
@@ -237,6 +238,8 @@ class Result:
         if not filename:
             filename = self._get_default_filename()
         path = os.path.join(dirpath, filename)
+        if self.pdf_url is None:
+            raise ValueError("No PDF URL available for this result")
         pdf_url = Result._substitute_domain(self.pdf_url, download_domain)
         written_path, _ = urlretrieve(pdf_url, path)
         return written_path
@@ -259,14 +262,19 @@ class Result:
         if not filename:
             filename = self._get_default_filename("tar.gz")
         path = os.path.join(dirpath, filename)
-        source_url = Result._substitute_domain(self.source_url(), download_domain)
+        source_url_str = self.source_url()
+        if source_url_str is None:
+            raise ValueError("No source URL available for this result")
+        source_url = Result._substitute_domain(source_url_str, download_domain)
         written_path, _ = urlretrieve(source_url, path)
         return written_path
 
-    def source_url(self) -> str:
+    def source_url(self) -> str | None:
         """
         Derives a URL for the source tarfile for this result.
         """
+        if self.pdf_url is None:
+            return None
         return self.pdf_url.replace("/pdf/", "/src/")
 
     @staticmethod
@@ -337,7 +345,7 @@ class Result:
         def __repr__(self) -> str:
             return "{}({})".format(_classname(self), repr(self.name))
 
-        def __eq__(self, other) -> bool:
+        def __eq__(self, other: object) -> bool:
             if isinstance(other, Result.Author):
                 return self.name == other.name
             return False
@@ -353,14 +361,14 @@ class Result:
         """The link's title."""
         rel: str
         """The link's relationship to the `Result`."""
-        content_type: str
+        content_type: str | None
         """The link's HTTP content type."""
 
         def __init__(
             self,
             href: str,
             title: str | None = None,
-            rel: str | None = None,
+            rel: str = "",
             content_type: str | None = None,
         ):
             """
@@ -385,7 +393,7 @@ class Result:
             return Result.Link(
                 href=feed_link.href,
                 title=feed_link.get("title"),
-                rel=feed_link.get("rel"),
+                rel=feed_link.get("rel") or "",
                 content_type=feed_link.get("content_type"),
             )
 
@@ -401,7 +409,7 @@ class Result:
                 repr(self.content_type),
             )
 
-        def __eq__(self, other) -> bool:
+        def __eq__(self, other: object) -> bool:
             if isinstance(other, Result.Link):
                 return self.href == other.href
             return False
@@ -417,7 +425,7 @@ class Result:
         message: str
         """Message describing what caused this error."""
 
-        def __init__(self, missing_field):
+        def __init__(self, missing_field: str):
             self.missing_field = missing_field
             self.message = "Entry from arXiv missing required info"
 
@@ -758,6 +766,9 @@ class ArxivError(Exception):
         self.message = message
         super().__init__(self.message)
 
+    def __reduce__(self) -> tuple:
+        return (self.__class__, (self.url, self.retry, self.message))
+
     def __str__(self) -> str:
         return "{} ({})".format(self.message, self.url)
 
@@ -787,6 +798,9 @@ class UnexpectedEmptyPageError(ArxivError):
         self.raw_feed = raw_feed
         super().__init__(url, retry, "Page of results was unexpectedly empty")
 
+    def __reduce__(self) -> tuple:
+        return (self.__class__, (self.url, self.retry, self.raw_feed))
+
     def __repr__(self) -> str:
         return "{}({}, {}, {})".format(
             _classname(self), repr(self.url), repr(self.retry), repr(self.raw_feed)
@@ -816,6 +830,9 @@ class HTTPError(ArxivError):
             "Page request resulted in HTTP {}".format(self.status),
         )
 
+    def __reduce__(self) -> tuple:
+        return (self.__class__, (self.url, self.retry, self.status))
+
     def __repr__(self) -> str:
         return "{}({}, {}, {})".format(
             _classname(self), repr(self.url), repr(self.retry), repr(self.status)

{arxiv-2.3.2.dev15 → arxiv-2.4.1}/release.sh

@@ -74,8 +74,7 @@ echo ""
 
 # Run tests
 echo "🧪 Running tests..."
-make lint
-make test
+make check
 echo "✅ Tests passed"
 
 # Clean previous builds

arxiv-2.4.1/tests/test_errors.py

@@ -0,0 +1,46 @@
+import pickle
+import unittest
+
+import arxiv
+
+
+class TestErrorPickle(unittest.TestCase):
+    """Regression tests for https://github.com/lukasschwab/arxiv.py/issues/191."""
+
+    def test_arxiv_error_pickle_roundtrip(self):
+        err = arxiv.ArxivError(url="http://example.com", retry=1, message="test")
+        restored = pickle.loads(pickle.dumps(err))
+        self.assertEqual(restored.url, err.url)
+        self.assertEqual(restored.retry, err.retry)
+        self.assertEqual(restored.message, err.message)
+        self.assertEqual(str(restored), str(err))
+
+    def test_http_error_pickle_roundtrip(self):
+        err = arxiv.HTTPError(url="http://export.arxiv.org/api/query", retry=3, status=503)
+        restored = pickle.loads(pickle.dumps(err))
+        self.assertEqual(restored.url, err.url)
+        self.assertEqual(restored.retry, err.retry)
+        self.assertEqual(restored.status, err.status)
+        self.assertIsInstance(restored.status, int)
+        self.assertEqual(str(restored), str(err))
+        self.assertEqual(repr(restored), repr(err))
+
+    def test_unexpected_empty_page_error_pickle_roundtrip(self):
+        err = arxiv.UnexpectedEmptyPageError(
+            url="http://export.arxiv.org/api/query", retry=2, raw_feed="<xml/>"
+        )
+        restored = pickle.loads(pickle.dumps(err))
+        self.assertEqual(restored.url, err.url)
+        self.assertEqual(restored.retry, err.retry)
+        self.assertEqual(restored.raw_feed, err.raw_feed)
+        self.assertEqual(str(restored), str(err))
+        self.assertEqual(repr(restored), repr(err))
+
+    def test_http_error_double_roundtrip(self):
+        """Ensure repeated pickle round-trips don't degrade the object."""
+        err = arxiv.HTTPError(url="http://export.arxiv.org/api/query", retry=3, status=503)
+        restored = pickle.loads(pickle.dumps(err))
+        restored2 = pickle.loads(pickle.dumps(restored))
+        self.assertEqual(restored2.status, 503)
+        self.assertEqual(restored2.args, err.args)
+        self.assertEqual(str(restored2), str(err))

{arxiv-2.3.2.dev15 → arxiv-2.4.1}/uv.lock

@@ -117,7 +117,7 @@ wheels = [
 
 [package.optional-dependencies]
 filecache = [
-    { name = "filelock", version = "3.20.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.10'" },
+    { name = "filelock", version = "3.25.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.10'" },
 ]
 
 [[package]]
@@ -327,14 +327,14 @@ wheels = [
 
 [[package]]
 name = "filelock"
-version = "3.20.2"
+version = "3.25.0"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
     "python_full_version >= '3.10'",
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/c1/e0/a75dbe4bca1e7d41307323dad5ea2efdd95408f74ab2de8bd7dba9b51a1a/filelock-3.20.2.tar.gz", hash = "sha256:a2241ff4ddde2a7cebddf78e39832509cb045d18ec1a09d7248d6bfc6bfbbe64", size = 19510, upload-time = "2026-01-02T15:33:32.582Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/77/18/a1fd2231c679dcb9726204645721b12498aeac28e1ad0601038f94b42556/filelock-3.25.0.tar.gz", hash = "sha256:8f00faf3abf9dc730a1ffe9c354ae5c04e079ab7d3a683b7c32da5dd05f26af3", size = 40158, upload-time = "2026-03-01T15:08:45.916Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/9a/30/ab407e2ec752aa541704ed8f93c11e2a5d92c168b8a755d818b74a3c5c2d/filelock-3.20.2-py3-none-any.whl", hash = "sha256:fbba7237d6ea277175a32c54bb71ef814a8546d8601269e1bfc388de333974e8", size = 16697, upload-time = "2026-01-02T15:33:31.133Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/0b/de6f54d4a8bedfe8645c41497f3c18d749f0bd3218170c667bf4b81d0cdd/filelock-3.25.0-py3-none-any.whl", hash = "sha256:5ccf8069f7948f494968fc0713c10e5c182a9c9d9eef3a636307a20c2490f047", size = 26427, upload-time = "2026-03-01T15:08:44.593Z" },
 ]
 
 [[package]]
@@ -785,11 +785,11 @@ wheels = [
 
 [[package]]
 name = "pip"
-version = "25.3"
+version = "26.0.1"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/fe/6e/74a3f0179a4a73a53d66ce57fdb4de0080a8baa1de0063de206d6167acc2/pip-25.3.tar.gz", hash = "sha256:8d0538dbbd7babbd207f261ed969c65de439f6bc9e5dbd3b3b9a77f25d95f343", size = 1803014, upload-time = "2025-10-25T00:55:41.394Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/48/83/0d7d4e9efe3344b8e2fe25d93be44f64b65364d3c8d7bc6dc90198d5422e/pip-26.0.1.tar.gz", hash = "sha256:c4037d8a277c89b320abe636d59f91e6d0922d08a05b60e85e53b296613346d8", size = 1812747, upload-time = "2026-02-05T02:20:18.702Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/44/3c/d717024885424591d5376220b5e836c2d5293ce2011523c9de23ff7bf068/pip-25.3-py3-none-any.whl", hash = "sha256:9655943313a94722b7774661c21049070f6bbb0a1516bf02f7c8d5d9201514cd", size = 1778622, upload-time = "2025-10-25T00:55:39.247Z" },
+    { url = "https://files.pythonhosted.org/packages/de/f0/c81e05b613866b76d2d1066490adf1a3dbc4ee9d9c839961c3fc8a6997af/pip-26.0.1-py3-none-any.whl", hash = "sha256:bdb1b08f4274833d62c1aa29e20907365a2ceb950410df15fc9521bad440122b", size = 1787723, upload-time = "2026-02-05T02:20:16.416Z" },
 ]
 
 [[package]]
@@ -1129,9 +1129,9 @@ wheels = [
 
 [[package]]
 name = "urllib3"
-version = "2.6.2"
+version = "2.6.3"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/1e/24/a2a2ed9addd907787d7aa0355ba36a6cadf1768b934c652ea78acbd59dcd/urllib3-2.6.2.tar.gz", hash = "sha256:016f9c98bb7e98085cb2b4b17b87d2c702975664e4f060c6532e64d1c1a5e797", size = 432930, upload-time = "2025-12-11T15:56:40.252Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/c7/24/5f1b3bdffd70275f6661c76461e25f024d5a38a46f04aaca912426a2b1d3/urllib3-2.6.3.tar.gz", hash = "sha256:1b62b6884944a57dbe321509ab94fd4d3b307075e0c2eae991ac71ee15ad38ed", size = 435556, upload-time = "2026-01-07T16:24:43.925Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/6d/b9/4095b668ea3678bf6a0af005527f39de12fb026516fb3df17495a733b7f8/urllib3-2.6.2-py3-none-any.whl", hash = "sha256:ec21cddfe7724fc7cb4ba4bea7aa8e2ef36f607a4bab81aa6ce42a13dc3f03dd", size = 131182, upload-time = "2025-12-11T15:56:38.584Z" },
+    { url = "https://files.pythonhosted.org/packages/39/08/aaaad47bc4e9dc8c725e68f9d04865dbcb2052843ff09c97b08904852d84/urllib3-2.6.3-py3-none-any.whl", hash = "sha256:bf272323e553dfb2e87d9bfd225ca7b0f467b919d7bbd355436d3fd37cb0acd4", size = 131584, upload-time = "2026-01-07T16:24:42.685Z" },
 ]