audioarxiv 0.1.2rc59.post1__tar.gz → 0.1.2rc62.post1__tar.gz

{audioarxiv-0.1.2rc59.post1 → audioarxiv-0.1.2rc62.post1}/.github/workflows/CI.yml

@@ -36,7 +36,7 @@ jobs:
 
       - name: Run tests with coverage
         run: |
-          pytest --cov=audioarxiv --cov-report=xml
+          pytest --cov=audioarxiv --cov-report=xml -m ""
 
       - name: Upload coverage to Codecov
         uses: codecov/codecov-action@v5

audioarxiv-0.1.2rc62.post1/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

audioarxiv-0.1.2rc62.post1/CONTRIBUTING.md

@@ -0,0 +1,80 @@
+# Contributing to audioarxiv
+
+🎉 Thank you for your interest in contributing to `audioarxiv`! 🎧📚
+Your ideas, fixes, and improvements are welcome and appreciated.
+
+Whether you’re fixing a typo, reporting a bug, suggesting a feature, or submitting a pull request—this guide will help you get started.
+
+## 📌 How to Contribute
+
+1. Open an Issue
+
+- Have a question, bug report, or feature suggestion? [Open an issue](https://github.com/isaac-cf-wong/audioarxiv/issues/new/choose) and describe your idea clearly.
+- Check for existing issues before opening a new one.
+
+2. Fork and Clone the Repository
+
+```shell
+git clone git@github.com:<your-username>/audioarxiv.git
+cd audioarxiv
+```
+
+3. Set Up Your Environment
+
+We recommend using a virtual environment:
+
+```shell
+python -m venv venv
+source venv/bin/activate  # on Windows: venv\Scripts\activate
+pip install -e ".[dev]"
+```
+
+4. Set Up Pre-commit Hooks
+
+We use pre-commit to ensure code quality and consistency. After installing dependencies, run:
+
+```shell
+pre-commit install
+```
+
+This ensures checks like code formatting, linting, and basic hygiene run automatically when you commit.
+
+5. Create a New Branch
+
+Give it a meaningful name like fix-typo-in-docs or feature-add-summary-option.
+
+6. Make Changes
+
+- Write clear, concise, and well-documented code.
+- Follow [PEP 8](https://pep8.org/) style conventions.
+- Add or update unit tests when applicable.
+
+7. Run Tests
+
+Ensure that all tests pass before opening a pull request:
+
+```shell
+pytest
+```
+
+8. Open a Pull Request
+
+Clearly describe the motivation and scope of your change. Link it to the relevant issue if applicable.
+The pull request titles should match the [Conventional Commits spec](https://www.conventionalcommits.org/).
+
+## 💡 Tips
+
+- Be kind and constructive in your communication.
+- Keep PRs focused and atomic—smaller changes are easier to review.
+- Document new features and update existing docs if needed.
+- Tag your PR with relevant labels if you can.
+
+## 📜 Licensing
+
+By contributing, you agree that your contributions will be licensed under the project’s MIT License.
+
+---
+
+Thanks again for being part of the audioarxiv community!
+
+---

{audioarxiv-0.1.2rc59.post1 → audioarxiv-0.1.2rc62.post1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: audioarxiv
-Version: 0.1.2rc59.post1
+Version: 0.1.2rc62.post1
 Summary: Turn arXiv papers into audio. audioarxiv lets you fetch the research papers from arXiv and read them aloud.
 Author-email: "Isaac C. F. Wong" <isaac.cf.wong@gmail.com>
 Requires-Python: >=3.9
@@ -22,6 +22,10 @@ Requires-Dist: sympy
 Requires-Dist: nltk
 Requires-Dist: pandas
 Requires-Dist: platformdirs
+Requires-Dist: pytest ; extra == "dev"
+Requires-Dist: pre-commit ; extra == "dev"
+Requires-Dist: black ; extra == "dev"
+Requires-Dist: flake8 ; extra == "dev"
 Requires-Dist: pyspark>=3.0.0 ; extra == "spark"
 Requires-Dist: bandit[toml]==1.8.3 ; extra == "test"
 Requires-Dist: black==25.1.0 ; extra == "test"
@@ -45,6 +49,7 @@ Project-URL: Homepage, https://github.com/isaac-cf-wong/audioarxiv
 Project-URL: Release Notes, https://github.com/isaac-cf-wong/audioarxiv/releases
 Project-URL: Source, https://github.com/isaac-cf-wong/audioarxiv
 Project-URL: Tracker, https://github.com/isaac-cf-wong/audioarxiv/issues
+Provides-Extra: dev
 Provides-Extra: spark
 Provides-Extra: test
 
@@ -114,5 +119,15 @@ The settings are saved, so you only need to provide your preferred settings once
 
 ## Contributing
 
-This project welcomes contributions and suggestions. For details, visit the repository's [Contributor License Agreement (CLA)](https://cla.opensource.microsoft.com) and [Code of Conduct](https://opensource.microsoft.com/codeofconduct/) pages.
+Contributions and suggestions are welcome! Whether it's fixing bugs, improving documentation, or adding new features, your help is appreciated.
+
+Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before contributing.
+
+To get started:
+
+- Fork the repository
+- Create a new branch for your changes
+- Submit a pull request
+
+If you're unsure where to begin, feel free to open an issue or ask for guidance!
 

{audioarxiv-0.1.2rc59.post1 → audioarxiv-0.1.2rc62.post1}/README.md

@@ -64,4 +64,14 @@ The settings are saved, so you only need to provide your preferred settings once
 
 ## Contributing
 
-This project welcomes contributions and suggestions. For details, visit the repository's [Contributor License Agreement (CLA)](https://cla.opensource.microsoft.com) and [Code of Conduct](https://opensource.microsoft.com/codeofconduct/) pages.
+Contributions and suggestions are welcome! Whether it's fixing bugs, improving documentation, or adding new features, your help is appreciated.
+
+Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before contributing.
+
+To get started:
+
+- Fork the repository
+- Create a new branch for your changes
+- Submit a pull request
+
+If you're unsure where to begin, feel free to open an issue or ask for guidance!

audioarxiv-0.1.2rc62.post1/SECURITY.md

@@ -0,0 +1,36 @@
+# Security Policy
+
+We will support the latest stable release of `audioarxiv`. Please make sure you are using the most recent version before reporting a security issue.
+
+| Version | Supported |
+| ------- | --------- |
+| 0.1.x   | ✅        |
+| < 0.1   | ❌        |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in `audioarxiv`, we encourage you to report it responsibly.
+
+**Please do not open a public issue.** Instead, contact us directly via email:
+
+📧 [isaac.cf.wong@gmail.com](mailto:isaac.cf.wong@gmail.com)
+
+Include as much information as possible to help us understand and reproduce the issue quickly and accurately:
+
+- Description of the vulnerability
+- Steps to reproduce
+- Affected versions
+- Your operating system and Python version
+
+We aim to respond to all security-related emails within **3–5 business days**.
+
+## Responsible Disclosure Process
+
+1. Submit the vulnerability report via email (see above).
+2. We will acknowledge receipt and begin investigation.
+3. We will work on a fix and prepare a patch release.
+4. Once the issue is resolved, we will publish an advisory and credit you (if desired).
+
+## Thanks
+
+We value the security of our users and appreciate responsible disclosures. Thank you for helping make `audioarxiv` better and safer!

audioarxiv-0.1.2rc62.post1/SUPPORT.md

@@ -0,0 +1,29 @@
+# Support
+
+Thank you for your interest in **audioarxiv**!
+
+If you have questions, suggestions, or need help using the project, here are some ways to get support:
+
+## 💬 Ask a Question
+
+If you're experiencing a problem or have a question about how to use `audioarxiv`, please open a [GitHub Discussion](https://github.com/isaac-cf-wong/audioarxiv/discussions) or [Issue](https://github.com/isaac-cf-wong/audioarxiv/issues), depending on the nature of your question.
+
+- Use **Discussions** for general questions, ideas, or usage help.
+- Use **Issues** for reporting bugs or requesting new features.
+
+## 🐛 Found a Bug?
+
+Please check if your issue has already been reported. If not, create a [new issue](https://github.com/isaac-cf-wong/audioarxiv/issues/new/choose) with:
+
+- A clear and descriptive title.
+- Steps to reproduce the problem.
+- Relevant logs or error messages.
+- The version of Python and `audioarxiv` you're using.
+
+## 🙋 Want to Contribute?
+
+Contributions are welcome! Please check out the [Contributing Guide](CONTRIBUTING.md) and our [Code of Conduct](CODE_OF_CONDUCT.md) to get started.
+
+---
+
+We appreciate your support and interest in the project!

audioarxiv-0.1.2rc62.post1/codecov.yml

@@ -0,0 +1,12 @@
+coverage:
+  status:
+    project:
+      default:
+        target: auto # auto compares coverage to the previous base commit
+comment: #this is a top-level key
+  layout: " diff, flags, files"
+  behavior: default
+  require_changes: false # if true: only post the comment if coverage changes
+  require_base: false # [true :: must have a base report to post]
+  require_head: true # [true :: must have a head report to post]
+  hide_project_coverage: false # [true :: only show coverage on the git diff aka patch coverage]]

{audioarxiv-0.1.2rc59.post1 → audioarxiv-0.1.2rc62.post1}/cspell.json

@@ -28,6 +28,9 @@
         "recarray",
         "punkt",
         "srepr",
-        "fitz"
+        "fitz",
+        "caplog",
+        "venv",
+        "pytest",
     ]
 }

{audioarxiv-0.1.2rc59.post1 → audioarxiv-0.1.2rc62.post1}/docs/release_notes.rst

@@ -11,6 +11,8 @@ This page summarizes the key updates and changes in each release.
 Version 0.1.2 (2025-04-20)
 --------------------------
 - Update the LICENSE and the intended audience.
+- Update text in SUPPORT.md, CODE_OF_CONDUCT.md, CONTRIBUTING.md, and SECURITY.md.
+- Add more unit tests to increase coverage.
 
 **Full Changelog**: https://github.com/isaac-cf-wong/audioarxiv/compare/v0.1.1...v0.1.2
 

{audioarxiv-0.1.2rc59.post1 → audioarxiv-0.1.2rc62.post1}/pyproject.toml

@@ -55,6 +55,12 @@ test = [
     "pytest-github-actions-annotate-failures",
     "shellcheck-py==0.10.0.1"
 ]
+dev = [
+    "pytest",
+    "pre-commit",
+    "black",
+    "flake8"
+]
 
 [project.urls]
 Documentation = "https://isaac-cf-wong.github.io/audioarxiv"

{audioarxiv-0.1.2rc59.post1 → audioarxiv-0.1.2rc62.post1}/src/audioarxiv/__init__.py

@@ -24,7 +24,7 @@ from pandas import DataFrame
 
 from . import audio, preprocess, resources
 
-__version__ = "0.1.2-rc59-post1"
+__version__ = "0.1.2-rc62-post1"
 
 
 def get_version_information() -> str:

{audioarxiv-0.1.2rc59.post1 → audioarxiv-0.1.2rc62.post1}/src/audioarxiv/audio/base.py

@@ -43,6 +43,7 @@ def validate_audio_arguments(rate: float, volume: float, voice: int | str | None
             logger.error('Invalid voice ID = %s. Keeping current voice.', voice)
     elif voice is not None:
         logger.error('Unsupported datatype of voice = %s. It must be either int or str.', type(voice))
+        voice = None
     if pause_seconds < 0:
         pause_seconds = 0.1
         logger.error('pause = %s must be non-negative. Keeping the current pause.', pause_seconds)

{audioarxiv-0.1.2rc59.post1 → audioarxiv-0.1.2rc62.post1}/src/audioarxiv/resources/paper.py

@@ -172,6 +172,9 @@ class Paper:
             list: A list of sections. Each section is a dict with the header as the key and the content as the value.
         """
         if len(self._sections) == 0:
+            if self.paper is None:
+                logger.error('Paper is None. Cannot download PDF.')
+                return self._sections
             with tempfile.NamedTemporaryFile() as tmp:
                 filename = tmp.name
                 self.download_pdf(filename=filename)

{audioarxiv-0.1.2rc59.post1 → audioarxiv-0.1.2rc62.post1}/tests/audio/test_base.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import logging
 from unittest.mock import MagicMock, patch
 
 import pytest
@@ -118,3 +119,83 @@ def test_list_voices(mock_init, mock_logger):
     audio.list_voices()
 
     mock_logger.info.assert_any_call("Index %s: %s (ID: %s)", 0, "Voice 1", "voice1")
+
+
+def test_validate_audio_arguments_with_voice_index():
+    mock_voice = MagicMock()
+    mock_voice.id = "mock_voice_id"
+    with patch("pyttsx3.init") as mock_init:
+        mock_engine = MagicMock()
+        mock_engine.getProperty.return_value = [mock_voice]
+        mock_init.return_value = mock_engine
+
+        result = validate_audio_arguments(rate=140, volume=0.9, voice=0, pause_seconds=0.1)
+        assert result["voice"] == "mock_voice_id"
+
+
+def test_validate_audio_arguments_with_invalid_voice_type(caplog):
+    with patch("pyttsx3.init") as mock_init:
+        mock_engine = MagicMock()
+        mock_engine.getProperty.return_value = None
+        mock_init.return_value = mock_engine
+
+        logger = logging.getLogger('audioarxiv')  # Match the logger name
+        logger.setLevel(logging.ERROR)  # Ensure ERROR logs are allowed
+        logger.propagate = True
+
+        # Capture logs at ERROR level
+        with caplog.at_level(logging.ERROR, logger='audioarxiv'):
+            result = validate_audio_arguments(rate=140,
+                                              volume=0.9,
+                                              voice=[],  # type: ignore[argument]
+                                              pause_seconds=0.1)
+            print(caplog.text)
+            # Check if the log contains the expected error message
+            assert "Unsupported datatype of voice" in caplog.text
+            assert "<class 'list'>" in caplog.text  # Optionally check for the actual type in the log message
+
+            # Ensure the result['voice'] is None
+            assert result['voice'] is None
+
+
+def test_audio_sets_voice_property():
+    mock_voice = MagicMock()
+    mock_voice.id = "mock_voice_id"
+    with patch("pyttsx3.init") as mock_init:
+        mock_engine = MagicMock()
+        mock_engine.getProperty.return_value = [mock_voice]
+        mock_init.return_value = mock_engine
+
+        audio = Audio(voice="mock_voice_id")  # noqa: F841
+        # Ensure setProperty was called with the correct voice ID
+        mock_engine.setProperty.assert_any_call("voice", "mock_voice_id")
+
+
+@patch('audioarxiv.audio.base.pyttsx3.init')  # control TTS engine
+def test_read_article_with_non_string_input(mock_init, caplog):
+    mock_engine = MagicMock()
+    mock_init.return_value = mock_engine
+
+    logger = logging.getLogger('audioarxiv')  # Match the logger name
+    logger.setLevel(logging.WARNING)  # Ensure ERROR logs are allowed
+    logger.propagate = True
+
+    audio = Audio()
+    with caplog.at_level("WARNING"):
+        audio.read_article(article=12345)  # type: ignore[argument]
+        assert "is not str. Skipping." in caplog.text
+
+
+@patch('audioarxiv.audio.base.pyttsx3.init')  # control TTS engine
+def test_audio_stop(mock_init):
+    mock_engine = MagicMock()
+    mock_init.return_value = mock_engine  # Ensure the mock engine is returned
+
+    # Create the Audio instance, which should use the mocked engine
+    audio = Audio()
+
+    # Call the stop method
+    audio.stop()
+
+    # Verify that the stop method was called on the mocked engine
+    mock_engine.stop.assert_called_once()

audioarxiv-0.1.2rc62.post1/tests/resources/test_paper.py

@@ -0,0 +1,183 @@
+from __future__ import annotations
+
+import logging
+from datetime import datetime
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+from audioarxiv.resources.paper import (  # Replace with actual module name
+    Paper, validate_paper_arguments)
+
+
+@pytest.fixture
+def mock_paper_object():
+    mock_paper = MagicMock()
+    mock_paper.title = "Test Title"
+    mock_paper.summary = "This is a test abstract."
+
+    author1 = MagicMock()
+    author1.name = "Alice"
+    author2 = MagicMock()
+    author2.name = "Bob"
+    mock_paper.authors = [author1, author2]
+
+    mock_paper.published = datetime(2022, 1, 1)
+    mock_paper.updated = datetime(2022, 1, 2)
+    return mock_paper
+
+
+@patch("audioarxiv.resources.paper.arxiv.Client")
+def test_paper_init_and_client(mock_client_class):
+    paper = Paper(page_size=200, delay_seconds=5.0, num_retries=2)
+    client_instance = mock_client_class.return_value
+
+    assert paper.client == client_instance
+    mock_client_class.assert_called_with(page_size=200, delay_seconds=5.0, num_retries=2)
+
+
+def test_validate_paper_arguments():
+    args = validate_paper_arguments(page_size=150, delay_seconds=2.0, num_retries=5)
+    assert args == {
+        'page_size': 150,
+        'delay_seconds': 2.0,
+        'num_retries': 5
+    }
+
+
+@patch("audioarxiv.resources.paper.arxiv.Client")
+def test_search_by_arxiv_id_and_properties(mock_client_class, mock_paper_object):
+    mock_client = MagicMock()
+    mock_client.results.return_value = iter([mock_paper_object])
+    mock_client_class.return_value = mock_client
+
+    paper = Paper()
+    paper.search_by_arxiv_id("1234.5678")
+
+    assert paper.title == "Test Title"
+    assert paper.abstract == "This is a test abstract."
+    assert paper.authors == ["Alice", "Bob"]
+    assert paper.published == datetime(2022, 1, 1)
+    assert paper.updated == datetime(2022, 1, 2)
+
+
+@patch("audioarxiv.resources.paper.arxiv.Client")
+def test_init_without_validation(mock_client_class):
+    paper = Paper(validate_arguments=False)  # noqa: F841 # pylint: disable=unused-variable
+    mock_client_class.assert_called_once()
+
+
+@patch("audioarxiv.resources.paper.arxiv.Client")
+def test_paper_properties_when_paper_is_none(mock_client_class, caplog):
+    mock_client = MagicMock()
+    mock_client_class.return_value = mock_client
+
+    logger = logging.getLogger('audioarxiv')  # Match the logger name
+    logger.setLevel(logging.ERROR)  # Ensure ERROR logs are allowed
+    logger.propagate = True
+
+    paper = Paper()
+
+    with caplog.at_level(logging.ERROR, logger='audioarxiv'):
+        assert paper.title is None
+        assert 'paper is None.' in caplog.text
+    with caplog.at_level(logging.ERROR, logger='audioarxiv'):
+        assert paper.abstract is None
+        assert 'paper is None.' in caplog.text
+    with caplog.at_level(logging.ERROR, logger='audioarxiv'):
+        assert paper.authors is None
+        assert 'paper is None.' in caplog.text
+    with caplog.at_level(logging.ERROR, logger='audioarxiv'):
+        assert paper.published is None
+        assert 'paper is None.' in caplog.text
+    with caplog.at_level(logging.ERROR, logger='audioarxiv'):
+        assert paper.updated is None
+        assert 'paper is None.' in caplog.text
+
+
+@patch("audioarxiv.resources.paper.arxiv.Client")
+def test_download_pdf_with_valid_paper(mock_client_class, mock_paper_object):
+    mock_client = MagicMock()
+    mock_client.results.return_value = iter([mock_paper_object])
+    mock_client_class.return_value = mock_client
+
+    mock_paper_object.download_pdf.return_value = "path/to/pdf"
+
+    # Create the Paper instance
+    paper = Paper(validate_arguments=False)
+    paper.search_by_arxiv_id('arxiv_id')
+
+    # Call the `download_pdf` method
+    pdf_path = paper.download_pdf(dirpath='./', filename='test_paper.pdf')
+
+    # Assertions
+    mock_paper_object.download_pdf.assert_called_once_with(dirpath='./', filename='test_paper.pdf')
+    assert pdf_path == "path/to/pdf"
+
+
+@patch("audioarxiv.resources.paper.arxiv.Client")
+def test_download_pdf_when_no_paper(mock_client_class, caplog):
+    mock_client = MagicMock()
+    mock_client_class.return_value = mock_client
+
+    logger = logging.getLogger('audioarxiv')  # Match the logger name
+    logger.setLevel(logging.ERROR)  # Ensure ERROR logs are allowed
+    logger.propagate = True
+
+    # Setup: Create Paper instance with no paper assigned
+    paper = Paper(validate_arguments=False)
+
+    with caplog.at_level(logging.ERROR, logger='audioarxiv'):
+        # Call `download_pdf`
+        pdf_path = paper.download_pdf(dirpath='./', filename='test_paper.pdf')
+
+        # Assertions
+        assert pdf_path is None
+        assert 'Paper is None. Cannot download PDF.' in caplog.text
+
+
+@patch("audioarxiv.resources.paper.arxiv.Client")
+def test_sections_with_valid_pdf(mock_client_class, mock_paper_object):
+    mock_client = MagicMock()
+    mock_client.results.return_value = iter([mock_paper_object])
+    mock_client_class.return_value = mock_client
+
+    # Setup: Create Paper instance with no paper assigned
+    paper = Paper(validate_arguments=False)
+    paper.search_by_arxiv_id('arxiv_id')
+
+    # Mock the `download_pdf` and `fitz.open` methods
+    with patch('fitz.open') as mock_fitz_open:
+        mock_page = MagicMock()
+        mock_page.get_text.return_value = [[None, None, None, None, "SECTION HEADER\n"],
+                                           [None, None, None, None, "Section Content"]]
+        mock_fitz_open.return_value = [mock_page]
+
+        # Call the `sections` property
+        sections = paper.sections
+
+        # Assertions
+        assert len(sections) > 0  # Should return at least one section
+        assert sections[0]["header"] == "SECTION HEADER"
+        assert "Section Content" in sections[0]["content"]
+
+
+@patch("audioarxiv.resources.paper.arxiv.Client")
+def test_sections_when_no_paper(mock_client_class, caplog):
+    mock_client = MagicMock()
+    mock_client_class.return_value = mock_client
+
+    logger = logging.getLogger('audioarxiv')  # Match the logger name
+    logger.setLevel(logging.ERROR)  # Ensure ERROR logs are allowed
+    logger.propagate = True
+
+    # Setup: Create Paper instance with no paper assigned
+    paper = Paper(validate_arguments=False)
+
+    with caplog.at_level(logging.ERROR, logger='audioarxiv'):
+        # Call `sections` property
+        sections = paper.sections
+
+        # Assertions
+        assert 'Paper is None. Cannot download PDF.' in caplog.text
+        assert len(sections) == 0  # No sections should be found since paper is None

audioarxiv-0.1.2rc59.post1/CODE_OF_CONDUCT.md

@@ -1,9 +0,0 @@
-# Microsoft Open Source Code of Conduct
-
-This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
-
-Resources:
-
-- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
-- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
-- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns

audioarxiv-0.1.2rc59.post1/SUPPORT.md

@@ -1,7 +0,0 @@
-# Support
-
-## How to file issues and get help
-
-This project uses GitHub Issues to track bugs and feature requests. Please search the existing
-issues before filing new issues to avoid duplicates. For new issues, file your bug or
-feature request as a new Issue.

audioarxiv-0.1.2rc59.post1/tests/resources/test_paper.py

@@ -1,66 +0,0 @@
-from __future__ import annotations
-
-from datetime import datetime
-from unittest.mock import MagicMock, patch
-
-import pytest
-
-from audioarxiv.resources.paper import (  # Replace with actual module name
-    Paper, validate_paper_arguments)
-
-
-@pytest.fixture
-def mock_paper_object():
-    mock_paper = MagicMock()
-    mock_paper.title = "Test Title"
-    mock_paper.summary = "This is a test abstract."
-
-    author1 = MagicMock()
-    author1.name = "Alice"
-    author2 = MagicMock()
-    author2.name = "Bob"
-    mock_paper.authors = [author1, author2]
-
-    mock_paper.published = datetime(2022, 1, 1)
-    mock_paper.updated = datetime(2022, 1, 2)
-    return mock_paper
-
-
-@patch("audioarxiv.resources.paper.arxiv.Client")
-def test_paper_init_and_client(mock_client_class):
-    paper = Paper(page_size=200, delay_seconds=5.0, num_retries=2)
-    client_instance = mock_client_class.return_value
-
-    assert paper.client == client_instance
-    mock_client_class.assert_called_with(page_size=200, delay_seconds=5.0, num_retries=2)
-
-
-def test_validate_paper_arguments():
-    args = validate_paper_arguments(page_size=150, delay_seconds=2.0, num_retries=5)
-    assert args == {
-        'page_size': 150,
-        'delay_seconds': 2.0,
-        'num_retries': 5
-    }
-
-
-@patch("audioarxiv.resources.paper.arxiv.Client")
-def test_search_by_arxiv_id_and_properties(mock_client_class, mock_paper_object):
-    mock_client = MagicMock()
-    mock_client.results.return_value = iter([mock_paper_object])
-    mock_client_class.return_value = mock_client
-
-    paper = Paper()
-    paper.search_by_arxiv_id("1234.5678")
-
-    assert paper.title == "Test Title"
-    assert paper.abstract == "This is a test abstract."
-    assert paper.authors == ["Alice", "Bob"]
-    assert paper.published == datetime(2022, 1, 1)
-    assert paper.updated == datetime(2022, 1, 2)
-
-
-@patch("audioarxiv.resources.paper.arxiv.Client")
-def test_init_without_validation(mock_client_class):
-    paper = Paper(validate_arguments=False)  # noqa: F841 # pylint: disable=unused-variable
-    mock_client_class.assert_called_once()