Merging dev into main.

.coveragerc

@@ -0,0 +1,3 @@
+[run]
+omit =
+    tests/*

.github/workflows/codecov.yml

@@ -0,0 +1,37 @@
+name: Run tests and upload coverage report to Codecov
+
+on:
+  push:
+    branches: [dev, main]
+
+jobs:
+  coverage:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+            python-version: "3.11"
+
+      - name: Install Python dependencies
+        run: |
+          pip install -r requirements.txt
+          pip install codecov
+          pip install -e .
+
+      - name: Run tests with coverage
+        env:
+            SKIP_ONLINE_TESTS: "true"
+        run: |
+            coverage run -m pytest
+            coverage xml
+
+      - name: Upload score to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+            files: coverage.xml
+            token: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/mkdocs.yml

@@ -0,0 +1,39 @@
+name: Build and deploy mkdocs site to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  mkdocs:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+            python-version: "3.11"
+
+      - name: Install docs dependencies
+        run: |
+            pip install mkdocs
+
+      - name: Generate index.md from README.md
+        run: |
+          cp README.md docs/index.md
+          sed -i 's|docs/guide.md|guide/|g' docs/index.md
+          mkdir docs/media
+          cp media/logo.png docs/media/logo.png
+
+      - name: Build mkdocs site
+        run: mkdocs build
+
+      - name: Deploy site to gh-pages branch
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site

.gitignore

@@ -0,0 +1,7 @@
+.idea/
+*.egg-info/
+.env
+__pycache__/
+.coverage
+dist/
+coverage.xml

README.md

@@ -0,0 +1,60 @@
+# eppoPynder <img src="media/logo.png" height="140" align="right">
+
+[![Lifecycle: stable](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html#stable) [![codecov](https://codecov.io/gh/openefsa/eppoPynder/branch/main/graph/badge.svg?token=6U3TL9T27T)](https://codecov.io/gh/openefsa/eppoPynder)
+
+## Overview
+
+**eppoPynder** provides a Python interface to the public APIs of the **European
+and Mediterranean Plant Protection Organization (EPPO)** database.
+The package facilitates access to a wide range of pest-related information
+collected and maintained by EPPO, allowing users to query, retrieve, and
+process this data directly from Python.
+
+The package is intended for researchers, analysts, and practitioners in plant
+protection who require convenient programmatic access to EPPO data.
+
+## Installation
+
+### From PyPi
+
+```
+pip install eppopynder
+```
+
+### Development version
+
+To install the latest development version:
+
+```
+pip install git+https://github.com/openefsa/eppoPynder.git
+```
+
+## Requirements
+
+An active internet connection is required, as the package communicates with
+EPPO's online services to fetch and process data.
+
+## Usage
+
+Once installed, load the package as usual:
+
+```python
+from eppopynder import *
+```
+
+Basic usage examples and full documentation are available in the package
+[guide](docs/guide.md).
+
+## Authors and maintainers
+
+- **Lorenzo Copelli** (author, [ORCID](https://orcid.org/0009-0002-4305-065X)).
+- **Dayana Stephanie Buzle** (author, [ORCID](https://orcid.org/0009-0003-2990-7431)).
+- **Rafael Vieira** (author, [ORCID](https://orcid.org/0009-0009-0289-5438)).
+- **Agata Kaczmarek** (author, [ORCID](https://orcid.org/0000-0002-7463-5821)).
+- **Luca Belmonte** (author, maintainer, [ORCID](https://orcid.org/0000-0002-7977-9170)).
+
+## Links
+
+- **Homepage**: [GitHub](https://github.com/openefsa/eppoPynder).
+- **Bug Tracker**: [Issues on GitHub](https://github.com/openefsa/eppoPynder/issues).
+- **EPPO Database**: [https://gd.eppo.int](https://gd.eppo.int).