pylindol 0.1.0__tar.gz

pylindol-0.1.0/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.3
+Name: pylindol
+Version: 0.1.0
+Summary: A tool to download earthquake report information from the Philippine Institute of Volcanology and Seismology (PHIVOLCS) website.
+Author: clnhrn
+Author-email: clnhrn <herniacln@gmail.com>
+License: MIT
+Requires-Dist: beautifulsoup4>=4.14.2
+Requires-Dist: certifi>=2024.0.0
+Requires-Dist: click>=8.1.8
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: lxml>=6.0.2
+Requires-Dist: pandas>=2.3.3
+Requires-Dist: requests>=2.32.5
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# pylindol
+
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
+
+pylindol is a lightweight and easy-to-use library designed to scrape or pull the latest earthquake data from the [Philippine Institute of Volcanology and Seismology (PHIVOLCS)](https://earthquake.phivolcs.dost.gov.ph) website. It provides a simple API to get up-to-date information for your applications, scripts, or research projects.
+
+## Requirements
+
+- Python >= 3.11
+
+## Installation
+
+Install pylindol directly from PyPI:
+
+```bash
+pip install pylindol
+```
+
+### Using a virtual environment (recommended)
+
+```bash
+# Create a virtual environment
+python3 -m venv .venv
+
+# Activate the virtual environment
+source .venv/bin/activate  # On macOS/Linux
+# .venv\Scripts\activate   # On Windows
+
+# Install pylindol
+pip install pylindol
+```
+
+### Using uv
+
+If you prefer using `uv` for faster package management:
+
+```bash
+uv add pylindol
+```
+
+## Usage
+
+### Command Line Interface (CLI)
+
+The package provides the `pylindol` command after installation.
+
+#### Basic usage (scrape current month)
+
+```bash
+pylindol
+```
+
+#### Scrape a specific month and year
+
+```bash
+pylindol --month 8 --year 2025
+```
+
+#### Specify custom output directory
+
+```bash
+pylindol --output-path my_data
+```
+
+#### Combine options
+
+```bash
+pylindol --month 9 --year 2025 --output-path archive
+```
+
+#### Get help
+
+```bash
+pylindol --help
+```
+
+### Python Library
+
+You can also use the scraper as a Python library in your code.
+
+#### Import the class
+
+```python
+from pylindol import PhivolcsEarthquakeInfoScraper
+```
+
+#### Scrape current month
+
+```python
+scraper = PhivolcsEarthquakeInfoScraper()
+scraper.run()
+```
+
+#### Scrape specific month and year
+
+```python
+scraper = PhivolcsEarthquakeInfoScraper(month=8, year=2025)
+scraper.run()
+```
+
+#### Specify custom output path
+
+```python
+scraper = PhivolcsEarthquakeInfoScraper(
+    month=9, 
+    year=2025, 
+    output_path="custom/directory"
+)
+scraper.run()
+```
+
+## Features
+
+- ✅ Scrape current month's earthquake data
+- ✅ Scrape historical data by month and year
+- ✅ Automatic CA certificate handling for SSL connections
+- ✅ Input validation (month range, year validation, and future date prevention)
+- ✅ Export data to CSV format
+- ✅ Structured logging with loguru
+
+## Output
+
+The scraper saves earthquake data as CSV files with the naming convention:
+
+```
+phivolcs_earthquake_data_{month}_{year}.csv
+```
+
+**Default location:** `data/` directory (created automatically if it doesn't exist)
+
+**Example:** `data/phivolcs_earthquake_data_10_2025.csv`
+
+The CSV files contain earthquake information including date, time, magnitude, location, and depth.
+
+## Development
+
+If you want to contribute to pylindol or run it from source:
+
+```bash
+# Clone the repository
+git clone git@github.com:clnhrn/pylindol.git
+cd pylindol
+
+# Install in development mode
+pip install -e .
+
+# Or using uv
+uv sync
+```

pylindol-0.1.0/README.md

@@ -0,0 +1,149 @@
+# pylindol
+
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
+
+pylindol is a lightweight and easy-to-use library designed to scrape or pull the latest earthquake data from the [Philippine Institute of Volcanology and Seismology (PHIVOLCS)](https://earthquake.phivolcs.dost.gov.ph) website. It provides a simple API to get up-to-date information for your applications, scripts, or research projects.
+
+## Requirements
+
+- Python >= 3.11
+
+## Installation
+
+Install pylindol directly from PyPI:
+
+```bash
+pip install pylindol
+```
+
+### Using a virtual environment (recommended)
+
+```bash
+# Create a virtual environment
+python3 -m venv .venv
+
+# Activate the virtual environment
+source .venv/bin/activate  # On macOS/Linux
+# .venv\Scripts\activate   # On Windows
+
+# Install pylindol
+pip install pylindol
+```
+
+### Using uv
+
+If you prefer using `uv` for faster package management:
+
+```bash
+uv add pylindol
+```
+
+## Usage
+
+### Command Line Interface (CLI)
+
+The package provides the `pylindol` command after installation.
+
+#### Basic usage (scrape current month)
+
+```bash
+pylindol
+```
+
+#### Scrape a specific month and year
+
+```bash
+pylindol --month 8 --year 2025
+```
+
+#### Specify custom output directory
+
+```bash
+pylindol --output-path my_data
+```
+
+#### Combine options
+
+```bash
+pylindol --month 9 --year 2025 --output-path archive
+```
+
+#### Get help
+
+```bash
+pylindol --help
+```
+
+### Python Library
+
+You can also use the scraper as a Python library in your code.
+
+#### Import the class
+
+```python
+from pylindol import PhivolcsEarthquakeInfoScraper
+```
+
+#### Scrape current month
+
+```python
+scraper = PhivolcsEarthquakeInfoScraper()
+scraper.run()
+```
+
+#### Scrape specific month and year
+
+```python
+scraper = PhivolcsEarthquakeInfoScraper(month=8, year=2025)
+scraper.run()
+```
+
+#### Specify custom output path
+
+```python
+scraper = PhivolcsEarthquakeInfoScraper(
+    month=9, 
+    year=2025, 
+    output_path="custom/directory"
+)
+scraper.run()
+```
+
+## Features
+
+- ✅ Scrape current month's earthquake data
+- ✅ Scrape historical data by month and year
+- ✅ Automatic CA certificate handling for SSL connections
+- ✅ Input validation (month range, year validation, and future date prevention)
+- ✅ Export data to CSV format
+- ✅ Structured logging with loguru
+
+## Output
+
+The scraper saves earthquake data as CSV files with the naming convention:
+
+```
+phivolcs_earthquake_data_{month}_{year}.csv
+```
+
+**Default location:** `data/` directory (created automatically if it doesn't exist)
+
+**Example:** `data/phivolcs_earthquake_data_10_2025.csv`
+
+The CSV files contain earthquake information including date, time, magnitude, location, and depth.
+
+## Development
+
+If you want to contribute to pylindol or run it from source:
+
+```bash
+# Clone the repository
+git clone git@github.com:clnhrn/pylindol.git
+cd pylindol
+
+# Install in development mode
+pip install -e .
+
+# Or using uv
+uv sync
+```

pylindol-0.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[project]
+name = "pylindol"
+version = "0.1.0"
+description = "A tool to download earthquake report information from the Philippine Institute of Volcanology and Seismology (PHIVOLCS) website."
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    { name = "clnhrn", email = "herniacln@gmail.com" }
+]
+requires-python = ">=3.11"
+dependencies = [
+    "beautifulsoup4>=4.14.2",
+    "certifi>=2024.0.0",
+    "click>=8.1.8",
+    "loguru>=0.7.3",
+    "lxml>=6.0.2",
+    "pandas>=2.3.3",
+    "requests>=2.32.5",
+]
+
+[project.scripts]
+pylindol = "pylindol.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.8.0,<0.9"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "coverage-badge>=1.1.2",
+    "pre-commit>=4.3.0",
+    "pytest>=8.0.0",
+    "pytest-cov>=7.0.0",
+    "pytest-mock>=3.12.0",
+    "responses>=0.25.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["src/pylindol/tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"

pylindol-0.1.0/src/pylindol/__init__.py

@@ -0,0 +1,3 @@
+from pylindol.earthquake_info_scraper import PhivolcsEarthquakeInfoScraper
+
+__all__ = ["PhivolcsEarthquakeInfoScraper"]

pylindol-0.1.0/src/pylindol/ca_certificates/GlobalSign RSA OV SSL CA 2018.pem

@@ -0,0 +1,26 @@
+-----BEGIN CERTIFICATE-----
+MIIETjCCAzagAwIBAgINAe5fIh38YjvUMzqFVzANBgkqhkiG9w0BAQsFADBMMSAw
+HgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMzETMBEGA1UEChMKR2xvYmFs
+U2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjAeFw0xODExMjEwMDAwMDBaFw0yODEx
+MjEwMDAwMDBaMFAxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52
+LXNhMSYwJAYDVQQDEx1HbG9iYWxTaWduIFJTQSBPViBTU0wgQ0EgMjAxODCCASIw
+DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKdaydUMGCEAI9WXD+uu3Vxoa2uP
+UGATeoHLl+6OimGUSyZ59gSnKvuk2la77qCk8HuKf1UfR5NhDW5xUTolJAgvjOH3
+idaSz6+zpz8w7bXfIa7+9UQX/dhj2S/TgVprX9NHsKzyqzskeU8fxy7quRU6fBhM
+abO1IFkJXinDY+YuRluqlJBJDrnw9UqhCS98NE3QvADFBlV5Bs6i0BDxSEPouVq1
+lVW9MdIbPYa+oewNEtssmSStR8JvA+Z6cLVwzM0nLKWMjsIYPJLJLnNvBhBWk0Cq
+o8VS++XFBdZpaFwGue5RieGKDkFNm5KQConpFmvv73W+eka440eKHRwup08CAwEA
+AaOCASkwggElMA4GA1UdDwEB/wQEAwIBhjASBgNVHRMBAf8ECDAGAQH/AgEAMB0G
+A1UdDgQWBBT473/yzXhnqN5vjySNiPGHAwKz6zAfBgNVHSMEGDAWgBSP8Et/qC5F
+JK5NUPpjmove4t0bvDA+BggrBgEFBQcBAQQyMDAwLgYIKwYBBQUHMAGGImh0dHA6
+Ly9vY3NwMi5nbG9iYWxzaWduLmNvbS9yb290cjMwNgYDVR0fBC8wLTAroCmgJ4Yl
+aHR0cDovL2NybC5nbG9iYWxzaWduLmNvbS9yb290LXIzLmNybDBHBgNVHSAEQDA+
+MDwGBFUdIAAwNDAyBggrBgEFBQcCARYmaHR0cHM6Ly93d3cuZ2xvYmFsc2lnbi5j
+b20vcmVwb3NpdG9yeS8wDQYJKoZIhvcNAQELBQADggEBAJmQyC1fQorUC2bbmANz
+EdSIhlIoU4r7rd/9c446ZwTbw1MUcBQJfMPg+NccmBqixD7b6QDjynCy8SIwIVbb
+0615XoFYC20UgDX1b10d65pHBf9ZjQCxQNqQmJYaumxtf4z1s4DfjGRzNpZ5eWl0
+6r/4ngGPoJVpjemEuunl1Ig423g7mNA2eymw0lIYkN5SQwCuaifIFJ6GlazhgDEw
+fpolu4usBCOmmQDo8dIm7A9+O4orkjgTHY+GzYZSR+Y0fFukAj6KYXwidlNalFMz
+hriSqHKvoflShx8xpfywgVcvzfTO3PYkz6fiNJBonf6q8amaEsybwMbDqKWwIX7e
+SPY=
+-----END CERTIFICATE-----

pylindol-0.1.0/src/pylindol/cli.py

@@ -0,0 +1,35 @@
+import click
+
+from pylindol.earthquake_info_scraper import PhivolcsEarthquakeInfoScraper
+
+
+@click.command()
+@click.option(
+    "--month",
+    type=int,
+    default=None,
+    help="Month to scrape (1-12). If not provided, scrapes current month.",
+)
+@click.option(
+    "--year",
+    type=int,
+    default=None,
+    help="Year to scrape. If not provided, scrapes current year.",
+)
+@click.option(
+    "--output-path",
+    type=str,
+    default="data",
+    help="Path to save the output CSV file. Default is 'data'.",
+)
+def main(month, year, output_path):
+    """
+    Scrape earthquake information from PHIVOLCS website.
+
+    By default, scrapes the current month's data. You can specify a different
+    month and year to scrape historical data.
+    """
+    scraper = PhivolcsEarthquakeInfoScraper(
+        month=month, year=year, output_path=output_path
+    )
+    scraper.run()

pylindol-0.1.0/src/pylindol/config/__init__.py

@@ -0,0 +1,3 @@
+from pylindol.config.paths import CA_CERTIFICATE_PATH
+
+__all__ = ["CA_CERTIFICATE_PATH"]

pylindol-0.1.0/src/pylindol/config/paths.py

@@ -0,0 +1,7 @@
+from pathlib import Path
+
+CA_CERTIFICATE_PATH = (
+    Path(__file__).parent.parent
+    / "ca_certificates"
+    / "GlobalSign RSA OV SSL CA 2018.pem"
+)

pylindol-0.1.0/src/pylindol/earthquake_info_scraper.py

@@ -0,0 +1,181 @@
+from datetime import date, datetime
+from io import StringIO
+from pathlib import Path
+from typing import Optional
+
+import pandas as pd
+import requests
+from bs4 import BeautifulSoup
+from loguru import logger
+
+from pylindol.config.paths import CA_CERTIFICATE_PATH
+
+
+class PhivolcsEarthquakeInfoScraper:
+    """
+    This class is used to scrape the latest earthquake information from the
+    PHIVOLCS website.
+
+    You can either scrape the latest earthquake information or a specific month
+    and year. By default, it will scrape the latest earthquake information.
+    """
+
+    def __init__(
+        self,
+        month: Optional[int] = None,
+        year: Optional[int] = None,
+        output_path: Optional[str] = "data",
+    ):
+        """
+        Initialize the scraper.
+
+        Args:
+            month: The month to scrape.
+            year: The year to scrape.
+            output_path: The path to export the dataframe.
+        """
+
+        self.base_url = "https://earthquake.phivolcs.dost.gov.ph"
+        self.output_path = output_path
+
+        if month is not None and year is None:
+            raise ValueError("If month is provided, year must also be provided.")
+        elif month is None and year is not None:
+            raise ValueError("If year is provided, month must also be provided.")
+
+        if month is not None and year is not None:
+            self.month = self._validate_month_input(month)
+            self.year = self._validate_year_input(year)
+            month_name = datetime(self.year, self.month, 1).strftime("%B")
+            self.month_url = (
+                f"{self.base_url}/EQLatest-Monthly/{self.year}/"
+                f"{self.year}_{month_name}.html"
+            )
+        else:
+            self.month = datetime.now().month
+            self.year = datetime.now().year
+
+    def _validate_month_input(self, month: int) -> int:
+        """
+        Validate the month input.
+        """
+        if month is not None and month < 1 or month > 12:
+            raise ValueError((f"Month must be between 1 and 12. You provided {month}."))
+        return month
+
+    def _validate_year_input(self, year: int) -> int:
+        """
+        Validate the year input.
+        """
+        if year is not None and (year < 1900 or year > datetime.now().year):
+            raise ValueError(
+                (
+                    "Year must be greater than 1900 and less than the current year "
+                    f"({datetime.now().year}). You provided {year}."
+                )
+            )
+        return year
+
+    def extract_main_page(self) -> bytes:
+        """
+        Scrape the main earthquake data page of the PHIVOLCS website.
+
+        Returns:
+            bytes: The content of the main page.
+        """
+        try:
+            with requests.Session() as session:
+                response = session.get(self.base_url, verify=CA_CERTIFICATE_PATH)
+                response.raise_for_status()
+                return response.content
+        except Exception as e:
+            logger.error(f"Error extracting main page: {e}")
+            raise
+
+    def extract_month_page(self) -> bytes:
+        """
+        Scrape the monthly earthquake data page of the PHIVOLCS website.
+
+        Returns:
+            bytes: The content of the monthly page.
+        """
+        try:
+            with requests.Session() as session:
+                response = session.get(self.month_url, verify=CA_CERTIFICATE_PATH)
+                response.raise_for_status()
+                return response.content
+        except Exception as e:
+            logger.error(f"Error extracting month page: {e}")
+            raise
+
+    def extract_target_table(self, page: bytes) -> pd.DataFrame:
+        """
+        Extract the target table from the page.
+
+        Args:
+            page: The content of the page in bytes.
+
+        Returns:
+            pd.DataFrame: Dataframe of the target table.
+        """
+        soup = BeautifulSoup(page, "html.parser")
+        tables = pd.read_html(StringIO(soup.prettify()))
+        return tables[2]
+
+    def _export_to_csv(self, df: pd.DataFrame):
+        """
+        Export the dataframe to a CSV file.
+
+        Args:
+            df: The dataframe to export.
+            output_path: The path to export the dataframe.
+        """
+        Path(self.output_path).mkdir(exist_ok=True, parents=True)
+        file_name = (
+            Path(self.output_path)
+            / f"phivolcs_earthquake_data_{self.month}_{self.year}.csv"
+        )
+        df.to_csv(file_name, index=False)
+        logger.info(f"Exported data to {file_name}")
+
+    def _run_main_scrape(self):
+        """
+        Run the scraper for the main page.
+        """
+        page = self.extract_main_page()
+        table = self.extract_target_table(page)
+        self._export_to_csv(table)
+
+    def _run_month_scrape(self):
+        """
+        Run the scraper for the month page.
+        """
+        page = self.extract_month_page()
+        table = self.extract_target_table(page)
+        self._export_to_csv(table)
+
+    def run(self):
+        """
+        Run the scraper.
+
+        Args:
+            output_path: The path to export the dataframe.
+        """
+        target_date = date(self.year, self.month, 1)
+        current_date = date.today().replace(day=1)
+        if target_date > current_date:
+            raise ValueError(
+                (
+                    f"Month {self.month} of year {self.year} is in the future. "
+                    "Please provide a month-year combination that is current "
+                    "or in the past."
+                )
+            )
+        elif self.month == datetime.now().month and self.year == datetime.now().year:
+            logger.info(
+                f"Scraping main (current month) page: {self.month} of {self.year}"
+            )
+            self._run_main_scrape()
+        else:
+            logger.info(f"Scraping month {self.month} of year {self.year}")
+            self._run_month_scrape()

pylindol-0.1.0/src/pylindol/tests/__init__.py

@@ -0,0 +1 @@
+"""Tests for the pylindol package."""

pylindol-0.1.0/src/pylindol/tests/test_cli.py

@@ -0,0 +1,83 @@
+"""Tests for the CLI interface."""
+
+import responses
+from click.testing import CliRunner
+
+from pylindol.cli import main
+
+
+class TestCLI:
+    """Test CLI functionality."""
+
+    def test_cli_help(self):
+        """Test that CLI help command works."""
+        runner = CliRunner()
+        result = runner.invoke(main, ["--help"])
+
+        assert result.exit_code == 0
+        expected = "Scrape earthquake information from PHIVOLCS website"
+        assert expected in result.output
+        assert "--month" in result.output
+        assert "--year" in result.output
+        assert "--output-path" in result.output
+
+    @responses.activate
+    def test_cli_with_valid_options(self, tmp_path, monkeypatch):
+        """Test CLI with valid month and year options."""
+        # Mock the HTTP response
+        mock_html = """
+        <html>
+            <body>
+                <table><tr><td>Table 1</td></tr></table>
+                <table><tr><td>Table 2</td></tr></table>
+                <table>
+                    <tr><th>Date</th><th>Magnitude</th></tr>
+                    <tr><td>2025-08-01</td><td>5.0</td></tr>
+                </table>
+            </body>
+        </html>
+        """
+
+        url = (
+            "https://earthquake.phivolcs.dost.gov.ph/"
+            "EQLatest-Monthly/2025/2025_August.html"
+        )
+        responses.add(
+            responses.GET,
+            url,
+            body=mock_html,
+            status=200,
+        )
+
+        runner = CliRunner()
+        result = runner.invoke(
+            main, ["--month", "8", "--year", "2025", "--output-path", str(tmp_path)]
+        )
+
+        # Should succeed
+        assert result.exit_code == 0
+
+        # Check that CSV file was created
+        import os
+
+        csv_files = [f for f in os.listdir(tmp_path) if f.endswith(".csv")]
+        assert len(csv_files) == 1
+        assert "phivolcs_earthquake_data_8_2025.csv" in csv_files[0]
+
+    def test_cli_with_invalid_month(self):
+        """Test CLI rejects invalid month."""
+        runner = CliRunner()
+        result = runner.invoke(main, ["--month", "13", "--year", "2025"])
+
+        # Should fail with error
+        assert result.exit_code != 0
+
+    def test_cli_with_only_month(self):
+        """Test CLI rejects month without year."""
+        runner = CliRunner()
+        result = runner.invoke(main, ["--month", "8"])
+
+        # Should fail with error
+        assert result.exit_code != 0
+        # Check that exception was raised (it won't be in output with Click)
+        assert isinstance(result.exception, ValueError)

pylindol-0.1.0/src/pylindol/tests/test_earthquake_info_scraper.py

@@ -0,0 +1,217 @@
+"""Tests for the PhivolcsEarthquakeInfoScraper class."""
+
+from datetime import datetime
+
+import pandas as pd
+import pytest
+import responses
+
+from pylindol.earthquake_info_scraper import PhivolcsEarthquakeInfoScraper
+
+
+class TestPhivolcsEarthquakeInfoScraperInit:
+    """Test initialization of the scraper."""
+
+    def test_init_with_no_params(self):
+        """Test initialization with no parameters defaults to current month."""
+        scraper = PhivolcsEarthquakeInfoScraper()
+        assert scraper.month == datetime.now().month
+        assert scraper.year == datetime.now().year
+        assert scraper.output_path == "data"
+
+    def test_init_with_valid_month_and_year(self):
+        """Test initialization with valid month and year."""
+        scraper = PhivolcsEarthquakeInfoScraper(month=8, year=2025)
+        assert scraper.month == 8
+        assert scraper.year == 2025
+        assert "2025_August.html" in scraper.month_url
+
+    def test_init_with_custom_output_path(self):
+        """Test initialization with custom output path."""
+        scraper = PhivolcsEarthquakeInfoScraper(
+            month=8, year=2025, output_path="custom/path"
+        )
+        assert scraper.output_path == "custom/path"
+
+    def test_init_with_only_month_raises_error(self):
+        """Test that providing only month raises ValueError."""
+        with pytest.raises(ValueError, match="year must also be provided"):
+            PhivolcsEarthquakeInfoScraper(month=8)
+
+    def test_init_with_only_year_raises_error(self):
+        """Test that providing only year raises ValueError."""
+        with pytest.raises(ValueError, match="month must also be provided"):
+            PhivolcsEarthquakeInfoScraper(year=2025)
+
+
+class TestPhivolcsEarthquakeInfoScraperValidation:
+    """Test validation methods of the scraper."""
+
+    def test_month_validation_rejects_less_than_one(self):
+        """Test that month < 1 raises ValueError."""
+        with pytest.raises(ValueError, match="Month must be between 1 and 12"):
+            PhivolcsEarthquakeInfoScraper(month=0, year=2025)
+
+    def test_month_validation_rejects_greater_than_twelve(self):
+        """Test that month > 12 raises ValueError."""
+        with pytest.raises(ValueError, match="Month must be between 1 and 12"):
+            PhivolcsEarthquakeInfoScraper(month=13, year=2025)
+
+    def test_year_validation_rejects_too_old(self):
+        """Test that year < 1900 raises ValueError."""
+        with pytest.raises(ValueError, match="Year must be greater than 1900"):
+            PhivolcsEarthquakeInfoScraper(month=1, year=1899)
+
+    def test_year_validation_rejects_future(self):
+        """Test that year > current year raises ValueError."""
+        future_year = datetime.now().year + 1
+        with pytest.raises(ValueError, match="less than the current year"):
+            PhivolcsEarthquakeInfoScraper(month=1, year=future_year)
+
+    def test_future_date_validation_in_run(self, tmp_path):
+        """Test that run() rejects future dates."""
+        now = datetime.now()
+        if now.month < 12:
+            future_month = now.month + 1
+            future_year = now.year
+        else:
+            future_month = 1
+            future_year = now.year + 1
+
+        scraper = PhivolcsEarthquakeInfoScraper(
+            month=future_month, year=future_year, output_path=str(tmp_path)
+        )
+
+        with pytest.raises(ValueError, match="is in the future"):
+            scraper.run()
+
+
+class TestPhivolcsEarthquakeInfoScraperScraping:
+    """Test scraping functionality with mocked requests."""
+
+    @responses.activate
+    def test_extract_main_page_success(self):
+        """Test successful extraction of main page."""
+        mock_html = "<html><body>Test content</body></html>"
+        responses.add(
+            responses.GET,
+            "https://earthquake.phivolcs.dost.gov.ph",
+            body=mock_html,
+            status=200,
+        )
+
+        scraper = PhivolcsEarthquakeInfoScraper()
+        content = scraper.extract_main_page()
+        assert content == mock_html.encode()
+
+    @responses.activate
+    def test_extract_month_page_success(self):
+        """Test successful extraction of monthly page."""
+        mock_html = "<html><body>Monthly data</body></html>"
+        url = (
+            "https://earthquake.phivolcs.dost.gov.ph/"
+            "EQLatest-Monthly/2025/2025_August.html"
+        )
+        responses.add(
+            responses.GET,
+            url,
+            body=mock_html,
+            status=200,
+        )
+
+        scraper = PhivolcsEarthquakeInfoScraper(month=8, year=2025)
+        content = scraper.extract_month_page()
+        assert content == mock_html.encode()
+
+    def test_extract_target_table(self):
+        """Test extraction of target table from HTML."""
+        # Create mock HTML with 3 tables (we extract the 3rd one)
+        mock_html = """
+        <html>
+            <body>
+                <table><tr><td>Table 1</td></tr></table>
+                <table><tr><td>Table 2</td></tr></table>
+                <table>
+                    <tr><th>Date</th><th>Magnitude</th></tr>
+                    <tr><td>2025-08-01</td><td>5.0</td></tr>
+                </table>
+            </body>
+        </html>
+        """
+
+        scraper = PhivolcsEarthquakeInfoScraper()
+        df = scraper.extract_target_table(mock_html.encode())
+
+        assert isinstance(df, pd.DataFrame)
+        assert len(df) > 0
+
+    @responses.activate
+    def test_run_with_current_month(self, tmp_path):
+        """Test run method for current month with mocked response."""
+        # Create mock HTML with proper table structure
+        mock_html = """
+        <html>
+            <body>
+                <table><tr><td>Table 1</td></tr></table>
+                <table><tr><td>Table 2</td></tr></table>
+                <table>
+                    <tr><th>Date</th><th>Magnitude</th></tr>
+                    <tr><td>2025-10-01</td><td>5.0</td></tr>
+                    <tr><td>2025-10-02</td><td>4.5</td></tr>
+                </table>
+            </body>
+        </html>
+        """
+
+        responses.add(
+            responses.GET,
+            "https://earthquake.phivolcs.dost.gov.ph",
+            body=mock_html,
+            status=200,
+        )
+
+        scraper = PhivolcsEarthquakeInfoScraper(output_path=str(tmp_path))
+        scraper.run()
+
+        # Check that CSV was created
+        now = datetime.now()
+        expected_file = (
+            tmp_path / f"phivolcs_earthquake_data_{now.month}_{now.year}.csv"
+        )
+        assert expected_file.exists()
+
+    @responses.activate
+    def test_run_with_specific_month(self, tmp_path):
+        """Test run method for specific month with mocked response."""
+        mock_html = """
+        <html>
+            <body>
+                <table><tr><td>Table 1</td></tr></table>
+                <table><tr><td>Table 2</td></tr></table>
+                <table>
+                    <tr><th>Date</th><th>Magnitude</th></tr>
+                    <tr><td>2025-08-01</td><td>5.0</td></tr>
+                </table>
+            </body>
+        </html>
+        """
+
+        url = (
+            "https://earthquake.phivolcs.dost.gov.ph/"
+            "EQLatest-Monthly/2025/2025_August.html"
+        )
+        responses.add(
+            responses.GET,
+            url,
+            body=mock_html,
+            status=200,
+        )
+
+        scraper = PhivolcsEarthquakeInfoScraper(
+            month=8, year=2025, output_path=str(tmp_path)
+        )
+        scraper.run()
+
+        # Check that CSV was created
+        expected_file = tmp_path / "phivolcs_earthquake_data_8_2025.csv"
+        assert expected_file.exists()