From 55145754f185ab12644244f37cfc795d42bb9c32 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Mon, 13 Jan 2025 15:13:58 +0100 Subject: [PATCH 01/43] Transferred all files from Azure to GitHub --- MANIFEST.in | 3 + README.md | 301 +++++++++++++++++++ pyproject.toml | 3 + requirements.txt | Bin 0 -> 670 bytes setup.py | 48 +++ src/eppoPynder/__init__.py | 0 src/eppoPynder/api_query.py | 78 +++++ src/eppoPynder/data_dump.py | 75 +++++ src/eppoPynder/getting_countries.py | 106 +++++++ src/eppoPynder/query_the_eppo_for_service.py | 82 +++++ src/eppoPynder/query_the_whole_eppo.py | 64 ++++ src/eppoPynder/taxonomy_ranked.py | 34 +++ src/eppoPynder/unnest_lists.py | 25 ++ tests/test_api_query.py | 21 ++ tests/test_data_dump.py | 41 +++ tests/test_getting_countries.py | 96 ++++++ tests/test_query_the_eppo_for_service.py | 28 ++ tests/test_query_the_whole_eppo.py | 25 ++ tests/test_taxonomy_ranked.py | 53 ++++ tests/test_unnest_lists.py | 70 +++++ 20 files changed, 1153 insertions(+) create mode 100644 MANIFEST.in create mode 100644 README.md create mode 100644 pyproject.toml create mode 100644 requirements.txt create mode 100644 setup.py create mode 100644 src/eppoPynder/__init__.py create mode 100644 src/eppoPynder/api_query.py create mode 100644 src/eppoPynder/data_dump.py create mode 100644 src/eppoPynder/getting_countries.py create mode 100644 src/eppoPynder/query_the_eppo_for_service.py create mode 100644 src/eppoPynder/query_the_whole_eppo.py create mode 100644 src/eppoPynder/taxonomy_ranked.py create mode 100644 src/eppoPynder/unnest_lists.py create mode 100644 tests/test_api_query.py create mode 100644 tests/test_data_dump.py create mode 100644 tests/test_getting_countries.py create mode 100644 tests/test_query_the_eppo_for_service.py create mode 100644 tests/test_query_the_whole_eppo.py create mode 100644 tests/test_taxonomy_ranked.py create mode 100644 tests/test_unnest_lists.py diff --git a/MANIFEST.in b/MANIFEST.in new file mode 100644 index 0000000..1632008 --- /dev/null +++ b/MANIFEST.in @@ -0,0 +1,3 @@ +# Exclude the following Python files +exclude eppoPynder/api_query.py +exclude eppoPynder/unnest_lists.py \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..d2aad7b --- /dev/null +++ b/README.md @@ -0,0 +1,301 @@ +# eppoPynder + +## Overview + +Welcome to the *eppoPynder* package! This package is a wrapper around the public APIs of the European and Mediterranean Plant Protection Organization (EPPO) database. It provides a straightforward way to access a wide range of pest-specific information that has been produced or collected by EPPO. + +*eppoPynder* is designed for use by researchers and practitioners working in plant protection who need easy access to the EPPO database using Python. + +## Prerequisites + +To use the *eppoPynder* package, you need a stable internet connection, as it interacts with the EPPO database online services to fetch and manipulate data. A reliable internet connection is essential for the functionality of the package. + +## Installation + +You can install the *eppoPynder* package from PyPi using the following command: + +``` +pip install eppoPynder +``` + +Alternatively, if you want to install the package from GitHub (for the latest development version), use: + +``` +pip install git+https://github.com/openefsa/eppoPynder.git +``` + +## Working with API Tokens + +The *eppoPynder* package requires your unique token to be included in each API request for proper functionality. There are three ways to provide this token: + +1. **Using the `.env` file** +2. **Manually adding it to each API request** + +### 1. Setting Environment Variables via `.env` + +The `.env` file is used to specify environment variables that Python loads at the start of every session. It is particularly useful for setting variables, such as API keys, that can be accessed by Python scripts and functions. + +After installing the *eppoPynder* package, you should create a `.env` file in your project's root directory (i.e., the same directory as `setup.py`). This is important because the `python-dotenv` package expects the `.env` file to be in this location by default. + +#### Example Project Structure: + +``` +/eppoPynder + ├── .env # Place your .env file here + ├── setup.py + ├── src/ + │ └── eppoPynder/ + │ └── __init__.py + │ └── module.py + └── README.md +``` + +You can create or modify the `.env` file manually using any text editor. In the `.env` file, you set environment variables in the following format: + +`EPPO_token=your-eppo-token` + +After adding your EPPO token to the `.env` file, save and close the file. Python will automatically read the token when it starts up, and you can access it in any Python session using `os.getenv('EPPO_token')`. + +### 2. Manually adding your token to each API request + +For functions that require an API token, you can manually specify the token in the `token` argument of the function. This method is useful if you want to use different tokens for different function calls or if you don't want to store the token globally. For example: + +`query_the_eppo_for_service(queried_eppocode = "BEMITA", service = "general", token = "your-eppo-token")` + +#### Explanation: + +`query_the_eppo_for_service(queried_eppocode = "BEMITA", service = "general", token = "your-eppo-token")`: This calls the function with the necessary parameters: + +- `queried_eppocode = "BEMITA"`: The EPPO code for which you want to query a service. +- `service = "general"`: Specifies the service you want to query (you can replace this with any valid service type). +- `token = "your-eppo-token"`: Passes the token for authentication. Replace "your-eppo-token" with your actual EPPO token enclosed in quotes. + +## Basic Usage + +The primary functionality of *eppoPynder* is to query the EPPO database for specific EPPO codes and retrieve data across various services. Users can either choose to: 1) query a single service for a given EPPO code or 2) query all available services in the database for more comprehensive information. + +For plant and pest species, the basic available information includes scientific names, synonyms, common names in different languages, and taxonomic position. For each pest of regulatory interest, more detailed information can also be retrieved regarding its host plants and categorization (quarantine status). + +The examples below will guide you on how to use the functions in this package to access these data, but to begin, we need to load the *eppoPynder* package with this command: + +``` +import eppoPynder +``` + +If you want to learn more about the arguments and usage of a particular function, you can use Python's built-in `help()` function. Simply run: + +``` +help(function_name) +``` + +This will display the detailed documentation for the function, including its arguments, return values, and examples. + +For example, if you're working with a function called `query_the_eppo_for_service()`, you would use: + +``` +help(query_the_eppo_for_service) +``` + +## Querying a Specific Service + +To query a specific service (e.g., categorization) for an EPPO code (e.g., "BEMITA"), you can use the `query_the_eppo_for_service()` function as follows: + +``` +categorization_BEMITA = query_the_eppo_for_service("BEMITA", service = "categorization") +``` + +### Expected Output: + +``` +>>> categorization_BEMITA + nomcontinent isocode ... queried_on queried_url +0 America CL ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +1 Asia BH ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +2 Asia KZ ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +3 Europe AZ ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +4 Europe BY ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +5 Europe GE ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +6 Europe MD ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +7 Europe NO ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +8 Europe RU ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +9 Europe RS ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +10 Europe CH ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +11 Europe TR ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +12 Europe UA ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +13 Europe GB ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +14 Oceania NZ ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +15 RPPO/EU 9M ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +16 RPPO/EU 9A ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +17 RPPO/EU 9L ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +18 RPPO/EU 9L ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +19 RPPO/EU 9H ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... + +[20 rows x 11 columns] +``` + +`categorization_BEMITA` is a dataframe containing information about the categorization of the EPPO code "BEMITA", and includes the following columns: + +- **nomcontinent**: The continent where the country is located. +- **isocode**: The ISO country code. +- **country**: The name of the country or region. +- **qlist**: A code representing the pest status or classification. +- **qlistlabel**: A label explaining the pest classification (e.g., "A1 list" or "Quarantine pest"). +- **yr_add**: The year the country was added to the list. +- **yr_del**: The year the country was removed (if applicable). +- **yr_trans**: The year the country transitioned (if applicable). +- **queried_eppocode**: The input EPPO code. +- **queried_on**: The date when the query was performed. +- **queried_url**: The queried URL. + +## Querying All Available Services + +If you wish to query all available services for the EPPO code "BEMITA", you can use the `query_the_whole_eppo()` function. This will return a dictionary of dataframes, each corresponding to a different service. + +``` +result_dict = query_the_whole_eppo("BEMITA") +``` + +### Expected Output: + +``` +# Print the names of the services in the result + +>>> result_dict.keys() +dict_keys(['general', 'names', 'taxonomy', 'categorization', 'hosts', 'pests', 'kingdom']) +``` + +`result_dict.keys()` returns the names of the services: general, names, taxonomy, categorization, hosts, pests, and kingdom. + +``` +# Print the data from a specific service, e.g., categorization + +>>> result_dict["categorization"] + nomcontinent isocode ... queried_on queried_url +0 America CL ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +1 Asia BH ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +2 Asia KZ ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +3 Europe AZ ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +4 Europe BY ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +5 Europe GE ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +6 Europe MD ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +7 Europe NO ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +8 Europe RU ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +9 Europe RS ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +10 Europe CH ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +11 Europe TR ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +12 Europe UA ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +13 Europe GB ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +14 Oceania NZ ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +15 RPPO/EU 9M ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +16 RPPO/EU 9A ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +17 RPPO/EU 9L ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +18 RPPO/EU 9L ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +19 RPPO/EU 9H ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... + +[20 rows x 11 columns] +``` + +Accessing a specific service (e.g., `result_dict["categorization"]`) will show the data related to that particular service for the EPPO code "BEMITA". + +## Wrangling Data + +The *eppoPynder* package also provides a data wrangling function, `taxonomy_ranked()`, which can combine the data fetched from the "taxonomy" and "kingdom" EPPO services to create a unified, integrated dataframe. + +For example, assume you have two dataframes: `taxonomy` and `kingdom`, which were obtained by querying the "taxonomy" and "kingdom" services for the EPPO code "BEMITA" using the `query_the_eppo_for_service()` function. + +You can combine these two dataframes as follows: + +``` +# Query the taxonomy service for the EPPO code "BEMITA" +taxonomy = query_the_eppo_for_service("BEMITA", service = "taxonomy") + +# Query the kingdom service for the EPPO code "BEMITA" +kingdom = query_the_eppo_for_service("BEMITA", service = "kingdom") + +# Combine taxonomy and kingdom data +wrangled_data = taxonomy_ranked(taxonomy, kingdom) +``` + +### Expected Output: + +``` +>>> wrangled_data + rank codeid ... queried_on queried_url +0 kingdom 57021 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +1 57200 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +2 77963 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +3 59061 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +4 58830 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +5 73260 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +6 56905 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +7 57321 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +8 5935 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... + +[9 rows x 8 columns] +``` + +`wrangled_data` is a dataframe that combines the taxonomy and kingdom information for the EPPO code "BEMITA". This integration provides a more comprehensive view of the organism's taxonomic rank. + +Specifically, the output dataframe contains the following columns: + +- **rank**: The taxonomic rank. +- **codeid**: A unique identifier for each entry. +- **eppocode**: The EPPO code representing the taxonomic group. +- **prefname**: The preferred name of the taxonomic group (e.g., "Animalia", "Insecta"). +- **level**: The taxonomic level in the hierarchy (1 for the broadest category, progressing to more specific levels). +- **queried_eppocode**: The input EPPO code. +- **queried_on**: The date when the query was performed. +- **queried_url**: The queried URL. + +## Retrieving Countries in Regional Plant Protection Organizations + +The `getting_countries()` function allows you to retrieve all the member countries of a specific Regional Plant Protection Organization (RPPO). + +For example, to get the member countries of the EAEU (Eurasian Economic Union), you can use the following command: + +``` +EAEU_countries = getting_countries('EAEU') +``` + +### Expected Output: + +``` +>>> EAEU_countries +'Armenia, Belarus, Kazakhstan, Kyrgyzstan, Russia' +``` + +`EAEU_countries` is a string of country names that are members of the EAEU. + +## Data Dump for Multiple EPPO Codes + +The `data_dump()` function allows you to retrieve a comprehensive data dump for multiple EPPO codes. This function queries all available EPPO services for a list of input codes. + +The following is an example of how the function can be used to query all available EPPO services for the EPPO codes "APHIPO" and "LEUCSC": + +``` +data_dump_result = data_dump(["APHIPO", "LEUCSC"]) +``` + +### Expected Output: + +``` +# Print the names of the services in the result + +>>> data_dump_result.keys() +dict_keys(['general', 'names', 'taxonomy', 'categorization', 'hosts', 'pests', 'kingdom']) +``` + +The output is a dictionary of dataframes, each corresponding to a different service: general, names, taxonomy, categorization, hosts, pests, and kingdom. + +``` +# Print the data from a specific service, e.g., general + +>>> data_dump_result["general"] + pestCode ... queried_url +0 APHIPO ... https://data.eppo.int/api/rest/1.0/taxon/APHIP... +0 LEUCSC ... https://data.eppo.int/api/rest/1.0/taxon/LEUCS... + +[2 rows x 20 columns] +``` + +Accessing a specific service (e.g., `data_dump["general"]`) will show the data related to that particular service for the EPPO codes "APHIPO" and "LEUCSC". The column `queried_eppocode` in the dataframe distinguishes which data have been retrieved for each EPPO code. \ No newline at end of file diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..fa7093a --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,3 @@ +[build-system] +requires = ["setuptools>=42"] +build-backend = "setuptools.build_meta" \ No newline at end of file diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000000000000000000000000000000000000..2955c1ed79038af327b83e1022a55c15f1ffeb63 GIT binary patch literal 670 zcmY+B+fKtU42FG;#G|ZQTiD=&hbd)r5v3VxI>8qwRNfP9p z{lY3_%YKkdp4cUS_i`t-9Hj!;gHN)NP9lGw+_mtorlRZ;j&dhfq^`)yu!`7@h~20g z6NX1=D+XGDj4#jCwD8J$`9E$R)+)m8bC?au0%cu&t)x!%i#tJR}r- zn!KJ(EhB$4owf3HL`}0QEb$qYFLc~@NnNgT`veD66S_Jd$L%e>cG!J-vV5D1zAU$i ncqK7!?Mh;M*4q>V^KMx|Ug`Dpnsw)HUmsCAFoDbL<`et}_}5|Y literal 0 HcmV?d00001 diff --git a/setup.py b/setup.py new file mode 100644 index 0000000..4750527 --- /dev/null +++ b/setup.py @@ -0,0 +1,48 @@ +from setuptools import setup, find_packages + +setup( + name='eppoPynder', + version='1.0.0', + description='A Wrapper for EPPO Codes', + long_description='The eppoPynder package provides a wrapper around the European and Mediterranean Plant Protection Organization (EPPO) database public APIs. It enables users to retrieve EPPO-related data through searches across the entire EPPO database or by utilizing specific services, including categorization, taxonomy, and more. The package also includes a data wrangling function to integrate taxonomy and rank information, and a function that returns the list of member countries for each Regional Plant Protection Organization acronym which is used in the EPPO database.', + long_description_content_type='text/markdown', + author='Luca Belmonte, Dayana Stephanie Buzle, Rafael Vieira, Agata Kaczmarek', + author_email='luca.belmonte@efsa.europa.eu', + maintainer='Luca Belmonte', + maintainer_email='luca.belmonte@efsa.europa.eu', + url='https://github.com/openefsa/eppoPynder', + project_urls={ + 'Luca Belmonte ORCID': 'https://orcid.org/0000-0002-7977-9170', + 'Dayana Stephanie Buzle ORCID': 'https://orcid.org/0009-0003-2990-7431', + 'Agata Kaczmarek ORCID': 'https://orcid.org/0000-0002-7463-5821', + } + license='GPL-3.0', + packages=find_packages(where='src'), + package_dir={'': 'src'}, + install_requires=[ + 'numpy>=2.1.3', + 'pandas>=2.2.3', + 'python-dateutil>=2.9.0.post0', + 'requests>=2.32.3', + 'certifi>=2024.8.30', + 'charset-normalizer>=3.4.0', + 'idna>=3.10', + 'urllib3>=2.2.3', + 'pytz>=2024.2', + 'tzdata>=2024.2', + 'python-dotenv>=1.0.0' + ], + extras_require={ + 'dev': [ + 'setuptools>=75.3.0', + 'coverage>=7.6.4', + 'colorama>=0.4.6', + 'pytest>=8.3.3', + 'iniconfig>=2.0.0', + 'pluggy>=1.5.0', + 'packaging>=24.1', + 'six>=1.16.0' + ], + }, + python_requires='>=3.11' + ) \ No newline at end of file diff --git a/src/eppoPynder/__init__.py b/src/eppoPynder/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/src/eppoPynder/api_query.py b/src/eppoPynder/api_query.py new file mode 100644 index 0000000..8252228 --- /dev/null +++ b/src/eppoPynder/api_query.py @@ -0,0 +1,78 @@ +import numpy as np +import pandas as pd +import requests +from datetime import date + +from eppoPynder.unnest_lists import unnest_lists + +def api_query(queried_eppocode, queried_url): + """ + Query the EPPO database via REST API to retrieve basic information, + all names, taxonomy, categorization, hosts, pests, or kingdom data about an EPPO code. + + Parameters + ---------- + queried_eppocode : str + A single EPPO code. EPPO codes are unique computer codes developed for plants and pests + (including pathogens) important in agriculture and plant protection. These codes + facilitate the management of plant and pest names in databases and enable data exchange + between IT systems. Each EPPO code consists of 5 to 6 letters, often mnemonic + abbreviations of the scientific name of the organism, and can be freely downloaded + from the EPPO Data Services platform at https://data.eppo.int/. + + queried_url : str + The URL to query. The URL should be in the format: + https://data.eppo.int/api/rest/1.0/taxon/queriedEppocode?authtoken=xxxxxxxxxxxxxxxxxxx + Replace "queriedEppocode" with the EPPO code of interest and add your unique token using the "authtoken" parameter. + + Returns + ------- + df : pd.DataFrame + A dataframe containing the contents of the request converted from JSON. + Based on the query, the output dataframe will contain basic information, all names, + taxonomy, categorization, hosts, pests, or kingdom data about the input EPPO code. + The dataframe will also include the following columns: + - queried_eppocode: The EPPO code requested. + - queried_on: The date when the query was performed. + - queried_url: The URL that was queried. + + Examples + -------- + # Get basic information about Bemisia tabaci: + queried_eppocode = "BEMITA" + queried_url = "https://data.eppo.int/api/rest/1.0/taxon/BEMITA?authtoken=xxxxxxxxxxxxxxxxxxx" + api_query(queried_eppocode, queried_url) + + # Get taxonomy data about Bemisia tabaci: + queried_eppocode = "BEMITA" + queried_url = "https://data.eppo.int/api/rest/1.0/taxon/BEMITA/taxonomy?authtoken=xxxxxxxxxxxxxxxxxxx" + api_query(queried_eppocode, queried_url) + + # Get all names about Aphis pomi: + queried_eppocode = "APHIPO" + queried_url = "https://data.eppo.int/api/rest/1.0/taxon/APHIPO/names?authtoken=xxxxxxxxxxxxxxxxxxx" + api_query(queried_eppocode, queried_url) + """ + assert isinstance(queried_eppocode, str), "queried_eppocode must be a string!" + assert isinstance(queried_url, str), "queried_url must be a string!" + + df = pd.DataFrame() + + try: + requested_service = requests.get(queried_url) + requested_service.raise_for_status() + json_response = requested_service.json() + data = unnest_lists(json_response) + df = pd.json_normalize(data) + + except (requests.exceptions.MissingSchema, requests.exceptions.InvalidURL) as e: + print(f"{e}") + except requests.exceptions.HTTPError as e: + print(f"HTTP error: {e}") + + finally: + df['queried_eppocode'] = pd.Series([queried_eppocode for i in range(len(df)+1)]) + df['queried_on'] = pd.Series([str(date.today()) for i in range(len(df)+1)]) + df['queried_url'] = pd.Series([queried_url for i in range(len(df)+1)]) + + return df diff --git a/src/eppoPynder/data_dump.py b/src/eppoPynder/data_dump.py new file mode 100644 index 0000000..68ecf83 --- /dev/null +++ b/src/eppoPynder/data_dump.py @@ -0,0 +1,75 @@ +from eppoPynder.query_the_eppo_for_service import query_the_eppo_for_service +import pandas as pd +import os +from dotenv import load_dotenv + +# Load environment variables from a .env file (if present) +load_dotenv() + +def data_dump(codes_to_scan, token = os.getenv('EPPO_token')): + """ + Create a dump of the whole EPPO database via REST API for one or more EPPO code(s). + + Parameters + ---------- + codes_to_scan : list of str + One or more EPPO code(s) as a list of strings. + + token : str, optional + Manually add your unique token or set it inside a .env file. + Default is retrieved from the environment variable EPPO_token using os.getenv('EPPO_token'). + + Returns + ------- + dump : dict of {str : pd.DataFrame} + A dictionary of pandas dataframes, each containing basic information, all names, taxonomy, categorization, hosts, pests and kingdom data about the input EPPO code, respectively. + The dataframes will also include the following columns: + - queried_eppocode: The EPPO code requested. + - queried_on: The date when the query was performed. + - queried_url: The URL that was queried. + + Examples + -------- + # Create a dump of all data about Bemisia tabaci: basic information, all names, taxonomy, categorization, hosts, pests and kingdom data. + data_dump(["BEMITA"]) + + # Create a dump of all data about Aphis pomi and Leucoptera malifoliella: basic information, all names, taxonomy, categorization, hosts, pests and kingdom data. + data_dump(["APHIPO", "LEUCSC"]) + """ + # Ensure the token is available + if not token: + raise ValueError("EPPO token is required. Please provide a valid token.") + + # Add input validation + assert isinstance(token, str), "Token must be a string!" + if not isinstance(codes_to_scan, list): + raise AssertionError("Input must be a list!") + if not codes_to_scan: + raise AssertionError("Input list cannot be empty!") + if not all(isinstance(code, str) for code in codes_to_scan): + raise AssertionError("All codes must be strings!") + + general = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="", token=token) for i in codes_to_scan]) + general.insert(0, "pestCode", general[["queried_eppocode"]], True) + + names = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="names", token=token) for i in codes_to_scan]) + names.insert(0, "pestCode", names[["queried_eppocode"]], True) + + taxonomy = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="taxonomy", token=token) for i in codes_to_scan]) + taxonomy.insert(0, "pestCode", taxonomy[["queried_eppocode"]], True) + + categorization = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="categorization", token=token) for i in codes_to_scan]) + categorization.insert(0, "pestCode", categorization[["queried_eppocode"]], True) + + hosts = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="hosts", token=token) for i in codes_to_scan]) + hosts.insert(0, "pestCode", hosts[["queried_eppocode"]], True) + + pests = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="pests", token=token) for i in codes_to_scan]) + pests.insert(0, "pestCode", pests[["queried_eppocode"]], True) + + kingdom = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="kingdom", token=token) for i in codes_to_scan]) + kingdom.insert(0, "pestCode", kingdom[["queried_eppocode"]], True) + + dump = {"general":general, "names":names, "taxonomy":taxonomy, "categorization":categorization, "hosts":hosts, "pests":pests, "kingdom":kingdom} + + return dump diff --git a/src/eppoPynder/getting_countries.py b/src/eppoPynder/getting_countries.py new file mode 100644 index 0000000..077318b --- /dev/null +++ b/src/eppoPynder/getting_countries.py @@ -0,0 +1,106 @@ +import numpy as np + +def getting_countries(acronym): + """ + Function to translate the acronyms of the Regional Plant Protection Organizations used in the EPPO database to the corresponding member countries. + + Parameters + ---------- + acronym : str + The acronym of the Regional Plant Protection Organization. + + Returns + ------- + countries : str + All the member countries. + + Examples + -------- + getting_countries('OIRSA') + """ + assert isinstance(acronym, str), "acronym must be a string!" + + if acronym == 'EPPO': + countries = ", ".join([ + 'Albania', 'Algeria', 'Austria', 'Azerbaijan', 'Belarus', 'Belgium', + 'Bosnia and Herzegovina', 'Bulgaria', 'Croatia', 'Cyprus', 'Czech Republic', + 'Denmark', 'Estonia', 'Finland', 'France', 'Georgia', 'Germany', 'Greece', + 'Guernsey', 'Hungary', 'Ireland', 'Israel', 'Italy', 'Jersey', 'Jordan', + 'Kazakhstan', 'Kyrgyzstan', 'Latvia', 'Lithuania', 'Luxembourg', 'Malta', + 'Moldova', 'Montenegro', 'Morocco', 'Netherlands', 'North Macedonia', 'Norway', + 'Poland', 'Portugal', 'Romania', 'Russia', 'Serbia', 'Slovakia', 'Slovenia', + 'Spain', 'Sweden', 'Switzerland', 'Tunisia', 'Türkiye', 'Ukraine', 'United Kingdom', + 'Uzbekistan' + ]) + elif acronym == 'OIRSA': + countries = ", ".join([ + 'Belize', 'Costa Rica', 'Dominican Republic', 'El Salvador', 'Guatemala', + 'Honduras', 'Mexico', 'Nicaragua', 'Panama' + ]) + elif acronym == 'EAEU': + countries = ", ".join([ + 'Armenia', 'Belarus', 'Kazakhstan', 'Kyrgyzstan', 'Russia' + ]) + elif acronym == 'COSAVE': + countries = ", ".join([ + 'Argentina', 'Bolivia', 'Brazil', 'Chile', 'Paraguay', 'Peru', 'Uruguay' + ]) + elif acronym == 'EU': + countries = ", ".join([ + 'Austria', 'Belgium', 'Bulgaria', 'Croatia', 'Cyprus', 'Czech Republic', + 'Denmark', 'Estonia', 'Finland', 'France', 'Germany', 'Greece', 'Hungary', + 'Ireland', 'Italy', 'Latvia', 'Lithuania', 'Luxembourg', 'Malta', 'Netherlands', + 'Poland', 'Portugal', 'Romania', 'Slovakia', 'Slovenia', 'Spain', 'Sweden' + ]) + elif acronym == 'APPPC': + countries = ", ".join([ + 'Australia', 'Bangladesh', 'Cambodia', 'China', 'East Timor', 'Fiji', + 'French Polynesia', 'India', 'Indonesia', "Korea Dem. People's Republic", + 'Korea, Republic', 'Laos', 'Malaysia', 'Myanmar', 'Nepal', 'New Zealand', + 'Pakistan', 'Papua New Guinea', 'Philippines', 'Samoa', 'Solomon Islands', + 'Sri Lanka', 'Thailand', 'Tonga', 'Vietnam' + ]) + elif acronym == 'CAHFSA': + countries = ", ".join([ + 'Antigua and Barbuda', 'Bahamas', 'Barbados', 'Belize', 'Dominica', 'Grenada', + 'Guyana', 'Haiti', 'Jamaica', 'Montserrat', 'Saint Lucia', 'St Kitts-Nevis', + 'St Vincent and the Grenadines', 'Suriname', 'Trinidad and Tobago' + ]) + elif acronym == 'CAN': + countries = ", ".join([ + 'Bolivia', 'Colombia', 'Ecuador', 'Peru', 'Venezuela' + ]) + elif acronym == 'IAPSC': + countries = ", ".join([ + 'Algeria', 'Angola', 'Benin', 'Botswana', 'Burkina Faso', 'Burundi', 'Cameroon', + 'Cape Verde', 'Central African Republic', 'Chad', 'Comoros', 'Congo', + 'Congo, Democratic Republic of the', "Cote d'Ivoire", 'Djibouti', 'Egypt', + 'Equatorial Guinea', 'Eritrea', 'Eswatini', 'Ethiopia', 'Gabon', 'Gambia', + 'Ghana', 'Guinea', 'Guinea-Bissau', 'Kenya', 'Lesotho', 'Liberia', 'Libya', + 'Madagascar', 'Malawi', 'Mali', 'Mauritania', 'Mauritius', 'Morocco', 'Mozambique', + 'Namibia', 'Niger', 'Nigeria', 'Rwanda', 'Sao Tome & Principe', 'Senegal', + 'Seychelles', 'Sierra Leone', 'Somalia', 'South Africa', 'South Sudan', 'Sudan', + 'Tanzania', 'Togo', 'Tunisia', 'Uganda', 'Zaire', 'Zambia', 'Zimbabwe' + ]) + elif acronym == 'NAPPO': + countries = ", ".join([ + 'Canada', 'Mexico', 'United States of America' + ]) + elif acronym == 'NEPPO': + countries = ", ".join([ + 'Algeria', 'Egypt', 'Jordan', 'Libya', 'Malta', 'Morocco', 'Pakistan', + 'South Sudan', 'Sudan', 'Syria', 'Tunisia' + ]) + elif acronym == 'PPPO': + countries = ", ".join([ + 'American Samoa', 'Australia', 'Cook Islands', 'Fiji', 'French Polynesia', + 'Guam', 'Kiribati', 'Marshall Islands', 'Micronesia', 'Nauru', 'New Caledonia', + 'New Zealand', 'Niue', 'Northern Mariana Islands', 'Palau', 'Papua New Guinea', + 'Pitcairn', 'Samoa', 'Solomon Islands', 'Tokelau', 'Tonga', 'Tuvalu', 'Vanuatu', + 'Wallis and Futuna Islands' + ]) + else: + countries = np.nan + print("Unknown acronym") + + return countries diff --git a/src/eppoPynder/query_the_eppo_for_service.py b/src/eppoPynder/query_the_eppo_for_service.py new file mode 100644 index 0000000..da49eea --- /dev/null +++ b/src/eppoPynder/query_the_eppo_for_service.py @@ -0,0 +1,82 @@ +from eppoPynder.api_query import api_query +import numpy as np +import os +from dotenv import load_dotenv + +# Load environment variables from a .env file (if present) +load_dotenv() + +def query_the_eppo_for_service(queried_eppocode, base_url = "https://data.eppo.int/api/rest/1.0/taxon/", service = "categorization", token = os.getenv('EPPO_token')): + """ + Query the EPPO database via REST API by specifying the name of the required service to retrieve + basic information, all names, taxonomy, categorization, hosts, pests, or kingdom data + about an EPPO code. + + Parameters + ---------- + queried_eppocode : str + A single EPPO code. EPPO codes are unique computer codes developed for plants and pests + (including pathogens) important in agriculture and plant protection. These codes + facilitate the management of plant and pest names in databases and enable data exchange + between IT systems. Each EPPO code consists of 5 to 6 letters, often mnemonic + abbreviations of the scientific name of the organism, and can be freely downloaded + from the EPPO Data Services platform at https://data.eppo.int/. + + base_url : str, optional + URL root for all REST API requests. Default is "https://data.eppo.int/api/rest/1.0". + + service : str, optional + The specific service to query. Choose from the following options: + - "" : basic information + - "names" : all names + - "taxonomy" : taxonomy data + - "categorization" : categorization data + - "hosts" : hosts data + - "pests" : pests data + - "kingdom" : kingdom taxonomic rank + Default is "categorization". + + token : str, optional + Manually add your unique token or set it inside a .env file. + Default is retrieved from the environment variable EPPO_token using os.getenv('EPPO_token'). + + Returns + ------- + queried_service : pd.DataFrame + A dataframe containing the contents of the request converted from JSON. + Based on the query, the output dataframe will contain basic information, all names, + taxonomy, categorization, hosts, pests, or kingdom data about the input EPPO code. + The dataframe will also include the following columns: + - queried_eppocode: The EPPO code requested. + - queried_on: The date when the query was performed. + - queried_url: The URL that was queried. + + Examples + -------- + # Get basic information about Bemisia tabaci: + query_the_eppo_for_service("BEMITA", service="") + + # Get all names for Bemisia tabaci: + query_the_eppo_for_service("BEMITA", service="names") + + # Get categorization data for Bemisia tabaci: + query_the_eppo_for_service("BEMITA", service="categorization") + """ + # Ensure the token is available + if not token: + raise ValueError("EPPO token is required. Please provide a valid token.") + + assert isinstance(queried_eppocode, str), "queried_eppocode must be a string!" + assert isinstance(base_url, str), "base_url must be a string!" + assert isinstance(service, str), "service must be a string!" + assert isinstance(token, str), "token must be a string!" + + queried_url = base_url+queried_eppocode+"/"+service+"?authtoken="+token + + if service == "": + queried_url = base_url+queried_eppocode+"?authtoken="+token + + queried_service = api_query(queried_eppocode=queried_eppocode, queried_url=queried_url) + + return queried_service + diff --git a/src/eppoPynder/query_the_whole_eppo.py b/src/eppoPynder/query_the_whole_eppo.py new file mode 100644 index 0000000..5ba88d2 --- /dev/null +++ b/src/eppoPynder/query_the_whole_eppo.py @@ -0,0 +1,64 @@ +from eppoPynder.query_the_eppo_for_service import query_the_eppo_for_service +import numpy as np +import os +from dotenv import load_dotenv + +# Load environment variables from a .env file (if present) +load_dotenv() + +def query_the_whole_eppo(queried_eppocode, base_url = "https://data.eppo.int/api/rest/1.0/taxon/", token = os.getenv('EPPO_token')): + """ + Query the EPPO database via REST API to retrieve basic information, + all names, taxonomy, categorization, hosts, pests, and kingdom data about an EPPO code. + + Parameters + ---------- + queried_eppocode : str + A single EPPO code. EPPO codes are unique computer codes developed for plants and pests + (including pathogens) important in agriculture and plant protection. These codes + facilitate the management of plant and pest names in databases and enable data exchange + between IT systems. Each EPPO code consists of 5 to 6 letters, often mnemonic + abbreviations of the scientific name of the organism, and can be freely downloaded + from the EPPO Data Services platform at https://data.eppo.int/. + + base_url : str, optional + URL root for all REST API requests. Default is "https://data.eppo.int/api/rest/1.0". + + token : str, optional + Manually add your unique token or set it inside a .env file. + Default is retrieved from the environment variable EPPO_token using os.getenv('EPPO_token'). + + Returns + ------- + EPPO_dict : dict of {str : pd.DataFrame} + A dictionary of pandas dataframes, each containing basic information, all names, taxonomy, categorization, hosts, pests and kingdom data about the input EPPO code, respectively. + The dataframes will also include the following columns: + - queried_eppocode: The EPPO code requested. + - queried_on: The date when the query was performed. + - queried_url: The URL that was queried. + + Examples + -------- + # Get all information about Bemisia tabaci: basic information, all names, taxonomy, + # categorization, hosts, pests, and kingdom data. + query_the_whole_eppo("BEMITA") + """ + # Ensure the token is available + if not token: + raise ValueError("EPPO token is required. Please provide a valid token.") + + assert isinstance(queried_eppocode, str), "queried_eppocode must be a string!" + assert isinstance(base_url, str), "base_url must be a string!" + assert isinstance(token, str), "token must be a string!" + + services = ["", "names", "taxonomy", "categorization", "hosts", "pests", "kingdom"] + + EPPO_list = [] + + for service in services: + EPPO_list.append(query_the_eppo_for_service(queried_eppocode=queried_eppocode, base_url=base_url, service=service, token=token)) + + services[0]="general" + EPPO_dict = {name: df for name, df in zip(services, EPPO_list)} + + return EPPO_dict diff --git a/src/eppoPynder/taxonomy_ranked.py b/src/eppoPynder/taxonomy_ranked.py new file mode 100644 index 0000000..1a22c66 --- /dev/null +++ b/src/eppoPynder/taxonomy_ranked.py @@ -0,0 +1,34 @@ +import numpy as np +import pandas as pd + +def taxonomy_ranked(taxonomy, kingdom): + """ + Merge taxonomy and kingdom information into a single dataframe. + + Parameters + ---------- + taxonomy : pd.DataFrame + A pandas dataframe containing taxonomy data about the queried EPPO code. + + kingdom : pd.DataFrame + A pandas dataframe containing kingdom data about the queried EPPO code. + + Returns + ------- + taxonomy_ranked_ : pd.DataFrame + A pandas dataframe containing taxonomy and kingdom information about the queried EPPO code. + + Examples + -------- + # Get taxonomy and kingdom data about Bemisia tabaci: + taxonomy = query_the_eppo_for_service(queried_eppocode="BEMITA", service="taxonomy") + kingdom = query_the_eppo_for_service(queried_eppocode="BEMITA", service="kingdom") + + # Merge taxonomy and kingdom information about Bemisia tabaci into a single dataframe: + taxonomy_ranked(taxonomy, kingdom) + """ + taxonomy_ranked_ = pd.merge(taxonomy, kingdom[["eppocode", "queried_eppocode", "status"]], how='left', on=["eppocode", "queried_eppocode"]) + taxonomy_ranked_ = taxonomy_ranked_.rename(columns={'status':'rank'}) + taxonomy_ranked_.insert(0, "rank", taxonomy_ranked_.pop("rank")) + taxonomy_ranked_["rank"] = np.where(taxonomy_ranked_["rank"].notnull(), "kingdom", pd.NA) + return taxonomy_ranked_ diff --git a/src/eppoPynder/unnest_lists.py b/src/eppoPynder/unnest_lists.py new file mode 100644 index 0000000..aeda42c --- /dev/null +++ b/src/eppoPynder/unnest_lists.py @@ -0,0 +1,25 @@ +def unnest_lists(json_response): + """ + Unnest nested lists and dictionaries in a JSON dictionary of host data retrieved from EPPO. + + Parameters + ---------- + json_response : dict + A JSON dictionary of nested lists and dictionaries containing the contents of a request. + + Returns + ------- + json_response : list + A list of JSON dictionaries containing the contents of a request. + """ + if type(json_response) is dict and len(json_response)>0 and ("Major host" in json_response or "Host" in json_response or "Wild/Weed" in json_response or "Alternate" in json_response or "Experimental" in json_response or "Doubtful host" in json_response or "Non-host" in json_response): + unnest_hosts = (json_response.get("Major host") if json_response.get("Major host") is not None else []) + \ + (json_response.get("Host") if json_response.get("Host") is not None else []) + \ + (json_response.get("Wild/Weed") if json_response.get("Wild/Weed") is not None else []) + \ + (json_response.get("Alternate") if json_response.get("Alternate") is not None else []) + \ + (json_response.get("Experimental") if json_response.get("Experimental") is not None else []) + \ + (json_response.get("Doubtful host") if json_response.get("Doubtful host") is not None else []) + \ + (json_response.get("Non-host") if json_response.get("Non-host") is not None else []) + json_response = unnest_hosts + + return json_response diff --git a/tests/test_api_query.py b/tests/test_api_query.py new file mode 100644 index 0000000..f0d6397 --- /dev/null +++ b/tests/test_api_query.py @@ -0,0 +1,21 @@ +import unittest +from unittest.mock import patch, MagicMock +import pandas as pd +import requests +from datetime import date +from eppoPynder.api_query import api_query + +class TestApiQuery(unittest.TestCase): + + def test_if_wrong_service_is_requested_standard_df_returned(self): + """Test successful API response""" + result = api_query("BEMITA", "https://data.eppo.int/api/rest/1.0/taxon/BEMITA?authtoken=token") + self.assertIn('queried_url', result.columns) + self.assertEqual(result.iloc[0,0], 'BEMITA') + + @patch('builtins.print') + @patch('requests.get') + def test_missing_schema_print(self, mock_get, mock_print): + mock_get.side_effect = requests.exceptions.InvalidURL() + api_query("BEMITA", "https://data.eppo.int/api/rest/1.0/taxon/BEMITA?authtoken=token ") + mock_print.assert_called_once_with('') \ No newline at end of file diff --git a/tests/test_data_dump.py b/tests/test_data_dump.py new file mode 100644 index 0000000..442c7f6 --- /dev/null +++ b/tests/test_data_dump.py @@ -0,0 +1,41 @@ +import unittest + +from eppoPynder.data_dump import data_dump + +class DataDumpEppo(unittest.TestCase): + + def test_data_dump(self): + # Call the function being tested + result = data_dump(["BEMITA", "LEUCSC"]) + + # Ensure the dictionary contains the expected keys + services = ["general", "names", "taxonomy", "categorization", + "hosts", "pests", "kingdom"] + + self.assertTrue( + set(services).issubset(result.keys()), + "The keys in the dictionary do not match the expected services.") + + def test_input_type_validation(self): + with self.assertRaises(AssertionError) as context: + data_dump("not_a_list") + self.assertEqual(str(context.exception), "Input must be a list!") + + with self.assertRaises(AssertionError) as context: + data_dump([]) + self.assertEqual(str(context.exception), "Input list cannot be empty!") + + with self.assertRaises(AssertionError) as context: + data_dump(["BEMITA", 123]) + self.assertEqual(str(context.exception), "All codes must be strings!") + + def test_missing_token(self): + # Test when token is None + with self.assertRaises(ValueError) as context: + data_dump(["BEMITA"], token=None) + self.assertEqual(str(context.exception), "EPPO token is required. Please provide a valid token.") + + # Test when token is an empty string + with self.assertRaises(ValueError) as context: + data_dump(["BEMITA"], token="") + self.assertEqual(str(context.exception), "EPPO token is required. Please provide a valid token.") diff --git a/tests/test_getting_countries.py b/tests/test_getting_countries.py new file mode 100644 index 0000000..100b973 --- /dev/null +++ b/tests/test_getting_countries.py @@ -0,0 +1,96 @@ +import unittest +import numpy as np +from io import StringIO +import sys + +from eppoPynder.getting_countries import getting_countries + +class TestGettingCountries(unittest.TestCase): + + def test_EPPO(self): + """Test if a concatenation of countries corresponding to the acronym 'EPPO' is returned.""" + result = getting_countries("EPPO") + expected = "Albania, Algeria, Austria, Azerbaijan, Belarus, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Georgia, Germany, Greece, Guernsey, Hungary, Ireland, Israel, Italy, Jersey, Jordan, Kazakhstan, Kyrgyzstan, Latvia, Lithuania, Luxembourg, Malta, Moldova, Montenegro, Morocco, Netherlands, North Macedonia, Norway, Poland, Portugal, Romania, Russia, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, Tunisia, Türkiye, Ukraine, United Kingdom, Uzbekistan" + self.assertEqual(result, expected) + + def test_OIRSA(self): + """Test if a concatenation of countries corresponding to the acronym 'OIRSA' is returned.""" + result = getting_countries("OIRSA") + expected = "Belize, Costa Rica, Dominican Republic, El Salvador, Guatemala, Honduras, Mexico, Nicaragua, Panama" + self.assertEqual(result, expected) + + def test_EAEU(self): + """Test if a concatenation of countries corresponding to the acronym 'EAEU' is returned.""" + result = getting_countries("EAEU") + expected = "Armenia, Belarus, Kazakhstan, Kyrgyzstan, Russia" + self.assertEqual(result, expected) + + def test_COSAVE(self): + """Test if a concatenation of countries corresponding to the acronym 'COSAVE' is returned.""" + result = getting_countries("COSAVE") + expected = "Argentina, Bolivia, Brazil, Chile, Paraguay, Peru, Uruguay" + self.assertEqual(result, expected) + + def test_EU(self): + """Test if a concatenation of countries corresponding to the acronym 'EU' is returned.""" + result = getting_countries("EU") + expected = "Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden" + self.assertEqual(result, expected) + + def test_APPPC(self): + """Test if a concatenation of countries corresponding to the acronym 'APPPC' is returned.""" + result = getting_countries("APPPC") + expected = "Australia, Bangladesh, Cambodia, China, East Timor, Fiji, French Polynesia, India, Indonesia, Korea Dem. People's Republic, Korea, Republic, Laos, Malaysia, Myanmar, Nepal, New Zealand, Pakistan, Papua New Guinea, Philippines, Samoa, Solomon Islands, Sri Lanka, Thailand, Tonga, Vietnam" + self.assertEqual(result, expected) + + def test_CAHFSA(self): + """Test if a concatenation of countries corresponding to the acronym 'CAHFSA' is returned.""" + result = getting_countries("CAHFSA") + expected = "Antigua and Barbuda, Bahamas, Barbados, Belize, Dominica, Grenada, Guyana, Haiti, Jamaica, Montserrat, Saint Lucia, St Kitts-Nevis, St Vincent and the Grenadines, Suriname, Trinidad and Tobago" + self.assertEqual(result, expected) + + def test_CAN(self): + """Test if a concatenation of countries corresponding to the acronym 'CAN' is returned.""" + result = getting_countries("CAN") + expected = "Bolivia, Colombia, Ecuador, Peru, Venezuela" + self.assertEqual(result, expected) + + def test_IAPSC(self): + """Test if a concatenation of countries corresponding to the acronym 'IAPSC' is returned.""" + result = getting_countries("IAPSC") + expected = "Algeria, Angola, Benin, Botswana, Burkina Faso, Burundi, Cameroon, Cape Verde, Central African Republic, Chad, Comoros, Congo, Congo, Democratic Republic of the, Cote d'Ivoire, Djibouti, Egypt, Equatorial Guinea, Eritrea, Eswatini, Ethiopia, Gabon, Gambia, Ghana, Guinea, Guinea-Bissau, Kenya, Lesotho, Liberia, Libya, Madagascar, Malawi, Mali, Mauritania, Mauritius, Morocco, Mozambique, Namibia, Niger, Nigeria, Rwanda, Sao Tome & Principe, Senegal, Seychelles, Sierra Leone, Somalia, South Africa, South Sudan, Sudan, Tanzania, Togo, Tunisia, Uganda, Zaire, Zambia, Zimbabwe" + self.assertEqual(result, expected) + + def test_NAPPO(self): + """Test if a concatenation of countries corresponding to the acronym 'NAPPO' is returned.""" + result = getting_countries("NAPPO") + expected = "Canada, Mexico, United States of America" + self.assertEqual(result, expected) + + def test_NEPPO(self): + """Test if a concatenation of countries corresponding to the acronym 'NEPPO' is returned.""" + result = getting_countries("NEPPO") + expected = "Algeria, Egypt, Jordan, Libya, Malta, Morocco, Pakistan, South Sudan, Sudan, Syria, Tunisia" + self.assertEqual(result, expected) + + def test_PPPO(self): + """Test if a concatenation of countries corresponding to the acronym 'PPPO' is returned.""" + result = getting_countries("PPPO") + expected = "American Samoa, Australia, Cook Islands, Fiji, French Polynesia, Guam, Kiribati, Marshall Islands, Micronesia, Nauru, New Caledonia, New Zealand, Niue, Northern Mariana Islands, Palau, Papua New Guinea, Pitcairn, Samoa, Solomon Islands, Tokelau, Tonga, Tuvalu, Vanuatu, Wallis and Futuna Islands" + self.assertEqual(result, expected) + + def test_unknown_acronym(self): + """Test if np.nan and print message are returned for unknown acronyms.""" + # Capture print output + captured_output = StringIO() + sys.stdout = captured_output + + # Test unknown acronym + result = getting_countries("XYZ") + + # Reset stdout + sys.stdout = sys.__stdout__ + + # Verify results + self.assertTrue(np.isnan(result)) + self.assertEqual(captured_output.getvalue().strip(), "Unknown acronym") diff --git a/tests/test_query_the_eppo_for_service.py b/tests/test_query_the_eppo_for_service.py new file mode 100644 index 0000000..d1501a9 --- /dev/null +++ b/tests/test_query_the_eppo_for_service.py @@ -0,0 +1,28 @@ +import unittest +from unittest.mock import patch +import pandas as pd + +from eppoPynder.query_the_eppo_for_service import query_the_eppo_for_service + +class TestQueryTheEPPOForService(unittest.TestCase): + + def test_if_code_is_passed_dataframe_is_returned(self): + result = query_the_eppo_for_service("BEMITA") + self.assertTrue(isinstance(result, pd.DataFrame)) + + @patch('eppoPynder.query_the_eppo_for_service') + def test_if_wrong_service_is_requested_standard_df_returned(self, mock_query): + mock_query.return_value = pd.DataFrame(columns=['col1', 'col2', 'col3']) + result = query_the_eppo_for_service("BEMITA", service="wrongservice") + self.assertEqual(result.shape[1], 3) + + def test_missing_token(self): + # Test when token is None + with self.assertRaises(ValueError) as context: + query_the_eppo_for_service("BEMITA", token=None) + self.assertEqual(str(context.exception), "EPPO token is required. Please provide a valid token.") + + # Test when token is an empty string + with self.assertRaises(ValueError) as context: + query_the_eppo_for_service("BEMITA", token="") + self.assertEqual(str(context.exception), "EPPO token is required. Please provide a valid token.") \ No newline at end of file diff --git a/tests/test_query_the_whole_eppo.py b/tests/test_query_the_whole_eppo.py new file mode 100644 index 0000000..b081f0c --- /dev/null +++ b/tests/test_query_the_whole_eppo.py @@ -0,0 +1,25 @@ +import unittest +from eppoPynder.query_the_whole_eppo import query_the_whole_eppo + +class TestQueryTheWholeEPPO(unittest.TestCase): + + def test_getting_7_dataframes_are_returned(self): + result = query_the_whole_eppo('BEMITA') + self.assertEqual(len(result), 7) + + def test_getting_the_right_names(self): + services = ["general", "names", "taxonomy", "categorization", "hosts", "pests", "kingdom"] + result = query_the_whole_eppo('BEMITA') + + self.assertEqual(list(result.keys()), services) + + def test_missing_token(self): + # Test when token is None + with self.assertRaises(ValueError) as context: + query_the_whole_eppo("BEMITA", token=None) + self.assertEqual(str(context.exception), "EPPO token is required. Please provide a valid token.") + + # Test when token is an empty string + with self.assertRaises(ValueError) as context: + query_the_whole_eppo("BEMITA", token="") + self.assertEqual(str(context.exception), "EPPO token is required. Please provide a valid token.") \ No newline at end of file diff --git a/tests/test_taxonomy_ranked.py b/tests/test_taxonomy_ranked.py new file mode 100644 index 0000000..3f60edf --- /dev/null +++ b/tests/test_taxonomy_ranked.py @@ -0,0 +1,53 @@ +import unittest +import pandas as pd +import numpy as np + +from eppoPynder.taxonomy_ranked import taxonomy_ranked +from eppoPynder.query_the_eppo_for_service import query_the_eppo_for_service + +class TestTaxonomyRanked(unittest.TestCase): + + def test_output_is_dataframe(self): + # Get kingdom and taxonomy data + kingdom = query_the_eppo_for_service("BEMITA", service="kingdom") + taxonomy = query_the_eppo_for_service("BEMITA", service="taxonomy") + + # Debugging: Check data types of the inputs + print(f"taxonomy type: {type(taxonomy)}") + print(f"kingdom type: {type(kingdom)}") + print(f"taxonomy dtypes:\n{taxonomy.dtypes}") + + # Ensure taxonomy is a DataFrame and kingdom is valid + result = taxonomy_ranked(taxonomy, kingdom) + + # Check if the result is a DataFrame + self.assertTrue(isinstance(result, pd.DataFrame), "Result is not a dataframe") + + def setUp(self): + # Sample taxonomy DataFrame + self.taxonomy_data = { + 'eppocode': ['BEMITA', 'BEMITA', 'SOMECODE'], + 'queriedEppocode': ['BEMITA', 'BEMITA', 'SOMECODE'], + 'taxonRank': ['species', 'genus', 'family'] + } + self.taxonomy = pd.DataFrame(self.taxonomy_data) + + # Sample kingdom DataFrame + self.kingdom_data = { + 'eppocode': ['BEMITA', 'SOMECODE'], + 'queriedEppocode': ['BEMITA', 'SOMECODE'], + 'rank': ['active', 'inactive'] + } + self.kingdom = pd.DataFrame(self.kingdom_data) + + def test_empty_kingdom_dataframe(self): + # Test case where kingdom DataFrame is empty + empty_kingdom = pd.DataFrame(columns=['eppocode', 'queriedEppocode', 'status']) + result = pd.merge(self.taxonomy, empty_kingdom[["eppocode", "queriedEppocode", "status"]], how='left', on=["eppocode", "queriedEppocode"]) + + # Check if 'rank' is NaN when there is no match in kingdom data + result = result.rename(columns={'status': 'rank'}) + result.insert(0, "rank", result.pop("rank")) + result["rank"] = np.where(result["rank"].notnull(), "kingdom", pd.NA) + + self.assertTrue(result['rank'].isna().all(), "All values in 'rank' should be NaN when kingdom data is empty.") \ No newline at end of file diff --git a/tests/test_unnest_lists.py b/tests/test_unnest_lists.py new file mode 100644 index 0000000..fdd55df --- /dev/null +++ b/tests/test_unnest_lists.py @@ -0,0 +1,70 @@ +import unittest + +from eppoPynder.unnest_lists import unnest_lists + +class TestUnnestLists(unittest.TestCase): + + def test_unnest_lists_all_keys_present(self): + # Test when all keys are present and the lists are non-empty + input_data = { + "Major host": ["Host1", "Host2"], + "Host": ["Host3", "Host4"], + "Wild/Weed": ["Host5"], + "Alternate": ["Host6", "Host7"], + "Experimental": ["Host8"], + "Doubtful host": [], + "Non-host": ["Host9"] + } + expected_output = [ + "Host1", "Host2", "Host3", "Host4", "Host5", + "Host6", "Host7", "Host8", "Host9" + ] + result = unnest_lists(input_data) + self.assertEqual(result, expected_output) + + def test_unnest_lists_some_keys_missing(self): + # Test when some keys are missing + input_data = { + "Major host": ["Host1", "Host2"], + "Host": ["Host3"] + } + expected_output = ["Host1", "Host2", "Host3"] + result = unnest_lists(input_data) + self.assertEqual(result, expected_output) + + def test_unnest_lists_non_dict_input(self): + # Test when the input is not a dictionary (edge case) + input_data = ["Some", "List"] + expected_output = ["Some", "List"] + result = unnest_lists(input_data) + self.assertEqual(result, expected_output) + + def test_unnest_lists_with_empty_lists(self): + # Test when input has empty lists for some of the keys + input_data = { + "Major host": ["Host1"], + "Host": [], + "Wild/Weed": [], + "Alternate": [], + "Experimental": [], + "Doubtful host": [], + "Non-host": ["Host2"] + } + expected_output = ["Host1", "Host2"] + result = unnest_lists(input_data) + self.assertEqual(result, expected_output) + + def test_unnest_lists_with_none_values(self): + # Test when the input has None for some values of the lists + input_data = { + "Major host": None, + "Host": ["Host1"], + "Wild/Weed": None, + "Alternate": None, + "Experimental": ["Host2"], + "Doubtful host": None, + "Non-host": ["Host3"] + } + expected_output = ["Host1", "Host2", "Host3"] + result = unnest_lists(input_data) + self.assertEqual(result, expected_output) \ No newline at end of file From 2975d5077d860553c6cee9dd0d83f4768a98a060 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Wed, 15 Jan 2025 15:37:46 +0100 Subject: [PATCH 02/43] Added ORCID --- setup.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/setup.py b/setup.py index 4750527..e4cf581 100644 --- a/setup.py +++ b/setup.py @@ -14,6 +14,7 @@ project_urls={ 'Luca Belmonte ORCID': 'https://orcid.org/0000-0002-7977-9170', 'Dayana Stephanie Buzle ORCID': 'https://orcid.org/0009-0003-2990-7431', + 'Rafael Vieira ORCID': 'https://orcid.org/0009-0009-0289-5438', 'Agata Kaczmarek ORCID': 'https://orcid.org/0000-0002-7463-5821', } license='GPL-3.0', @@ -45,4 +46,4 @@ ], }, python_requires='>=3.11' - ) \ No newline at end of file + ) From 76e9d64118e16e0c84c9de1b81327b3c20555545 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Wed, 15 Jan 2025 16:30:22 +0100 Subject: [PATCH 03/43] Create temp --- docs/temp | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/temp diff --git a/docs/temp b/docs/temp new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/docs/temp @@ -0,0 +1 @@ + From c7dcb7560d93fbf0d1a2975c7b77fb13bccb4e6c Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Wed, 15 Jan 2025 16:31:43 +0100 Subject: [PATCH 04/43] pkgdown website --- docs/.nojekyll | 1 + docs/404.html | 81 +++++++++++++++ docs/apple-touch-icon.png | Bin 0 -> 23045 bytes docs/authors.html | 90 +++++++++++++++++ docs/favicon-96x96.png | Bin 0 -> 8009 bytes docs/favicon.ico | Bin 0 -> 15086 bytes docs/favicon.svg | 3 + docs/index.html | 133 ++++++++++++++++++++++++ docs/katex-auto.js | 14 +++ docs/lightswitch.js | 85 ++++++++++++++++ docs/link.svg | 12 +++ docs/logo.png | Bin 0 -> 48235 bytes docs/pkgdown.js | 162 ++++++++++++++++++++++++++++++ docs/pkgdown.yml | 6 ++ docs/search.json | 1 + docs/site.webmanifest | 21 ++++ docs/sitemap.xml | 17 ++++ docs/web-app-manifest-192x192.png | Bin 0 -> 26012 bytes docs/web-app-manifest-512x512.png | Bin 0 -> 155835 bytes 19 files changed, 626 insertions(+) create mode 100644 docs/.nojekyll create mode 100644 docs/404.html create mode 100644 docs/apple-touch-icon.png create mode 100644 docs/authors.html create mode 100644 docs/favicon-96x96.png create mode 100644 docs/favicon.ico create mode 100644 docs/favicon.svg create mode 100644 docs/index.html create mode 100644 docs/katex-auto.js create mode 100644 docs/lightswitch.js create mode 100644 docs/link.svg create mode 100644 docs/logo.png create mode 100644 docs/pkgdown.js create mode 100644 docs/pkgdown.yml create mode 100644 docs/search.json create mode 100644 docs/site.webmanifest create mode 100644 docs/sitemap.xml create mode 100644 docs/web-app-manifest-192x192.png create mode 100644 docs/web-app-manifest-512x512.png diff --git a/docs/.nojekyll b/docs/.nojekyll new file mode 100644 index 0000000..d3f5a12 --- /dev/null +++ b/docs/.nojekyll @@ -0,0 +1 @@ + diff --git a/docs/404.html b/docs/404.html new file mode 100644 index 0000000..ed5b85f --- /dev/null +++ b/docs/404.html @@ -0,0 +1,81 @@ + + + + + + + +Page not found (404) • eppoFindeR + + + + + + + + + + + + + + + Skip to contents + + +
+
+
+

Page not found (404)

+ +
+ +Content not found. Please use links in the navbar. + +
+
+ + +
+

Developed by Luca Belmonte, Dayana Stephanie Buzle, Rafael Vieira, Agata Kaczmarek.

+
+ +
+

Site built with pkgdown 2.1.1.

+
+ +
+
+ + + + + + + diff --git a/docs/apple-touch-icon.png b/docs/apple-touch-icon.png new file mode 100644 index 0000000000000000000000000000000000000000..0fea86225d7348bed950d0fd5a379e29ebdf9658 GIT binary patch literal 23045 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 Y2m9MIxR2%3!2kdN07*qoM6N<$g2ZT0ssI20 literal 0 HcmV?d00001 diff --git a/docs/authors.html b/docs/authors.html new file mode 100644 index 0000000..ff487d9 --- /dev/null +++ b/docs/authors.html @@ -0,0 +1,90 @@ + +Authors and Citation • eppoFindeR + Skip to contents + + +
+
+
+

Authors and Citation

+
+ +
+

Authors

+ +
  • +

    Luca Belmonte. Author, maintainer. +

    +
    • +
  • +

    Dayana Stephanie Buzle. Author. +

    +
    • +
  • +

    Rafael Vieira. Author. +

    +
    • +
  • +

    Agata Kaczmarek. Author. +

    +
    • +
+ +
+

Citation

+

Source: DESCRIPTION

+ +

Belmonte L, Buzle D, Vieira R, Kaczmarek A (2025). +eppoFindeR: A Wrapper for EPPO Codes. +R package version 1.0.0, https://CRAN.R-project.org/package=eppoFindeR. +

+ 
@Manual{,
+  title = {eppoFindeR: A Wrapper for EPPO Codes},
+  author = {Luca Belmonte and Dayana Stephanie Buzle and Rafael Vieira and Agata Kaczmarek},
+  year = {2025},
+  note = {R package version 1.0.0},
+  url = {https://CRAN.R-project.org/package=eppoFindeR},
+}
+
+ +
+ + +
+

Developed by Luca Belmonte, Dayana Stephanie Buzle, Rafael Vieira, Agata Kaczmarek.

+
+ +
+

Site built with pkgdown 2.1.1.

+
+ +
+ + + + + + + diff --git a/docs/favicon-96x96.png b/docs/favicon-96x96.png new file mode 100644 index 0000000000000000000000000000000000000000..ccab40ff11ceb87c3bb1111c4e24cb9cabc6e764 GIT binary patch literal 8009 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 LNkvXXu0mjfOz%C? literal 0 HcmV?d00001 diff --git a/docs/favicon.ico b/docs/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..b67f5aa84b5a43d27521f14b49c12fae36a0e1a1 GIT binary patch literal 15086 zcmd5@2Ut~Cw!TT;d-HuWZ_MPGM2&)Q=^dmamwTy#AfSK7oK&kPeEy7o@6a z#DZM{_7aUHrdVQ0H6|wczIkt6=8f@xYn_{e7eo*x&hUMQeeOAXul?_}*KYq>Mi0Yp>%Eb`tRvyD^dBw2UzgaZcSc)l{d%>tk+oo@%O;ir%a{fRp)y7 z6vBQdygduW-*ongxwkgWr!ryfnIIXrT{gK)mVng!68_|MavQpi1?-uIxu3TV7Iatu87yn&1_)&$Sr(XN}J*g%a zqwI7r_hMU@yz={J5OZoiTpK-pa;Z~fc`xz)!waRIz4@u{#e6-}ihCbGXNnEptu5=b?5yis;nzCl5%vE*=LTov{`$hb z&V4A&X-hn|`2Jt=#pS4a@L_lPKR!7(Mz7rj<;O?6^5uWH50&4Y@A};hJK5Tt^LyaA zEDh3BXV}KNqwK5Gz32UH9%c;5A1;H(=J9_gTUg|<&f&j$wu9#2e|KqcNm4YpeIIpv z9?HHu)vL@|ovlz_?dbL{uHg_8w;$?ymVTfW72lrg`YqzmI<*ZBbHZSf?+??e07&B< zq2V(E=96uZcX{s<`NeW#%9tXL<%2NZm(|G=%H`k#2~d7-x?0=YMn%W)%}*vOECBOMGEeDu*<}3fiGMkOoU( zG|3D_H=k_{nRjoe{&Aen+_m&Q4_Q*l#rUQf}zt=*oUqmn^)}} z%Dy~}(3)MCv9(T^TdN7bX^cIzgGWQlZzM*0z5@-#aOfo3!=&5`mem2!jW&k1k0$c3 z?0aS`+%C^8z8DDp#O7MeJk$yMDQlo*y$J8<#9)+h5wy+AVdzkWqU$G6MRQANuHT6JssN$4UZAf^m+%HiV@Io8-Y=D8N@ljydnSwa~xriY6WS~XiTcf_+9bG*VQ3q z?|zI4+JvERC1aG?5*S9eLc=H(xm*Ou&BI$~Tmdj>HWwjXcCnK21B9XkK7KV0{G0H(3n(iZET+5%7N{s1eg_jQJ0=Kqe_`@V!7tiT%(_*WvAGFxRU2XGLt}b$ zD~65Af;6xa2C=)L?^g>wZy!h%t}yU(hv`%=IJYl?VWA5Y8*|~fEeGbs9yFdUF`Cwf zl*1ceD*m#sRC{OMgH3Dx2)c@$Fw8y*r=sJqUvv$|D;~fwA_azVUa%+$g!TIAaNIN- z*7XT6oMi{6#@Vo35eof86PQe~MAZ*H_KP%Mh`Q=6eV+NJH#z*Q{F4r()^34S%}w09 z{{Wv{zlFf1XJIsd56o$tS}lx)ZA%8Nx04~;TMUZ@6G-pYuvs5N`wBfwZ7A&%Yj5=q zCVrNmbE*~c*|oTN>keub)!^>kyReE%f?0V0OiL!fYV|Z&kiKOt1+b{}hJLaMjB*^| zT^R%3XY_`#uV;gapU)(=X>Kro*A`~c#fUFmjRmX7)|2IMXw8OsO(5ypp61OUDE2Re z(HsZpB^bhgc`B-Z7&vxr*I?ogSey*q$x`Ts=|I;<4#R0O7$>;GFw+rEJ7>eJYCP@J zOki2#59h-bG)`>cUK~z(f3|&ZZ~ZV>_+#E%0G(;Nw1?4$-gr9KhS$pPDpdOHRKf9aQ}V47?L{S;H^1v$ZFh9C53 zKWV)w7DgGgSBUq7&89e*6pV#lyfG|lXwSPU5hZtzzYzApvY+X@RzNq@R;Bk)OW19Q zhkhE(D|Io@pJ@f72v6EyIwNpxI#Lg9K;og*!oFHvkI#EQ82S%foDBn7e=Li9VP5DC zvr-S37P`VXkM@|EPVg?8fzYajn0xl%3+uaQI|l>5W4!!D&uiNRIuhM07%L3SDxnk z?{?%O_EZU?PZpu{-U%@NxYMOVp7=8r#QC2Wcz@>qBaat!^;hcURbB07&Li*EE@XXD zkMjE}zG~)`HNrTaePf%z>!e&-iPTG~G8tDlBI<+^DHm4=c~URaT1fl|_q&QKQT26C z{9OP1uiq!$?E;cMTq@uX*b^z>WBxOuBS*j=@qP};y-3{RR`Nwu3hiMoow+jh2b6q! zT;TS_KFIm3nfh#l(3hgGfMu~hLJy}2_2u7g!=!!j$iKZu@NaP0%uniwcWp=b`&mLe zrW{G9GLProp7?|JCy=g-g=^B@SQLJF1X0J8U3v^XJQK4>|1$-BTo!a6{(d%L&g|kE zlP)X~`~pFQC5`N?;LbjD$FJh=BB&f=oqn!Lkk4EN%V*o#`JMrZX-Xi}`bx0`?;(lq&_-qei|4|EZ{o1`@?dzFKql+u~Y%cP=#`DJD;(PjjY2Mv^ z!dgbQ@S$^^Lf#j~{@$^lM%JK6P&B%I$7@L0cQ1Bk>PrWu_fBHku{@BC-;+1WJ9dvu^%m&_7+e0_Gpatg{`l5EQ{AK_buapAzNAKywdrNXTkJ5d0gsT zjM$&)+d2iau5Wp6%wl_ZKSFE#Bl5wuk&mClPF}{}D`Zo?)E}SnKB4fdCw~y z|Hq49!6RP3Boh20k&Nc_XNlx>PCF%%*EnV2^zR|3a*2epQAUa64yP2IP{`>^*Bn>+ z&;2Xp>Z#p#I3+!ZdLea^LLcj`OOK*nMLqwfcOEcWbSdZ>j5sZ}2O8fgLHnlvP;lqT zvt>R#qqD&evU)`_`~9ifLHnci*>n7RAy+a!uI+O_%KJagGk!KX-u7!+JEORc-f&QVIgi^m>705DSGAhog1MrU-Ku?j@y+9?`o6nQLwT(o zpJ|c_8cI8^F9<@If~eNio0MLsgd#DN=O^h8Za zr2E%9g=Aa2wuyhhiB_t1(=AI*jad5x=1x30s<>GhSDS!H|aO!!T6_>yuLUtvzR=)3GbK`1_O3>)bM`-$0b2#JS=vljGI9bvIP0;b9d zuvj<|)-~bePxgXUoZ}1E&tp1j)p~?2+7Hb!>nXk?32$qJLQ^jsBdw&+b~T4>eFp67 zvtYk;2JAM?fN7qBe7`0bJG<`~p8on@v=dI_Hf}&tGx?-lw^2++HFSa&LoaL{bjOh| zD0Dom=SPzdE(|VP$Ol(VzGoT_!K-p!xc%xFcn-+ibrPl-9awqr8r)Z0hw&^W#T!h9 zb!`HiTJngWm%(OjEcB)sQViqc_%(Go;{8C{FP33nu4mCw>^j(ilc!F@A|nCjl@rN- zHw6xLX)v4b3ZryeL~gI>v+XSJdFqd7P(nXkAI4E}n3Ne!u|`4UYYu@ynjOZr7Eo%1 zs8$vCCt`kDI?(#lPc%R;#t?eJHZV$bgHiH0SS<>N)sjhqPsg@72@`9x`dz0)JOi!Y ziDC@(LdcJr)7!l$i{Gi=tMaPqQExxBJkce?dvyD$8S^gvyt2S;)&}Ic}U|UO69^=ii)%d08>9dj0HU$RNIz zDj0=l@)7=s(QzP879Ol27$7TNu zKWD$u?3>$#_v-bt&w_Ezy|t5MuN3ey&%_tEhk17PF|ba!Zsy_(h|gi&=6u#9JmYpT z&&~18EQ@&==9f7?%VC_n4@>x9L0A10i+%rD;%im?_IOXnTqw6I@7C_8#&YN0Xc6iW z%X0s*9*cJ@C zua*f%Q+kWQZF031_rKlJ-@ae*-!=74U-9t+#lp5VVfVYYWp#>B zI>SD}4|l^rKg92UrW{WDYhQcg{%~+vmf_N%m}kAlZ@}LJjji+0r08n0;z6KP&BG5HVA>1L>p_3?@zREoB zJC=Kg`O& zMo-JQGv%GV`BU<*@8h|$gY)#1;8^eYHu+)JkPq-7>%Z{Rquth)%KPWxw=hi@t9iHf zJPhy1S?%27{1(dz+#8db^-04|JYQDczkrh4r;&TQ0~~Y7F%a2TT47T@35JnlkaJEI zFU@(gKCS<8Vq0v6x__F>j?1ZomH!gtob1Gm_jbZ{-eiiSeg{Ugh3 znxjRV;j^<(b|Z%CC}HG07hyH4q2s4ZabGqtFZYK5ogu}%oO0dj<@s6Oxpp{B-GE`5 zSh8eJ^3PjL)+QZR% z@p@W$-jBN#h9hWB8Y~xt&^|B%o=eFuPx}P1ET>N^A5Z6YqeK__cEkgYW#I_jQH1h) zPky(gUcT%*Rh$8*5nJaY<#ZipU)_ab`YuAfPW5}Syvp~vPS_JQ=Mlc=yoC8dKwD%g+pxSz{$_Z4_6qV<{zJ_Bv~(`z32V<<&fhL^ zS@l1UMh`Rc*&iwX=JEGQq8xq}d%E \ No newline at end of file diff --git a/docs/index.html b/docs/index.html new file mode 100644 index 0000000..e60bf53 --- /dev/null +++ b/docs/index.html @@ -0,0 +1,133 @@ + + + + + + + +A Wrapper for EPPO Codes • eppoFindeR + + + + + + + + + + + + + + + + + Skip to contents + + +
+
+
+
+

eppoFindeR +

+
+

Lifecycle: stable codecov

+
+
+

Introduction +

+

Welcome to the eppoFindeR package! This package is a wrapper around the public APIs of the European and Mediterranean Plant Protection Organization (EPPO) database. It provides a straightforward way to access a wide range of pest-specific information that has been produced or collected by EPPO.

+

eppoFindeR is designed for use by researchers and practitioners working in plant protection who need easy access to the EPPO database using R.

+
+
+

Getting Started +

+

To use the eppoFindeR package, you need a stable internet connection, as it interacts with the EPPO database online services to fetch and manipulate data. A reliable internet connection is essential for the functionality of the package.

+

You can install the eppoFindeR package from CRAN using the following command:

+
install.packages("eppoFindeR")
+

For a detailed guide and usage examples, please refer to the full vignette.

+
+ +
+
+ + +
+

Developed by Luca Belmonte, Dayana Stephanie Buzle, Rafael Vieira, Agata Kaczmarek.

+
+ +
+

Site built with pkgdown 2.1.1.

+
+ +
+
+ + + + + + + diff --git a/docs/katex-auto.js b/docs/katex-auto.js new file mode 100644 index 0000000..20651d9 --- /dev/null +++ b/docs/katex-auto.js @@ -0,0 +1,14 @@ +// https://github.com/jgm/pandoc/blob/29fa97ab96b8e2d62d48326e1b949a71dc41f47a/src/Text/Pandoc/Writers/HTML.hs#L332-L345 +document.addEventListener("DOMContentLoaded", function () { + var mathElements = document.getElementsByClassName("math"); + var macros = []; + for (var i = 0; i < mathElements.length; i++) { + var texText = mathElements[i].firstChild; + if (mathElements[i].tagName == "SPAN") { + katex.render(texText.data, mathElements[i], { + displayMode: mathElements[i].classList.contains("display"), + throwOnError: false, + macros: macros, + fleqn: false + }); + }}}); diff --git a/docs/lightswitch.js b/docs/lightswitch.js new file mode 100644 index 0000000..9467125 --- /dev/null +++ b/docs/lightswitch.js @@ -0,0 +1,85 @@ + +/*! + * Color mode toggler for Bootstrap's docs (https://getbootstrap.com/) + * Copyright 2011-2023 The Bootstrap Authors + * Licensed under the Creative Commons Attribution 3.0 Unported License. + * Updates for {pkgdown} by the {bslib} authors, also licensed under CC-BY-3.0. + */ + +const getStoredTheme = () => localStorage.getItem('theme') +const setStoredTheme = theme => localStorage.setItem('theme', theme) + +const getPreferredTheme = () => { + const storedTheme = getStoredTheme() + if (storedTheme) { + return storedTheme + } + + return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light' +} + +const setTheme = theme => { + if (theme === 'auto') { + document.documentElement.setAttribute('data-bs-theme', (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light')) + } else { + document.documentElement.setAttribute('data-bs-theme', theme) + } +} + +function bsSetupThemeToggle () { + 'use strict' + + const showActiveTheme = (theme, focus = false) => { + var activeLabel, activeIcon; + + document.querySelectorAll('[data-bs-theme-value]').forEach(element => { + const buttonTheme = element.getAttribute('data-bs-theme-value') + const isActive = buttonTheme == theme + + element.classList.toggle('active', isActive) + element.setAttribute('aria-pressed', isActive) + + if (isActive) { + activeLabel = element.textContent; + activeIcon = element.querySelector('span').classList.value; + } + }) + + const themeSwitcher = document.querySelector('#dropdown-lightswitch') + if (!themeSwitcher) { + return + } + + themeSwitcher.setAttribute('aria-label', activeLabel) + themeSwitcher.querySelector('span').classList.value = activeIcon; + + if (focus) { + themeSwitcher.focus() + } + } + + window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => { + const storedTheme = getStoredTheme() + if (storedTheme !== 'light' && storedTheme !== 'dark') { + setTheme(getPreferredTheme()) + } + }) + + window.addEventListener('DOMContentLoaded', () => { + showActiveTheme(getPreferredTheme()) + + document + .querySelectorAll('[data-bs-theme-value]') + .forEach(toggle => { + toggle.addEventListener('click', () => { + const theme = toggle.getAttribute('data-bs-theme-value') + setTheme(theme) + setStoredTheme(theme) + showActiveTheme(theme, true) + }) + }) + }) +} + +setTheme(getPreferredTheme()); +bsSetupThemeToggle(); diff --git a/docs/link.svg b/docs/link.svg new file mode 100644 index 0000000..88ad827 --- /dev/null +++ b/docs/link.svg @@ -0,0 +1,12 @@ + + + + + + diff --git a/docs/logo.png b/docs/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..739a715eb4efdccc3e35e8425122d80efec3e355 GIT binary patch literal 48235 zcmXV11yCGYlqJB&-7UC#aCg@r!Cit3?oM#GV8Mfjz~F9!ySr;}hv2rI-7TnMs%Lt5 z@4hSNoO?U!vx+P#5)l#<6cnnwoRm87_Yw-~10Dh#@JdINs09iN=E+7<^0SS(ITRFM zT-+B!YmzTGB3UhUOwh090Lst&pEbHvon3L`5#S@25*K=%WId@-* zY#2mv#4);mZ6$BL>vz*p*p{EguoTpPE`SZ8f0%lb&7Z+XJZa&qYfEkhb&Re(?q^>F z9BjCrZy+Z&GwY{q&_FX2RkG~O?$izL_w@<5b^A}D`cJVi#iuf+(taS`?SZVEU62oK zEZ#NUzgwMDewO_ZxgNGu!8by=V+r+!+h1$=4OaYl2yxNu0kKceE}MJ@tG5A4n;;kc zvUV~fi6hcjnwkE0>|5VzB>Vx@ogOT_>*Z>^5ce-I1LdgnFi&}=3e{{!$a7$$^g5_- zHAFR`j@=(;6Q=ntozW$2I|3u`%bzv3$SPKwx_*pz%N85ND=H|%w)QX=q$`m=^Dn;b zB!_Ngzj>#-m`dj|tS~l1yxhBmMh4EMUK&0bXCt`>sAr?>qmx2y?J%-b``lBJRx8^u zMvlg5Tk{NFM?N&~<9&tpKWDMB5m=n!Fa8=W&U_xTdyT18D$=K2mYXi|YRuAvGe9F8 zZj_DUHpK4!a{J_=os)sE^PL|bnJAWqO{?KbVkl6%fvyO{xX~>zVP|bfc{O?DLmniL zXzz0}S@M~INFVNxxM8vGQ14S*b`xx=L~?W+KYf$JQY4~7>-@uF>->lLt<%jOhQ~Lk zCQaM7p_9XDc8QXAs>`Y0Jr~wrsM=8iysgXKrx3q7QO$jlXOsUP@<2kF{D+;8qLBPM z-LQs5ti`l|0vh*V8l|hnP0RG0_XjHVJl>f0m_twTfj29QA6xa4{R(-!7)z5&lc15* zMF%4Re+TWDHW{tFwguNCH)<;)TNbyWmAM?3$@d=PgT-p&171CpH~0XUz>`(2Chili zF)bwjR!99l*&AUM3z1@$FLtJNg$26YT2Ihqqfq`WUTp|gaQZKQ?uSLcgNESF9->`dmGCu=+BeZd7fuPUrT+P6tpTg#KsTVfHSw+IvN z>Fu#lR6WEE4@ER(^YP#<$Bx4{Y=axDcC;w>ulR;v=6dQ-QMa%yswtBON9R|vd%+2# z;;_^aN< zmachld@po@_j--|=vx&qQ_t3;Jm0K#J1(FqL`uBw)V=8X%r>F<=0keBwN;5G%gIh| z^}QTuHlUXLI*i_*Uw!;DwU`lsh{V)UgQ^l)w)tD14{vRy85u4LCDJSt+RZe?LDvN|S*r@NV+T((p$gknngo z?kIT>fgEG(qp9PjZt6+y~HXr!*1tvU5ydba2@##`A<~uXPXm;&9PKBP5EjIjnQ@3RnLR1(~PYD8ZJHyj${0`@nOzGis>UPWY1cw_pYq&1893I$ubxA`OP zKSes?U!Cr_SRD|>*WjdgSd(##*W`oQQDUtOlebvP$XP~IGRm==pMUKcB>k3FFoTvP z1mpgi`n-(?Wk|60xrZqf13l_od&F%qg|1fHJ}z^Gg10k2?+aJEX?ufB&(TNc8B);(81S1H*Kewp49#o5bw7#EWa~eH~ zQEPP}1o5RlzmJ4OAr!jNN4KljA z&(@mUM2B##(?cCvY$jhUWpc3T?xG^u?%qViVHR=EpPt*C4OIJfx6iuZKNuH6F81hD zvXbgWF54!J&lK&pkR%Mwkgc~yOfT^7DY@(=B8_3*pq8|r=bg8z8nleH^_WHO%0jfC z)rp%WtT7%0x;o+Sf@aiABkw;1!mYvdV3p@qF06b&`}S5pb4({OG!mrB6ZzsH8`9-y ze(Gz&_U*$OW#|KM7aOHqWQ>p&*d6Zy?+~IX!iE$S`12DL#D1Fmauws=@6G6UCsjfI z<D_-Z^^*|hO}tPPa+)@{tED4)H9S~(2j;#M_;)ADb7wO? zhRp{E^vkEnbqR9qKp9XR99Cl-98!G9Rw{L+zsiS*Ac(|?BeL>-(tzDdqXe)r?9n-XxpG2}57D=(c4evcZyy}7xRX=e3uw9hP`q`C>R5syY4oQE3dDgek3Sj z%J6%0y^6yE|N zJVToCyJTW~ZJ*cju!Dz=2Q}#`?FsDc?JYN_;CPzqO%xt~>)uPu1=2xjGfXfuUmjk1 ztFSR|F*cAUDR!YxKh1U}Bdp019}F&{5W#lBRo^4u|4dDr;c7(eBl`fM#Q?XfM+U(a zVf>}lIQ>ZSC%lriAPpBo`$Rj*QFu<2>080Blb26sNFkNdo(t$AA;j{DQ3TW@b(**?V(`k=gpj$wz_{yob5x>2fNZF+Ms$KSt* zYI;$54Y?+B2)P(bH7@SzZy#TVi+9Je4ovAc$bWB9iJ$PF<|7`j=Ff*b*@5*cEWP*p zTSvl>VO&~~pJPC~-dY{^#p&Vkx_Q)iIwfvsA~E!VSku{X%jGNTzuI|cz)(?EKTgp*#x#%M2b@#-sV)(s*vSSoEFEycE-p_UDEvPd8*pqYH*e1Y|3G3IdbapC)W#aUs0W?rsDwsSe>acWyFbK;T|5s|_O? z?pu_%*_&?fTs+^Q>}z!5nlEW@?h1Y|;dq(Zr5w=G4r!I+uac4dCsH_VTqk*_&ZDuj zEb4cCZ1^Au1?)Qt!EIDZtX;bc^4}d2Ma6tx88)w7=IQaF$>tOW5J?0L{^t!)A0G5L zvvqg6F4+h7_ka0p_(*wtlda#Mg}&na`Euwe>eJx3-TH6S(0A{>MpG+&iM$lQR$soK zoViA1!aVNAH+o2vJf^YyJCF2v+{xXgQ)YOXaKd4W%SBNSJ-E)Og*UaZTItbL_SEkcZahI~QHba?!hVJSjyjlPkR|$n~^WbW50i`Yg zA5bd(XS912G-n{Wbl=}W4=$$YW5o!B_ESQbZhzt|w-0z#Rz4*rG1Io9O9DCNJ<9;` zW4X9joI!{di^7>ZZlsjfg5Zby5PSEEEtikR_4N;LXw&^+3)0f_V_O-H0%fLx8&zK^ zf?a?lbj?gw`J}6UVbJ)+UFR1b$jP^6d^7H(^#9FsyJc6-c%VjUuVOJxcw+(NmkzCC zMR>}D@l*HnDR|MVzw@1`O}Ld+YJX{WI&*%$r+WsS&|&()0wo755vdIeZESjTa=gFM zE#8_uj9a#IE3?+{8L~KR5FbL-+s-H4QDR>sV}|Yp_kfJL34aYQvRut##8~-0?e<^w zMG#<1dxkw>*ypu-ipWTJy8wMX{bfRIAZI5S4UI#kAw-cZ8GFNF&)IqBM^#ZdvL=)}*vx0e$nx>Z5?Z@UiPo0@j5 zet(31%<6)`HCCif$iN)Qg$h1BwbWH5q*?#XRQqfQLa>XG&Ltt<&4`M+wU4om+o!(d z)hiE_8F{pA>6s0@9GmY91EHZpSM_`h?96g%{qOAg6U8G`q$tce4uUJ#JpY$vO=(@S ze~6^^+P-IpDa-0kAyqF)PDXxvC-dxor0^nVpxd9Okuy<_a{HaLiC-6{39PvP)qHDH z%D(`T5QPy5CGX6Aan?{oeuj@&T3NU&S$V1Ct)O+8zvt)Y9W3na&7Q2V*RSxWLw`Zm zdk>T8gjxapIY7FMC$qm7sm2HU*~poPVC>unsX`foitTa5v?;qgLPFNo)^F1O|EntX z_8y1ja|ww3fdx`uep`5|Q|TxBWG^XtCwOrxwkYT^w|>36YK=(ui?Io}ZxGQgKyYF7 zO{eK`{Y%~BeBdJa`JSme*#s_6(8>*F>p&2*skTAZ+~Sy z-pJ>J*eD(M#BtBqx?$K{M)e0K8=DlHlv>!9Rs2sk54;fL0|16)oWS zDM8D45w`O}@&0Fh7?4KQ0K-%}a6>*v>bJJFSeYbF^sSBp=Wi~MzPojZ5K&TMRKBu< z++}PF?xaFtVp_vWc$v5@uj+I_^fOMJpe-^DJQKPXM(6>3L=Hm z4HwiBk7u0|c0i#Ux9(M(Oc% z8=DL~tI5klh#*i=_M*313Bb>!OYoVYiGHEvx=*bqbWeE5*5%5)?ehPTn(ueRGD~8rQHxN80akd}0-R~gTN6Hh(b{WEiBA&ItD(U(k9VRIGQ`=H-mrg>m@N(R z-?DEO4bYF<>d4zvt$>f7{Vl0*MGPzj3>3#KD$Mi4v)zfe0KLL=5Ha8z#ucl0 zgSwTPtXj%Du$PN^SMy$!TzTVZ-Y=e;BAnN&X4L4fZ68tA7Q!!n|G?OJmAJI(GL$d@ zbDzjC#|VGSIsHgfBsxF0bkG@6EpP^|;w~H|L_i#yi{t4TY5Lt(Dd&89ZqI#iP*^!(oVw*ej=bs?n=ROWDlM`_ZhiALY`0i&O7c zA^8hTUh~tSine>-h3^)r&?asP;W2jP=7#|ML*v35DC?O1W?z$Ut3E#RhJ#JvYQhcEqbuvvN`@|wLw(k)TX zHZ<6p-ZoW%G}>Q@qvmNz2(#8ZZP+%=>JJ3_qn}C^7UP)Fi9@#}AXDhEp7yoA)QF~< zT})y43J64T{YgM=mj(>=u;XT;pFITDw#O8kgfX5zgj{`e#|rX!x!=gNyv>>jZ+kmd z$>bSe7}sjWyvFXjpjvuB>JPmV^fG)7BjT*Y2|kxHxoN8@kI|8QTk7JDN4Ae)Q&PTu zIHcETu#Gu6O(+dw1A*U-9ya(XP;ZBD4YZ6gOV+NMJZDyt$n(nUk^8D(0_99@^flg= zsvo(XI>@V8;;&Ep`ugo+qFe3NPO4-m^TYZdnI~U|>(XEE*|I)8lQ!d%M`Hk|E-LBN zWOBv`k2!1RX+`%82Y=+KX9-l;rl2N5BZ|?v%xR@?n15g-r`YAnHU^%{kEl2x_^01i z6PqJXKyStJJGv(f0l_{PKyC?8Q4POIeyG<{Y_NsS-OCVi#m8L0m2e`*m+rUe5gbXc=R{@R$sZf z-y~d-t6jHnaWa>+_E#;#h@@m6Ei1q3hjQP}?{!2gWjW5Y z$25X{Qz+~#Zb4)kpK%v1l<1e&1}1^wgtIs7`DrerW0nfTeK8%-ZbirU;)I zCn#`cp6e1s#@9;bgVgs0CB-b^gZJlLW5Sb15eeM30 zE|kI$^7+rOD1YeEeV5Uc9%Y{g#s5hYEEQCNr;5c(f_#0s6DkF$S;jD^?Gyl_op$$j z_K612fYQFp$r2uSmk=OH-0=QX3Hdy*B?~VYh7(91`T+TMk4#YjN@}7Z+A}2Px!gVz zTw0q6wjp3MmI`TiRIDJC+6m6%zT7wKw=d;xG@Z(`HS^UMq?olR(=0gku6i(tv-*VL ziPY^Ih5@ISjSomM7ZfIB&>#S=ckM6sZ*)`m5Y4|-63<2buBX*t)wmVXD^LRna3lFu zIc>s&f&4yRRh;TCDGBH}{kB77RfGoToWBB% zLE|^c$uEb0Z4@d;Q4Mqayq-M@()=47ufDS9Q>ZLalr~H!

!x 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 ZYr@IGGU)q)32p)*BcUi>Eov0>e*icClMes@ literal 0 HcmV?d00001 diff --git a/docs/pkgdown.js b/docs/pkgdown.js new file mode 100644 index 0000000..1a99c65 --- /dev/null +++ b/docs/pkgdown.js @@ -0,0 +1,162 @@ +/* http://gregfranko.com/blog/jquery-best-practices/ */ +(function($) { + $(function() { + + $('nav.navbar').headroom(); + + Toc.init({ + $nav: $("#toc"), + $scope: $("main h2, main h3, main h4, main h5, main h6") + }); + + if ($('#toc').length) { + $('body').scrollspy({ + target: '#toc', + offset: $("nav.navbar").outerHeight() + 1 + }); + } + + // Activate popovers + $('[data-bs-toggle="popover"]').popover({ + container: 'body', + html: true, + trigger: 'focus', + placement: "top", + sanitize: false, + }); + + $('[data-bs-toggle="tooltip"]').tooltip(); + + /* Clipboard --------------------------*/ + + function changeTooltipMessage(element, msg) { + var tooltipOriginalTitle=element.getAttribute('data-bs-original-title'); + element.setAttribute('data-bs-original-title', msg); + $(element).tooltip('show'); + element.setAttribute('data-bs-original-title', tooltipOriginalTitle); + } + + if(ClipboardJS.isSupported()) { + $(document).ready(function() { + var copyButton = ""; + + $("div.sourceCode").addClass("hasCopyButton"); + + // Insert copy buttons: + $(copyButton).prependTo(".hasCopyButton"); + + // Initialize tooltips: + $('.btn-copy-ex').tooltip({container: 'body'}); + + // Initialize clipboard: + var clipboard = new ClipboardJS('[data-clipboard-copy]', { + text: function(trigger) { + return trigger.parentNode.textContent.replace(/\n#>[^\n]*/g, ""); + } + }); + + clipboard.on('success', function(e) { + changeTooltipMessage(e.trigger, 'Copied!'); + e.clearSelection(); + }); + + clipboard.on('error', function(e) { + changeTooltipMessage(e.trigger,'Press Ctrl+C or Command+C to copy'); + }); + + }); + } + + /* Search marking --------------------------*/ + var url = new URL(window.location.href); + var toMark = url.searchParams.get("q"); + var mark = new Mark("main#main"); + if (toMark) { + mark.mark(toMark, { + accuracy: { + value: "complementary", + limiters: [",", ".", ":", "/"], + } + }); + } + + /* Search --------------------------*/ + /* Adapted from https://github.com/rstudio/bookdown/blob/2d692ba4b61f1e466c92e78fd712b0ab08c11d31/inst/resources/bs4_book/bs4_book.js#L25 */ + // Initialise search index on focus + var fuse; + $("#search-input").focus(async function(e) { + if (fuse) { + return; + } + + $(e.target).addClass("loading"); + var response = await fetch($("#search-input").data("search-index")); + var data = await response.json(); + + var options = { + keys: ["what", "text", "code"], + ignoreLocation: true, + threshold: 0.1, + includeMatches: true, + includeScore: true, + }; + fuse = new Fuse(data, options); + + $(e.target).removeClass("loading"); + }); + + // Use algolia autocomplete + var options = { + autoselect: true, + debug: true, + hint: false, + minLength: 2, + }; + var q; +async function searchFuse(query, callback) { + await fuse; + + var items; + if (!fuse) { + items = []; + } else { + q = query; + var results = fuse.search(query, { limit: 20 }); + items = results + .filter((x) => x.score <= 0.75) + .map((x) => x.item); + if (items.length === 0) { + items = [{dir:"Sorry 😿",previous_headings:"",title:"No results found.",what:"No results found.",path:window.location.href}]; + } + } + callback(items); +} + $("#search-input").autocomplete(options, [ + { + name: "content", + source: searchFuse, + templates: { + suggestion: (s) => { + if (s.title == s.what) { + return `${s.dir} >

${s.title}
`; + } else if (s.previous_headings == "") { + return `${s.dir} >
${s.title}
> ${s.what}`; + } else { + return `${s.dir} >
${s.title}
> ${s.previous_headings} > ${s.what}`; + } + }, + }, + }, + ]).on('autocomplete:selected', function(event, s) { + window.location.href = s.path + "?q=" + q + "#" + s.id; + }); + }); +})(window.jQuery || window.$) + +document.addEventListener('keydown', function(event) { + // Check if the pressed key is '/' + if (event.key === '/') { + event.preventDefault(); // Prevent any default action associated with the '/' key + document.getElementById('search-input').focus(); // Set focus to the search input + } +}); diff --git a/docs/pkgdown.yml b/docs/pkgdown.yml new file mode 100644 index 0000000..04b29f9 --- /dev/null +++ b/docs/pkgdown.yml @@ -0,0 +1,6 @@ +pandoc: 3.1.11 +pkgdown: 2.1.1 +pkgdown_sha: ~ +articles: + eppoFindeR: eppoFindeR.html +last_built: 2025-01-15T15:25Z diff --git a/docs/search.json b/docs/search.json new file mode 100644 index 0000000..d1e4aaa --- /dev/null +++ b/docs/search.json @@ -0,0 +1 @@ +[{"path":"/articles/eppoFindeR.html","id":"overview","dir":"Articles","previous_headings":"","what":"Overview","title":"eppoFindeR","text":"Welcome eppoFindeR package! package wrapper around public APIs European Mediterranean Plant Protection Organization (EPPO) database. provides straightforward way access wide range pest-specific information produced collected EPPO. eppoFindeR designed use researchers practitioners working plant protection need easy access EPPO database using R.","code":""},{"path":"/articles/eppoFindeR.html","id":"prerequisites","dir":"Articles","previous_headings":"","what":"Prerequisites","title":"eppoFindeR","text":"use eppoFindeR package, need stable internet connection, interacts EPPO database online services fetch manipulate data. reliable internet connection essential functionality package.","code":""},{"path":"/articles/eppoFindeR.html","id":"installation","dir":"Articles","previous_headings":"","what":"Installation","title":"eppoFindeR","text":"can install eppoFindeR package CRAN using following command: Alternatively, want install package GitHub (latest development version), use:","code":"install.packages(\"eppoFindeR\") # install.packages(\"devtools\") devtools::install_github(\"openefsa/eppoFindeR\")"},{"path":"/articles/eppoFindeR.html","id":"working-with-api-tokens","dir":"Articles","previous_headings":"","what":"Working with API Tokens","title":"eppoFindeR","text":"eppoFindeR package requires unique token included API request proper functionality. two ways provide token: Using .Renviron file Manually adding API request","code":""},{"path":"/articles/eppoFindeR.html","id":"setting-environment-variables-via--renviron","dir":"Articles","previous_headings":"Working with API Tokens","what":"1. Setting Environment Variables via .Renviron","title":"eppoFindeR","text":".Renviron file used specify environment variables R loads start every session. particularly useful setting variables, API keys, can accessed R scripts functions. .Renviron file placed home directory (e.g., C:/Users/username/Documents/.Renviron Windows ~/.Renviron Unix-like systems). can create modify file manually using text editor. .Renviron file, set environment variables following format: EPPO_token=-eppo-token adding EPPO token .Renviron file, save close file. R automatically read token starts , can access R session using Sys.getenv('EPPO_token').","code":""},{"path":"/articles/eppoFindeR.html","id":"manually-adding-your-token-to-each-api-request","dir":"Articles","previous_headings":"Working with API Tokens","what":"2. Manually adding your token to each API request","title":"eppoFindeR","text":"functions require API token, can manually specify token token argument function. method useful want use different tokens different function calls don’t want store token globally. example:","code":"queryTheEPPOForService(\"BEMITA\", service = \"general\", token = \"your-eppo-token\")"},{"path":"/articles/eppoFindeR.html","id":"explanation","dir":"Articles","previous_headings":"Working with API Tokens > 2. Manually adding your token to each API request","what":"Explanation:","title":"eppoFindeR","text":"queryTheEPPOForService(queriedEppocode = \"BEMITA\", service = \"general\", token = \"-eppo-token\"): calls function necessary parameters: queriedEppocode = \"BEMITA\": EPPO code want query service. service = \"general\": Specifies service want query (can replace valid service type). token = \"-eppo-token\": Passes token authentication. Replace “-eppo-token” actual EPPO token enclosed quotes.","code":""},{"path":"/articles/eppoFindeR.html","id":"basic-usage","dir":"Articles","previous_headings":"","what":"Basic Usage","title":"eppoFindeR","text":"primary functionality eppoFindeR query EPPO database specific EPPO codes retrieve data across various services. Users can either choose : 1) query single service given EPPO code 2) query available services database comprehensive information. plant pest species, basic available information includes scientific names, synonyms, common names different languages, taxonomic position. pest regulatory interest, detailed information can also retrieved regarding host plants categorization (quarantine status). examples guide use functions package access data, begin, need load eppoFindeR package command: want learn arguments usage particular function, can simply run: help(\"function_name\") display detailed documentation function, including arguments, return values, examples. example, ’re working function called queryTheEPPOForService(), use: help(\"queryTheEPPOForService\")","code":"library(eppoFindeR)"},{"path":"/articles/eppoFindeR.html","id":"querying-a-specific-service","dir":"Articles","previous_headings":"","what":"Querying a Specific Service","title":"eppoFindeR","text":"query specific service (e.g., categorization) EPPO code (e.g., “BEMITA”), can use queryTheEPPOForService() function follows:","code":"categorization_BEMITA <- queryTheEPPOForService(\"BEMITA\", service = \"categorization\")"},{"path":"/articles/eppoFindeR.html","id":"expected-output","dir":"Articles","previous_headings":"Querying a Specific Service","what":"Expected Output:","title":"eppoFindeR","text":"categorization_BEMITA dataframe containing information categorization EPPO code “BEMITA”, includes following columns: nomcontinent: continent country located. isocode: ISO country code. country: name country region. qlist: code representing pest status classification. qlistlabel: label explaining pest classification (e.g., “A1 list” “Quarantine pest”). yr_add: year country added list. yr_del: year country removed (applicable). yr_trans: year country transitioned (applicable). queriedEppocode: input EPPO code. queriedOn: date query performed. queriedUrl: queried URL.","code":"categorization_BEMITA #> # A tibble: 20 × 11 #> nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 America CL Chile 1 A1 list 2019 NA NA #> 2 Asia BH Bahrain 2 A2 list 2003 NA NA #> 3 Asia KZ Kazakhstan 1 A1 list 2017 NA NA #> 4 Europe AZ Azerbaijan 1 A1 list 2007 NA NA #> 5 Europe BY Belarus X Quarantine … 1994 NA NA #> 6 Europe GE Georgia 1 A1 list 2018 NA NA #> 7 Europe MD Moldova X Quarantine … 2017 NA NA #> 8 Europe NO Norway X Quarantine … 2012 NA NA #> 9 Europe RU Russia 2 A2 list 2014 NA NA #> 10 Europe RS Serbia 1 A1 list 2015 NA NA #> 11 Europe CH Switzerland 1 A1 list 2019 NA NA #> 12 Europe TR Türkiye 2 A2 list 2016 NA NA #> 13 Europe UA Ukraine 1 A1 list 2019 NA NA #> 14 Europe GB United Kingdom 1 A1 list 2020 NA NA #> 15 Oceania NZ New Zealand X Quarantine … 2000 NA NA #> 16 RPPO/EU 9M EAEU 2 A2 list 2016 NA NA #> 17 RPPO/EU 9A EPPO 2 A2 list 1989 NA NA #> 18 RPPO/EU 9L EU P PZ Quaranti… 2019 NA NA #> 19 RPPO/EU 9L EU N A1 Quaranti… 2019 NA NA #> 20 RPPO/EU 9H OIRSA 2 A2 list 1992 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl "},{"path":"/articles/eppoFindeR.html","id":"querying-all-available-services","dir":"Articles","previous_headings":"","what":"Querying All Available Services","title":"eppoFindeR","text":"wish query available services EPPO code “BEMITA”, can use queryTheWholeEPPO() function. return list dataframes, corresponding different service.","code":"result_list <- queryTheWholeEPPO(\"BEMITA\")"},{"path":"/articles/eppoFindeR.html","id":"expected-output-1","dir":"Articles","previous_headings":"Querying All Available Services","what":"Expected Output:","title":"eppoFindeR","text":"names(result_list) returns names services: general, names, taxonomy, categorization, hosts, pests, kingdom. Accessing specific service (e.g., result_list$categorization) show data related particular service EPPO code “BEMITA”.","code":"# Print the names of the services in the result names(result_list) #> [1] \"general\" \"names\" \"taxonomy\" \"categorization\" #> [5] \"hosts\" \"pests\" \"kingdom\" # Print the data from a specific service, e.g., categorization result_list$categorization #> # A tibble: 20 × 11 #> nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 America CL Chile 1 A1 list 2019 NA NA #> 2 Asia BH Bahrain 2 A2 list 2003 NA NA #> 3 Asia KZ Kazakhstan 1 A1 list 2017 NA NA #> 4 Europe AZ Azerbaijan 1 A1 list 2007 NA NA #> 5 Europe BY Belarus X Quarantine … 1994 NA NA #> 6 Europe GE Georgia 1 A1 list 2018 NA NA #> 7 Europe MD Moldova X Quarantine … 2017 NA NA #> 8 Europe NO Norway X Quarantine … 2012 NA NA #> 9 Europe RU Russia 2 A2 list 2014 NA NA #> 10 Europe RS Serbia 1 A1 list 2015 NA NA #> 11 Europe CH Switzerland 1 A1 list 2019 NA NA #> 12 Europe TR Türkiye 2 A2 list 2016 NA NA #> 13 Europe UA Ukraine 1 A1 list 2019 NA NA #> 14 Europe GB United Kingdom 1 A1 list 2020 NA NA #> 15 Oceania NZ New Zealand X Quarantine … 2000 NA NA #> 16 RPPO/EU 9M EAEU 2 A2 list 2016 NA NA #> 17 RPPO/EU 9A EPPO 2 A2 list 1989 NA NA #> 18 RPPO/EU 9L EU P PZ Quaranti… 2019 NA NA #> 19 RPPO/EU 9L EU N A1 Quaranti… 2019 NA NA #> 20 RPPO/EU 9H OIRSA 2 A2 list 1992 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl "},{"path":"/articles/eppoFindeR.html","id":"wrangling-data","dir":"Articles","previous_headings":"","what":"Wrangling Data","title":"eppoFindeR","text":"eppoFindeR package also provides data wrangling function, taxonomyRanked(), can combine data fetched “taxonomy” “kingdom” EPPO services create unified, integrated dataframe. example, assume two dataframes: taxonomy kingdom, obtained querying “taxonomy” “kingdom” services EPPO code “BEMITA” using queryTheEPPOForService() function. can combine two dataframes follows:","code":"# Query the taxonomy service for the EPPO code \"BEMITA\" taxonomy <- queryTheEPPOForService(\"BEMITA\", service = \"taxonomy\") # Query the kingdom service for the EPPO code \"BEMITA\" kingdom <- queryTheEPPOForService(\"BEMITA\", service = \"kingdom\") # Combine taxonomy and kingdom data wrangled_data <- taxonomyRanked(taxonomy, kingdom)"},{"path":"/articles/eppoFindeR.html","id":"expected-output-2","dir":"Articles","previous_headings":"Wrangling Data","what":"Expected Output:","title":"eppoFindeR","text":"wrangled_data dataframe combines taxonomy kingdom information EPPO code “BEMITA”. integration provides comprehensive view organism’s taxonomic rank. Specifically, output dataframe contains following columns: rank: taxonomic rank. codeid: unique identifier entry. eppocode: EPPO code representing taxonomic group. prefname: preferred name taxonomic group (e.g., “Animalia”, “Insecta”). level: taxonomic level hierarchy (1 broadest category, progressing specific levels). queriedEppocode: input EPPO code. queriedOn: date query performed. queriedUrl: queried URL.","code":"wrangled_data #> # A tibble: 9 × 8 #> rank codeid eppocode prefname level queriedEppocode queriedOn queriedUrl #> #> 1 kingdom 57021 1ANIMK Animalia 1 BEMITA 2025-01-15 https://d… #> 2 NA 57200 1ARTHP Arthropoda 2 BEMITA 2025-01-15 https://d… #> 3 NA 77963 1HEXAQ Hexapoda 3 BEMITA 2025-01-15 https://d… #> 4 NA 59061 1INSEC Insecta 4 BEMITA 2025-01-15 https://d… #> 5 NA 58830 1HEMIO Hemiptera 5 BEMITA 2025-01-15 https://d… #> 6 NA 73260 1STERR Sternorrh… 6 BEMITA 2025-01-15 https://d… #> 7 NA 56905 1ALEYF Aleyrodid… 7 BEMITA 2025-01-15 https://d… #> 8 NA 57321 1BEMIG Bemisia 8 BEMITA 2025-01-15 https://d… #> 9 NA 5935 BEMITA Bemisia t… 9 BEMITA 2025-01-15 https://d…"},{"path":"/articles/eppoFindeR.html","id":"retrieving-countries-in-regional-plant-protection-organizations","dir":"Articles","previous_headings":"","what":"Retrieving Countries in Regional Plant Protection Organizations","title":"eppoFindeR","text":"gettingCountries() function allows retrieve member countries specific Regional Plant Protection Organization (RPPO). example, get member countries EAEU (Eurasian Economic Union), can use following command:","code":"EAEU_countries <- gettingCountries('EAEU')"},{"path":"/articles/eppoFindeR.html","id":"expected-output-3","dir":"Articles","previous_headings":"Retrieving Countries in Regional Plant Protection Organizations","what":"Expected Output:","title":"eppoFindeR","text":"EAEU_countries vector country names members EAEU.","code":"EAEU_countries #> [1] \"Armenia,Belarus,Kazakhstan,Kyrgyzstan,Russia\""},{"path":"/articles/eppoFindeR.html","id":"data-dump-for-multiple-eppo-codes","dir":"Articles","previous_headings":"","what":"Data Dump for Multiple EPPO Codes","title":"eppoFindeR","text":"dataDump() function allows retrieve comprehensive data dump multiple EPPO codes. function queries available EPPO services list input codes. following example function can used query available EPPO services EPPO codes “APHIPO” “LEUCSC”:","code":"data_dump <- dataDump(c(\"APHIPO\", \"LEUCSC\"))"},{"path":"/articles/eppoFindeR.html","id":"expected-output-4","dir":"Articles","previous_headings":"Data Dump for Multiple EPPO Codes","what":"Expected Output:","title":"eppoFindeR","text":"output list dataframes, corresponding different service: general, names, taxonomy, categorization, hosts, pests, kingdom. Accessing specific service (e.g., data_dump$general) show data related particular service EPPO codes “APHIPO” “LEUCSC”. column queriedEppocode dataframe distinguishes data retrieved EPPO code.","code":"# Print the names of the services in the result names(data_dump) #> [1] \"general\" \"names\" \"taxonomy\" \"categorization\" #> [5] \"hosts\" \"pests\" \"kingdom\" # Print the data from a specific service, e.g., general data_dump$general #> # A tibble: 16 × 11 #> pestCode codeid eppocode status c_date m_date prefname attached_infos #> #> 1 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 2 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 3 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 4 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 5 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 6 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 7 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 8 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 9 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 10 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 11 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 12 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 13 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 14 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 15 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 16 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl "},{"path":"/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Luca Belmonte. Author, maintainer. Dayana Stephanie Buzle. Author. Rafael Vieira. Author. Agata Kaczmarek. Author.","code":""},{"path":"/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Belmonte L, Buzle D, Vieira R, Kaczmarek (2025). eppoFindeR: Wrapper EPPO Codes. R package version 1.0.0, https://CRAN.R-project.org/package=eppoFindeR.","code":"@Manual{, title = {eppoFindeR: A Wrapper for EPPO Codes}, author = {Luca Belmonte and Dayana Stephanie Buzle and Rafael Vieira and Agata Kaczmarek}, year = {2025}, note = {R package version 1.0.0}, url = {https://CRAN.R-project.org/package=eppoFindeR}, }"},{"path":[]},{"path":"/index.html","id":"introduction","dir":"","previous_headings":"","what":"Introduction","title":"A Wrapper for EPPO Codes","text":"Welcome eppoFindeR package! package wrapper around public APIs European Mediterranean Plant Protection Organization (EPPO) database. provides straightforward way access wide range pest-specific information produced collected EPPO. eppoFindeR designed use researchers practitioners working plant protection need easy access EPPO database using R.","code":""},{"path":"/index.html","id":"getting-started","dir":"","previous_headings":"","what":"Getting Started","title":"A Wrapper for EPPO Codes","text":"use eppoFindeR package, need stable internet connection, interacts EPPO database online services fetch manipulate data. reliable internet connection essential functionality package. can install eppoFindeR package CRAN using following command: detailed guide usage examples, please refer full vignette.","code":"install.packages(\"eppoFindeR\")"},{"path":"/reference/apiQuery.html","id":null,"dir":"Reference","previous_headings":"","what":"Query the EPPO database via REST API — apiQuery","title":"Query the EPPO database via REST API — apiQuery","text":"apiQuery queries EPPO database via REST API retrieve basic information, names, taxonomy, categorization, hosts, pests kingdom data EPPO code.","code":""},{"path":"/reference/apiQuery.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query the EPPO database via REST API — apiQuery","text":"","code":"apiQuery(queriedEppocode, queriedUrl)"},{"path":"/reference/apiQuery.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query the EPPO database via REST API — apiQuery","text":"queriedEppocode character. single EPPO code. EPPO codes computer codes developed plants pests (including pathogens) important agriculture plant protection. EPPO codes constitute harmonized coding system aims facilitate management plant pest names computerized databases, well data exchange systems. EPPO codes constructed combinations 5 6 letters , whenever possible, codes mnemonic abbreviations scientific name organism. taxon represented unique code. EPPO codes can freely downloaded incorporated systems via dedicated platform, EPPO Data Services. queriedUrl character. URL query. URL type: https://data.eppo.int/api/rest/1.0/taxon/queriedEppocode?authtoken=xxxxxxxxxxxxxxxxxxx API requests: Replace \"queriedEppocode\" EPPO code interest. Add unique token.","code":""},{"path":"/reference/apiQuery.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query the EPPO database via REST API — apiQuery","text":"single flattened dataframe returned, containing contents request converted JSON. Based query, output dataframe contain basic information, names, taxonomy, categorization, hosts, pests kingdom data input EPPO code. queriedEppocode, queriedOn queriedUrl columns dataframe report input EPPO code, date query performed, queried URL, respectively.","code":""},{"path":[]},{"path":"/reference/dataDump.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a dump of the whole EPPO database via REST API — dataDump","title":"Create a dump of the whole EPPO database via REST API — dataDump","text":"dataDump creates dump whole EPPO database via REST API one EPPO code(s).","code":""},{"path":"/reference/dataDump.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a dump of the whole EPPO database via REST API — dataDump","text":"","code":"dataDump(codesToScan, token = Sys.getenv(\"EPPO_token\"))"},{"path":"/reference/dataDump.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a dump of the whole EPPO database via REST API — dataDump","text":"codesToScan character vector one EPPO code(s). token character. Manually add unique token, set inside .Renviron using Sys.setenv(EPPO_token = \"-token\").","code":""},{"path":"/reference/dataDump.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a dump of the whole EPPO database via REST API — dataDump","text":"list flattened dataframes returned, dataframe containing contents request converted JSON. output dataframe contain basic information, names, taxonomy, categorization, hosts, pests kingdom data input EPPO code(s), respectively. queriedEppocode, queriedOn queriedUrl columns dataframe report input EPPO code(s), date query performed, queried URL, respectively.","code":""},{"path":"/reference/dataDump.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a dump of the whole EPPO database via REST API — dataDump","text":"","code":"# Create a dump of all data about Bemisia tabaci: basic information, all names, taxonomy, # categorization, hosts, pests and kingdom data. dataDump(\"BEMITA\") #> #> $general #> # A tibble: 8 × 11 #> pestCode codeid eppocode status c_date m_date prefname attached_infos #> #> 1 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 2 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 3 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 4 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 5 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 6 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 7 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 8 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl #> #> $names #> # A tibble: 39 × 10 #> pestCode nameid isolang isocountry fullname preferred author queriedEppocode #> #> 1 BEMITA 7224 la NA Bemisia … 1 (Genn… BEMITA #> 2 BEMITA 211279 de NA Baumwoll… 0 NA BEMITA #> 3 BEMITA 211280 de NA Tabakmot… 0 NA BEMITA #> 4 BEMITA 280710 de NA weiße Fl… 0 NA BEMITA #> 5 BEMITA 7220 en NA cotton w… 0 NA BEMITA #> 6 BEMITA 7221 en NA sweet-po… 0 NA BEMITA #> 7 BEMITA 7222 en NA tobacco … 0 NA BEMITA #> 8 BEMITA 180181 en NA cassava … 0 NA BEMITA #> 9 BEMITA 273619 en NA silverle… 0 NA BEMITA #> 10 BEMITA 7241 es NA mosquita… 0 NA BEMITA #> # ℹ 29 more rows #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $taxonomy #> # A tibble: 9 × 8 #> pestCode codeid eppocode prefname level queriedEppocode queriedOn queriedUrl #> #> 1 BEMITA 57021 1ANIMK Animalia 1 BEMITA 2025-01-15 https://d… #> 2 BEMITA 57200 1ARTHP Arthropo… 2 BEMITA 2025-01-15 https://d… #> 3 BEMITA 77963 1HEXAQ Hexapoda 3 BEMITA 2025-01-15 https://d… #> 4 BEMITA 59061 1INSEC Insecta 4 BEMITA 2025-01-15 https://d… #> 5 BEMITA 58830 1HEMIO Hemiptera 5 BEMITA 2025-01-15 https://d… #> 6 BEMITA 73260 1STERR Sternorr… 6 BEMITA 2025-01-15 https://d… #> 7 BEMITA 56905 1ALEYF Aleyrodi… 7 BEMITA 2025-01-15 https://d… #> 8 BEMITA 57321 1BEMIG Bemisia 8 BEMITA 2025-01-15 https://d… #> 9 BEMITA 5935 BEMITA Bemisia … 9 BEMITA 2025-01-15 https://d… #> #> $categorization #> # A tibble: 20 × 12 #> pestCode nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 BEMITA America CL Chile 1 A1 list 2019 NA NA #> 2 BEMITA Asia BH Bahrain 2 A2 list 2003 NA NA #> 3 BEMITA Asia KZ Kazakh… 1 A1 list 2017 NA NA #> 4 BEMITA Europe AZ Azerba… 1 A1 list 2007 NA NA #> 5 BEMITA Europe BY Belarus X Quarantin… 1994 NA NA #> 6 BEMITA Europe GE Georgia 1 A1 list 2018 NA NA #> 7 BEMITA Europe MD Moldova X Quarantin… 2017 NA NA #> 8 BEMITA Europe NO Norway X Quarantin… 2012 NA NA #> 9 BEMITA Europe RU Russia 2 A2 list 2014 NA NA #> 10 BEMITA Europe RS Serbia 1 A1 list 2015 NA NA #> 11 BEMITA Europe CH Switze… 1 A1 list 2019 NA NA #> 12 BEMITA Europe TR Türkiye 2 A2 list 2016 NA NA #> 13 BEMITA Europe UA Ukraine 1 A1 list 2019 NA NA #> 14 BEMITA Europe GB United… 1 A1 list 2020 NA NA #> 15 BEMITA Oceania NZ New Ze… X Quarantin… 2000 NA NA #> 16 BEMITA RPPO/EU 9M EAEU 2 A2 list 2016 NA NA #> 17 BEMITA RPPO/EU 9A EPPO 2 A2 list 1989 NA NA #> 18 BEMITA RPPO/EU 9L EU P PZ Quaran… 2019 NA NA #> 19 BEMITA RPPO/EU 9L EU N A1 Quaran… 2019 NA NA #> 20 BEMITA RPPO/EU 9H OIRSA 2 A2 list 1992 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl #> #> $hosts #> # A tibble: 50 × 9 #> pestCode codeid eppocode idclass labelclass full_name queriedEppocode #> #> 1 BEMITA 31422 EPHPU 1 Major host Euphorbia pulche… BEMITA #> 2 BEMITA 32978 GEBJA 1 Major host Gerbera jamesonii BEMITA #> 3 BEMITA 33334 GOSHI 1 Major host Gossypium hirsut… BEMITA #> 4 BEMITA 35046 IPOBA 1 Major host Ipomoea batatas BEMITA #> 5 BEMITA 37151 MANES 1 Major host Manihot esculenta BEMITA #> 6 BEMITA 38512 NIOTA 1 Major host Nicotiana tabacum BEMITA #> 7 BEMITA 36921 LYPES 1 Major host Solanum lycopers… BEMITA #> 8 BEMITA 23377 AMABL 6 Wild/Weed Amaranthus blito… BEMITA #> 9 BEMITA 23414 AMARE 6 Wild/Weed Amaranthus retro… BEMITA #> 10 BEMITA 24583 ATXSE 6 Wild/Weed Atriplex semibac… BEMITA #> # ℹ 40 more rows #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $pests #> # A tibble: 1 × 4 #> pestCode queriedEppocode queriedOn queriedUrl #> #> 1 BEMITA BEMITA 2025-01-15 https://data.eppo.int/api/rest/1.0/taxon/… #> #> $kingdom #> # A tibble: 1 × 7 #> pestCode codeid eppocode status queriedEppocode queriedOn queriedUrl #> #> 1 BEMITA 57021 1ANIMK A BEMITA 2025-01-15 https://data.eppo.… #> # Create a dump of all data about Aphis pomi and Leucoptera malifoliella: basic information, # all names, taxonomy, categorization, hosts, pests and kingdom data. dataDump(c(\"APHIPO\", \"LEUCSC\")) #> #> #> #> $general #> # A tibble: 16 × 11 #> pestCode codeid eppocode status c_date m_date prefname attached_infos #> #> 1 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 2 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 3 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 4 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 5 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 6 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 7 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 8 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 9 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 10 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 11 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 12 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 13 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 14 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 15 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 16 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl #> #> $names #> # A tibble: 49 × 10 #> pestCode nameid isolang isocountry fullname preferred author queriedEppocode #> #> 1 APHIPO 4708 la NA Aphis po… 1 DeGeer APHIPO #> 2 APHIPO 4700 da NA grøn æbl… 0 NA APHIPO #> 3 APHIPO 213257 de NA grüne Ap… 0 NA APHIPO #> 4 APHIPO 4702 en NA green ap… 0 NA APHIPO #> 5 APHIPO 4703 en NA permanen… 0 NA APHIPO #> 6 APHIPO 4718 es NA afido de… 0 NA APHIPO #> 7 APHIPO 4719 es NA pulgón d… 0 NA APHIPO #> 8 APHIPO 4720 es NA pulgón v… 0 NA APHIPO #> 9 APHIPO 4724 fa NA schatte … 0 NA APHIPO #> 10 APHIPO 4722 fi NA omenakir… 0 NA APHIPO #> # ℹ 39 more rows #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $taxonomy #> # A tibble: 17 × 8 #> pestCode codeid eppocode prefname level queriedEppocode queriedOn queriedUrl #> #> 1 APHIPO 57021 1ANIMK Animalia 1 APHIPO 2025-01-15 https://d… #> 2 APHIPO 57200 1ARTHP Arthrop… 2 APHIPO 2025-01-15 https://d… #> 3 APHIPO 77963 1HEXAQ Hexapoda 3 APHIPO 2025-01-15 https://d… #> 4 APHIPO 59061 1INSEC Insecta 4 APHIPO 2025-01-15 https://d… #> 5 APHIPO 58830 1HEMIO Hemipte… 5 APHIPO 2025-01-15 https://d… #> 6 APHIPO 73260 1STERR Sternor… 6 APHIPO 2025-01-15 https://d… #> 7 APHIPO 57100 1APHIF Aphidid… 7 APHIPO 2025-01-15 https://d… #> 8 APHIPO 57101 1APHIG Aphis 8 APHIPO 2025-01-15 https://d… #> 9 APHIPO 5050 APHIPO Aphis p… 9 APHIPO 2025-01-15 https://d… #> 10 LEUCSC 57021 1ANIMK Animalia 1 LEUCSC 2025-01-15 https://d… #> 11 LEUCSC 57200 1ARTHP Arthrop… 2 LEUCSC 2025-01-15 https://d… #> 12 LEUCSC 77963 1HEXAQ Hexapoda 3 LEUCSC 2025-01-15 https://d… #> 13 LEUCSC 59061 1INSEC Insecta 4 LEUCSC 2025-01-15 https://d… #> 14 LEUCSC 59211 1LEPIO Lepidop… 5 LEUCSC 2025-01-15 https://d… #> 15 LEUCSC 59367 1LYONF Lyoneti… 6 LEUCSC 2025-01-15 https://d… #> 16 LEUCSC 59235 1LEUCG Leucopt… 7 LEUCSC 2025-01-15 https://d… #> 17 LEUCSC 13110 LEUCSC Leucopt… 8 LEUCSC 2025-01-15 https://d… #> #> $categorization #> # A tibble: 9 × 12 #> pestCode nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 APHIPO Africa EG Egypt 1 A1 list 2018 NA NA #> 2 APHIPO America CL Chile 1 A1 list 2019 NA NA #> 3 LEUCSC Africa EG Egypt 1 A1 list 2018 NA NA #> 4 LEUCSC America AR Argenti… 1 A1 list 2019 NA NA #> 5 LEUCSC America BR Brazil 1 A1 list 2018 NA NA #> 6 LEUCSC America CA Canada X Quarantin… 2019 NA NA #> 7 LEUCSC America CL Chile 1 A1 list 2019 NA NA #> 8 LEUCSC America US United … X Quarantin… 1995 NA NA #> 9 LEUCSC RPPO/EU 9D COSAVE 1 A1 list 2021 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl #> #> $hosts #> # A tibble: 8 × 9 #> pestCode queriedEppocode queriedOn queriedUrl codeid eppocode idclass #> #> 1 APHIPO APHIPO 2025-01-15 https://data.eppo… NA NA NA #> 2 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 37021 MABSD 1 #> 3 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 51515 1BETG 9 #> 4 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 52076 1CSCG 9 #> 5 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 29214 CYDOB 9 #> 6 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 41523 PRNAV 9 #> 7 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 54453 1PYUG 9 #> 8 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 42266 PYUCO 9 #> # ℹ 2 more variables: labelclass , full_name #> #> $pests #> # A tibble: 2 × 4 #> pestCode queriedEppocode queriedOn queriedUrl #> #> 1 APHIPO APHIPO 2025-01-15 https://data.eppo.int/api/rest/1.0/taxon/… #> 2 LEUCSC LEUCSC 2025-01-15 https://data.eppo.int/api/rest/1.0/taxon/… #> #> $kingdom #> # A tibble: 2 × 7 #> pestCode codeid eppocode status queriedEppocode queriedOn queriedUrl #> #> 1 APHIPO 57021 1ANIMK A APHIPO 2025-01-15 https://data.eppo.… #> 2 LEUCSC 57021 1ANIMK A LEUCSC 2025-01-15 https://data.eppo.… #>"},{"path":"/reference/eppoFindeR-package.html","id":null,"dir":"Reference","previous_headings":"","what":"eppoFindeR: A Wrapper for EPPO Codes — eppoFindeR-package","title":"eppoFindeR: A Wrapper for EPPO Codes — eppoFindeR-package","text":"eppoFindeR package provides wrap around European Mediterranean Plant Protection Organization (EPPO) database public APIs. enables users retrieve EPPO-related data searches across entire EPPO database utilizing specific services, including categorization, taxonomy, . package also includes data wrangling function integrate taxonomy rank information, function returns list member countries Regional Plant Protection Organization acronym used EPPO database.","code":""},{"path":[]},{"path":"/reference/eppoFindeR-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"eppoFindeR: A Wrapper for EPPO Codes — eppoFindeR-package","text":"Maintainer: Luca Belmonte luca.belmonte@efsa.europa.eu (ORCID) Authors: Dayana Stephanie Buzle (ORCID) Rafael Vieira Agata Kaczmarek (ORCID)","code":""},{"path":"/reference/gettingCountries.html","id":null,"dir":"Reference","previous_headings":"","what":"Get member countries from the acronyms of all Regional Plant Protection Organizations used in the EPPO database — gettingCountries","title":"Get member countries from the acronyms of all Regional Plant Protection Organizations used in the EPPO database — gettingCountries","text":"gettingCountries returns list member countries Regional Plant Protection Organization acronym used EPPO database (source: https://gd.eppo.int/rppo/).","code":""},{"path":"/reference/gettingCountries.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get member countries from the acronyms of all Regional Plant Protection Organizations used in the EPPO database — gettingCountries","text":"","code":"gettingCountries(acronym)"},{"path":"/reference/gettingCountries.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get member countries from the acronyms of all Regional Plant Protection Organizations used in the EPPO database — gettingCountries","text":"acronym character. acronym Regional Plant Protection Organization.","code":""},{"path":"/reference/gettingCountries.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get member countries from the acronyms of all Regional Plant Protection Organizations used in the EPPO database — gettingCountries","text":"character vector containing member countries.","code":""},{"path":"/reference/gettingCountries.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get member countries from the acronyms of all Regional Plant Protection Organizations used in the EPPO database — gettingCountries","text":"","code":"# Get the list of member countries for the 'EAEU' acronym: gettingCountries('EAEU') #> [1] \"Armenia,Belarus,Kazakhstan,Kyrgyzstan,Russia\" # Get the list of member countries for the 'EPPO' acronym: gettingCountries('EPPO') #> [1] \"Albania,Algeria,Austria,Azerbaijan,Belarus,Belgium,Bosnia and Herzegovina,Bulgaria,Croatia,Cyprus,Czech Republic,Denmark,Estonia,Finland,France,Georgia,Germany,Greece,Guernsey,Hungary,Ireland,Israel,Italy,Jersey,Jordan,Kazakhstan,Kyrgyzstan,Latvia,Lithuania,Luxembourg,Malta,Moldova,Montenegro,Morocco,Netherlands,North Macedonia,Norway,Poland,Portugal,Romania,Russia,Serbia,Slovakia,Slovenia,Spain,Sweden,Switzerland,Tunisia,Türkiye,Ukraine,United Kingdom,Uzbekistan\" # Get the list of member countries for the 'COSAVE' acronym: gettingCountries('COSAVE') #> [1] \"Argentina,Bolivia,Brazil,Chile,Paraguay,Peru,Uruguay\""},{"path":"/reference/queryTheEPPOForService.html","id":null,"dir":"Reference","previous_headings":"","what":"Query the EPPO database via REST API by specifying the name of the required service — queryTheEPPOForService","title":"Query the EPPO database via REST API by specifying the name of the required service — queryTheEPPOForService","text":"queryTheEPPOForService queries EPPO database via REST API specifying name required service, retrieve basic information, names, taxonomy, categorization, hosts, pests kingdom data EPPO code.","code":""},{"path":"/reference/queryTheEPPOForService.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query the EPPO database via REST API by specifying the name of the required service — queryTheEPPOForService","text":"","code":"queryTheEPPOForService( queriedEppocode, baseUrl = \"https://data.eppo.int/api/rest/1.0/taxon/\", service = \"categorization\", token = Sys.getenv(\"EPPO_token\") )"},{"path":"/reference/queryTheEPPOForService.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query the EPPO database via REST API by specifying the name of the required service — queryTheEPPOForService","text":"queriedEppocode character. single EPPO code. EPPO codes computer codes developed plants pests (including pathogens) important agriculture plant protection. EPPO codes constitute harmonized coding system aims facilitate management plant pest names computerized databases, well data exchange systems. EPPO codes constructed combinations 5 6 letters , whenever possible, codes mnemonic abbreviations scientific name organism. taxon represented unique code. EPPO codes can freely downloaded incorporated systems via dedicated platform, EPPO Data Services. baseUrl character. URL root REST API. default: https://data.eppo.int/api/rest/1.0 service character. single service, selected among following: \"\": basic information \"names\": names \"taxonomy\": taxonomy data \"categorization\": categorization data \"hosts\": hosts data \"pests\": pests data \"kingdom\": kingdom taxonomic rank default: \"categorization\" token character. Manually add unique token, set inside .Renviron using Sys.setenv(EPPO_token = \"-token\"). default: Sys.getenv('EPPO_token')","code":""},{"path":"/reference/queryTheEPPOForService.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query the EPPO database via REST API by specifying the name of the required service — queryTheEPPOForService","text":"list flattened dataframes returned, dataframe containing contents request converted JSON. Based query, output dataframe contain basic information, names, taxonomy, categorization, hosts, pests kingdom data input EPPO code. queriedEppocode, queriedOn queriedUrl columns dataframe report input EPPO code, date query performed, queried URL, respectively.","code":""},{"path":"/reference/queryTheEPPOForService.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Query the EPPO database via REST API by specifying the name of the required service — queryTheEPPOForService","text":"","code":"# Get basic information about Bemisia tabaci: queryTheEPPOForService(\"BEMITA\", service = \"\") #> # A tibble: 8 × 10 #> codeid eppocode status c_date m_date prefname attached_infos queriedEppocode #> #> 1 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 2 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 3 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 4 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 5 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 6 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 7 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 8 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> # ℹ 2 more variables: queriedOn , queriedUrl # Get all names about Bemisia tabaci: queryTheEPPOForService(\"BEMITA\", service = \"names\") #> # A tibble: 39 × 9 #> nameid isolang isocountry fullname preferred author queriedEppocode #> #> 1 7224 la NA Bemisia tabaci 1 (Genn… BEMITA #> 2 211279 de NA Baumwollmottensch… 0 NA BEMITA #> 3 211280 de NA Tabakmottenschild… 0 NA BEMITA #> 4 280710 de NA weiße Fliege 0 NA BEMITA #> 5 7220 en NA cotton whitefly 0 NA BEMITA #> 6 7221 en NA sweet-potato whit… 0 NA BEMITA #> 7 7222 en NA tobacco whitefly 0 NA BEMITA #> 8 180181 en NA cassava whitefly 0 NA BEMITA #> 9 273619 en NA silverleaf whitef… 0 NA BEMITA #> 10 7241 es NA mosquita blanca d… 0 NA BEMITA #> # ℹ 29 more rows #> # ℹ 2 more variables: queriedOn , queriedUrl # Get categorization data about Bemisia tabaci: queryTheEPPOForService(\"BEMITA\", service = \"categorization\") #> # A tibble: 20 × 11 #> nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 America CL Chile 1 A1 list 2019 NA NA #> 2 Asia BH Bahrain 2 A2 list 2003 NA NA #> 3 Asia KZ Kazakhstan 1 A1 list 2017 NA NA #> 4 Europe AZ Azerbaijan 1 A1 list 2007 NA NA #> 5 Europe BY Belarus X Quarantine … 1994 NA NA #> 6 Europe GE Georgia 1 A1 list 2018 NA NA #> 7 Europe MD Moldova X Quarantine … 2017 NA NA #> 8 Europe NO Norway X Quarantine … 2012 NA NA #> 9 Europe RU Russia 2 A2 list 2014 NA NA #> 10 Europe RS Serbia 1 A1 list 2015 NA NA #> 11 Europe CH Switzerland 1 A1 list 2019 NA NA #> 12 Europe TR Türkiye 2 A2 list 2016 NA NA #> 13 Europe UA Ukraine 1 A1 list 2019 NA NA #> 14 Europe GB United Kingdom 1 A1 list 2020 NA NA #> 15 Oceania NZ New Zealand X Quarantine … 2000 NA NA #> 16 RPPO/EU 9M EAEU 2 A2 list 2016 NA NA #> 17 RPPO/EU 9A EPPO 2 A2 list 1989 NA NA #> 18 RPPO/EU 9L EU P PZ Quaranti… 2019 NA NA #> 19 RPPO/EU 9L EU N A1 Quaranti… 2019 NA NA #> 20 RPPO/EU 9H OIRSA 2 A2 list 1992 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl "},{"path":"/reference/queryTheWholeEPPO.html","id":null,"dir":"Reference","previous_headings":"","what":"Query all services, a single service or multiple services in the EPPO database via REST API — queryTheWholeEPPO","title":"Query all services, a single service or multiple services in the EPPO database via REST API — queryTheWholeEPPO","text":"queryTheWholeEPPO queries EPPO database via REST API specifying name(s) required service(s), retrieve basic information, names, taxonomy, categorization, hosts, pests kingdom data EPPO code.","code":""},{"path":"/reference/queryTheWholeEPPO.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query all services, a single service or multiple services in the EPPO database via REST API — queryTheWholeEPPO","text":"","code":"queryTheWholeEPPO( queriedEppocode, baseUrl = \"https://data.eppo.int/api/rest/1.0/taxon/\", token = Sys.getenv(\"EPPO_token\") )"},{"path":"/reference/queryTheWholeEPPO.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query all services, a single service or multiple services in the EPPO database via REST API — queryTheWholeEPPO","text":"queriedEppocode character. single EPPO code. EPPO codes computer codes developed plants pests (including pathogens) important agriculture plant protection. EPPO codes constitute harmonized coding system aims facilitate management plant pest names computerized databases, well data exchange systems. EPPO codes constructed combinations 5 6 letters , whenever possible, codes mnemonic abbreviations scientific name organism. taxon represented unique code. EPPO codes can freely downloaded incorporated systems via dedicated platform, EPPO Data Services. baseUrl character. URL root REST API. default: https://data.eppo.int/api/rest/1.0 token character. Manually add unique token, set inside .Renviron using Sys.setenv(EPPO_token = \"-token\"). default: Sys.getenv('EPPO_token') \"\": basic information \"names\": names \"taxonomy\": taxonomy data \"categorization\": categorization data \"hosts\": hosts data \"pests\": pests data \"kingdom\": kingdom taxonomic rank default: \"\", means whole EPPO database taxonomy (https://data.eppo.int/api/rest/1.0/taxon) screened.","code":""},{"path":"/reference/queryTheWholeEPPO.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query all services, a single service or multiple services in the EPPO database via REST API — queryTheWholeEPPO","text":"list flattened dataframes returned, dataframe containing contents request converted JSON. Based query, output dataframe contain basic information, names, taxonomy, categorization, hosts, pests kingdom data input EPPO code. queriedEppocode, queriedOn queriedUrl columns dataframe report input EPPO code, date query performed, queried URL, respectively.","code":""},{"path":"/reference/queryTheWholeEPPO.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Query all services, a single service or multiple services in the EPPO database via REST API — queryTheWholeEPPO","text":"","code":"# Get all information about Bemisia tabaci: basic information, all names, taxonomy, # categorization, hosts, pests and kingdom data. queryTheWholeEPPO(\"BEMITA\") #> #> $general #> # A tibble: 8 × 10 #> codeid eppocode status c_date m_date prefname attached_infos queriedEppocode #> #> 1 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 2 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 3 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 4 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 5 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 6 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 7 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 8 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $names #> # A tibble: 39 × 9 #> nameid isolang isocountry fullname preferred author queriedEppocode #> #> 1 7224 la NA Bemisia tabaci 1 (Genn… BEMITA #> 2 211279 de NA Baumwollmottensch… 0 NA BEMITA #> 3 211280 de NA Tabakmottenschild… 0 NA BEMITA #> 4 280710 de NA weiße Fliege 0 NA BEMITA #> 5 7220 en NA cotton whitefly 0 NA BEMITA #> 6 7221 en NA sweet-potato whit… 0 NA BEMITA #> 7 7222 en NA tobacco whitefly 0 NA BEMITA #> 8 180181 en NA cassava whitefly 0 NA BEMITA #> 9 273619 en NA silverleaf whitef… 0 NA BEMITA #> 10 7241 es NA mosquita blanca d… 0 NA BEMITA #> # ℹ 29 more rows #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $taxonomy #> # A tibble: 9 × 7 #> codeid eppocode prefname level queriedEppocode queriedOn queriedUrl #> #> 1 57021 1ANIMK Animalia 1 BEMITA 2025-01-15 https://data.… #> 2 57200 1ARTHP Arthropoda 2 BEMITA 2025-01-15 https://data.… #> 3 77963 1HEXAQ Hexapoda 3 BEMITA 2025-01-15 https://data.… #> 4 59061 1INSEC Insecta 4 BEMITA 2025-01-15 https://data.… #> 5 58830 1HEMIO Hemiptera 5 BEMITA 2025-01-15 https://data.… #> 6 73260 1STERR Sternorrhyncha 6 BEMITA 2025-01-15 https://data.… #> 7 56905 1ALEYF Aleyrodidae 7 BEMITA 2025-01-15 https://data.… #> 8 57321 1BEMIG Bemisia 8 BEMITA 2025-01-15 https://data.… #> 9 5935 BEMITA Bemisia tabaci 9 BEMITA 2025-01-15 https://data.… #> #> $categorization #> # A tibble: 20 × 11 #> nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 America CL Chile 1 A1 list 2019 NA NA #> 2 Asia BH Bahrain 2 A2 list 2003 NA NA #> 3 Asia KZ Kazakhstan 1 A1 list 2017 NA NA #> 4 Europe AZ Azerbaijan 1 A1 list 2007 NA NA #> 5 Europe BY Belarus X Quarantine … 1994 NA NA #> 6 Europe GE Georgia 1 A1 list 2018 NA NA #> 7 Europe MD Moldova X Quarantine … 2017 NA NA #> 8 Europe NO Norway X Quarantine … 2012 NA NA #> 9 Europe RU Russia 2 A2 list 2014 NA NA #> 10 Europe RS Serbia 1 A1 list 2015 NA NA #> 11 Europe CH Switzerland 1 A1 list 2019 NA NA #> 12 Europe TR Türkiye 2 A2 list 2016 NA NA #> 13 Europe UA Ukraine 1 A1 list 2019 NA NA #> 14 Europe GB United Kingdom 1 A1 list 2020 NA NA #> 15 Oceania NZ New Zealand X Quarantine … 2000 NA NA #> 16 RPPO/EU 9M EAEU 2 A2 list 2016 NA NA #> 17 RPPO/EU 9A EPPO 2 A2 list 1989 NA NA #> 18 RPPO/EU 9L EU P PZ Quaranti… 2019 NA NA #> 19 RPPO/EU 9L EU N A1 Quaranti… 2019 NA NA #> 20 RPPO/EU 9H OIRSA 2 A2 list 1992 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl #> #> $hosts #> # A tibble: 50 × 8 #> codeid eppocode idclass labelclass full_name queriedEppocode queriedOn #> #> 1 31422 EPHPU 1 Major host Euphorbia pulc… BEMITA 2025-01-15 #> 2 32978 GEBJA 1 Major host Gerbera jameso… BEMITA 2025-01-15 #> 3 33334 GOSHI 1 Major host Gossypium hirs… BEMITA 2025-01-15 #> 4 35046 IPOBA 1 Major host Ipomoea batatas BEMITA 2025-01-15 #> 5 37151 MANES 1 Major host Manihot escule… BEMITA 2025-01-15 #> 6 38512 NIOTA 1 Major host Nicotiana taba… BEMITA 2025-01-15 #> 7 36921 LYPES 1 Major host Solanum lycope… BEMITA 2025-01-15 #> 8 23377 AMABL 6 Wild/Weed Amaranthus bli… BEMITA 2025-01-15 #> 9 23414 AMARE 6 Wild/Weed Amaranthus ret… BEMITA 2025-01-15 #> 10 24583 ATXSE 6 Wild/Weed Atriplex semib… BEMITA 2025-01-15 #> # ℹ 40 more rows #> # ℹ 1 more variable: queriedUrl #> #> $pests #> # A tibble: 1 × 3 #> queriedEppocode queriedOn queriedUrl #> #> 1 BEMITA 2025-01-15 https://data.eppo.int/api/rest/1.0/taxon/BEMITA/pe… #> #> $kingdom #> # A tibble: 1 × 6 #> codeid eppocode status queriedEppocode queriedOn queriedUrl #> #> 1 57021 1ANIMK A BEMITA 2025-01-15 https://data.eppo.int/api/r… #>"},{"path":"/reference/queryTheWholeEPPOSafe.html","id":null,"dir":"Reference","previous_headings":"","what":"Query all services, a single service or multiple services in the EPPO database via REST API (version that never fails) — queryTheWholeEPPOSafe","title":"Query all services, a single service or multiple services in the EPPO database via REST API (version that never fails) — queryTheWholeEPPOSafe","text":"queryTheWholeEPPOSafe queries EPPO database via REST API specifying name(s) required service(s), retrieve basic information, names, taxonomy, categorization, hosts, pests kingdom data EPPO code. queryTheWholeEPPOSafe modified version queryTheWholeEPPO never fails.","code":""},{"path":"/reference/queryTheWholeEPPOSafe.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query all services, a single service or multiple services in the EPPO database via REST API (version that never fails) — queryTheWholeEPPOSafe","text":"","code":"queryTheWholeEPPOSafe(...)"},{"path":"/reference/queryTheWholeEPPOSafe.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query all services, a single service or multiple services in the EPPO database via REST API (version that never fails) — queryTheWholeEPPOSafe","text":"... function takes arguments .f. default, .f = queryTheWholeEPPO. safely(.f) function purrr/tidyverse package R wraps function capture errors side effects, .e. creates modified version .f never fails.","code":""},{"path":"/reference/queryTheWholeEPPOSafe.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query all services, a single service or multiple services in the EPPO database via REST API (version that never fails) — queryTheWholeEPPOSafe","text":"function takes arguments .f, returns different value: list components result error. function succeeds, result contains returned value error NULL. error occurred, error error object result either NULL otherwise. function succeeds, result contains list flattened dataframes, dataframe containing contents request converted JSON. Based query, output dataframe contain basic information, names, taxonomy, categorization, hosts, pests kingdom data input EPPO code. queriedEppocode, queriedOn queriedUrl columns dataframe report input EPPO code, date query performed, queried URL, respectively.","code":""},{"path":"/reference/queryTheWholeEPPOSafe.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Query all services, a single service or multiple services in the EPPO database via REST API (version that never fails) — queryTheWholeEPPOSafe","text":"","code":"# Get all information about Bemisia tabaci: basic information, all names, taxonomy, # categorization, hosts pests, and kingdom data. queryTheWholeEPPOSafe(\"BEMITA\") #> #> $result #> $result$general #> # A tibble: 8 × 10 #> codeid eppocode status c_date m_date prefname attached_infos queriedEppocode #> #> 1 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 2 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 3 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 4 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 5 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 6 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 7 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 8 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $result$names #> # A tibble: 39 × 9 #> nameid isolang isocountry fullname preferred author queriedEppocode #> #> 1 7224 la NA Bemisia tabaci 1 (Genn… BEMITA #> 2 211279 de NA Baumwollmottensch… 0 NA BEMITA #> 3 211280 de NA Tabakmottenschild… 0 NA BEMITA #> 4 280710 de NA weiße Fliege 0 NA BEMITA #> 5 7220 en NA cotton whitefly 0 NA BEMITA #> 6 7221 en NA sweet-potato whit… 0 NA BEMITA #> 7 7222 en NA tobacco whitefly 0 NA BEMITA #> 8 180181 en NA cassava whitefly 0 NA BEMITA #> 9 273619 en NA silverleaf whitef… 0 NA BEMITA #> 10 7241 es NA mosquita blanca d… 0 NA BEMITA #> # ℹ 29 more rows #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $result$taxonomy #> # A tibble: 9 × 7 #> codeid eppocode prefname level queriedEppocode queriedOn queriedUrl #> #> 1 57021 1ANIMK Animalia 1 BEMITA 2025-01-15 https://data.… #> 2 57200 1ARTHP Arthropoda 2 BEMITA 2025-01-15 https://data.… #> 3 77963 1HEXAQ Hexapoda 3 BEMITA 2025-01-15 https://data.… #> 4 59061 1INSEC Insecta 4 BEMITA 2025-01-15 https://data.… #> 5 58830 1HEMIO Hemiptera 5 BEMITA 2025-01-15 https://data.… #> 6 73260 1STERR Sternorrhyncha 6 BEMITA 2025-01-15 https://data.… #> 7 56905 1ALEYF Aleyrodidae 7 BEMITA 2025-01-15 https://data.… #> 8 57321 1BEMIG Bemisia 8 BEMITA 2025-01-15 https://data.… #> 9 5935 BEMITA Bemisia tabaci 9 BEMITA 2025-01-15 https://data.… #> #> $result$categorization #> # A tibble: 20 × 11 #> nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 America CL Chile 1 A1 list 2019 NA NA #> 2 Asia BH Bahrain 2 A2 list 2003 NA NA #> 3 Asia KZ Kazakhstan 1 A1 list 2017 NA NA #> 4 Europe AZ Azerbaijan 1 A1 list 2007 NA NA #> 5 Europe BY Belarus X Quarantine … 1994 NA NA #> 6 Europe GE Georgia 1 A1 list 2018 NA NA #> 7 Europe MD Moldova X Quarantine … 2017 NA NA #> 8 Europe NO Norway X Quarantine … 2012 NA NA #> 9 Europe RU Russia 2 A2 list 2014 NA NA #> 10 Europe RS Serbia 1 A1 list 2015 NA NA #> 11 Europe CH Switzerland 1 A1 list 2019 NA NA #> 12 Europe TR Türkiye 2 A2 list 2016 NA NA #> 13 Europe UA Ukraine 1 A1 list 2019 NA NA #> 14 Europe GB United Kingdom 1 A1 list 2020 NA NA #> 15 Oceania NZ New Zealand X Quarantine … 2000 NA NA #> 16 RPPO/EU 9M EAEU 2 A2 list 2016 NA NA #> 17 RPPO/EU 9A EPPO 2 A2 list 1989 NA NA #> 18 RPPO/EU 9L EU P PZ Quaranti… 2019 NA NA #> 19 RPPO/EU 9L EU N A1 Quaranti… 2019 NA NA #> 20 RPPO/EU 9H OIRSA 2 A2 list 1992 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl #> #> $result$hosts #> # A tibble: 50 × 8 #> codeid eppocode idclass labelclass full_name queriedEppocode queriedOn #> #> 1 31422 EPHPU 1 Major host Euphorbia pulc… BEMITA 2025-01-15 #> 2 32978 GEBJA 1 Major host Gerbera jameso… BEMITA 2025-01-15 #> 3 33334 GOSHI 1 Major host Gossypium hirs… BEMITA 2025-01-15 #> 4 35046 IPOBA 1 Major host Ipomoea batatas BEMITA 2025-01-15 #> 5 37151 MANES 1 Major host Manihot escule… BEMITA 2025-01-15 #> 6 38512 NIOTA 1 Major host Nicotiana taba… BEMITA 2025-01-15 #> 7 36921 LYPES 1 Major host Solanum lycope… BEMITA 2025-01-15 #> 8 23377 AMABL 6 Wild/Weed Amaranthus bli… BEMITA 2025-01-15 #> 9 23414 AMARE 6 Wild/Weed Amaranthus ret… BEMITA 2025-01-15 #> 10 24583 ATXSE 6 Wild/Weed Atriplex semib… BEMITA 2025-01-15 #> # ℹ 40 more rows #> # ℹ 1 more variable: queriedUrl #> #> $result$pests #> # A tibble: 1 × 3 #> queriedEppocode queriedOn queriedUrl #> #> 1 BEMITA 2025-01-15 https://data.eppo.int/api/rest/1.0/taxon/BEMITA/pe… #> #> $result$kingdom #> # A tibble: 1 × 6 #> codeid eppocode status queriedEppocode queriedOn queriedUrl #> #> 1 57021 1ANIMK A BEMITA 2025-01-15 https://data.eppo.int/api/r… #> #> #> $error #> NULL #>"},{"path":"/reference/taxonomyRanked.html","id":null,"dir":"Reference","previous_headings":"","what":"Merge taxonomy and kingdom data into a single dataframe — taxonomyRanked","title":"Merge taxonomy and kingdom data into a single dataframe — taxonomyRanked","text":"taxonomyRanked merges taxonomy kingdom information queried EPPO code single dataframe.","code":""},{"path":"/reference/taxonomyRanked.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Merge taxonomy and kingdom data into a single dataframe — taxonomyRanked","text":"","code":"taxonomyRanked(taxonomy, kingdom)"},{"path":"/reference/taxonomyRanked.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Merge taxonomy and kingdom data into a single dataframe — taxonomyRanked","text":"taxonomy dataframe containing taxonomy data queried EPPO code. kingdom dataframe containing kingdom data queried EPPO code.","code":""},{"path":"/reference/taxonomyRanked.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Merge taxonomy and kingdom data into a single dataframe — taxonomyRanked","text":"dataframe containing taxonomy kingdom information queried EPPO code.","code":""},{"path":"/reference/taxonomyRanked.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Merge taxonomy and kingdom data into a single dataframe — taxonomyRanked","text":"","code":"# Get taxonomy and kingdom data about Bemisia tabaci: taxonomy <- queryTheEPPOForService(\"BEMITA\", service = \"taxonomy\") kingdom <- queryTheEPPOForService(\"BEMITA\", service = \"kingdom\") # Merge taxonomy and kingdom information about Bemisia tabaci into a single dataframe: taxonomyRanked(taxonomy, kingdom) #> # A tibble: 9 × 8 #> rank codeid eppocode prefname level queriedEppocode queriedOn queriedUrl #> #> 1 kingdom 57021 1ANIMK Animalia 1 BEMITA 2025-01-15 https://d… #> 2 NA 57200 1ARTHP Arthropoda 2 BEMITA 2025-01-15 https://d… #> 3 NA 77963 1HEXAQ Hexapoda 3 BEMITA 2025-01-15 https://d… #> 4 NA 59061 1INSEC Insecta 4 BEMITA 2025-01-15 https://d… #> 5 NA 58830 1HEMIO Hemiptera 5 BEMITA 2025-01-15 https://d… #> 6 NA 73260 1STERR Sternorrh… 6 BEMITA 2025-01-15 https://d… #> 7 NA 56905 1ALEYF Aleyrodid… 7 BEMITA 2025-01-15 https://d… #> 8 NA 57321 1BEMIG Bemisia 8 BEMITA 2025-01-15 https://d… #> 9 NA 5935 BEMITA Bemisia t… 9 BEMITA 2025-01-15 https://d…"}] diff --git a/docs/site.webmanifest b/docs/site.webmanifest new file mode 100644 index 0000000..4ebda26 --- /dev/null +++ b/docs/site.webmanifest @@ -0,0 +1,21 @@ +{ + "name": "", + "short_name": "", + "icons": [ + { + "src": "/web-app-manifest-192x192.png", + "sizes": "192x192", + "type": "image/png", + "purpose": "maskable" + }, + { + "src": "/web-app-manifest-512x512.png", + "sizes": "512x512", + "type": "image/png", + "purpose": "maskable" + } + ], + "theme_color": "#ffffff", + "background_color": "#ffffff", + "display": "standalone" +} \ No newline at end of file diff --git a/docs/sitemap.xml b/docs/sitemap.xml new file mode 100644 index 0000000..ed8fc71 --- /dev/null +++ b/docs/sitemap.xml @@ -0,0 +1,17 @@ + +/404.html +/articles/eppoFindeR.html +/articles/index.html +/authors.html +/index.html +/reference/apiQuery.html +/reference/dataDump.html +/reference/eppoFindeR-package.html +/reference/gettingCountries.html +/reference/index.html +/reference/queryTheEPPOForService.html +/reference/queryTheWholeEPPO.html +/reference/queryTheWholeEPPOSafe.html +/reference/taxonomyRanked.html + + diff --git a/docs/web-app-manifest-192x192.png b/docs/web-app-manifest-192x192.png new file mode 100644 index 0000000000000000000000000000000000000000..1613969c19f0b0c1716d6ba264794cb6728b9cce GIT binary patch literal 26012 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 byDR@6i|IIs7AVeQ00000NkvXXu0mjfh_bJy literal 0 HcmV?d00001 diff --git a/docs/web-app-manifest-512x512.png b/docs/web-app-manifest-512x512.png new file mode 100644 index 0000000000000000000000000000000000000000..b342959b5479d7b65a5f52e3eacd4daab860fb14 GIT binary patch literal 155835 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 literal 0 HcmV?d00001 From d4727a8fb82bbd34382897c8932bae818cf36e39 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Wed, 15 Jan 2025 16:32:49 +0100 Subject: [PATCH 05/43] Delete docs/temp --- docs/temp | 1 - 1 file changed, 1 deletion(-) delete mode 100644 docs/temp diff --git a/docs/temp b/docs/temp deleted file mode 100644 index 8b13789..0000000 --- a/docs/temp +++ /dev/null @@ -1 +0,0 @@ - From 69cea950b96ebc8f1b5427748ca83f321bacd6a5 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Wed, 15 Jan 2025 16:34:19 +0100 Subject: [PATCH 06/43] Create temp --- docs/articles/temp | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/articles/temp diff --git a/docs/articles/temp b/docs/articles/temp new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/docs/articles/temp @@ -0,0 +1 @@ + From 261a5a37f0907a4befdeccda04c340d77848e6dc Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Wed, 15 Jan 2025 16:34:43 +0100 Subject: [PATCH 07/43] pkgdown website --- docs/articles/eppoFindeR.html | 476 ++++++++++++++++++++++++++++++++++ docs/articles/index.html | 58 +++++ 2 files changed, 534 insertions(+) create mode 100644 docs/articles/eppoFindeR.html create mode 100644 docs/articles/index.html diff --git a/docs/articles/eppoFindeR.html b/docs/articles/eppoFindeR.html new file mode 100644 index 0000000..f208251 --- /dev/null +++ b/docs/articles/eppoFindeR.html @@ -0,0 +1,476 @@ + + + + + + + +eppoFindeR • eppoFindeR + + + + + + + + + + + + + + Skip to contents + + +

+ + + + +
+
+

eppoFindeR

+ + + Source: vignettes/eppoFindeR.Rmd +
eppoFindeR.Rmd
+
+ + + +
+

Overview +

+

Welcome to the eppoFindeR package! This package is a wrapper +around the public APIs of the European and Mediterranean Plant +Protection Organization (EPPO) database. It provides a straightforward +way to access a wide range of pest-specific information that has been +produced or collected by EPPO.

+

eppoFindeR is designed for use by researchers and +practitioners working in plant protection who need easy access to the +EPPO database using R.

+
+
+

Prerequisites +

+

To use the eppoFindeR package, you need a stable internet +connection, as it interacts with the EPPO database online services to +fetch and manipulate data. A reliable internet connection is essential +for the functionality of the package.

+
+
+

Installation +

+

You can install the eppoFindeR package from CRAN using the +following command:

+
+install.packages("eppoFindeR")
+

Alternatively, if you want to install the package from GitHub (for +the latest development version), use:

+
+# install.packages("devtools")
+
+devtools::install_github("openefsa/eppoFindeR")
+
+
+

Working with API Tokens +

+

The eppoFindeR package requires your unique token to be +included in each API request for proper functionality. There are two +ways to provide this token:

+
    +
  1. +Using the .Renviron file
    +
    2. +
  2. Manually adding it to each API request
    3. +
+
+

1. Setting Environment Variables via .Renviron +

+

The .Renviron file is used to specify environment +variables that R loads at the start of every session. It is particularly +useful for setting variables, such as API keys, that can be accessed by +R scripts and functions.

+

The .Renviron file should be placed in your home +directory (e.g., C:/Users/username/Documents/.Renviron on +Windows or ~/.Renviron on Unix-like systems). You can +create or modify this file manually using any text editor.

+

In the .Renviron file, you set environment variables in +the following format:

+

EPPO_token=your-eppo-token

+

After adding your EPPO token to the .Renviron file, save +and close the file. R will automatically read the token when it starts +up, and you can access it in any R session using +Sys.getenv('EPPO_token').

+
+
+

2. Manually adding your token to each API request +

+

For functions that require an API token, you can manually specify the +token in the token argument of the function. This method is +useful if you want to use different tokens for different function calls +or if you don’t want to store the token globally. For example:

+
+queryTheEPPOForService("BEMITA", service = "general", token = "your-eppo-token")
+
+

Explanation: +

+

queryTheEPPOForService(queriedEppocode = "BEMITA", service = "general", token = "your-eppo-token"): +This calls the function with the necessary parameters:

+
    +
  • +queriedEppocode = "BEMITA": The EPPO code for which you +want to query a service.
    • +
  • +service = "general": Specifies the service you want to +query (you can replace this with any valid service type).
    • +
  • +token = "your-eppo-token": Passes the token for +authentication. Replace “your-eppo-token” with your actual EPPO token +enclosed in quotes.
    • +
+
+
+
+
+

Basic Usage +

+

The primary functionality of eppoFindeR is to query the EPPO +database for specific EPPO codes and retrieve data across various +services. Users can either choose to: 1) query a single service for a +given EPPO code or 2) query all available services in the database for +more comprehensive information.

+

For plant and pest species, the basic available information includes +scientific names, synonyms, common names in different languages, and +taxonomic position. For each pest of regulatory interest, more detailed +information can also be retrieved regarding its host plants and +categorization (quarantine status).

+

The examples below will guide you on how to use the functions in this +package to access these data, but to begin, we need to load the +eppoFindeR package with this command:

+ +

If you want to learn more about the arguments and usage of a +particular function, you can simply run:

+

help("function_name")

+

This will display the detailed documentation for the function, +including its arguments, return values, and examples.

+

For example, if you’re working with a function called +queryTheEPPOForService(), you would use:

+

help("queryTheEPPOForService")

+
+
+

Querying a Specific Service +

+

To query a specific service (e.g., categorization) for an EPPO code +(e.g., “BEMITA”), you can use the queryTheEPPOForService() +function as follows:

+
+categorization_BEMITA <- queryTheEPPOForService("BEMITA", service = "categorization")
+
+

Expected Output: +

+
+categorization_BEMITA
+#> # A tibble: 20 × 11
+#>    nomcontinent isocode country        qlist qlistlabel   yr_add yr_del yr_trans
+#>    <chr>        <chr>   <chr>          <chr> <chr>         <int> <lgl>  <lgl>   
+#>  1 America      CL      Chile          1     A1 list        2019 NA     NA      
+#>  2 Asia         BH      Bahrain        2     A2 list        2003 NA     NA      
+#>  3 Asia         KZ      Kazakhstan     1     A1 list        2017 NA     NA      
+#>  4 Europe       AZ      Azerbaijan     1     A1 list        2007 NA     NA      
+#>  5 Europe       BY      Belarus        X     Quarantine …   1994 NA     NA      
+#>  6 Europe       GE      Georgia        1     A1 list        2018 NA     NA      
+#>  7 Europe       MD      Moldova        X     Quarantine …   2017 NA     NA      
+#>  8 Europe       NO      Norway         X     Quarantine …   2012 NA     NA      
+#>  9 Europe       RU      Russia         2     A2 list        2014 NA     NA      
+#> 10 Europe       RS      Serbia         1     A1 list        2015 NA     NA      
+#> 11 Europe       CH      Switzerland    1     A1 list        2019 NA     NA      
+#> 12 Europe       TR      Türkiye        2     A2 list        2016 NA     NA      
+#> 13 Europe       UA      Ukraine        1     A1 list        2019 NA     NA      
+#> 14 Europe       GB      United Kingdom 1     A1 list        2020 NA     NA      
+#> 15 Oceania      NZ      New Zealand    X     Quarantine …   2000 NA     NA      
+#> 16 RPPO/EU      9M      EAEU           2     A2 list        2016 NA     NA      
+#> 17 RPPO/EU      9A      EPPO           2     A2 list        1989 NA     NA      
+#> 18 RPPO/EU      9L      EU             P     PZ Quaranti…   2019 NA     NA      
+#> 19 RPPO/EU      9L      EU             N     A1 Quaranti…   2019 NA     NA      
+#> 20 RPPO/EU      9H      OIRSA          2     A2 list        1992 NA     NA      
+#> # ℹ 3 more variables: queriedEppocode <chr>, queriedOn <date>,
+#> #   queriedUrl <glue>
+

categorization_BEMITA is a dataframe containing +information about the categorization of the EPPO code “BEMITA”, and +includes the following columns:

+
    +
  • +nomcontinent: The continent where the country is +located.
    • +
  • +isocode: The ISO country code.
    • +
  • +country: The name of the country or region.
    • +
  • +qlist: A code representing the pest status or +classification.
    • +
  • +qlistlabel: A label explaining the pest +classification (e.g., “A1 list” or “Quarantine pest”).
    • +
  • +yr_add: The year the country was added to the +list.
    • +
  • +yr_del: The year the country was removed (if +applicable).
    • +
  • +yr_trans: The year the country transitioned (if +applicable).
    • +
  • +queriedEppocode: The input EPPO code.
    • +
  • +queriedOn: The date when the query was +performed.
    • +
  • +queriedUrl: The queried URL.
    • +
+
+
+
+

Querying All Available Services +

+

If you wish to query all available services for the EPPO code +“BEMITA”, you can use the queryTheWholeEPPO() function. +This will return a list of dataframes, each corresponding to a different +service.

+
+result_list <- queryTheWholeEPPO("BEMITA")
+
+

Expected Output: +

+
+# Print the names of the services in the result
+names(result_list)
+#> [1] "general"        "names"          "taxonomy"       "categorization"
+#> [5] "hosts"          "pests"          "kingdom"
+
+# Print the data from a specific service, e.g., categorization
+result_list$categorization
+#> # A tibble: 20 × 11
+#>    nomcontinent isocode country        qlist qlistlabel   yr_add yr_del yr_trans
+#>    <chr>        <chr>   <chr>          <chr> <chr>         <int> <lgl>  <lgl>   
+#>  1 America      CL      Chile          1     A1 list        2019 NA     NA      
+#>  2 Asia         BH      Bahrain        2     A2 list        2003 NA     NA      
+#>  3 Asia         KZ      Kazakhstan     1     A1 list        2017 NA     NA      
+#>  4 Europe       AZ      Azerbaijan     1     A1 list        2007 NA     NA      
+#>  5 Europe       BY      Belarus        X     Quarantine …   1994 NA     NA      
+#>  6 Europe       GE      Georgia        1     A1 list        2018 NA     NA      
+#>  7 Europe       MD      Moldova        X     Quarantine …   2017 NA     NA      
+#>  8 Europe       NO      Norway         X     Quarantine …   2012 NA     NA      
+#>  9 Europe       RU      Russia         2     A2 list        2014 NA     NA      
+#> 10 Europe       RS      Serbia         1     A1 list        2015 NA     NA      
+#> 11 Europe       CH      Switzerland    1     A1 list        2019 NA     NA      
+#> 12 Europe       TR      Türkiye        2     A2 list        2016 NA     NA      
+#> 13 Europe       UA      Ukraine        1     A1 list        2019 NA     NA      
+#> 14 Europe       GB      United Kingdom 1     A1 list        2020 NA     NA      
+#> 15 Oceania      NZ      New Zealand    X     Quarantine …   2000 NA     NA      
+#> 16 RPPO/EU      9M      EAEU           2     A2 list        2016 NA     NA      
+#> 17 RPPO/EU      9A      EPPO           2     A2 list        1989 NA     NA      
+#> 18 RPPO/EU      9L      EU             P     PZ Quaranti…   2019 NA     NA      
+#> 19 RPPO/EU      9L      EU             N     A1 Quaranti…   2019 NA     NA      
+#> 20 RPPO/EU      9H      OIRSA          2     A2 list        1992 NA     NA      
+#> # ℹ 3 more variables: queriedEppocode <chr>, queriedOn <date>,
+#> #   queriedUrl <glue>
+

names(result_list) returns the names of the services: +general, names, taxonomy, categorization, hosts, pests, and kingdom.

+

Accessing a specific service (e.g., +result_list$categorization) will show the data related to +that particular service for the EPPO code “BEMITA”.

+
+
+
+

Wrangling Data +

+

The eppoFindeR package also provides a data wrangling +function, taxonomyRanked(), which can combine the data +fetched from the “taxonomy” and “kingdom” EPPO services to create a +unified, integrated dataframe.

+

For example, assume you have two dataframes: taxonomy +and kingdom, which were obtained by querying the “taxonomy” +and “kingdom” services for the EPPO code “BEMITA” using the +queryTheEPPOForService() function.

+

You can combine these two dataframes as follows:

+
+# Query the taxonomy service for the EPPO code "BEMITA"
+taxonomy <- queryTheEPPOForService("BEMITA", service = "taxonomy")
+
+# Query the kingdom service for the EPPO code "BEMITA"
+kingdom <- queryTheEPPOForService("BEMITA", service = "kingdom")
+
+# Combine taxonomy and kingdom data
+wrangled_data <- taxonomyRanked(taxonomy, kingdom)
+
+

Expected Output: +

+
+wrangled_data
+#> # A tibble: 9 × 8
+#>   rank    codeid eppocode prefname   level queriedEppocode queriedOn  queriedUrl
+#>   <chr>    <int> <chr>    <chr>      <int> <chr>           <date>     <glue>    
+#> 1 kingdom  57021 1ANIMK   Animalia       1 BEMITA          2025-01-15 https://d…
+#> 2 NA       57200 1ARTHP   Arthropoda     2 BEMITA          2025-01-15 https://d…
+#> 3 NA       77963 1HEXAQ   Hexapoda       3 BEMITA          2025-01-15 https://d…
+#> 4 NA       59061 1INSEC   Insecta        4 BEMITA          2025-01-15 https://d…
+#> 5 NA       58830 1HEMIO   Hemiptera      5 BEMITA          2025-01-15 https://d…
+#> 6 NA       73260 1STERR   Sternorrh…     6 BEMITA          2025-01-15 https://d…
+#> 7 NA       56905 1ALEYF   Aleyrodid…     7 BEMITA          2025-01-15 https://d…
+#> 8 NA       57321 1BEMIG   Bemisia        8 BEMITA          2025-01-15 https://d…
+#> 9 NA        5935 BEMITA   Bemisia t…     9 BEMITA          2025-01-15 https://d…
+

wrangled_data is a dataframe that combines the taxonomy +and kingdom information for the EPPO code “BEMITA”. This integration +provides a more comprehensive view of the organism’s taxonomic rank.

+

Specifically, the output dataframe contains the following +columns:

+
    +
  • +rank: The taxonomic rank.
    • +
  • +codeid: A unique identifier for each entry.
    • +
  • +eppocode: The EPPO code representing the taxonomic +group.
    • +
  • +prefname: The preferred name of the taxonomic group +(e.g., “Animalia”, “Insecta”).
    • +
  • +level: The taxonomic level in the hierarchy (1 for +the broadest category, progressing to more specific levels).
    • +
  • +queriedEppocode: The input EPPO code.
    • +
  • +queriedOn: The date when the query was +performed.
    • +
  • +queriedUrl: The queried URL.
    • +
+
+
+
+

Retrieving Countries in Regional Plant Protection Organizations +

+

The gettingCountries() function allows you to retrieve +all the member countries of a specific Regional Plant Protection +Organization (RPPO).

+

For example, to get the member countries of the EAEU (Eurasian +Economic Union), you can use the following command:

+
+EAEU_countries <- gettingCountries('EAEU')
+
+

Expected Output: +

+
+EAEU_countries
+#> [1] "Armenia,Belarus,Kazakhstan,Kyrgyzstan,Russia"
+

EAEU_countries is a vector of country names that are +members of the EAEU.

+
+
+
+

Data Dump for Multiple EPPO Codes +

+

The dataDump() function allows you to retrieve a +comprehensive data dump for multiple EPPO codes. This function queries +all available EPPO services for a list of input codes.

+

The following is an example of how the function can be used to query +all available EPPO services for the EPPO codes “APHIPO” and +“LEUCSC”:

+
+data_dump <- dataDump(c("APHIPO", "LEUCSC"))
+
+

Expected Output: +

+
+# Print the names of the services in the result
+names(data_dump)
+#> [1] "general"        "names"          "taxonomy"       "categorization"
+#> [5] "hosts"          "pests"          "kingdom"
+
+# Print the data from a specific service, e.g., general
+data_dump$general
+#> # A tibble: 16 × 11
+#>    pestCode codeid eppocode status c_date         m_date prefname attached_infos
+#>    <chr>     <int> <chr>    <chr>  <chr>          <chr>  <chr>    <named list>  
+#>  1 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
+#>  2 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
+#>  3 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
+#>  4 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
+#>  5 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
+#>  6 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
+#>  7 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
+#>  8 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
+#>  9 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
+#> 10 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
+#> 11 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
+#> 12 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
+#> 13 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
+#> 14 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
+#> 15 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
+#> 16 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
+#> # ℹ 3 more variables: queriedEppocode <chr>, queriedOn <date>,
+#> #   queriedUrl <glue>
+

The output is a list of dataframes, each corresponding to a different +service: general, names, taxonomy, categorization, hosts, pests, and +kingdom.

+

Accessing a specific service (e.g., data_dump$general) +will show the data related to that particular service for the EPPO codes +“APHIPO” and “LEUCSC”. The column queriedEppocode in the +dataframe distinguishes which data have been retrieved for each EPPO +code.

+
+
+
+
+ + + +
+

Developed by Luca Belmonte, Dayana Stephanie Buzle, Rafael Vieira, Agata Kaczmarek.

+
+ +
+

Site built with pkgdown 2.1.1.

+
+ +
+
+ + + + + + + diff --git a/docs/articles/index.html b/docs/articles/index.html new file mode 100644 index 0000000..6cc6c5f --- /dev/null +++ b/docs/articles/index.html @@ -0,0 +1,58 @@ + +Articles • eppoFindeR + Skip to contents + + +
+
+
+

Articles

+
+ +
+

All vignettes

+
+ +
eppoFindeR
+
+
+
+ + +
+

Developed by Luca Belmonte, Dayana Stephanie Buzle, Rafael Vieira, Agata Kaczmarek.

+
+ +
+

Site built with pkgdown 2.1.1.

+
+ +
+ + + + + + + From f086e560baa0b57eca5d44d40ecb7c1d2f3e39d4 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Wed, 15 Jan 2025 16:35:03 +0100 Subject: [PATCH 08/43] Delete docs/articles/temp --- docs/articles/temp | 1 - 1 file changed, 1 deletion(-) delete mode 100644 docs/articles/temp diff --git a/docs/articles/temp b/docs/articles/temp deleted file mode 100644 index 8b13789..0000000 --- a/docs/articles/temp +++ /dev/null @@ -1 +0,0 @@ - From 170f35c478e1d08ee3196facc0a6cbcc20607711 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Wed, 15 Jan 2025 16:38:28 +0100 Subject: [PATCH 09/43] Delete docs directory --- docs/.nojekyll | 1 - docs/404.html | 81 ----- docs/apple-touch-icon.png | Bin 23045 -> 0 bytes docs/articles/eppoFindeR.html | 476 ------------------------------ docs/articles/index.html | 58 ---- docs/authors.html | 90 ------ docs/favicon-96x96.png | Bin 8009 -> 0 bytes docs/favicon.ico | Bin 15086 -> 0 bytes docs/favicon.svg | 3 - docs/index.html | 133 --------- docs/katex-auto.js | 14 - docs/lightswitch.js | 85 ------ docs/link.svg | 12 - docs/logo.png | Bin 48235 -> 0 bytes docs/pkgdown.js | 162 ---------- docs/pkgdown.yml | 6 - docs/search.json | 1 - docs/site.webmanifest | 21 -- docs/sitemap.xml | 17 -- docs/web-app-manifest-192x192.png | Bin 26012 -> 0 bytes docs/web-app-manifest-512x512.png | Bin 155835 -> 0 bytes 21 files changed, 1160 deletions(-) delete mode 100644 docs/.nojekyll delete mode 100644 docs/404.html delete mode 100644 docs/apple-touch-icon.png delete mode 100644 docs/articles/eppoFindeR.html delete mode 100644 docs/articles/index.html delete mode 100644 docs/authors.html delete mode 100644 docs/favicon-96x96.png delete mode 100644 docs/favicon.ico delete mode 100644 docs/favicon.svg delete mode 100644 docs/index.html delete mode 100644 docs/katex-auto.js delete mode 100644 docs/lightswitch.js delete mode 100644 docs/link.svg delete mode 100644 docs/logo.png delete mode 100644 docs/pkgdown.js delete mode 100644 docs/pkgdown.yml delete mode 100644 docs/search.json delete mode 100644 docs/site.webmanifest delete mode 100644 docs/sitemap.xml delete mode 100644 docs/web-app-manifest-192x192.png delete mode 100644 docs/web-app-manifest-512x512.png diff --git a/docs/.nojekyll b/docs/.nojekyll deleted file mode 100644 index d3f5a12..0000000 --- a/docs/.nojekyll +++ /dev/null @@ -1 +0,0 @@ - diff --git a/docs/404.html b/docs/404.html deleted file mode 100644 index ed5b85f..0000000 --- a/docs/404.html +++ /dev/null @@ -1,81 +0,0 @@ - - - - - - - -Page not found (404) • eppoFindeR - - - - - - - - - - - - - - - Skip to contents - - -
-
-
-

Page not found (404)

- -
- -Content not found. Please use links in the navbar. - -
-
- - -
-

Developed by Luca Belmonte, Dayana Stephanie Buzle, Rafael Vieira, Agata Kaczmarek.

-
- -
-

Site built with pkgdown 2.1.1.

-
- -
-
- - - - - - - diff --git a/docs/apple-touch-icon.png b/docs/apple-touch-icon.png deleted file mode 100644 index 0fea86225d7348bed950d0fd5a379e29ebdf9658..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 23045 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 Y2m9MIxR2%3!2kdN07*qoM6N<$g2ZT0ssI20 diff --git a/docs/articles/eppoFindeR.html b/docs/articles/eppoFindeR.html deleted file mode 100644 index f208251..0000000 --- a/docs/articles/eppoFindeR.html +++ /dev/null @@ -1,476 +0,0 @@ - - - - - - - -eppoFindeR • eppoFindeR - - - - - - - - - - - - - - Skip to contents - - -
- - - - -
-
-

eppoFindeR

- - - Source: vignettes/eppoFindeR.Rmd -
eppoFindeR.Rmd
-
- - - -
-

Overview -

-

Welcome to the eppoFindeR package! This package is a wrapper -around the public APIs of the European and Mediterranean Plant -Protection Organization (EPPO) database. It provides a straightforward -way to access a wide range of pest-specific information that has been -produced or collected by EPPO.

-

eppoFindeR is designed for use by researchers and -practitioners working in plant protection who need easy access to the -EPPO database using R.

-
-
-

Prerequisites -

-

To use the eppoFindeR package, you need a stable internet -connection, as it interacts with the EPPO database online services to -fetch and manipulate data. A reliable internet connection is essential -for the functionality of the package.

-
-
-

Installation -

-

You can install the eppoFindeR package from CRAN using the -following command:

-
-install.packages("eppoFindeR")
-

Alternatively, if you want to install the package from GitHub (for -the latest development version), use:

-
-# install.packages("devtools")
-
-devtools::install_github("openefsa/eppoFindeR")
-
-
-

Working with API Tokens -

-

The eppoFindeR package requires your unique token to be -included in each API request for proper functionality. There are two -ways to provide this token:

-
    -
  1. -Using the .Renviron file
    -
    2. -
  2. Manually adding it to each API request
    3. -
-
-

1. Setting Environment Variables via .Renviron -

-

The .Renviron file is used to specify environment -variables that R loads at the start of every session. It is particularly -useful for setting variables, such as API keys, that can be accessed by -R scripts and functions.

-

The .Renviron file should be placed in your home -directory (e.g., C:/Users/username/Documents/.Renviron on -Windows or ~/.Renviron on Unix-like systems). You can -create or modify this file manually using any text editor.

-

In the .Renviron file, you set environment variables in -the following format:

-

EPPO_token=your-eppo-token

-

After adding your EPPO token to the .Renviron file, save -and close the file. R will automatically read the token when it starts -up, and you can access it in any R session using -Sys.getenv('EPPO_token').

-
-
-

2. Manually adding your token to each API request -

-

For functions that require an API token, you can manually specify the -token in the token argument of the function. This method is -useful if you want to use different tokens for different function calls -or if you don’t want to store the token globally. For example:

-
-queryTheEPPOForService("BEMITA", service = "general", token = "your-eppo-token")
-
-

Explanation: -

-

queryTheEPPOForService(queriedEppocode = "BEMITA", service = "general", token = "your-eppo-token"): -This calls the function with the necessary parameters:

-
    -
  • -queriedEppocode = "BEMITA": The EPPO code for which you -want to query a service.
    • -
  • -service = "general": Specifies the service you want to -query (you can replace this with any valid service type).
    • -
  • -token = "your-eppo-token": Passes the token for -authentication. Replace “your-eppo-token” with your actual EPPO token -enclosed in quotes.
    • -
-
-
-
-
-

Basic Usage -

-

The primary functionality of eppoFindeR is to query the EPPO -database for specific EPPO codes and retrieve data across various -services. Users can either choose to: 1) query a single service for a -given EPPO code or 2) query all available services in the database for -more comprehensive information.

-

For plant and pest species, the basic available information includes -scientific names, synonyms, common names in different languages, and -taxonomic position. For each pest of regulatory interest, more detailed -information can also be retrieved regarding its host plants and -categorization (quarantine status).

-

The examples below will guide you on how to use the functions in this -package to access these data, but to begin, we need to load the -eppoFindeR package with this command:

- -

If you want to learn more about the arguments and usage of a -particular function, you can simply run:

-

help("function_name")

-

This will display the detailed documentation for the function, -including its arguments, return values, and examples.

-

For example, if you’re working with a function called -queryTheEPPOForService(), you would use:

-

help("queryTheEPPOForService")

-
-
-

Querying a Specific Service -

-

To query a specific service (e.g., categorization) for an EPPO code -(e.g., “BEMITA”), you can use the queryTheEPPOForService() -function as follows:

-
-categorization_BEMITA <- queryTheEPPOForService("BEMITA", service = "categorization")
-
-

Expected Output: -

-
-categorization_BEMITA
-#> # A tibble: 20 × 11
-#>    nomcontinent isocode country        qlist qlistlabel   yr_add yr_del yr_trans
-#>    <chr>        <chr>   <chr>          <chr> <chr>         <int> <lgl>  <lgl>   
-#>  1 America      CL      Chile          1     A1 list        2019 NA     NA      
-#>  2 Asia         BH      Bahrain        2     A2 list        2003 NA     NA      
-#>  3 Asia         KZ      Kazakhstan     1     A1 list        2017 NA     NA      
-#>  4 Europe       AZ      Azerbaijan     1     A1 list        2007 NA     NA      
-#>  5 Europe       BY      Belarus        X     Quarantine …   1994 NA     NA      
-#>  6 Europe       GE      Georgia        1     A1 list        2018 NA     NA      
-#>  7 Europe       MD      Moldova        X     Quarantine …   2017 NA     NA      
-#>  8 Europe       NO      Norway         X     Quarantine …   2012 NA     NA      
-#>  9 Europe       RU      Russia         2     A2 list        2014 NA     NA      
-#> 10 Europe       RS      Serbia         1     A1 list        2015 NA     NA      
-#> 11 Europe       CH      Switzerland    1     A1 list        2019 NA     NA      
-#> 12 Europe       TR      Türkiye        2     A2 list        2016 NA     NA      
-#> 13 Europe       UA      Ukraine        1     A1 list        2019 NA     NA      
-#> 14 Europe       GB      United Kingdom 1     A1 list        2020 NA     NA      
-#> 15 Oceania      NZ      New Zealand    X     Quarantine …   2000 NA     NA      
-#> 16 RPPO/EU      9M      EAEU           2     A2 list        2016 NA     NA      
-#> 17 RPPO/EU      9A      EPPO           2     A2 list        1989 NA     NA      
-#> 18 RPPO/EU      9L      EU             P     PZ Quaranti…   2019 NA     NA      
-#> 19 RPPO/EU      9L      EU             N     A1 Quaranti…   2019 NA     NA      
-#> 20 RPPO/EU      9H      OIRSA          2     A2 list        1992 NA     NA      
-#> # ℹ 3 more variables: queriedEppocode <chr>, queriedOn <date>,
-#> #   queriedUrl <glue>
-

categorization_BEMITA is a dataframe containing -information about the categorization of the EPPO code “BEMITA”, and -includes the following columns:

-
    -
  • -nomcontinent: The continent where the country is -located.
    • -
  • -isocode: The ISO country code.
    • -
  • -country: The name of the country or region.
    • -
  • -qlist: A code representing the pest status or -classification.
    • -
  • -qlistlabel: A label explaining the pest -classification (e.g., “A1 list” or “Quarantine pest”).
    • -
  • -yr_add: The year the country was added to the -list.
    • -
  • -yr_del: The year the country was removed (if -applicable).
    • -
  • -yr_trans: The year the country transitioned (if -applicable).
    • -
  • -queriedEppocode: The input EPPO code.
    • -
  • -queriedOn: The date when the query was -performed.
    • -
  • -queriedUrl: The queried URL.
    • -
-
-
-
-

Querying All Available Services -

-

If you wish to query all available services for the EPPO code -“BEMITA”, you can use the queryTheWholeEPPO() function. -This will return a list of dataframes, each corresponding to a different -service.

-
-result_list <- queryTheWholeEPPO("BEMITA")
-
-

Expected Output: -

-
-# Print the names of the services in the result
-names(result_list)
-#> [1] "general"        "names"          "taxonomy"       "categorization"
-#> [5] "hosts"          "pests"          "kingdom"
-
-# Print the data from a specific service, e.g., categorization
-result_list$categorization
-#> # A tibble: 20 × 11
-#>    nomcontinent isocode country        qlist qlistlabel   yr_add yr_del yr_trans
-#>    <chr>        <chr>   <chr>          <chr> <chr>         <int> <lgl>  <lgl>   
-#>  1 America      CL      Chile          1     A1 list        2019 NA     NA      
-#>  2 Asia         BH      Bahrain        2     A2 list        2003 NA     NA      
-#>  3 Asia         KZ      Kazakhstan     1     A1 list        2017 NA     NA      
-#>  4 Europe       AZ      Azerbaijan     1     A1 list        2007 NA     NA      
-#>  5 Europe       BY      Belarus        X     Quarantine …   1994 NA     NA      
-#>  6 Europe       GE      Georgia        1     A1 list        2018 NA     NA      
-#>  7 Europe       MD      Moldova        X     Quarantine …   2017 NA     NA      
-#>  8 Europe       NO      Norway         X     Quarantine …   2012 NA     NA      
-#>  9 Europe       RU      Russia         2     A2 list        2014 NA     NA      
-#> 10 Europe       RS      Serbia         1     A1 list        2015 NA     NA      
-#> 11 Europe       CH      Switzerland    1     A1 list        2019 NA     NA      
-#> 12 Europe       TR      Türkiye        2     A2 list        2016 NA     NA      
-#> 13 Europe       UA      Ukraine        1     A1 list        2019 NA     NA      
-#> 14 Europe       GB      United Kingdom 1     A1 list        2020 NA     NA      
-#> 15 Oceania      NZ      New Zealand    X     Quarantine …   2000 NA     NA      
-#> 16 RPPO/EU      9M      EAEU           2     A2 list        2016 NA     NA      
-#> 17 RPPO/EU      9A      EPPO           2     A2 list        1989 NA     NA      
-#> 18 RPPO/EU      9L      EU             P     PZ Quaranti…   2019 NA     NA      
-#> 19 RPPO/EU      9L      EU             N     A1 Quaranti…   2019 NA     NA      
-#> 20 RPPO/EU      9H      OIRSA          2     A2 list        1992 NA     NA      
-#> # ℹ 3 more variables: queriedEppocode <chr>, queriedOn <date>,
-#> #   queriedUrl <glue>
-

names(result_list) returns the names of the services: -general, names, taxonomy, categorization, hosts, pests, and kingdom.

-

Accessing a specific service (e.g., -result_list$categorization) will show the data related to -that particular service for the EPPO code “BEMITA”.

-
-
-
-

Wrangling Data -

-

The eppoFindeR package also provides a data wrangling -function, taxonomyRanked(), which can combine the data -fetched from the “taxonomy” and “kingdom” EPPO services to create a -unified, integrated dataframe.

-

For example, assume you have two dataframes: taxonomy -and kingdom, which were obtained by querying the “taxonomy” -and “kingdom” services for the EPPO code “BEMITA” using the -queryTheEPPOForService() function.

-

You can combine these two dataframes as follows:

-
-# Query the taxonomy service for the EPPO code "BEMITA"
-taxonomy <- queryTheEPPOForService("BEMITA", service = "taxonomy")
-
-# Query the kingdom service for the EPPO code "BEMITA"
-kingdom <- queryTheEPPOForService("BEMITA", service = "kingdom")
-
-# Combine taxonomy and kingdom data
-wrangled_data <- taxonomyRanked(taxonomy, kingdom)
-
-

Expected Output: -

-
-wrangled_data
-#> # A tibble: 9 × 8
-#>   rank    codeid eppocode prefname   level queriedEppocode queriedOn  queriedUrl
-#>   <chr>    <int> <chr>    <chr>      <int> <chr>           <date>     <glue>    
-#> 1 kingdom  57021 1ANIMK   Animalia       1 BEMITA          2025-01-15 https://d…
-#> 2 NA       57200 1ARTHP   Arthropoda     2 BEMITA          2025-01-15 https://d…
-#> 3 NA       77963 1HEXAQ   Hexapoda       3 BEMITA          2025-01-15 https://d…
-#> 4 NA       59061 1INSEC   Insecta        4 BEMITA          2025-01-15 https://d…
-#> 5 NA       58830 1HEMIO   Hemiptera      5 BEMITA          2025-01-15 https://d…
-#> 6 NA       73260 1STERR   Sternorrh…     6 BEMITA          2025-01-15 https://d…
-#> 7 NA       56905 1ALEYF   Aleyrodid…     7 BEMITA          2025-01-15 https://d…
-#> 8 NA       57321 1BEMIG   Bemisia        8 BEMITA          2025-01-15 https://d…
-#> 9 NA        5935 BEMITA   Bemisia t…     9 BEMITA          2025-01-15 https://d…
-

wrangled_data is a dataframe that combines the taxonomy -and kingdom information for the EPPO code “BEMITA”. This integration -provides a more comprehensive view of the organism’s taxonomic rank.

-

Specifically, the output dataframe contains the following -columns:

-
    -
  • -rank: The taxonomic rank.
    • -
  • -codeid: A unique identifier for each entry.
    • -
  • -eppocode: The EPPO code representing the taxonomic -group.
    • -
  • -prefname: The preferred name of the taxonomic group -(e.g., “Animalia”, “Insecta”).
    • -
  • -level: The taxonomic level in the hierarchy (1 for -the broadest category, progressing to more specific levels).
    • -
  • -queriedEppocode: The input EPPO code.
    • -
  • -queriedOn: The date when the query was -performed.
    • -
  • -queriedUrl: The queried URL.
    • -
-
-
-
-

Retrieving Countries in Regional Plant Protection Organizations -

-

The gettingCountries() function allows you to retrieve -all the member countries of a specific Regional Plant Protection -Organization (RPPO).

-

For example, to get the member countries of the EAEU (Eurasian -Economic Union), you can use the following command:

-
-EAEU_countries <- gettingCountries('EAEU')
-
-

Expected Output: -

-
-EAEU_countries
-#> [1] "Armenia,Belarus,Kazakhstan,Kyrgyzstan,Russia"
-

EAEU_countries is a vector of country names that are -members of the EAEU.

-
-
-
-

Data Dump for Multiple EPPO Codes -

-

The dataDump() function allows you to retrieve a -comprehensive data dump for multiple EPPO codes. This function queries -all available EPPO services for a list of input codes.

-

The following is an example of how the function can be used to query -all available EPPO services for the EPPO codes “APHIPO” and -“LEUCSC”:

-
-data_dump <- dataDump(c("APHIPO", "LEUCSC"))
-
-

Expected Output: -

-
-# Print the names of the services in the result
-names(data_dump)
-#> [1] "general"        "names"          "taxonomy"       "categorization"
-#> [5] "hosts"          "pests"          "kingdom"
-
-# Print the data from a specific service, e.g., general
-data_dump$general
-#> # A tibble: 16 × 11
-#>    pestCode codeid eppocode status c_date         m_date prefname attached_infos
-#>    <chr>     <int> <chr>    <chr>  <chr>          <chr>  <chr>    <named list>  
-#>  1 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
-#>  2 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
-#>  3 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
-#>  4 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
-#>  5 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
-#>  6 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
-#>  7 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
-#>  8 APHIPO     5050 APHIPO   A      2002-09-17 00… 2002-… Aphis p… <int [1]>     
-#>  9 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
-#> 10 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
-#> 11 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
-#> 12 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
-#> 13 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
-#> 14 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
-#> 15 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
-#> 16 LEUCSC    13110 LEUCSC   A      2000-12-25 00… 2000-… Leucopt… <int [1]>     
-#> # ℹ 3 more variables: queriedEppocode <chr>, queriedOn <date>,
-#> #   queriedUrl <glue>
-

The output is a list of dataframes, each corresponding to a different -service: general, names, taxonomy, categorization, hosts, pests, and -kingdom.

-

Accessing a specific service (e.g., data_dump$general) -will show the data related to that particular service for the EPPO codes -“APHIPO” and “LEUCSC”. The column queriedEppocode in the -dataframe distinguishes which data have been retrieved for each EPPO -code.

-
-
-
-
- - - -
-

Developed by Luca Belmonte, Dayana Stephanie Buzle, Rafael Vieira, Agata Kaczmarek.

-
- -
-

Site built with pkgdown 2.1.1.

-
- -
-
- - - - - - - diff --git a/docs/articles/index.html b/docs/articles/index.html deleted file mode 100644 index 6cc6c5f..0000000 --- a/docs/articles/index.html +++ /dev/null @@ -1,58 +0,0 @@ - -Articles • eppoFindeR - Skip to contents - - -
-
-
-

Articles

-
- -
-

All vignettes

-
- -
eppoFindeR
-
-
-
- - -
-

Developed by Luca Belmonte, Dayana Stephanie Buzle, Rafael Vieira, Agata Kaczmarek.

-
- -
-

Site built with pkgdown 2.1.1.

-
- -
- - - - - - - diff --git a/docs/authors.html b/docs/authors.html deleted file mode 100644 index ff487d9..0000000 --- a/docs/authors.html +++ /dev/null @@ -1,90 +0,0 @@ - -Authors and Citation • eppoFindeR - Skip to contents - - -
-
-
-

Authors and Citation

-
- -
-

Authors

- -
  • -

    Luca Belmonte. Author, maintainer. -

    -
    • -
  • -

    Dayana Stephanie Buzle. Author. -

    -
    • -
  • -

    Rafael Vieira. Author. -

    -
    • -
  • -

    Agata Kaczmarek. Author. -

    -
    • -
- -
-

Citation

-

Source: DESCRIPTION

- -

Belmonte L, Buzle D, Vieira R, Kaczmarek A (2025). -eppoFindeR: A Wrapper for EPPO Codes. -R package version 1.0.0, https://CRAN.R-project.org/package=eppoFindeR. -

- 
@Manual{,
-  title = {eppoFindeR: A Wrapper for EPPO Codes},
-  author = {Luca Belmonte and Dayana Stephanie Buzle and Rafael Vieira and Agata Kaczmarek},
-  year = {2025},
-  note = {R package version 1.0.0},
-  url = {https://CRAN.R-project.org/package=eppoFindeR},
-}
-
- -
- - -
-

Developed by Luca Belmonte, Dayana Stephanie Buzle, Rafael Vieira, Agata Kaczmarek.

-
- -
-

Site built with pkgdown 2.1.1.

-
- -
- - - - - - - diff --git a/docs/favicon-96x96.png b/docs/favicon-96x96.png deleted file mode 100644 index ccab40ff11ceb87c3bb1111c4e24cb9cabc6e764..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8009 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 LNkvXXu0mjfOz%C? diff --git a/docs/favicon.ico b/docs/favicon.ico deleted file mode 100644 index b67f5aa84b5a43d27521f14b49c12fae36a0e1a1..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 15086 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 \ No newline at end of file diff --git a/docs/index.html b/docs/index.html deleted file mode 100644 index e60bf53..0000000 --- a/docs/index.html +++ /dev/null @@ -1,133 +0,0 @@ - - - - - - - -A Wrapper for EPPO Codes • eppoFindeR - - - - - - - - - - - - - - - - - Skip to contents - - -
-
-
-
-

eppoFindeR -

-
-

Lifecycle: stable codecov

-
-
-

Introduction -

-

Welcome to the eppoFindeR package! This package is a wrapper around the public APIs of the European and Mediterranean Plant Protection Organization (EPPO) database. It provides a straightforward way to access a wide range of pest-specific information that has been produced or collected by EPPO.

-

eppoFindeR is designed for use by researchers and practitioners working in plant protection who need easy access to the EPPO database using R.

-
-
-

Getting Started -

-

To use the eppoFindeR package, you need a stable internet connection, as it interacts with the EPPO database online services to fetch and manipulate data. A reliable internet connection is essential for the functionality of the package.

-

You can install the eppoFindeR package from CRAN using the following command:

-
install.packages("eppoFindeR")
-

For a detailed guide and usage examples, please refer to the full vignette.

-
- -
-
- - -
-

Developed by Luca Belmonte, Dayana Stephanie Buzle, Rafael Vieira, Agata Kaczmarek.

-
- -
-

Site built with pkgdown 2.1.1.

-
- -
-
- - - - - - - diff --git a/docs/katex-auto.js b/docs/katex-auto.js deleted file mode 100644 index 20651d9..0000000 --- a/docs/katex-auto.js +++ /dev/null @@ -1,14 +0,0 @@ -// https://github.com/jgm/pandoc/blob/29fa97ab96b8e2d62d48326e1b949a71dc41f47a/src/Text/Pandoc/Writers/HTML.hs#L332-L345 -document.addEventListener("DOMContentLoaded", function () { - var mathElements = document.getElementsByClassName("math"); - var macros = []; - for (var i = 0; i < mathElements.length; i++) { - var texText = mathElements[i].firstChild; - if (mathElements[i].tagName == "SPAN") { - katex.render(texText.data, mathElements[i], { - displayMode: mathElements[i].classList.contains("display"), - throwOnError: false, - macros: macros, - fleqn: false - }); - }}}); diff --git a/docs/lightswitch.js b/docs/lightswitch.js deleted file mode 100644 index 9467125..0000000 --- a/docs/lightswitch.js +++ /dev/null @@ -1,85 +0,0 @@ - -/*! - * Color mode toggler for Bootstrap's docs (https://getbootstrap.com/) - * Copyright 2011-2023 The Bootstrap Authors - * Licensed under the Creative Commons Attribution 3.0 Unported License. - * Updates for {pkgdown} by the {bslib} authors, also licensed under CC-BY-3.0. - */ - -const getStoredTheme = () => localStorage.getItem('theme') -const setStoredTheme = theme => localStorage.setItem('theme', theme) - -const getPreferredTheme = () => { - const storedTheme = getStoredTheme() - if (storedTheme) { - return storedTheme - } - - return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light' -} - -const setTheme = theme => { - if (theme === 'auto') { - document.documentElement.setAttribute('data-bs-theme', (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light')) - } else { - document.documentElement.setAttribute('data-bs-theme', theme) - } -} - -function bsSetupThemeToggle () { - 'use strict' - - const showActiveTheme = (theme, focus = false) => { - var activeLabel, activeIcon; - - document.querySelectorAll('[data-bs-theme-value]').forEach(element => { - const buttonTheme = element.getAttribute('data-bs-theme-value') - const isActive = buttonTheme == theme - - element.classList.toggle('active', isActive) - element.setAttribute('aria-pressed', isActive) - - if (isActive) { - activeLabel = element.textContent; - activeIcon = element.querySelector('span').classList.value; - } - }) - - const themeSwitcher = document.querySelector('#dropdown-lightswitch') - if (!themeSwitcher) { - return - } - - themeSwitcher.setAttribute('aria-label', activeLabel) - themeSwitcher.querySelector('span').classList.value = activeIcon; - - if (focus) { - themeSwitcher.focus() - } - } - - window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => { - const storedTheme = getStoredTheme() - if (storedTheme !== 'light' && storedTheme !== 'dark') { - setTheme(getPreferredTheme()) - } - }) - - window.addEventListener('DOMContentLoaded', () => { - showActiveTheme(getPreferredTheme()) - - document - .querySelectorAll('[data-bs-theme-value]') - .forEach(toggle => { - toggle.addEventListener('click', () => { - const theme = toggle.getAttribute('data-bs-theme-value') - setTheme(theme) - setStoredTheme(theme) - showActiveTheme(theme, true) - }) - }) - }) -} - -setTheme(getPreferredTheme()); -bsSetupThemeToggle(); diff --git a/docs/link.svg b/docs/link.svg deleted file mode 100644 index 88ad827..0000000 --- a/docs/link.svg +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - diff --git a/docs/logo.png b/docs/logo.png deleted file mode 100644 index 739a715eb4efdccc3e35e8425122d80efec3e355..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 48235 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

!x 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 ZYr@IGGU)q)32p)*BcUi>Eov0>e*icClMes@ diff --git a/docs/pkgdown.js b/docs/pkgdown.js deleted file mode 100644 index 1a99c65..0000000 --- a/docs/pkgdown.js +++ /dev/null @@ -1,162 +0,0 @@ -/* http://gregfranko.com/blog/jquery-best-practices/ */ -(function($) { - $(function() { - - $('nav.navbar').headroom(); - - Toc.init({ - $nav: $("#toc"), - $scope: $("main h2, main h3, main h4, main h5, main h6") - }); - - if ($('#toc').length) { - $('body').scrollspy({ - target: '#toc', - offset: $("nav.navbar").outerHeight() + 1 - }); - } - - // Activate popovers - $('[data-bs-toggle="popover"]').popover({ - container: 'body', - html: true, - trigger: 'focus', - placement: "top", - sanitize: false, - }); - - $('[data-bs-toggle="tooltip"]').tooltip(); - - /* Clipboard --------------------------*/ - - function changeTooltipMessage(element, msg) { - var tooltipOriginalTitle=element.getAttribute('data-bs-original-title'); - element.setAttribute('data-bs-original-title', msg); - $(element).tooltip('show'); - element.setAttribute('data-bs-original-title', tooltipOriginalTitle); - } - - if(ClipboardJS.isSupported()) { - $(document).ready(function() { - var copyButton = ""; - - $("div.sourceCode").addClass("hasCopyButton"); - - // Insert copy buttons: - $(copyButton).prependTo(".hasCopyButton"); - - // Initialize tooltips: - $('.btn-copy-ex').tooltip({container: 'body'}); - - // Initialize clipboard: - var clipboard = new ClipboardJS('[data-clipboard-copy]', { - text: function(trigger) { - return trigger.parentNode.textContent.replace(/\n#>[^\n]*/g, ""); - } - }); - - clipboard.on('success', function(e) { - changeTooltipMessage(e.trigger, 'Copied!'); - e.clearSelection(); - }); - - clipboard.on('error', function(e) { - changeTooltipMessage(e.trigger,'Press Ctrl+C or Command+C to copy'); - }); - - }); - } - - /* Search marking --------------------------*/ - var url = new URL(window.location.href); - var toMark = url.searchParams.get("q"); - var mark = new Mark("main#main"); - if (toMark) { - mark.mark(toMark, { - accuracy: { - value: "complementary", - limiters: [",", ".", ":", "/"], - } - }); - } - - /* Search --------------------------*/ - /* Adapted from https://github.com/rstudio/bookdown/blob/2d692ba4b61f1e466c92e78fd712b0ab08c11d31/inst/resources/bs4_book/bs4_book.js#L25 */ - // Initialise search index on focus - var fuse; - $("#search-input").focus(async function(e) { - if (fuse) { - return; - } - - $(e.target).addClass("loading"); - var response = await fetch($("#search-input").data("search-index")); - var data = await response.json(); - - var options = { - keys: ["what", "text", "code"], - ignoreLocation: true, - threshold: 0.1, - includeMatches: true, - includeScore: true, - }; - fuse = new Fuse(data, options); - - $(e.target).removeClass("loading"); - }); - - // Use algolia autocomplete - var options = { - autoselect: true, - debug: true, - hint: false, - minLength: 2, - }; - var q; -async function searchFuse(query, callback) { - await fuse; - - var items; - if (!fuse) { - items = []; - } else { - q = query; - var results = fuse.search(query, { limit: 20 }); - items = results - .filter((x) => x.score <= 0.75) - .map((x) => x.item); - if (items.length === 0) { - items = [{dir:"Sorry 😿",previous_headings:"",title:"No results found.",what:"No results found.",path:window.location.href}]; - } - } - callback(items); -} - $("#search-input").autocomplete(options, [ - { - name: "content", - source: searchFuse, - templates: { - suggestion: (s) => { - if (s.title == s.what) { - return `${s.dir} >

${s.title}
`; - } else if (s.previous_headings == "") { - return `${s.dir} >
${s.title}
> ${s.what}`; - } else { - return `${s.dir} >
${s.title}
> ${s.previous_headings} > ${s.what}`; - } - }, - }, - }, - ]).on('autocomplete:selected', function(event, s) { - window.location.href = s.path + "?q=" + q + "#" + s.id; - }); - }); -})(window.jQuery || window.$) - -document.addEventListener('keydown', function(event) { - // Check if the pressed key is '/' - if (event.key === '/') { - event.preventDefault(); // Prevent any default action associated with the '/' key - document.getElementById('search-input').focus(); // Set focus to the search input - } -}); diff --git a/docs/pkgdown.yml b/docs/pkgdown.yml deleted file mode 100644 index 04b29f9..0000000 --- a/docs/pkgdown.yml +++ /dev/null @@ -1,6 +0,0 @@ -pandoc: 3.1.11 -pkgdown: 2.1.1 -pkgdown_sha: ~ -articles: - eppoFindeR: eppoFindeR.html -last_built: 2025-01-15T15:25Z diff --git a/docs/search.json b/docs/search.json deleted file mode 100644 index d1e4aaa..0000000 --- a/docs/search.json +++ /dev/null @@ -1 +0,0 @@ -[{"path":"/articles/eppoFindeR.html","id":"overview","dir":"Articles","previous_headings":"","what":"Overview","title":"eppoFindeR","text":"Welcome eppoFindeR package! package wrapper around public APIs European Mediterranean Plant Protection Organization (EPPO) database. provides straightforward way access wide range pest-specific information produced collected EPPO. eppoFindeR designed use researchers practitioners working plant protection need easy access EPPO database using R.","code":""},{"path":"/articles/eppoFindeR.html","id":"prerequisites","dir":"Articles","previous_headings":"","what":"Prerequisites","title":"eppoFindeR","text":"use eppoFindeR package, need stable internet connection, interacts EPPO database online services fetch manipulate data. reliable internet connection essential functionality package.","code":""},{"path":"/articles/eppoFindeR.html","id":"installation","dir":"Articles","previous_headings":"","what":"Installation","title":"eppoFindeR","text":"can install eppoFindeR package CRAN using following command: Alternatively, want install package GitHub (latest development version), use:","code":"install.packages(\"eppoFindeR\") # install.packages(\"devtools\") devtools::install_github(\"openefsa/eppoFindeR\")"},{"path":"/articles/eppoFindeR.html","id":"working-with-api-tokens","dir":"Articles","previous_headings":"","what":"Working with API Tokens","title":"eppoFindeR","text":"eppoFindeR package requires unique token included API request proper functionality. two ways provide token: Using .Renviron file Manually adding API request","code":""},{"path":"/articles/eppoFindeR.html","id":"setting-environment-variables-via--renviron","dir":"Articles","previous_headings":"Working with API Tokens","what":"1. Setting Environment Variables via .Renviron","title":"eppoFindeR","text":".Renviron file used specify environment variables R loads start every session. particularly useful setting variables, API keys, can accessed R scripts functions. .Renviron file placed home directory (e.g., C:/Users/username/Documents/.Renviron Windows ~/.Renviron Unix-like systems). can create modify file manually using text editor. .Renviron file, set environment variables following format: EPPO_token=-eppo-token adding EPPO token .Renviron file, save close file. R automatically read token starts , can access R session using Sys.getenv('EPPO_token').","code":""},{"path":"/articles/eppoFindeR.html","id":"manually-adding-your-token-to-each-api-request","dir":"Articles","previous_headings":"Working with API Tokens","what":"2. Manually adding your token to each API request","title":"eppoFindeR","text":"functions require API token, can manually specify token token argument function. method useful want use different tokens different function calls don’t want store token globally. example:","code":"queryTheEPPOForService(\"BEMITA\", service = \"general\", token = \"your-eppo-token\")"},{"path":"/articles/eppoFindeR.html","id":"explanation","dir":"Articles","previous_headings":"Working with API Tokens > 2. Manually adding your token to each API request","what":"Explanation:","title":"eppoFindeR","text":"queryTheEPPOForService(queriedEppocode = \"BEMITA\", service = \"general\", token = \"-eppo-token\"): calls function necessary parameters: queriedEppocode = \"BEMITA\": EPPO code want query service. service = \"general\": Specifies service want query (can replace valid service type). token = \"-eppo-token\": Passes token authentication. Replace “-eppo-token” actual EPPO token enclosed quotes.","code":""},{"path":"/articles/eppoFindeR.html","id":"basic-usage","dir":"Articles","previous_headings":"","what":"Basic Usage","title":"eppoFindeR","text":"primary functionality eppoFindeR query EPPO database specific EPPO codes retrieve data across various services. Users can either choose : 1) query single service given EPPO code 2) query available services database comprehensive information. plant pest species, basic available information includes scientific names, synonyms, common names different languages, taxonomic position. pest regulatory interest, detailed information can also retrieved regarding host plants categorization (quarantine status). examples guide use functions package access data, begin, need load eppoFindeR package command: want learn arguments usage particular function, can simply run: help(\"function_name\") display detailed documentation function, including arguments, return values, examples. example, ’re working function called queryTheEPPOForService(), use: help(\"queryTheEPPOForService\")","code":"library(eppoFindeR)"},{"path":"/articles/eppoFindeR.html","id":"querying-a-specific-service","dir":"Articles","previous_headings":"","what":"Querying a Specific Service","title":"eppoFindeR","text":"query specific service (e.g., categorization) EPPO code (e.g., “BEMITA”), can use queryTheEPPOForService() function follows:","code":"categorization_BEMITA <- queryTheEPPOForService(\"BEMITA\", service = \"categorization\")"},{"path":"/articles/eppoFindeR.html","id":"expected-output","dir":"Articles","previous_headings":"Querying a Specific Service","what":"Expected Output:","title":"eppoFindeR","text":"categorization_BEMITA dataframe containing information categorization EPPO code “BEMITA”, includes following columns: nomcontinent: continent country located. isocode: ISO country code. country: name country region. qlist: code representing pest status classification. qlistlabel: label explaining pest classification (e.g., “A1 list” “Quarantine pest”). yr_add: year country added list. yr_del: year country removed (applicable). yr_trans: year country transitioned (applicable). queriedEppocode: input EPPO code. queriedOn: date query performed. queriedUrl: queried URL.","code":"categorization_BEMITA #> # A tibble: 20 × 11 #> nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 America CL Chile 1 A1 list 2019 NA NA #> 2 Asia BH Bahrain 2 A2 list 2003 NA NA #> 3 Asia KZ Kazakhstan 1 A1 list 2017 NA NA #> 4 Europe AZ Azerbaijan 1 A1 list 2007 NA NA #> 5 Europe BY Belarus X Quarantine … 1994 NA NA #> 6 Europe GE Georgia 1 A1 list 2018 NA NA #> 7 Europe MD Moldova X Quarantine … 2017 NA NA #> 8 Europe NO Norway X Quarantine … 2012 NA NA #> 9 Europe RU Russia 2 A2 list 2014 NA NA #> 10 Europe RS Serbia 1 A1 list 2015 NA NA #> 11 Europe CH Switzerland 1 A1 list 2019 NA NA #> 12 Europe TR Türkiye 2 A2 list 2016 NA NA #> 13 Europe UA Ukraine 1 A1 list 2019 NA NA #> 14 Europe GB United Kingdom 1 A1 list 2020 NA NA #> 15 Oceania NZ New Zealand X Quarantine … 2000 NA NA #> 16 RPPO/EU 9M EAEU 2 A2 list 2016 NA NA #> 17 RPPO/EU 9A EPPO 2 A2 list 1989 NA NA #> 18 RPPO/EU 9L EU P PZ Quaranti… 2019 NA NA #> 19 RPPO/EU 9L EU N A1 Quaranti… 2019 NA NA #> 20 RPPO/EU 9H OIRSA 2 A2 list 1992 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl "},{"path":"/articles/eppoFindeR.html","id":"querying-all-available-services","dir":"Articles","previous_headings":"","what":"Querying All Available Services","title":"eppoFindeR","text":"wish query available services EPPO code “BEMITA”, can use queryTheWholeEPPO() function. return list dataframes, corresponding different service.","code":"result_list <- queryTheWholeEPPO(\"BEMITA\")"},{"path":"/articles/eppoFindeR.html","id":"expected-output-1","dir":"Articles","previous_headings":"Querying All Available Services","what":"Expected Output:","title":"eppoFindeR","text":"names(result_list) returns names services: general, names, taxonomy, categorization, hosts, pests, kingdom. Accessing specific service (e.g., result_list$categorization) show data related particular service EPPO code “BEMITA”.","code":"# Print the names of the services in the result names(result_list) #> [1] \"general\" \"names\" \"taxonomy\" \"categorization\" #> [5] \"hosts\" \"pests\" \"kingdom\" # Print the data from a specific service, e.g., categorization result_list$categorization #> # A tibble: 20 × 11 #> nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 America CL Chile 1 A1 list 2019 NA NA #> 2 Asia BH Bahrain 2 A2 list 2003 NA NA #> 3 Asia KZ Kazakhstan 1 A1 list 2017 NA NA #> 4 Europe AZ Azerbaijan 1 A1 list 2007 NA NA #> 5 Europe BY Belarus X Quarantine … 1994 NA NA #> 6 Europe GE Georgia 1 A1 list 2018 NA NA #> 7 Europe MD Moldova X Quarantine … 2017 NA NA #> 8 Europe NO Norway X Quarantine … 2012 NA NA #> 9 Europe RU Russia 2 A2 list 2014 NA NA #> 10 Europe RS Serbia 1 A1 list 2015 NA NA #> 11 Europe CH Switzerland 1 A1 list 2019 NA NA #> 12 Europe TR Türkiye 2 A2 list 2016 NA NA #> 13 Europe UA Ukraine 1 A1 list 2019 NA NA #> 14 Europe GB United Kingdom 1 A1 list 2020 NA NA #> 15 Oceania NZ New Zealand X Quarantine … 2000 NA NA #> 16 RPPO/EU 9M EAEU 2 A2 list 2016 NA NA #> 17 RPPO/EU 9A EPPO 2 A2 list 1989 NA NA #> 18 RPPO/EU 9L EU P PZ Quaranti… 2019 NA NA #> 19 RPPO/EU 9L EU N A1 Quaranti… 2019 NA NA #> 20 RPPO/EU 9H OIRSA 2 A2 list 1992 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl "},{"path":"/articles/eppoFindeR.html","id":"wrangling-data","dir":"Articles","previous_headings":"","what":"Wrangling Data","title":"eppoFindeR","text":"eppoFindeR package also provides data wrangling function, taxonomyRanked(), can combine data fetched “taxonomy” “kingdom” EPPO services create unified, integrated dataframe. example, assume two dataframes: taxonomy kingdom, obtained querying “taxonomy” “kingdom” services EPPO code “BEMITA” using queryTheEPPOForService() function. can combine two dataframes follows:","code":"# Query the taxonomy service for the EPPO code \"BEMITA\" taxonomy <- queryTheEPPOForService(\"BEMITA\", service = \"taxonomy\") # Query the kingdom service for the EPPO code \"BEMITA\" kingdom <- queryTheEPPOForService(\"BEMITA\", service = \"kingdom\") # Combine taxonomy and kingdom data wrangled_data <- taxonomyRanked(taxonomy, kingdom)"},{"path":"/articles/eppoFindeR.html","id":"expected-output-2","dir":"Articles","previous_headings":"Wrangling Data","what":"Expected Output:","title":"eppoFindeR","text":"wrangled_data dataframe combines taxonomy kingdom information EPPO code “BEMITA”. integration provides comprehensive view organism’s taxonomic rank. Specifically, output dataframe contains following columns: rank: taxonomic rank. codeid: unique identifier entry. eppocode: EPPO code representing taxonomic group. prefname: preferred name taxonomic group (e.g., “Animalia”, “Insecta”). level: taxonomic level hierarchy (1 broadest category, progressing specific levels). queriedEppocode: input EPPO code. queriedOn: date query performed. queriedUrl: queried URL.","code":"wrangled_data #> # A tibble: 9 × 8 #> rank codeid eppocode prefname level queriedEppocode queriedOn queriedUrl #> #> 1 kingdom 57021 1ANIMK Animalia 1 BEMITA 2025-01-15 https://d… #> 2 NA 57200 1ARTHP Arthropoda 2 BEMITA 2025-01-15 https://d… #> 3 NA 77963 1HEXAQ Hexapoda 3 BEMITA 2025-01-15 https://d… #> 4 NA 59061 1INSEC Insecta 4 BEMITA 2025-01-15 https://d… #> 5 NA 58830 1HEMIO Hemiptera 5 BEMITA 2025-01-15 https://d… #> 6 NA 73260 1STERR Sternorrh… 6 BEMITA 2025-01-15 https://d… #> 7 NA 56905 1ALEYF Aleyrodid… 7 BEMITA 2025-01-15 https://d… #> 8 NA 57321 1BEMIG Bemisia 8 BEMITA 2025-01-15 https://d… #> 9 NA 5935 BEMITA Bemisia t… 9 BEMITA 2025-01-15 https://d…"},{"path":"/articles/eppoFindeR.html","id":"retrieving-countries-in-regional-plant-protection-organizations","dir":"Articles","previous_headings":"","what":"Retrieving Countries in Regional Plant Protection Organizations","title":"eppoFindeR","text":"gettingCountries() function allows retrieve member countries specific Regional Plant Protection Organization (RPPO). example, get member countries EAEU (Eurasian Economic Union), can use following command:","code":"EAEU_countries <- gettingCountries('EAEU')"},{"path":"/articles/eppoFindeR.html","id":"expected-output-3","dir":"Articles","previous_headings":"Retrieving Countries in Regional Plant Protection Organizations","what":"Expected Output:","title":"eppoFindeR","text":"EAEU_countries vector country names members EAEU.","code":"EAEU_countries #> [1] \"Armenia,Belarus,Kazakhstan,Kyrgyzstan,Russia\""},{"path":"/articles/eppoFindeR.html","id":"data-dump-for-multiple-eppo-codes","dir":"Articles","previous_headings":"","what":"Data Dump for Multiple EPPO Codes","title":"eppoFindeR","text":"dataDump() function allows retrieve comprehensive data dump multiple EPPO codes. function queries available EPPO services list input codes. following example function can used query available EPPO services EPPO codes “APHIPO” “LEUCSC”:","code":"data_dump <- dataDump(c(\"APHIPO\", \"LEUCSC\"))"},{"path":"/articles/eppoFindeR.html","id":"expected-output-4","dir":"Articles","previous_headings":"Data Dump for Multiple EPPO Codes","what":"Expected Output:","title":"eppoFindeR","text":"output list dataframes, corresponding different service: general, names, taxonomy, categorization, hosts, pests, kingdom. Accessing specific service (e.g., data_dump$general) show data related particular service EPPO codes “APHIPO” “LEUCSC”. column queriedEppocode dataframe distinguishes data retrieved EPPO code.","code":"# Print the names of the services in the result names(data_dump) #> [1] \"general\" \"names\" \"taxonomy\" \"categorization\" #> [5] \"hosts\" \"pests\" \"kingdom\" # Print the data from a specific service, e.g., general data_dump$general #> # A tibble: 16 × 11 #> pestCode codeid eppocode status c_date m_date prefname attached_infos #> #> 1 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 2 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 3 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 4 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 5 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 6 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 7 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 8 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 9 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 10 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 11 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 12 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 13 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 14 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 15 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 16 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl "},{"path":"/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Luca Belmonte. Author, maintainer. Dayana Stephanie Buzle. Author. Rafael Vieira. Author. Agata Kaczmarek. Author.","code":""},{"path":"/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Belmonte L, Buzle D, Vieira R, Kaczmarek (2025). eppoFindeR: Wrapper EPPO Codes. R package version 1.0.0, https://CRAN.R-project.org/package=eppoFindeR.","code":"@Manual{, title = {eppoFindeR: A Wrapper for EPPO Codes}, author = {Luca Belmonte and Dayana Stephanie Buzle and Rafael Vieira and Agata Kaczmarek}, year = {2025}, note = {R package version 1.0.0}, url = {https://CRAN.R-project.org/package=eppoFindeR}, }"},{"path":[]},{"path":"/index.html","id":"introduction","dir":"","previous_headings":"","what":"Introduction","title":"A Wrapper for EPPO Codes","text":"Welcome eppoFindeR package! package wrapper around public APIs European Mediterranean Plant Protection Organization (EPPO) database. provides straightforward way access wide range pest-specific information produced collected EPPO. eppoFindeR designed use researchers practitioners working plant protection need easy access EPPO database using R.","code":""},{"path":"/index.html","id":"getting-started","dir":"","previous_headings":"","what":"Getting Started","title":"A Wrapper for EPPO Codes","text":"use eppoFindeR package, need stable internet connection, interacts EPPO database online services fetch manipulate data. reliable internet connection essential functionality package. can install eppoFindeR package CRAN using following command: detailed guide usage examples, please refer full vignette.","code":"install.packages(\"eppoFindeR\")"},{"path":"/reference/apiQuery.html","id":null,"dir":"Reference","previous_headings":"","what":"Query the EPPO database via REST API — apiQuery","title":"Query the EPPO database via REST API — apiQuery","text":"apiQuery queries EPPO database via REST API retrieve basic information, names, taxonomy, categorization, hosts, pests kingdom data EPPO code.","code":""},{"path":"/reference/apiQuery.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query the EPPO database via REST API — apiQuery","text":"","code":"apiQuery(queriedEppocode, queriedUrl)"},{"path":"/reference/apiQuery.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query the EPPO database via REST API — apiQuery","text":"queriedEppocode character. single EPPO code. EPPO codes computer codes developed plants pests (including pathogens) important agriculture plant protection. EPPO codes constitute harmonized coding system aims facilitate management plant pest names computerized databases, well data exchange systems. EPPO codes constructed combinations 5 6 letters , whenever possible, codes mnemonic abbreviations scientific name organism. taxon represented unique code. EPPO codes can freely downloaded incorporated systems via dedicated platform, EPPO Data Services. queriedUrl character. URL query. URL type: https://data.eppo.int/api/rest/1.0/taxon/queriedEppocode?authtoken=xxxxxxxxxxxxxxxxxxx API requests: Replace \"queriedEppocode\" EPPO code interest. Add unique token.","code":""},{"path":"/reference/apiQuery.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query the EPPO database via REST API — apiQuery","text":"single flattened dataframe returned, containing contents request converted JSON. Based query, output dataframe contain basic information, names, taxonomy, categorization, hosts, pests kingdom data input EPPO code. queriedEppocode, queriedOn queriedUrl columns dataframe report input EPPO code, date query performed, queried URL, respectively.","code":""},{"path":[]},{"path":"/reference/dataDump.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a dump of the whole EPPO database via REST API — dataDump","title":"Create a dump of the whole EPPO database via REST API — dataDump","text":"dataDump creates dump whole EPPO database via REST API one EPPO code(s).","code":""},{"path":"/reference/dataDump.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a dump of the whole EPPO database via REST API — dataDump","text":"","code":"dataDump(codesToScan, token = Sys.getenv(\"EPPO_token\"))"},{"path":"/reference/dataDump.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a dump of the whole EPPO database via REST API — dataDump","text":"codesToScan character vector one EPPO code(s). token character. Manually add unique token, set inside .Renviron using Sys.setenv(EPPO_token = \"-token\").","code":""},{"path":"/reference/dataDump.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a dump of the whole EPPO database via REST API — dataDump","text":"list flattened dataframes returned, dataframe containing contents request converted JSON. output dataframe contain basic information, names, taxonomy, categorization, hosts, pests kingdom data input EPPO code(s), respectively. queriedEppocode, queriedOn queriedUrl columns dataframe report input EPPO code(s), date query performed, queried URL, respectively.","code":""},{"path":"/reference/dataDump.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a dump of the whole EPPO database via REST API — dataDump","text":"","code":"# Create a dump of all data about Bemisia tabaci: basic information, all names, taxonomy, # categorization, hosts, pests and kingdom data. dataDump(\"BEMITA\") #> #> $general #> # A tibble: 8 × 11 #> pestCode codeid eppocode status c_date m_date prefname attached_infos #> #> 1 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 2 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 3 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 4 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 5 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 6 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 7 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> 8 BEMITA 5935 BEMITA A 2002-10-28 00:… 2002-… Bemisia… #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl #> #> $names #> # A tibble: 39 × 10 #> pestCode nameid isolang isocountry fullname preferred author queriedEppocode #> #> 1 BEMITA 7224 la NA Bemisia … 1 (Genn… BEMITA #> 2 BEMITA 211279 de NA Baumwoll… 0 NA BEMITA #> 3 BEMITA 211280 de NA Tabakmot… 0 NA BEMITA #> 4 BEMITA 280710 de NA weiße Fl… 0 NA BEMITA #> 5 BEMITA 7220 en NA cotton w… 0 NA BEMITA #> 6 BEMITA 7221 en NA sweet-po… 0 NA BEMITA #> 7 BEMITA 7222 en NA tobacco … 0 NA BEMITA #> 8 BEMITA 180181 en NA cassava … 0 NA BEMITA #> 9 BEMITA 273619 en NA silverle… 0 NA BEMITA #> 10 BEMITA 7241 es NA mosquita… 0 NA BEMITA #> # ℹ 29 more rows #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $taxonomy #> # A tibble: 9 × 8 #> pestCode codeid eppocode prefname level queriedEppocode queriedOn queriedUrl #> #> 1 BEMITA 57021 1ANIMK Animalia 1 BEMITA 2025-01-15 https://d… #> 2 BEMITA 57200 1ARTHP Arthropo… 2 BEMITA 2025-01-15 https://d… #> 3 BEMITA 77963 1HEXAQ Hexapoda 3 BEMITA 2025-01-15 https://d… #> 4 BEMITA 59061 1INSEC Insecta 4 BEMITA 2025-01-15 https://d… #> 5 BEMITA 58830 1HEMIO Hemiptera 5 BEMITA 2025-01-15 https://d… #> 6 BEMITA 73260 1STERR Sternorr… 6 BEMITA 2025-01-15 https://d… #> 7 BEMITA 56905 1ALEYF Aleyrodi… 7 BEMITA 2025-01-15 https://d… #> 8 BEMITA 57321 1BEMIG Bemisia 8 BEMITA 2025-01-15 https://d… #> 9 BEMITA 5935 BEMITA Bemisia … 9 BEMITA 2025-01-15 https://d… #> #> $categorization #> # A tibble: 20 × 12 #> pestCode nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 BEMITA America CL Chile 1 A1 list 2019 NA NA #> 2 BEMITA Asia BH Bahrain 2 A2 list 2003 NA NA #> 3 BEMITA Asia KZ Kazakh… 1 A1 list 2017 NA NA #> 4 BEMITA Europe AZ Azerba… 1 A1 list 2007 NA NA #> 5 BEMITA Europe BY Belarus X Quarantin… 1994 NA NA #> 6 BEMITA Europe GE Georgia 1 A1 list 2018 NA NA #> 7 BEMITA Europe MD Moldova X Quarantin… 2017 NA NA #> 8 BEMITA Europe NO Norway X Quarantin… 2012 NA NA #> 9 BEMITA Europe RU Russia 2 A2 list 2014 NA NA #> 10 BEMITA Europe RS Serbia 1 A1 list 2015 NA NA #> 11 BEMITA Europe CH Switze… 1 A1 list 2019 NA NA #> 12 BEMITA Europe TR Türkiye 2 A2 list 2016 NA NA #> 13 BEMITA Europe UA Ukraine 1 A1 list 2019 NA NA #> 14 BEMITA Europe GB United… 1 A1 list 2020 NA NA #> 15 BEMITA Oceania NZ New Ze… X Quarantin… 2000 NA NA #> 16 BEMITA RPPO/EU 9M EAEU 2 A2 list 2016 NA NA #> 17 BEMITA RPPO/EU 9A EPPO 2 A2 list 1989 NA NA #> 18 BEMITA RPPO/EU 9L EU P PZ Quaran… 2019 NA NA #> 19 BEMITA RPPO/EU 9L EU N A1 Quaran… 2019 NA NA #> 20 BEMITA RPPO/EU 9H OIRSA 2 A2 list 1992 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl #> #> $hosts #> # A tibble: 50 × 9 #> pestCode codeid eppocode idclass labelclass full_name queriedEppocode #> #> 1 BEMITA 31422 EPHPU 1 Major host Euphorbia pulche… BEMITA #> 2 BEMITA 32978 GEBJA 1 Major host Gerbera jamesonii BEMITA #> 3 BEMITA 33334 GOSHI 1 Major host Gossypium hirsut… BEMITA #> 4 BEMITA 35046 IPOBA 1 Major host Ipomoea batatas BEMITA #> 5 BEMITA 37151 MANES 1 Major host Manihot esculenta BEMITA #> 6 BEMITA 38512 NIOTA 1 Major host Nicotiana tabacum BEMITA #> 7 BEMITA 36921 LYPES 1 Major host Solanum lycopers… BEMITA #> 8 BEMITA 23377 AMABL 6 Wild/Weed Amaranthus blito… BEMITA #> 9 BEMITA 23414 AMARE 6 Wild/Weed Amaranthus retro… BEMITA #> 10 BEMITA 24583 ATXSE 6 Wild/Weed Atriplex semibac… BEMITA #> # ℹ 40 more rows #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $pests #> # A tibble: 1 × 4 #> pestCode queriedEppocode queriedOn queriedUrl #> #> 1 BEMITA BEMITA 2025-01-15 https://data.eppo.int/api/rest/1.0/taxon/… #> #> $kingdom #> # A tibble: 1 × 7 #> pestCode codeid eppocode status queriedEppocode queriedOn queriedUrl #> #> 1 BEMITA 57021 1ANIMK A BEMITA 2025-01-15 https://data.eppo.… #> # Create a dump of all data about Aphis pomi and Leucoptera malifoliella: basic information, # all names, taxonomy, categorization, hosts, pests and kingdom data. dataDump(c(\"APHIPO\", \"LEUCSC\")) #> #> #> #> $general #> # A tibble: 16 × 11 #> pestCode codeid eppocode status c_date m_date prefname attached_infos #> #> 1 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 2 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 3 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 4 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 5 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 6 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 7 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 8 APHIPO 5050 APHIPO A 2002-09-17 00… 2002-… Aphis p… #> 9 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 10 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 11 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 12 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 13 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 14 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 15 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> 16 LEUCSC 13110 LEUCSC A 2000-12-25 00… 2000-… Leucopt… #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl #> #> $names #> # A tibble: 49 × 10 #> pestCode nameid isolang isocountry fullname preferred author queriedEppocode #> #> 1 APHIPO 4708 la NA Aphis po… 1 DeGeer APHIPO #> 2 APHIPO 4700 da NA grøn æbl… 0 NA APHIPO #> 3 APHIPO 213257 de NA grüne Ap… 0 NA APHIPO #> 4 APHIPO 4702 en NA green ap… 0 NA APHIPO #> 5 APHIPO 4703 en NA permanen… 0 NA APHIPO #> 6 APHIPO 4718 es NA afido de… 0 NA APHIPO #> 7 APHIPO 4719 es NA pulgón d… 0 NA APHIPO #> 8 APHIPO 4720 es NA pulgón v… 0 NA APHIPO #> 9 APHIPO 4724 fa NA schatte … 0 NA APHIPO #> 10 APHIPO 4722 fi NA omenakir… 0 NA APHIPO #> # ℹ 39 more rows #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $taxonomy #> # A tibble: 17 × 8 #> pestCode codeid eppocode prefname level queriedEppocode queriedOn queriedUrl #> #> 1 APHIPO 57021 1ANIMK Animalia 1 APHIPO 2025-01-15 https://d… #> 2 APHIPO 57200 1ARTHP Arthrop… 2 APHIPO 2025-01-15 https://d… #> 3 APHIPO 77963 1HEXAQ Hexapoda 3 APHIPO 2025-01-15 https://d… #> 4 APHIPO 59061 1INSEC Insecta 4 APHIPO 2025-01-15 https://d… #> 5 APHIPO 58830 1HEMIO Hemipte… 5 APHIPO 2025-01-15 https://d… #> 6 APHIPO 73260 1STERR Sternor… 6 APHIPO 2025-01-15 https://d… #> 7 APHIPO 57100 1APHIF Aphidid… 7 APHIPO 2025-01-15 https://d… #> 8 APHIPO 57101 1APHIG Aphis 8 APHIPO 2025-01-15 https://d… #> 9 APHIPO 5050 APHIPO Aphis p… 9 APHIPO 2025-01-15 https://d… #> 10 LEUCSC 57021 1ANIMK Animalia 1 LEUCSC 2025-01-15 https://d… #> 11 LEUCSC 57200 1ARTHP Arthrop… 2 LEUCSC 2025-01-15 https://d… #> 12 LEUCSC 77963 1HEXAQ Hexapoda 3 LEUCSC 2025-01-15 https://d… #> 13 LEUCSC 59061 1INSEC Insecta 4 LEUCSC 2025-01-15 https://d… #> 14 LEUCSC 59211 1LEPIO Lepidop… 5 LEUCSC 2025-01-15 https://d… #> 15 LEUCSC 59367 1LYONF Lyoneti… 6 LEUCSC 2025-01-15 https://d… #> 16 LEUCSC 59235 1LEUCG Leucopt… 7 LEUCSC 2025-01-15 https://d… #> 17 LEUCSC 13110 LEUCSC Leucopt… 8 LEUCSC 2025-01-15 https://d… #> #> $categorization #> # A tibble: 9 × 12 #> pestCode nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 APHIPO Africa EG Egypt 1 A1 list 2018 NA NA #> 2 APHIPO America CL Chile 1 A1 list 2019 NA NA #> 3 LEUCSC Africa EG Egypt 1 A1 list 2018 NA NA #> 4 LEUCSC America AR Argenti… 1 A1 list 2019 NA NA #> 5 LEUCSC America BR Brazil 1 A1 list 2018 NA NA #> 6 LEUCSC America CA Canada X Quarantin… 2019 NA NA #> 7 LEUCSC America CL Chile 1 A1 list 2019 NA NA #> 8 LEUCSC America US United … X Quarantin… 1995 NA NA #> 9 LEUCSC RPPO/EU 9D COSAVE 1 A1 list 2021 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl #> #> $hosts #> # A tibble: 8 × 9 #> pestCode queriedEppocode queriedOn queriedUrl codeid eppocode idclass #> #> 1 APHIPO APHIPO 2025-01-15 https://data.eppo… NA NA NA #> 2 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 37021 MABSD 1 #> 3 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 51515 1BETG 9 #> 4 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 52076 1CSCG 9 #> 5 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 29214 CYDOB 9 #> 6 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 41523 PRNAV 9 #> 7 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 54453 1PYUG 9 #> 8 LEUCSC LEUCSC 2025-01-15 https://data.eppo… 42266 PYUCO 9 #> # ℹ 2 more variables: labelclass , full_name #> #> $pests #> # A tibble: 2 × 4 #> pestCode queriedEppocode queriedOn queriedUrl #> #> 1 APHIPO APHIPO 2025-01-15 https://data.eppo.int/api/rest/1.0/taxon/… #> 2 LEUCSC LEUCSC 2025-01-15 https://data.eppo.int/api/rest/1.0/taxon/… #> #> $kingdom #> # A tibble: 2 × 7 #> pestCode codeid eppocode status queriedEppocode queriedOn queriedUrl #> #> 1 APHIPO 57021 1ANIMK A APHIPO 2025-01-15 https://data.eppo.… #> 2 LEUCSC 57021 1ANIMK A LEUCSC 2025-01-15 https://data.eppo.… #>"},{"path":"/reference/eppoFindeR-package.html","id":null,"dir":"Reference","previous_headings":"","what":"eppoFindeR: A Wrapper for EPPO Codes — eppoFindeR-package","title":"eppoFindeR: A Wrapper for EPPO Codes — eppoFindeR-package","text":"eppoFindeR package provides wrap around European Mediterranean Plant Protection Organization (EPPO) database public APIs. enables users retrieve EPPO-related data searches across entire EPPO database utilizing specific services, including categorization, taxonomy, . package also includes data wrangling function integrate taxonomy rank information, function returns list member countries Regional Plant Protection Organization acronym used EPPO database.","code":""},{"path":[]},{"path":"/reference/eppoFindeR-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"eppoFindeR: A Wrapper for EPPO Codes — eppoFindeR-package","text":"Maintainer: Luca Belmonte luca.belmonte@efsa.europa.eu (ORCID) Authors: Dayana Stephanie Buzle (ORCID) Rafael Vieira Agata Kaczmarek (ORCID)","code":""},{"path":"/reference/gettingCountries.html","id":null,"dir":"Reference","previous_headings":"","what":"Get member countries from the acronyms of all Regional Plant Protection Organizations used in the EPPO database — gettingCountries","title":"Get member countries from the acronyms of all Regional Plant Protection Organizations used in the EPPO database — gettingCountries","text":"gettingCountries returns list member countries Regional Plant Protection Organization acronym used EPPO database (source: https://gd.eppo.int/rppo/).","code":""},{"path":"/reference/gettingCountries.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get member countries from the acronyms of all Regional Plant Protection Organizations used in the EPPO database — gettingCountries","text":"","code":"gettingCountries(acronym)"},{"path":"/reference/gettingCountries.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get member countries from the acronyms of all Regional Plant Protection Organizations used in the EPPO database — gettingCountries","text":"acronym character. acronym Regional Plant Protection Organization.","code":""},{"path":"/reference/gettingCountries.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get member countries from the acronyms of all Regional Plant Protection Organizations used in the EPPO database — gettingCountries","text":"character vector containing member countries.","code":""},{"path":"/reference/gettingCountries.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get member countries from the acronyms of all Regional Plant Protection Organizations used in the EPPO database — gettingCountries","text":"","code":"# Get the list of member countries for the 'EAEU' acronym: gettingCountries('EAEU') #> [1] \"Armenia,Belarus,Kazakhstan,Kyrgyzstan,Russia\" # Get the list of member countries for the 'EPPO' acronym: gettingCountries('EPPO') #> [1] \"Albania,Algeria,Austria,Azerbaijan,Belarus,Belgium,Bosnia and Herzegovina,Bulgaria,Croatia,Cyprus,Czech Republic,Denmark,Estonia,Finland,France,Georgia,Germany,Greece,Guernsey,Hungary,Ireland,Israel,Italy,Jersey,Jordan,Kazakhstan,Kyrgyzstan,Latvia,Lithuania,Luxembourg,Malta,Moldova,Montenegro,Morocco,Netherlands,North Macedonia,Norway,Poland,Portugal,Romania,Russia,Serbia,Slovakia,Slovenia,Spain,Sweden,Switzerland,Tunisia,Türkiye,Ukraine,United Kingdom,Uzbekistan\" # Get the list of member countries for the 'COSAVE' acronym: gettingCountries('COSAVE') #> [1] \"Argentina,Bolivia,Brazil,Chile,Paraguay,Peru,Uruguay\""},{"path":"/reference/queryTheEPPOForService.html","id":null,"dir":"Reference","previous_headings":"","what":"Query the EPPO database via REST API by specifying the name of the required service — queryTheEPPOForService","title":"Query the EPPO database via REST API by specifying the name of the required service — queryTheEPPOForService","text":"queryTheEPPOForService queries EPPO database via REST API specifying name required service, retrieve basic information, names, taxonomy, categorization, hosts, pests kingdom data EPPO code.","code":""},{"path":"/reference/queryTheEPPOForService.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query the EPPO database via REST API by specifying the name of the required service — queryTheEPPOForService","text":"","code":"queryTheEPPOForService( queriedEppocode, baseUrl = \"https://data.eppo.int/api/rest/1.0/taxon/\", service = \"categorization\", token = Sys.getenv(\"EPPO_token\") )"},{"path":"/reference/queryTheEPPOForService.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query the EPPO database via REST API by specifying the name of the required service — queryTheEPPOForService","text":"queriedEppocode character. single EPPO code. EPPO codes computer codes developed plants pests (including pathogens) important agriculture plant protection. EPPO codes constitute harmonized coding system aims facilitate management plant pest names computerized databases, well data exchange systems. EPPO codes constructed combinations 5 6 letters , whenever possible, codes mnemonic abbreviations scientific name organism. taxon represented unique code. EPPO codes can freely downloaded incorporated systems via dedicated platform, EPPO Data Services. baseUrl character. URL root REST API. default: https://data.eppo.int/api/rest/1.0 service character. single service, selected among following: \"\": basic information \"names\": names \"taxonomy\": taxonomy data \"categorization\": categorization data \"hosts\": hosts data \"pests\": pests data \"kingdom\": kingdom taxonomic rank default: \"categorization\" token character. Manually add unique token, set inside .Renviron using Sys.setenv(EPPO_token = \"-token\"). default: Sys.getenv('EPPO_token')","code":""},{"path":"/reference/queryTheEPPOForService.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query the EPPO database via REST API by specifying the name of the required service — queryTheEPPOForService","text":"list flattened dataframes returned, dataframe containing contents request converted JSON. Based query, output dataframe contain basic information, names, taxonomy, categorization, hosts, pests kingdom data input EPPO code. queriedEppocode, queriedOn queriedUrl columns dataframe report input EPPO code, date query performed, queried URL, respectively.","code":""},{"path":"/reference/queryTheEPPOForService.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Query the EPPO database via REST API by specifying the name of the required service — queryTheEPPOForService","text":"","code":"# Get basic information about Bemisia tabaci: queryTheEPPOForService(\"BEMITA\", service = \"\") #> # A tibble: 8 × 10 #> codeid eppocode status c_date m_date prefname attached_infos queriedEppocode #> #> 1 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 2 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 3 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 4 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 5 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 6 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 7 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 8 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> # ℹ 2 more variables: queriedOn , queriedUrl # Get all names about Bemisia tabaci: queryTheEPPOForService(\"BEMITA\", service = \"names\") #> # A tibble: 39 × 9 #> nameid isolang isocountry fullname preferred author queriedEppocode #> #> 1 7224 la NA Bemisia tabaci 1 (Genn… BEMITA #> 2 211279 de NA Baumwollmottensch… 0 NA BEMITA #> 3 211280 de NA Tabakmottenschild… 0 NA BEMITA #> 4 280710 de NA weiße Fliege 0 NA BEMITA #> 5 7220 en NA cotton whitefly 0 NA BEMITA #> 6 7221 en NA sweet-potato whit… 0 NA BEMITA #> 7 7222 en NA tobacco whitefly 0 NA BEMITA #> 8 180181 en NA cassava whitefly 0 NA BEMITA #> 9 273619 en NA silverleaf whitef… 0 NA BEMITA #> 10 7241 es NA mosquita blanca d… 0 NA BEMITA #> # ℹ 29 more rows #> # ℹ 2 more variables: queriedOn , queriedUrl # Get categorization data about Bemisia tabaci: queryTheEPPOForService(\"BEMITA\", service = \"categorization\") #> # A tibble: 20 × 11 #> nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 America CL Chile 1 A1 list 2019 NA NA #> 2 Asia BH Bahrain 2 A2 list 2003 NA NA #> 3 Asia KZ Kazakhstan 1 A1 list 2017 NA NA #> 4 Europe AZ Azerbaijan 1 A1 list 2007 NA NA #> 5 Europe BY Belarus X Quarantine … 1994 NA NA #> 6 Europe GE Georgia 1 A1 list 2018 NA NA #> 7 Europe MD Moldova X Quarantine … 2017 NA NA #> 8 Europe NO Norway X Quarantine … 2012 NA NA #> 9 Europe RU Russia 2 A2 list 2014 NA NA #> 10 Europe RS Serbia 1 A1 list 2015 NA NA #> 11 Europe CH Switzerland 1 A1 list 2019 NA NA #> 12 Europe TR Türkiye 2 A2 list 2016 NA NA #> 13 Europe UA Ukraine 1 A1 list 2019 NA NA #> 14 Europe GB United Kingdom 1 A1 list 2020 NA NA #> 15 Oceania NZ New Zealand X Quarantine … 2000 NA NA #> 16 RPPO/EU 9M EAEU 2 A2 list 2016 NA NA #> 17 RPPO/EU 9A EPPO 2 A2 list 1989 NA NA #> 18 RPPO/EU 9L EU P PZ Quaranti… 2019 NA NA #> 19 RPPO/EU 9L EU N A1 Quaranti… 2019 NA NA #> 20 RPPO/EU 9H OIRSA 2 A2 list 1992 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl "},{"path":"/reference/queryTheWholeEPPO.html","id":null,"dir":"Reference","previous_headings":"","what":"Query all services, a single service or multiple services in the EPPO database via REST API — queryTheWholeEPPO","title":"Query all services, a single service or multiple services in the EPPO database via REST API — queryTheWholeEPPO","text":"queryTheWholeEPPO queries EPPO database via REST API specifying name(s) required service(s), retrieve basic information, names, taxonomy, categorization, hosts, pests kingdom data EPPO code.","code":""},{"path":"/reference/queryTheWholeEPPO.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query all services, a single service or multiple services in the EPPO database via REST API — queryTheWholeEPPO","text":"","code":"queryTheWholeEPPO( queriedEppocode, baseUrl = \"https://data.eppo.int/api/rest/1.0/taxon/\", token = Sys.getenv(\"EPPO_token\") )"},{"path":"/reference/queryTheWholeEPPO.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query all services, a single service or multiple services in the EPPO database via REST API — queryTheWholeEPPO","text":"queriedEppocode character. single EPPO code. EPPO codes computer codes developed plants pests (including pathogens) important agriculture plant protection. EPPO codes constitute harmonized coding system aims facilitate management plant pest names computerized databases, well data exchange systems. EPPO codes constructed combinations 5 6 letters , whenever possible, codes mnemonic abbreviations scientific name organism. taxon represented unique code. EPPO codes can freely downloaded incorporated systems via dedicated platform, EPPO Data Services. baseUrl character. URL root REST API. default: https://data.eppo.int/api/rest/1.0 token character. Manually add unique token, set inside .Renviron using Sys.setenv(EPPO_token = \"-token\"). default: Sys.getenv('EPPO_token') \"\": basic information \"names\": names \"taxonomy\": taxonomy data \"categorization\": categorization data \"hosts\": hosts data \"pests\": pests data \"kingdom\": kingdom taxonomic rank default: \"\", means whole EPPO database taxonomy (https://data.eppo.int/api/rest/1.0/taxon) screened.","code":""},{"path":"/reference/queryTheWholeEPPO.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query all services, a single service or multiple services in the EPPO database via REST API — queryTheWholeEPPO","text":"list flattened dataframes returned, dataframe containing contents request converted JSON. Based query, output dataframe contain basic information, names, taxonomy, categorization, hosts, pests kingdom data input EPPO code. queriedEppocode, queriedOn queriedUrl columns dataframe report input EPPO code, date query performed, queried URL, respectively.","code":""},{"path":"/reference/queryTheWholeEPPO.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Query all services, a single service or multiple services in the EPPO database via REST API — queryTheWholeEPPO","text":"","code":"# Get all information about Bemisia tabaci: basic information, all names, taxonomy, # categorization, hosts, pests and kingdom data. queryTheWholeEPPO(\"BEMITA\") #> #> $general #> # A tibble: 8 × 10 #> codeid eppocode status c_date m_date prefname attached_infos queriedEppocode #> #> 1 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 2 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 3 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 4 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 5 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 6 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 7 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 8 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $names #> # A tibble: 39 × 9 #> nameid isolang isocountry fullname preferred author queriedEppocode #> #> 1 7224 la NA Bemisia tabaci 1 (Genn… BEMITA #> 2 211279 de NA Baumwollmottensch… 0 NA BEMITA #> 3 211280 de NA Tabakmottenschild… 0 NA BEMITA #> 4 280710 de NA weiße Fliege 0 NA BEMITA #> 5 7220 en NA cotton whitefly 0 NA BEMITA #> 6 7221 en NA sweet-potato whit… 0 NA BEMITA #> 7 7222 en NA tobacco whitefly 0 NA BEMITA #> 8 180181 en NA cassava whitefly 0 NA BEMITA #> 9 273619 en NA silverleaf whitef… 0 NA BEMITA #> 10 7241 es NA mosquita blanca d… 0 NA BEMITA #> # ℹ 29 more rows #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $taxonomy #> # A tibble: 9 × 7 #> codeid eppocode prefname level queriedEppocode queriedOn queriedUrl #> #> 1 57021 1ANIMK Animalia 1 BEMITA 2025-01-15 https://data.… #> 2 57200 1ARTHP Arthropoda 2 BEMITA 2025-01-15 https://data.… #> 3 77963 1HEXAQ Hexapoda 3 BEMITA 2025-01-15 https://data.… #> 4 59061 1INSEC Insecta 4 BEMITA 2025-01-15 https://data.… #> 5 58830 1HEMIO Hemiptera 5 BEMITA 2025-01-15 https://data.… #> 6 73260 1STERR Sternorrhyncha 6 BEMITA 2025-01-15 https://data.… #> 7 56905 1ALEYF Aleyrodidae 7 BEMITA 2025-01-15 https://data.… #> 8 57321 1BEMIG Bemisia 8 BEMITA 2025-01-15 https://data.… #> 9 5935 BEMITA Bemisia tabaci 9 BEMITA 2025-01-15 https://data.… #> #> $categorization #> # A tibble: 20 × 11 #> nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 America CL Chile 1 A1 list 2019 NA NA #> 2 Asia BH Bahrain 2 A2 list 2003 NA NA #> 3 Asia KZ Kazakhstan 1 A1 list 2017 NA NA #> 4 Europe AZ Azerbaijan 1 A1 list 2007 NA NA #> 5 Europe BY Belarus X Quarantine … 1994 NA NA #> 6 Europe GE Georgia 1 A1 list 2018 NA NA #> 7 Europe MD Moldova X Quarantine … 2017 NA NA #> 8 Europe NO Norway X Quarantine … 2012 NA NA #> 9 Europe RU Russia 2 A2 list 2014 NA NA #> 10 Europe RS Serbia 1 A1 list 2015 NA NA #> 11 Europe CH Switzerland 1 A1 list 2019 NA NA #> 12 Europe TR Türkiye 2 A2 list 2016 NA NA #> 13 Europe UA Ukraine 1 A1 list 2019 NA NA #> 14 Europe GB United Kingdom 1 A1 list 2020 NA NA #> 15 Oceania NZ New Zealand X Quarantine … 2000 NA NA #> 16 RPPO/EU 9M EAEU 2 A2 list 2016 NA NA #> 17 RPPO/EU 9A EPPO 2 A2 list 1989 NA NA #> 18 RPPO/EU 9L EU P PZ Quaranti… 2019 NA NA #> 19 RPPO/EU 9L EU N A1 Quaranti… 2019 NA NA #> 20 RPPO/EU 9H OIRSA 2 A2 list 1992 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl #> #> $hosts #> # A tibble: 50 × 8 #> codeid eppocode idclass labelclass full_name queriedEppocode queriedOn #> #> 1 31422 EPHPU 1 Major host Euphorbia pulc… BEMITA 2025-01-15 #> 2 32978 GEBJA 1 Major host Gerbera jameso… BEMITA 2025-01-15 #> 3 33334 GOSHI 1 Major host Gossypium hirs… BEMITA 2025-01-15 #> 4 35046 IPOBA 1 Major host Ipomoea batatas BEMITA 2025-01-15 #> 5 37151 MANES 1 Major host Manihot escule… BEMITA 2025-01-15 #> 6 38512 NIOTA 1 Major host Nicotiana taba… BEMITA 2025-01-15 #> 7 36921 LYPES 1 Major host Solanum lycope… BEMITA 2025-01-15 #> 8 23377 AMABL 6 Wild/Weed Amaranthus bli… BEMITA 2025-01-15 #> 9 23414 AMARE 6 Wild/Weed Amaranthus ret… BEMITA 2025-01-15 #> 10 24583 ATXSE 6 Wild/Weed Atriplex semib… BEMITA 2025-01-15 #> # ℹ 40 more rows #> # ℹ 1 more variable: queriedUrl #> #> $pests #> # A tibble: 1 × 3 #> queriedEppocode queriedOn queriedUrl #> #> 1 BEMITA 2025-01-15 https://data.eppo.int/api/rest/1.0/taxon/BEMITA/pe… #> #> $kingdom #> # A tibble: 1 × 6 #> codeid eppocode status queriedEppocode queriedOn queriedUrl #> #> 1 57021 1ANIMK A BEMITA 2025-01-15 https://data.eppo.int/api/r… #>"},{"path":"/reference/queryTheWholeEPPOSafe.html","id":null,"dir":"Reference","previous_headings":"","what":"Query all services, a single service or multiple services in the EPPO database via REST API (version that never fails) — queryTheWholeEPPOSafe","title":"Query all services, a single service or multiple services in the EPPO database via REST API (version that never fails) — queryTheWholeEPPOSafe","text":"queryTheWholeEPPOSafe queries EPPO database via REST API specifying name(s) required service(s), retrieve basic information, names, taxonomy, categorization, hosts, pests kingdom data EPPO code. queryTheWholeEPPOSafe modified version queryTheWholeEPPO never fails.","code":""},{"path":"/reference/queryTheWholeEPPOSafe.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query all services, a single service or multiple services in the EPPO database via REST API (version that never fails) — queryTheWholeEPPOSafe","text":"","code":"queryTheWholeEPPOSafe(...)"},{"path":"/reference/queryTheWholeEPPOSafe.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query all services, a single service or multiple services in the EPPO database via REST API (version that never fails) — queryTheWholeEPPOSafe","text":"... function takes arguments .f. default, .f = queryTheWholeEPPO. safely(.f) function purrr/tidyverse package R wraps function capture errors side effects, .e. creates modified version .f never fails.","code":""},{"path":"/reference/queryTheWholeEPPOSafe.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query all services, a single service or multiple services in the EPPO database via REST API (version that never fails) — queryTheWholeEPPOSafe","text":"function takes arguments .f, returns different value: list components result error. function succeeds, result contains returned value error NULL. error occurred, error error object result either NULL otherwise. function succeeds, result contains list flattened dataframes, dataframe containing contents request converted JSON. Based query, output dataframe contain basic information, names, taxonomy, categorization, hosts, pests kingdom data input EPPO code. queriedEppocode, queriedOn queriedUrl columns dataframe report input EPPO code, date query performed, queried URL, respectively.","code":""},{"path":"/reference/queryTheWholeEPPOSafe.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Query all services, a single service or multiple services in the EPPO database via REST API (version that never fails) — queryTheWholeEPPOSafe","text":"","code":"# Get all information about Bemisia tabaci: basic information, all names, taxonomy, # categorization, hosts pests, and kingdom data. queryTheWholeEPPOSafe(\"BEMITA\") #> #> $result #> $result$general #> # A tibble: 8 × 10 #> codeid eppocode status c_date m_date prefname attached_infos queriedEppocode #> #> 1 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 2 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 3 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 4 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 5 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 6 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 7 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> 8 5935 BEMITA A 2002-10… 2002-… Bemisia… BEMITA #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $result$names #> # A tibble: 39 × 9 #> nameid isolang isocountry fullname preferred author queriedEppocode #> #> 1 7224 la NA Bemisia tabaci 1 (Genn… BEMITA #> 2 211279 de NA Baumwollmottensch… 0 NA BEMITA #> 3 211280 de NA Tabakmottenschild… 0 NA BEMITA #> 4 280710 de NA weiße Fliege 0 NA BEMITA #> 5 7220 en NA cotton whitefly 0 NA BEMITA #> 6 7221 en NA sweet-potato whit… 0 NA BEMITA #> 7 7222 en NA tobacco whitefly 0 NA BEMITA #> 8 180181 en NA cassava whitefly 0 NA BEMITA #> 9 273619 en NA silverleaf whitef… 0 NA BEMITA #> 10 7241 es NA mosquita blanca d… 0 NA BEMITA #> # ℹ 29 more rows #> # ℹ 2 more variables: queriedOn , queriedUrl #> #> $result$taxonomy #> # A tibble: 9 × 7 #> codeid eppocode prefname level queriedEppocode queriedOn queriedUrl #> #> 1 57021 1ANIMK Animalia 1 BEMITA 2025-01-15 https://data.… #> 2 57200 1ARTHP Arthropoda 2 BEMITA 2025-01-15 https://data.… #> 3 77963 1HEXAQ Hexapoda 3 BEMITA 2025-01-15 https://data.… #> 4 59061 1INSEC Insecta 4 BEMITA 2025-01-15 https://data.… #> 5 58830 1HEMIO Hemiptera 5 BEMITA 2025-01-15 https://data.… #> 6 73260 1STERR Sternorrhyncha 6 BEMITA 2025-01-15 https://data.… #> 7 56905 1ALEYF Aleyrodidae 7 BEMITA 2025-01-15 https://data.… #> 8 57321 1BEMIG Bemisia 8 BEMITA 2025-01-15 https://data.… #> 9 5935 BEMITA Bemisia tabaci 9 BEMITA 2025-01-15 https://data.… #> #> $result$categorization #> # A tibble: 20 × 11 #> nomcontinent isocode country qlist qlistlabel yr_add yr_del yr_trans #> #> 1 America CL Chile 1 A1 list 2019 NA NA #> 2 Asia BH Bahrain 2 A2 list 2003 NA NA #> 3 Asia KZ Kazakhstan 1 A1 list 2017 NA NA #> 4 Europe AZ Azerbaijan 1 A1 list 2007 NA NA #> 5 Europe BY Belarus X Quarantine … 1994 NA NA #> 6 Europe GE Georgia 1 A1 list 2018 NA NA #> 7 Europe MD Moldova X Quarantine … 2017 NA NA #> 8 Europe NO Norway X Quarantine … 2012 NA NA #> 9 Europe RU Russia 2 A2 list 2014 NA NA #> 10 Europe RS Serbia 1 A1 list 2015 NA NA #> 11 Europe CH Switzerland 1 A1 list 2019 NA NA #> 12 Europe TR Türkiye 2 A2 list 2016 NA NA #> 13 Europe UA Ukraine 1 A1 list 2019 NA NA #> 14 Europe GB United Kingdom 1 A1 list 2020 NA NA #> 15 Oceania NZ New Zealand X Quarantine … 2000 NA NA #> 16 RPPO/EU 9M EAEU 2 A2 list 2016 NA NA #> 17 RPPO/EU 9A EPPO 2 A2 list 1989 NA NA #> 18 RPPO/EU 9L EU P PZ Quaranti… 2019 NA NA #> 19 RPPO/EU 9L EU N A1 Quaranti… 2019 NA NA #> 20 RPPO/EU 9H OIRSA 2 A2 list 1992 NA NA #> # ℹ 3 more variables: queriedEppocode , queriedOn , #> # queriedUrl #> #> $result$hosts #> # A tibble: 50 × 8 #> codeid eppocode idclass labelclass full_name queriedEppocode queriedOn #> #> 1 31422 EPHPU 1 Major host Euphorbia pulc… BEMITA 2025-01-15 #> 2 32978 GEBJA 1 Major host Gerbera jameso… BEMITA 2025-01-15 #> 3 33334 GOSHI 1 Major host Gossypium hirs… BEMITA 2025-01-15 #> 4 35046 IPOBA 1 Major host Ipomoea batatas BEMITA 2025-01-15 #> 5 37151 MANES 1 Major host Manihot escule… BEMITA 2025-01-15 #> 6 38512 NIOTA 1 Major host Nicotiana taba… BEMITA 2025-01-15 #> 7 36921 LYPES 1 Major host Solanum lycope… BEMITA 2025-01-15 #> 8 23377 AMABL 6 Wild/Weed Amaranthus bli… BEMITA 2025-01-15 #> 9 23414 AMARE 6 Wild/Weed Amaranthus ret… BEMITA 2025-01-15 #> 10 24583 ATXSE 6 Wild/Weed Atriplex semib… BEMITA 2025-01-15 #> # ℹ 40 more rows #> # ℹ 1 more variable: queriedUrl #> #> $result$pests #> # A tibble: 1 × 3 #> queriedEppocode queriedOn queriedUrl #> #> 1 BEMITA 2025-01-15 https://data.eppo.int/api/rest/1.0/taxon/BEMITA/pe… #> #> $result$kingdom #> # A tibble: 1 × 6 #> codeid eppocode status queriedEppocode queriedOn queriedUrl #> #> 1 57021 1ANIMK A BEMITA 2025-01-15 https://data.eppo.int/api/r… #> #> #> $error #> NULL #>"},{"path":"/reference/taxonomyRanked.html","id":null,"dir":"Reference","previous_headings":"","what":"Merge taxonomy and kingdom data into a single dataframe — taxonomyRanked","title":"Merge taxonomy and kingdom data into a single dataframe — taxonomyRanked","text":"taxonomyRanked merges taxonomy kingdom information queried EPPO code single dataframe.","code":""},{"path":"/reference/taxonomyRanked.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Merge taxonomy and kingdom data into a single dataframe — taxonomyRanked","text":"","code":"taxonomyRanked(taxonomy, kingdom)"},{"path":"/reference/taxonomyRanked.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Merge taxonomy and kingdom data into a single dataframe — taxonomyRanked","text":"taxonomy dataframe containing taxonomy data queried EPPO code. kingdom dataframe containing kingdom data queried EPPO code.","code":""},{"path":"/reference/taxonomyRanked.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Merge taxonomy and kingdom data into a single dataframe — taxonomyRanked","text":"dataframe containing taxonomy kingdom information queried EPPO code.","code":""},{"path":"/reference/taxonomyRanked.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Merge taxonomy and kingdom data into a single dataframe — taxonomyRanked","text":"","code":"# Get taxonomy and kingdom data about Bemisia tabaci: taxonomy <- queryTheEPPOForService(\"BEMITA\", service = \"taxonomy\") kingdom <- queryTheEPPOForService(\"BEMITA\", service = \"kingdom\") # Merge taxonomy and kingdom information about Bemisia tabaci into a single dataframe: taxonomyRanked(taxonomy, kingdom) #> # A tibble: 9 × 8 #> rank codeid eppocode prefname level queriedEppocode queriedOn queriedUrl #> #> 1 kingdom 57021 1ANIMK Animalia 1 BEMITA 2025-01-15 https://d… #> 2 NA 57200 1ARTHP Arthropoda 2 BEMITA 2025-01-15 https://d… #> 3 NA 77963 1HEXAQ Hexapoda 3 BEMITA 2025-01-15 https://d… #> 4 NA 59061 1INSEC Insecta 4 BEMITA 2025-01-15 https://d… #> 5 NA 58830 1HEMIO Hemiptera 5 BEMITA 2025-01-15 https://d… #> 6 NA 73260 1STERR Sternorrh… 6 BEMITA 2025-01-15 https://d… #> 7 NA 56905 1ALEYF Aleyrodid… 7 BEMITA 2025-01-15 https://d… #> 8 NA 57321 1BEMIG Bemisia 8 BEMITA 2025-01-15 https://d… #> 9 NA 5935 BEMITA Bemisia t… 9 BEMITA 2025-01-15 https://d…"}] diff --git a/docs/site.webmanifest b/docs/site.webmanifest deleted file mode 100644 index 4ebda26..0000000 --- a/docs/site.webmanifest +++ /dev/null @@ -1,21 +0,0 @@ -{ - "name": "", - "short_name": "", - "icons": [ - { - "src": "/web-app-manifest-192x192.png", - "sizes": "192x192", - "type": "image/png", - "purpose": "maskable" - }, - { - "src": "/web-app-manifest-512x512.png", - "sizes": "512x512", - "type": "image/png", - "purpose": "maskable" - } - ], - "theme_color": "#ffffff", - "background_color": "#ffffff", - "display": "standalone" -} \ No newline at end of file diff --git a/docs/sitemap.xml b/docs/sitemap.xml deleted file mode 100644 index ed8fc71..0000000 --- a/docs/sitemap.xml +++ /dev/null @@ -1,17 +0,0 @@ - -/404.html -/articles/eppoFindeR.html -/articles/index.html -/authors.html -/index.html -/reference/apiQuery.html -/reference/dataDump.html -/reference/eppoFindeR-package.html -/reference/gettingCountries.html -/reference/index.html -/reference/queryTheEPPOForService.html -/reference/queryTheWholeEPPO.html -/reference/queryTheWholeEPPOSafe.html -/reference/taxonomyRanked.html - - diff --git a/docs/web-app-manifest-192x192.png b/docs/web-app-manifest-192x192.png deleted file mode 100644 index 1613969c19f0b0c1716d6ba264794cb6728b9cce..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 26012 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 byDR@6i|IIs7AVeQ00000NkvXXu0mjfh_bJy diff --git a/docs/web-app-manifest-512x512.png b/docs/web-app-manifest-512x512.png deleted file mode 100644 index b342959b5479d7b65a5f52e3eacd4daab860fb14..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 155835 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 From 94cd97b2d21f3f0cf9806ed160e7f63f6211f2e7 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Wed, 15 Jan 2025 17:54:45 +0100 Subject: [PATCH 10/43] Update MANIFEST.in to exclude requirements.txt --- MANIFEST.in | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/MANIFEST.in b/MANIFEST.in index 1632008..0081be3 100644 --- a/MANIFEST.in +++ b/MANIFEST.in @@ -1,3 +1,4 @@ # Exclude the following Python files exclude eppoPynder/api_query.py -exclude eppoPynder/unnest_lists.py \ No newline at end of file +exclude eppoPynder/unnest_lists.py +exclude requirements.txt From 5503edd5df8b35c3c4b50efc0a268ca4102667cf Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 11:06:12 +0100 Subject: [PATCH 11/43] fix --- setup.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/setup.py b/setup.py index e4cf581..b8386b8 100644 --- a/setup.py +++ b/setup.py @@ -16,7 +16,7 @@ 'Dayana Stephanie Buzle ORCID': 'https://orcid.org/0009-0003-2990-7431', 'Rafael Vieira ORCID': 'https://orcid.org/0009-0009-0289-5438', 'Agata Kaczmarek ORCID': 'https://orcid.org/0000-0002-7463-5821', - } + }, license='GPL-3.0', packages=find_packages(where='src'), package_dir={'': 'src'}, From 7f4e27b960c0dc5ef9460c613c9f97289f58fcd3 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 15:11:59 +0100 Subject: [PATCH 12/43] Added lifecycle badge --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d2aad7b..efcbbc4 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,5 @@ +[![Lifecycle: stable](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html#stable) + # eppoPynder ## Overview @@ -298,4 +300,4 @@ The output is a dictionary of dataframes, each corresponding to a different serv [2 rows x 20 columns] ``` -Accessing a specific service (e.g., `data_dump["general"]`) will show the data related to that particular service for the EPPO codes "APHIPO" and "LEUCSC". The column `queried_eppocode` in the dataframe distinguishes which data have been retrieved for each EPPO code. \ No newline at end of file +Accessing a specific service (e.g., `data_dump["general"]`) will show the data related to that particular service for the EPPO codes "APHIPO" and "LEUCSC". The column `queried_eppocode` in the dataframe distinguishes which data have been retrieved for each EPPO code. From 3b09f935f9da9bdb9f49223b3723c3314384ec49 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 15:32:40 +0100 Subject: [PATCH 13/43] Added codecov badge --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index efcbbc4..73363ed 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -[![Lifecycle: stable](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html#stable) +[![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/dev/graph/badge.svg?token=6U3TL9T27T)](https://codecov.io/gh/openefsa/eppoPynder) # eppoPynder From e885adc663358b5fa86d04e9e915844f4b691c09 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 15:42:10 +0100 Subject: [PATCH 14/43] Created python-ci.yml for codecov badge --- .github/workflows/python-ci.yml | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 .github/workflows/python-ci.yml diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml new file mode 100644 index 0000000..bd7c307 --- /dev/null +++ b/.github/workflows/python-ci.yml @@ -0,0 +1,28 @@ +name: Run tests and upload coverage + +on: + push + +jobs: + test: + name: Run tests and collect coverage + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - name: Set up Python + uses: actions/setup-python@v4 + + - name: Install dependencies + run: pip install pytest pytest-cov + + - name: Run tests + run: pytest --cov-branch --cov-report=xml + + - name: Upload results to Codecov + uses: codecov/codecov-action@v5 + with: + token: ${{ secrets.CODECOV_TOKEN }} From d4a4cb0f3583985f97c88a0cf38598d0a01c3925 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 15:50:02 +0100 Subject: [PATCH 15/43] Fix python-ci.yml --- .github/workflows/python-ci.yml | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml index bd7c307..e1248b7 100644 --- a/.github/workflows/python-ci.yml +++ b/.github/workflows/python-ci.yml @@ -1,7 +1,12 @@ name: Run tests and upload coverage on: - push + push: + branches: + - dev # Trigger the workflow on push to the dev branch + pull_request: + branches: + - dev # Trigger the workflow on pull requests to the dev branch jobs: test: @@ -17,8 +22,10 @@ jobs: uses: actions/setup-python@v4 - name: Install dependencies - run: pip install pytest pytest-cov - + run: + pip install pytest-cov codecov + pip install -r requirements.txt + - name: Run tests run: pytest --cov-branch --cov-report=xml From 0938d92d8ecf1a64f90672463d49d91a2d75c327 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 15:53:32 +0100 Subject: [PATCH 16/43] Fix python-ci.yml --- .github/workflows/python-ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml index e1248b7..b1805ed 100644 --- a/.github/workflows/python-ci.yml +++ b/.github/workflows/python-ci.yml @@ -22,7 +22,7 @@ jobs: uses: actions/setup-python@v4 - name: Install dependencies - run: + run: | pip install pytest-cov codecov pip install -r requirements.txt From fe218a3793d95702d5e616f7456efc4550cc1f5f Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 16:02:28 +0100 Subject: [PATCH 17/43] Fix python-ci.yml --- .github/workflows/python-ci.yml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml index b1805ed..15829fe 100644 --- a/.github/workflows/python-ci.yml +++ b/.github/workflows/python-ci.yml @@ -25,6 +25,9 @@ jobs: run: | pip install pytest-cov codecov pip install -r requirements.txt + + - name: Set PYTHONPATH + run: echo "PYTHONPATH=$(pwd)" >> $GITHUB_ENV # Set PYTHONPATH to the root directory - name: Run tests run: pytest --cov-branch --cov-report=xml From 3f8ab72d0230f0a213ab67edcea58727ee47c0aa Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 16:08:28 +0100 Subject: [PATCH 18/43] Fix PYTHONPATH for src/eppoPynder --- .github/workflows/python-ci.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml index 15829fe..5cb60db 100644 --- a/.github/workflows/python-ci.yml +++ b/.github/workflows/python-ci.yml @@ -26,8 +26,8 @@ jobs: pip install pytest-cov codecov pip install -r requirements.txt - - name: Set PYTHONPATH - run: echo "PYTHONPATH=$(pwd)" >> $GITHUB_ENV # Set PYTHONPATH to the root directory + - name: Set PYTHONPATH to src + run: echo "PYTHONPATH=$(pwd)/src" >> $GITHUB_ENV # Set PYTHONPATH to the 'src' directory - name: Run tests run: pytest --cov-branch --cov-report=xml From 985c7ea9c97af04e2fd49ea9e78c82803ab7b125 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 16:12:25 +0100 Subject: [PATCH 19/43] Fix: Set EPPO Token as environment variable --- .github/workflows/python-ci.yml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml index 5cb60db..2120824 100644 --- a/.github/workflows/python-ci.yml +++ b/.github/workflows/python-ci.yml @@ -28,6 +28,9 @@ jobs: - name: Set PYTHONPATH to src run: echo "PYTHONPATH=$(pwd)/src" >> $GITHUB_ENV # Set PYTHONPATH to the 'src' directory + + - name: Set EPPO Token as environment variable + run: echo "EPPO_TOKEN=${{ secrets.EPPO_TOKEN }}" >> $GITHUB_ENV - name: Run tests run: pytest --cov-branch --cov-report=xml From fbec429075b5f1d1ea595d780d1e6b6539d24967 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 16:17:40 +0100 Subject: [PATCH 20/43] minor --- .github/workflows/python-ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml index 2120824..b8d68c1 100644 --- a/.github/workflows/python-ci.yml +++ b/.github/workflows/python-ci.yml @@ -30,7 +30,7 @@ jobs: run: echo "PYTHONPATH=$(pwd)/src" >> $GITHUB_ENV # Set PYTHONPATH to the 'src' directory - name: Set EPPO Token as environment variable - run: echo "EPPO_TOKEN=${{ secrets.EPPO_TOKEN }}" >> $GITHUB_ENV + run: echo "EPPO_TOKEN=${{ secrets.EPPO_TOKEN }}" >> $GITHUB_ENV # Use EPPO token set under Secrets section - name: Run tests run: pytest --cov-branch --cov-report=xml From f306155175a7ca1930d31cbab3ae65305e679cef Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 16:22:01 +0100 Subject: [PATCH 21/43] fix --- .github/workflows/python-ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml index b8d68c1..39becc3 100644 --- a/.github/workflows/python-ci.yml +++ b/.github/workflows/python-ci.yml @@ -30,7 +30,7 @@ jobs: run: echo "PYTHONPATH=$(pwd)/src" >> $GITHUB_ENV # Set PYTHONPATH to the 'src' directory - name: Set EPPO Token as environment variable - run: echo "EPPO_TOKEN=${{ secrets.EPPO_TOKEN }}" >> $GITHUB_ENV # Use EPPO token set under Secrets section + run: echo "EPPO_token=${{ secrets.EPPO_TOKEN }}" >> $GITHUB_ENV # Use EPPO token set under Secrets section - name: Run tests run: pytest --cov-branch --cov-report=xml From 7dd8c7811cb728cba2adfc46640be1d6e43a06ad Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 16:29:31 +0100 Subject: [PATCH 22/43] minor --- .github/workflows/python-ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml index 39becc3..d3c731a 100644 --- a/.github/workflows/python-ci.yml +++ b/.github/workflows/python-ci.yml @@ -33,7 +33,7 @@ jobs: run: echo "EPPO_token=${{ secrets.EPPO_TOKEN }}" >> $GITHUB_ENV # Use EPPO token set under Secrets section - name: Run tests - run: pytest --cov-branch --cov-report=xml + run: pytest --cov=eppoPynder --cov-report=xml - name: Upload results to Codecov uses: codecov/codecov-action@v5 From 8cca531b499341deb2024fa6b7045195c8dc7e6e Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 16:33:07 +0100 Subject: [PATCH 23/43] fix for codecov badge From 86395d4c01cc179e716552129b652a0b1a50f0ce Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 16:33:58 +0100 Subject: [PATCH 24/43] fix for codecov badge From af291e89b9c35aee4135df99bf21849ed2aeb877 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 16:44:40 +0100 Subject: [PATCH 25/43] fix --- .github/workflows/python-ci.yml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml index d3c731a..2006bfb 100644 --- a/.github/workflows/python-ci.yml +++ b/.github/workflows/python-ci.yml @@ -33,7 +33,10 @@ jobs: run: echo "EPPO_token=${{ secrets.EPPO_TOKEN }}" >> $GITHUB_ENV # Use EPPO token set under Secrets section - name: Run tests - run: pytest --cov=eppoPynder --cov-report=xml + run: | + coverage run -m pytest + coverage report -m + coverage html - name: Upload results to Codecov uses: codecov/codecov-action@v5 From a6aadbfde3653e3e4b3d013cf522dfc87d1274e4 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 16:51:13 +0100 Subject: [PATCH 26/43] fix --- .github/workflows/python-ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml index 2006bfb..957d2ed 100644 --- a/.github/workflows/python-ci.yml +++ b/.github/workflows/python-ci.yml @@ -36,7 +36,7 @@ jobs: run: | coverage run -m pytest coverage report -m - coverage html + coverage xml - name: Upload results to Codecov uses: codecov/codecov-action@v5 From 131cfee75101575bbe5fd7ee0412616cf94a967d Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 16:58:15 +0100 Subject: [PATCH 27/43] fix --- .github/workflows/python-ci.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml index 957d2ed..19c0471 100644 --- a/.github/workflows/python-ci.yml +++ b/.github/workflows/python-ci.yml @@ -42,3 +42,4 @@ jobs: uses: codecov/codecov-action@v5 with: token: ${{ secrets.CODECOV_TOKEN }} + file: coverage.xml From a65a051225405b20f80e18b0bbda6a11976052ef Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 17:05:58 +0100 Subject: [PATCH 28/43] fix --- .github/workflows/python-ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml index 19c0471..8a4611e 100644 --- a/.github/workflows/python-ci.yml +++ b/.github/workflows/python-ci.yml @@ -34,7 +34,7 @@ jobs: - name: Run tests run: | - coverage run -m pytest + coverage run -m pytest --ignore=/usr coverage report -m coverage xml From a22793cc34df42f6eda9722f26a5ac313539e43e Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Thu, 16 Jan 2025 17:08:36 +0100 Subject: [PATCH 29/43] fix --- .github/workflows/python-ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml index 8a4611e..5fcb149 100644 --- a/.github/workflows/python-ci.yml +++ b/.github/workflows/python-ci.yml @@ -34,7 +34,7 @@ jobs: - name: Run tests run: | - coverage run -m pytest --ignore=/usr + coverage run -m pytest --ignore=/usr/lib/python3/dist-packages coverage report -m coverage xml From aee58280610d445926a9abc7d42148ad8f1df6ba Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Fri, 31 Jan 2025 20:24:10 +0100 Subject: [PATCH 30/43] Updated for submission to PyPi --- src/eppoPynder/data_dump.py | 7 +++---- src/eppoPynder/query_the_eppo_for_service.py | 12 ++++++------ src/eppoPynder/query_the_whole_eppo.py | 6 +++--- 3 files changed, 12 insertions(+), 13 deletions(-) diff --git a/src/eppoPynder/data_dump.py b/src/eppoPynder/data_dump.py index 68ecf83..b0eeab4 100644 --- a/src/eppoPynder/data_dump.py +++ b/src/eppoPynder/data_dump.py @@ -36,12 +36,11 @@ def data_dump(codes_to_scan, token = os.getenv('EPPO_token')): # Create a dump of all data about Aphis pomi and Leucoptera malifoliella: basic information, all names, taxonomy, categorization, hosts, pests and kingdom data. data_dump(["APHIPO", "LEUCSC"]) """ - # Ensure the token is available if not token: - raise ValueError("EPPO token is required. Please provide a valid token.") + token = "default_token" + else: + assert isinstance(token, str), "token must be a string!" - # Add input validation - assert isinstance(token, str), "Token must be a string!" if not isinstance(codes_to_scan, list): raise AssertionError("Input must be a list!") if not codes_to_scan: diff --git a/src/eppoPynder/query_the_eppo_for_service.py b/src/eppoPynder/query_the_eppo_for_service.py index da49eea..5f4c867 100644 --- a/src/eppoPynder/query_the_eppo_for_service.py +++ b/src/eppoPynder/query_the_eppo_for_service.py @@ -62,15 +62,15 @@ def query_the_eppo_for_service(queried_eppocode, base_url = "https://data.eppo.i # Get categorization data for Bemisia tabaci: query_the_eppo_for_service("BEMITA", service="categorization") """ - # Ensure the token is available - if not token: - raise ValueError("EPPO token is required. Please provide a valid token.") - assert isinstance(queried_eppocode, str), "queried_eppocode must be a string!" assert isinstance(base_url, str), "base_url must be a string!" assert isinstance(service, str), "service must be a string!" - assert isinstance(token, str), "token must be a string!" - + + if not token: + token = "default_token" + else: + assert isinstance(token, str), "token must be a string!" + queried_url = base_url+queried_eppocode+"/"+service+"?authtoken="+token if service == "": diff --git a/src/eppoPynder/query_the_whole_eppo.py b/src/eppoPynder/query_the_whole_eppo.py index 5ba88d2..2e6a338 100644 --- a/src/eppoPynder/query_the_whole_eppo.py +++ b/src/eppoPynder/query_the_whole_eppo.py @@ -43,13 +43,13 @@ def query_the_whole_eppo(queried_eppocode, base_url = "https://data.eppo.int/api # categorization, hosts, pests, and kingdom data. query_the_whole_eppo("BEMITA") """ - # Ensure the token is available if not token: - raise ValueError("EPPO token is required. Please provide a valid token.") + token = "default_token" + else: + assert isinstance(token, str), "token must be a string!" assert isinstance(queried_eppocode, str), "queried_eppocode must be a string!" assert isinstance(base_url, str), "base_url must be a string!" - assert isinstance(token, str), "token must be a string!" services = ["", "names", "taxonomy", "categorization", "hosts", "pests", "kingdom"] From cbdb47dea98ec8ad36eb92e55dad54e2b83e3da6 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Fri, 31 Jan 2025 20:25:09 +0100 Subject: [PATCH 31/43] Updated for submission to PyPi --- tests/test_api_query.py | 18 ++++++- tests/test_data_dump.py | 31 +++++++---- tests/test_query_the_eppo_for_service.py | 26 ++++++---- tests/test_query_the_whole_eppo.py | 32 ++++++++---- tests/test_taxonomy_ranked.py | 66 +++++++----------------- 5 files changed, 95 insertions(+), 78 deletions(-) diff --git a/tests/test_api_query.py b/tests/test_api_query.py index f0d6397..77b7404 100644 --- a/tests/test_api_query.py +++ b/tests/test_api_query.py @@ -18,4 +18,20 @@ def test_if_wrong_service_is_requested_standard_df_returned(self): def test_missing_schema_print(self, mock_get, mock_print): mock_get.side_effect = requests.exceptions.InvalidURL() api_query("BEMITA", "https://data.eppo.int/api/rest/1.0/taxon/BEMITA?authtoken=token ") - mock_print.assert_called_once_with('') \ No newline at end of file + mock_print.assert_called_once_with('') + + @patch('requests.get') + def test_successful_json_processing(self, mock_get): + # Setup mock response + mock_response = MagicMock() + mock_response.json.return_value = {"name": "Test Name", "nested": [{"value": 1}, {"value": 2}]} + mock_get.return_value = mock_response + + # Call function + result = api_query("BEMITA", "https://data.eppo.int/api/rest/1.0/taxon/BEMITA?authtoken=token") + + # Verify json() was called and DataFrame was created + mock_response.json.assert_called_once() + assert len(result) > 0 + assert 'name' in result.columns + assert result.iloc[0]['name'] == "Test Name" diff --git a/tests/test_data_dump.py b/tests/test_data_dump.py index 442c7f6..174b5ba 100644 --- a/tests/test_data_dump.py +++ b/tests/test_data_dump.py @@ -1,7 +1,9 @@ import unittest - +from unittest.mock import patch +import pandas as pd from eppoPynder.data_dump import data_dump + class DataDumpEppo(unittest.TestCase): def test_data_dump(self): @@ -29,13 +31,20 @@ def test_input_type_validation(self): data_dump(["BEMITA", 123]) self.assertEqual(str(context.exception), "All codes must be strings!") - def test_missing_token(self): - # Test when token is None - with self.assertRaises(ValueError) as context: - data_dump(["BEMITA"], token=None) - self.assertEqual(str(context.exception), "EPPO token is required. Please provide a valid token.") - - # Test when token is an empty string - with self.assertRaises(ValueError) as context: - data_dump(["BEMITA"], token="") - self.assertEqual(str(context.exception), "EPPO token is required. Please provide a valid token.") + def test_non_string_token_raises_assertion_error(self): + with self.assertRaisesRegex(AssertionError, "token must be a string!"): + data_dump(["BEMITA"], token=123) + + def test_default_token_assignment(self): + with patch('eppoPynder.data_dump.query_the_eppo_for_service') as mock_query: + # Configure mock to return a DataFrame with required columns + mock_query.return_value = pd.DataFrame({'queried_eppocode': ['BEMITA']}) + + # Call function without a token + result = data_dump(["BEMITA"], token=None) + + # Get the first call to verify token value + first_call = mock_query.call_args_list[0] + + # Verify that default_token was used + self.assertEqual(first_call.kwargs['token'], 'default_token') diff --git a/tests/test_query_the_eppo_for_service.py b/tests/test_query_the_eppo_for_service.py index d1501a9..46a7d02 100644 --- a/tests/test_query_the_eppo_for_service.py +++ b/tests/test_query_the_eppo_for_service.py @@ -16,13 +16,19 @@ def test_if_wrong_service_is_requested_standard_df_returned(self, mock_query): result = query_the_eppo_for_service("BEMITA", service="wrongservice") self.assertEqual(result.shape[1], 3) - def test_missing_token(self): - # Test when token is None - with self.assertRaises(ValueError) as context: - query_the_eppo_for_service("BEMITA", token=None) - self.assertEqual(str(context.exception), "EPPO token is required. Please provide a valid token.") - - # Test when token is an empty string - with self.assertRaises(ValueError) as context: - query_the_eppo_for_service("BEMITA", token="") - self.assertEqual(str(context.exception), "EPPO token is required. Please provide a valid token.") \ No newline at end of file + def test_default_token_assignment(self): + with patch('eppoPynder.query_the_eppo_for_service.api_query') as mock_api: + # Configure mock to return an empty DataFrame + mock_api.return_value = pd.DataFrame() + + # Call function without a token + result = query_the_eppo_for_service("BEMITA", token=None) + + # Get the call arguments + call_args = mock_api.call_args + + # Extract the queried_url from the kwargs + queried_url = call_args.kwargs['queried_url'] + + # Verify that default_token was used in the URL + self.assertIn('authtoken=default_token', queried_url) diff --git a/tests/test_query_the_whole_eppo.py b/tests/test_query_the_whole_eppo.py index b081f0c..8bd762d 100644 --- a/tests/test_query_the_whole_eppo.py +++ b/tests/test_query_the_whole_eppo.py @@ -1,4 +1,6 @@ import unittest +from unittest.mock import patch +import pandas as pd from eppoPynder.query_the_whole_eppo import query_the_whole_eppo class TestQueryTheWholeEPPO(unittest.TestCase): @@ -13,13 +15,23 @@ def test_getting_the_right_names(self): self.assertEqual(list(result.keys()), services) - def test_missing_token(self): - # Test when token is None - with self.assertRaises(ValueError) as context: - query_the_whole_eppo("BEMITA", token=None) - self.assertEqual(str(context.exception), "EPPO token is required. Please provide a valid token.") - - # Test when token is an empty string - with self.assertRaises(ValueError) as context: - query_the_whole_eppo("BEMITA", token="") - self.assertEqual(str(context.exception), "EPPO token is required. Please provide a valid token.") \ No newline at end of file + def test_non_string_token_raises_assertion_error(self): + with self.assertRaisesRegex(AssertionError, "token must be a string!"): + query_the_whole_eppo("BEMITA", token=123) + + def test_default_token_assignment(self): + # Using the full import path for the mock + with patch('eppoPynder.query_the_whole_eppo.query_the_eppo_for_service') as mock_query: + # Configure mock to return an empty DataFrame + mock_query.return_value = pd.DataFrame() + + # Call function without a token + result = query_the_whole_eppo("BEMITA", token=None) + + # Get the first call to verify token value + first_call = mock_query.call_args_list[0] + + # Verify that default_token was used + self.assertEqual(first_call.kwargs['token'], 'default_token') + + \ No newline at end of file diff --git a/tests/test_taxonomy_ranked.py b/tests/test_taxonomy_ranked.py index 3f60edf..9908852 100644 --- a/tests/test_taxonomy_ranked.py +++ b/tests/test_taxonomy_ranked.py @@ -1,53 +1,27 @@ import unittest import pandas as pd -import numpy as np - from eppoPynder.taxonomy_ranked import taxonomy_ranked -from eppoPynder.query_the_eppo_for_service import query_the_eppo_for_service - -class TestTaxonomyRanked(unittest.TestCase): - def test_output_is_dataframe(self): - # Get kingdom and taxonomy data - kingdom = query_the_eppo_for_service("BEMITA", service="kingdom") - taxonomy = query_the_eppo_for_service("BEMITA", service="taxonomy") +class TaxonomyRanked(unittest.TestCase): + def test_taxonomy_ranked_merge_and_transform(self): + # Create test input data + taxonomy = pd.DataFrame({ + 'eppocode': ['CODE1'], + 'queried_eppocode': ['BEMITA'], + 'name': ['Test Species'] + }) - # Debugging: Check data types of the inputs - print(f"taxonomy type: {type(taxonomy)}") - print(f"kingdom type: {type(kingdom)}") - print(f"taxonomy dtypes:\n{taxonomy.dtypes}") - - # Ensure taxonomy is a DataFrame and kingdom is valid + kingdom = pd.DataFrame({ + 'eppocode': ['CODE1'], + 'queried_eppocode': ['BEMITA'], + 'status': ['Animalia'] + }) + + # Call the function result = taxonomy_ranked(taxonomy, kingdom) - # Check if the result is a DataFrame - self.assertTrue(isinstance(result, pd.DataFrame), "Result is not a dataframe") - - def setUp(self): - # Sample taxonomy DataFrame - self.taxonomy_data = { - 'eppocode': ['BEMITA', 'BEMITA', 'SOMECODE'], - 'queriedEppocode': ['BEMITA', 'BEMITA', 'SOMECODE'], - 'taxonRank': ['species', 'genus', 'family'] - } - self.taxonomy = pd.DataFrame(self.taxonomy_data) - - # Sample kingdom DataFrame - self.kingdom_data = { - 'eppocode': ['BEMITA', 'SOMECODE'], - 'queriedEppocode': ['BEMITA', 'SOMECODE'], - 'rank': ['active', 'inactive'] - } - self.kingdom = pd.DataFrame(self.kingdom_data) - - def test_empty_kingdom_dataframe(self): - # Test case where kingdom DataFrame is empty - empty_kingdom = pd.DataFrame(columns=['eppocode', 'queriedEppocode', 'status']) - result = pd.merge(self.taxonomy, empty_kingdom[["eppocode", "queriedEppocode", "status"]], how='left', on=["eppocode", "queriedEppocode"]) - - # Check if 'rank' is NaN when there is no match in kingdom data - result = result.rename(columns={'status': 'rank'}) - result.insert(0, "rank", result.pop("rank")) - result["rank"] = np.where(result["rank"].notnull(), "kingdom", pd.NA) - - self.assertTrue(result['rank'].isna().all(), "All values in 'rank' should be NaN when kingdom data is empty.") \ No newline at end of file + # Verify the results + assert 'rank' in result.columns + assert result.columns[0] == 'rank' # Check if rank is first column + assert result.iloc[0]['rank'] == 'kingdom' + assert len(result) == 1 \ No newline at end of file From 7dff3b8f16f9738614ba028ee0c89eab7e0d03c5 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Fri, 31 Jan 2025 20:25:56 +0100 Subject: [PATCH 32/43] Updated for submission to PyPi --- README.md | 4 +--- setup.py | 2 +- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 73363ed..d2aad7b 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,3 @@ -[![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/dev/graph/badge.svg?token=6U3TL9T27T)](https://codecov.io/gh/openefsa/eppoPynder) - # eppoPynder ## Overview @@ -300,4 +298,4 @@ The output is a dictionary of dataframes, each corresponding to a different serv [2 rows x 20 columns] ``` -Accessing a specific service (e.g., `data_dump["general"]`) will show the data related to that particular service for the EPPO codes "APHIPO" and "LEUCSC". The column `queried_eppocode` in the dataframe distinguishes which data have been retrieved for each EPPO code. +Accessing a specific service (e.g., `data_dump["general"]`) will show the data related to that particular service for the EPPO codes "APHIPO" and "LEUCSC". The column `queried_eppocode` in the dataframe distinguishes which data have been retrieved for each EPPO code. \ No newline at end of file diff --git a/setup.py b/setup.py index b8386b8..1478d2a 100644 --- a/setup.py +++ b/setup.py @@ -4,7 +4,7 @@ name='eppoPynder', version='1.0.0', description='A Wrapper for EPPO Codes', - long_description='The eppoPynder package provides a wrapper around the European and Mediterranean Plant Protection Organization (EPPO) database public APIs. It enables users to retrieve EPPO-related data through searches across the entire EPPO database or by utilizing specific services, including categorization, taxonomy, and more. The package also includes a data wrangling function to integrate taxonomy and rank information, and a function that returns the list of member countries for each Regional Plant Protection Organization acronym which is used in the EPPO database.', + long_description='A wrapper around the European and Mediterranean Plant Protection Organization (EPPO) database public APIs at https://data.eppo.int/. It enables users to retrieve EPPO-related data through searches across the entire EPPO database or by utilizing specific services, including categorization, taxonomy, and more. The package also includes a data wrangling function to integrate taxonomy and rank information, and a function that returns the list of member countries for each Regional Plant Protection Organization acronym which is used in the EPPO database.', long_description_content_type='text/markdown', author='Luca Belmonte, Dayana Stephanie Buzle, Rafael Vieira, Agata Kaczmarek', author_email='luca.belmonte@efsa.europa.eu', From 047904bccab04332581921c8bb84193c1885e164 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Fri, 31 Jan 2025 20:27:24 +0100 Subject: [PATCH 33/43] Create temp --- dist/temp | 1 + 1 file changed, 1 insertion(+) create mode 100644 dist/temp diff --git a/dist/temp b/dist/temp new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/dist/temp @@ -0,0 +1 @@ + From 020c09ee858d9a5c4616a66d25987be3ea775b1b Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Fri, 31 Jan 2025 20:27:56 +0100 Subject: [PATCH 34/43] Updated for submission to PyPi --- dist/eppoPynder-1.0.0-py3-none-any.whl | Bin 0 -> 22743 bytes dist/eppopynder-1.0.0.tar.gz | Bin 0 -> 27856 bytes 2 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 dist/eppoPynder-1.0.0-py3-none-any.whl create mode 100644 dist/eppopynder-1.0.0.tar.gz diff --git a/dist/eppoPynder-1.0.0-py3-none-any.whl b/dist/eppoPynder-1.0.0-py3-none-any.whl new file mode 100644 index 0000000000000000000000000000000000000000..fd886baaac60d74a0168f6d70ec5b18ef2e7c920 GIT binary patch literal 22743 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 gimCa>8vomQ)RoX~C#0F?z{G5`Po literal 0 HcmV?d00001 diff --git a/dist/eppopynder-1.0.0.tar.gz b/dist/eppopynder-1.0.0.tar.gz new file mode 100644 index 0000000000000000000000000000000000000000..a4c3faaf53478acc754b382ddce69240eff891c7 GIT binary patch literal 27856 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%0A)TRZ^(4^g4?|A3-M-!j5!v-~<1Ig~z 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 YN!T=tRG$Vz#zP<<*TFp$T{M*c17F$BH~;_u literal 0 HcmV?d00001 From 38634098c3060f505b4845d6dcbb412e5b54eb10 Mon Sep 17 00:00:00 2001 From: Dayana Stephanie Buzle Date: Fri, 31 Jan 2025 20:28:57 +0100 Subject: [PATCH 35/43] Delete dist/temp --- dist/temp | 1 - 1 file changed, 1 deletion(-) delete mode 100644 dist/temp diff --git a/dist/temp b/dist/temp deleted file mode 100644 index 8b13789..0000000 --- a/dist/temp +++ /dev/null @@ -1 +0,0 @@ - From 7de50f6be6a7441af7480eef4c75457dcb20744a Mon Sep 17 00:00:00 2001 From: Lorenzo Copelli Date: Wed, 8 Apr 2026 10:59:01 +0200 Subject: [PATCH 36/43] Migration to v2. (#1) * Refactored and improved code. * Added GitHub workflows. --- .coveragerc | 3 + .github/workflows/codecov.yml | 37 + .github/workflows/mkdocs.yml | 39 + .github/workflows/python-ci.yml | 45 - .gitignore | 7 + LICENSE | 961 ++++++------------- MANIFEST.in | 4 - README.md | 309 +----- dist/eppoPynder-1.0.0-py3-none-any.whl | Bin 22743 -> 0 bytes dist/eppopynder-1.0.0.tar.gz | Bin 27856 -> 0 bytes docs/guide.md | 342 +++++++ media/logo.png | Bin 0 -> 278029 bytes mkdocs.yml | 13 + pyproject.toml | 46 +- requirements.txt | Bin 670 -> 1504 bytes setup.py | 49 - src/eppoPynder/__init__.py | 23 + src/eppoPynder/_core/__init__.py | 1 + src/eppoPynder/_core/_country.py | 69 ++ src/eppoPynder/_core/_general.py | 53 + src/eppoPynder/_core/_references.py | 63 ++ src/eppoPynder/_core/_reporting_service.py | 65 ++ src/eppoPynder/_core/_rppo.py | 68 ++ src/eppoPynder/_core/_taxon.py | 82 ++ src/eppoPynder/_core/_taxons.py | 60 ++ src/eppoPynder/_core/_tools.py | 59 ++ src/eppoPynder/_utils/__init__.py | 1 + src/eppoPynder/_utils/_checks.py | 147 +++ src/eppoPynder/_utils/_data.py | 275 ++++++ src/eppoPynder/_utils/_requests.py | 309 ++++++ src/eppoPynder/api_query.py | 78 -- src/eppoPynder/client.py | 448 +++++++++ src/eppoPynder/data_dump.py | 74 -- src/eppoPynder/data_wrangling.py | 75 ++ src/eppoPynder/getting_countries.py | 106 -- src/eppoPynder/query_the_eppo_for_service.py | 82 -- src/eppoPynder/query_the_whole_eppo.py | 64 -- src/eppoPynder/taxonomy_ranked.py | 34 - src/eppoPynder/unnest_lists.py | 25 - tests/test__checks.py | 132 +++ tests/test__country.py | 103 ++ tests/test__data.py | 209 ++++ tests/test__general.py | 73 ++ tests/test__references.py | 73 ++ tests/test__reporting_service.py | 110 +++ tests/test__requests.py | 403 ++++++++ tests/test__rppo.py | 101 ++ tests/test__taxon.py | 101 ++ tests/test__taxons.py | 76 ++ tests/test__tools.py | 98 ++ tests/test_api_query.py | 37 - tests/test_client.py | 251 +++++ tests/test_data_dump.py | 50 - tests/test_data_wrangling.py | 36 + tests/test_getting_countries.py | 96 -- tests/test_query_the_eppo_for_service.py | 34 - tests/test_query_the_whole_eppo.py | 37 - tests/test_taxonomy_ranked.py | 27 - tests/test_unnest_lists.py | 70 -- 59 files changed, 4370 insertions(+), 1863 deletions(-) create mode 100644 .coveragerc create mode 100644 .github/workflows/codecov.yml create mode 100644 .github/workflows/mkdocs.yml delete mode 100644 .github/workflows/python-ci.yml create mode 100644 .gitignore delete mode 100644 MANIFEST.in delete mode 100644 dist/eppoPynder-1.0.0-py3-none-any.whl delete mode 100644 dist/eppopynder-1.0.0.tar.gz create mode 100644 docs/guide.md create mode 100644 media/logo.png create mode 100644 mkdocs.yml delete mode 100644 setup.py create mode 100644 src/eppoPynder/_core/__init__.py create mode 100644 src/eppoPynder/_core/_country.py create mode 100644 src/eppoPynder/_core/_general.py create mode 100644 src/eppoPynder/_core/_references.py create mode 100644 src/eppoPynder/_core/_reporting_service.py create mode 100644 src/eppoPynder/_core/_rppo.py create mode 100644 src/eppoPynder/_core/_taxon.py create mode 100644 src/eppoPynder/_core/_taxons.py create mode 100644 src/eppoPynder/_core/_tools.py create mode 100644 src/eppoPynder/_utils/__init__.py create mode 100644 src/eppoPynder/_utils/_checks.py create mode 100644 src/eppoPynder/_utils/_data.py create mode 100644 src/eppoPynder/_utils/_requests.py delete mode 100644 src/eppoPynder/api_query.py create mode 100644 src/eppoPynder/client.py delete mode 100644 src/eppoPynder/data_dump.py create mode 100644 src/eppoPynder/data_wrangling.py delete mode 100644 src/eppoPynder/getting_countries.py delete mode 100644 src/eppoPynder/query_the_eppo_for_service.py delete mode 100644 src/eppoPynder/query_the_whole_eppo.py delete mode 100644 src/eppoPynder/taxonomy_ranked.py delete mode 100644 src/eppoPynder/unnest_lists.py create mode 100644 tests/test__checks.py create mode 100644 tests/test__country.py create mode 100644 tests/test__data.py create mode 100644 tests/test__general.py create mode 100644 tests/test__references.py create mode 100644 tests/test__reporting_service.py create mode 100644 tests/test__requests.py create mode 100644 tests/test__rppo.py create mode 100644 tests/test__taxon.py create mode 100644 tests/test__taxons.py create mode 100644 tests/test__tools.py delete mode 100644 tests/test_api_query.py create mode 100644 tests/test_client.py delete mode 100644 tests/test_data_dump.py create mode 100644 tests/test_data_wrangling.py delete mode 100644 tests/test_getting_countries.py delete mode 100644 tests/test_query_the_eppo_for_service.py delete mode 100644 tests/test_query_the_whole_eppo.py delete mode 100644 tests/test_taxonomy_ranked.py delete mode 100644 tests/test_unnest_lists.py diff --git a/.coveragerc b/.coveragerc new file mode 100644 index 0000000..a7cba45 --- /dev/null +++ b/.coveragerc @@ -0,0 +1,3 @@ +[run] +omit = + tests/* diff --git a/.github/workflows/codecov.yml b/.github/workflows/codecov.yml new file mode 100644 index 0000000..204f6df --- /dev/null +++ b/.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 }} diff --git a/.github/workflows/mkdocs.yml b/.github/workflows/mkdocs.yml new file mode 100644 index 0000000..b40ad50 --- /dev/null +++ b/.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 diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml deleted file mode 100644 index 5fcb149..0000000 --- a/.github/workflows/python-ci.yml +++ /dev/null @@ -1,45 +0,0 @@ -name: Run tests and upload coverage - -on: - push: - branches: - - dev # Trigger the workflow on push to the dev branch - pull_request: - branches: - - dev # Trigger the workflow on pull requests to the dev branch - -jobs: - test: - name: Run tests and collect coverage - runs-on: ubuntu-latest - steps: - - name: Checkout - uses: actions/checkout@v4 - with: - fetch-depth: 0 - - - name: Set up Python - uses: actions/setup-python@v4 - - - name: Install dependencies - run: | - pip install pytest-cov codecov - pip install -r requirements.txt - - - name: Set PYTHONPATH to src - run: echo "PYTHONPATH=$(pwd)/src" >> $GITHUB_ENV # Set PYTHONPATH to the 'src' directory - - - name: Set EPPO Token as environment variable - run: echo "EPPO_token=${{ secrets.EPPO_TOKEN }}" >> $GITHUB_ENV # Use EPPO token set under Secrets section - - - name: Run tests - run: | - coverage run -m pytest --ignore=/usr/lib/python3/dist-packages - coverage report -m - coverage xml - - - name: Upload results to Codecov - uses: codecov/codecov-action@v5 - with: - token: ${{ secrets.CODECOV_TOKEN }} - file: coverage.xml diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..31910b2 --- /dev/null +++ b/.gitignore @@ -0,0 +1,7 @@ +.idea/ +*.egg-info/ +.env +__pycache__/ +.coverage +dist/ +coverage.xml diff --git a/LICENSE b/LICENSE index f288702..c29ce2f 100644 --- a/LICENSE +++ b/LICENSE @@ -1,674 +1,287 @@ - GNU GENERAL PUBLIC LICENSE - Version 3, 29 June 2007 - - Copyright (C) 2007 Free Software Foundation, Inc. - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. - - Preamble - - The GNU General Public License is a free, copyleft license for -software and other kinds of works. - - The licenses for most software and other practical works are designed -to take away your freedom to share and change the works. By contrast, -the GNU General Public License is intended to guarantee your freedom to -share and change all versions of a program--to make sure it remains free -software for all its users. We, the Free Software Foundation, use the -GNU General Public License for most of our software; it applies also to -any other work released this way by its authors. You can apply it to -your programs, too. - - When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you -have the freedom to distribute copies of free software (and charge for -them if you wish), that you receive source code or can get it if you -want it, that you can change the software or use pieces of it in new -free programs, and that you know you can do these things. - - To protect your rights, we need to prevent others from denying you -these rights or asking you to surrender the rights. Therefore, you have -certain responsibilities if you distribute copies of the software, or if -you modify it: responsibilities to respect the freedom of others. - - For example, if you distribute copies of such a program, whether -gratis or for a fee, you must pass on to the recipients the same -freedoms that you received. You must make sure that they, too, receive -or can get the source code. And you must show them these terms so they -know their rights. - - Developers that use the GNU GPL protect your rights with two steps: -(1) assert copyright on the software, and (2) offer you this License -giving you legal permission to copy, distribute and/or modify it. - - For the developers' and authors' protection, the GPL clearly explains -that there is no warranty for this free software. For both users' and -authors' sake, the GPL requires that modified versions be marked as -changed, so that their problems will not be attributed erroneously to -authors of previous versions. - - Some devices are designed to deny users access to install or run -modified versions of the software inside them, although the manufacturer -can do so. This is fundamentally incompatible with the aim of -protecting users' freedom to change the software. The systematic -pattern of such abuse occurs in the area of products for individuals to -use, which is precisely where it is most unacceptable. Therefore, we -have designed this version of the GPL to prohibit the practice for those -products. If such problems arise substantially in other domains, we -stand ready to extend this provision to those domains in future versions -of the GPL, as needed to protect the freedom of users. - - Finally, every program is threatened constantly by software patents. -States should not allow patents to restrict development and use of -software on general-purpose computers, but in those that do, we wish to -avoid the special danger that patents applied to a free program could -make it effectively proprietary. To prevent this, the GPL assures that -patents cannot be used to render the program non-free. - - The precise terms and conditions for copying, distribution and -modification follow. - - TERMS AND CONDITIONS - - 0. Definitions. - - "This License" refers to version 3 of the GNU General Public License. - - "Copyright" also means copyright-like laws that apply to other kinds of -works, such as semiconductor masks. - - "The Program" refers to any copyrightable work licensed under this -License. Each licensee is addressed as "you". "Licensees" and -"recipients" may be individuals or organizations. - - To "modify" a work means to copy from or adapt all or part of the work -in a fashion requiring copyright permission, other than the making of an -exact copy. The resulting work is called a "modified version" of the -earlier work or a work "based on" the earlier work. - - A "covered work" means either the unmodified Program or a work based -on the Program. - - To "propagate" a work means to do anything with it that, without -permission, would make you directly or secondarily liable for -infringement under applicable copyright law, except executing it on a -computer or modifying a private copy. Propagation includes copying, -distribution (with or without modification), making available to the -public, and in some countries other activities as well. - - To "convey" a work means any kind of propagation that enables other -parties to make or receive copies. Mere interaction with a user through -a computer network, with no transfer of a copy, is not conveying. - - An interactive user interface displays "Appropriate Legal Notices" -to the extent that it includes a convenient and prominently visible -feature that (1) displays an appropriate copyright notice, and (2) -tells the user that there is no warranty for the work (except to the -extent that warranties are provided), that licensees may convey the -work under this License, and how to view a copy of this License. If -the interface presents a list of user commands or options, such as a -menu, a prominent item in the list meets this criterion. - - 1. Source Code. - - The "source code" for a work means the preferred form of the work -for making modifications to it. "Object code" means any non-source -form of a work. - - A "Standard Interface" means an interface that either is an official -standard defined by a recognized standards body, or, in the case of -interfaces specified for a particular programming language, one that -is widely used among developers working in that language. - - The "System Libraries" of an executable work include anything, other -than the work as a whole, that (a) is included in the normal form of -packaging a Major Component, but which is not part of that Major -Component, and (b) serves only to enable use of the work with that -Major Component, or to implement a Standard Interface for which an -implementation is available to the public in source code form. A -"Major Component", in this context, means a major essential component -(kernel, window system, and so on) of the specific operating system -(if any) on which the executable work runs, or a compiler used to -produce the work, or an object code interpreter used to run it. - - The "Corresponding Source" for a work in object code form means all -the source code needed to generate, install, and (for an executable -work) run the object code and to modify the work, including scripts to -control those activities. However, it does not include the work's -System Libraries, or general-purpose tools or generally available free -programs which are used unmodified in performing those activities but -which are not part of the work. For example, Corresponding Source -includes interface definition files associated with source files for -the work, and the source code for shared libraries and dynamically -linked subprograms that the work is specifically designed to require, -such as by intimate data communication or control flow between those -subprograms and other parts of the work. - - The Corresponding Source need not include anything that users -can regenerate automatically from other parts of the Corresponding -Source. - - The Corresponding Source for a work in source code form is that -same work. - - 2. Basic Permissions. - - All rights granted under this License are granted for the term of -copyright on the Program, and are irrevocable provided the stated -conditions are met. This License explicitly affirms your unlimited -permission to run the unmodified Program. The output from running a -covered work is covered by this License only if the output, given its -content, constitutes a covered work. This License acknowledges your -rights of fair use or other equivalent, as provided by copyright law. - - You may make, run and propagate covered works that you do not -convey, without conditions so long as your license otherwise remains -in force. You may convey covered works to others for the sole purpose -of having them make modifications exclusively for you, or provide you -with facilities for running those works, provided that you comply with -the terms of this License in conveying all material for which you do -not control copyright. Those thus making or running the covered works -for you must do so exclusively on your behalf, under your direction -and control, on terms that prohibit them from making any copies of -your copyrighted material outside their relationship with you. - - Conveying under any other circumstances is permitted solely under -the conditions stated below. Sublicensing is not allowed; section 10 -makes it unnecessary. - - 3. Protecting Users' Legal Rights From Anti-Circumvention Law. - - No covered work shall be deemed part of an effective technological -measure under any applicable law fulfilling obligations under article -11 of the WIPO copyright treaty adopted on 20 December 1996, or -similar laws prohibiting or restricting circumvention of such -measures. - - When you convey a covered work, you waive any legal power to forbid -circumvention of technological measures to the extent such circumvention -is effected by exercising rights under this License with respect to -the covered work, and you disclaim any intention to limit operation or -modification of the work as a means of enforcing, against the work's -users, your or third parties' legal rights to forbid circumvention of -technological measures. - - 4. Conveying Verbatim Copies. - - You may convey verbatim copies of the Program's source code as you -receive it, in any medium, provided that you conspicuously and -appropriately publish on each copy an appropriate copyright notice; -keep intact all notices stating that this License and any -non-permissive terms added in accord with section 7 apply to the code; -keep intact all notices of the absence of any warranty; and give all -recipients a copy of this License along with the Program. - - You may charge any price or no price for each copy that you convey, -and you may offer support or warranty protection for a fee. - - 5. Conveying Modified Source Versions. - - You may convey a work based on the Program, or the modifications to -produce it from the Program, in the form of source code under the -terms of section 4, provided that you also meet all of these conditions: - - a) The work must carry prominent notices stating that you modified - it, and giving a relevant date. - - b) The work must carry prominent notices stating that it is - released under this License and any conditions added under section - 7. This requirement modifies the requirement in section 4 to - "keep intact all notices". - - c) You must license the entire work, as a whole, under this - License to anyone who comes into possession of a copy. This - License will therefore apply, along with any applicable section 7 - additional terms, to the whole of the work, and all its parts, - regardless of how they are packaged. This License gives no - permission to license the work in any other way, but it does not - invalidate such permission if you have separately received it. - - d) If the work has interactive user interfaces, each must display - Appropriate Legal Notices; however, if the Program has interactive - interfaces that do not display Appropriate Legal Notices, your - work need not make them do so. - - A compilation of a covered work with other separate and independent -works, which are not by their nature extensions of the covered work, -and which are not combined with it such as to form a larger program, -in or on a volume of a storage or distribution medium, is called an -"aggregate" if the compilation and its resulting copyright are not -used to limit the access or legal rights of the compilation's users -beyond what the individual works permit. Inclusion of a covered work -in an aggregate does not cause this License to apply to the other -parts of the aggregate. - - 6. Conveying Non-Source Forms. - - You may convey a covered work in object code form under the terms -of sections 4 and 5, provided that you also convey the -machine-readable Corresponding Source under the terms of this License, -in one of these ways: - - a) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by the - Corresponding Source fixed on a durable physical medium - customarily used for software interchange. - - b) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by a - written offer, valid for at least three years and valid for as - long as you offer spare parts or customer support for that product - model, to give anyone who possesses the object code either (1) a - copy of the Corresponding Source for all the software in the - product that is covered by this License, on a durable physical - medium customarily used for software interchange, for a price no - more than your reasonable cost of physically performing this - conveying of source, or (2) access to copy the - Corresponding Source from a network server at no charge. - - c) Convey individual copies of the object code with a copy of the - written offer to provide the Corresponding Source. This - alternative is allowed only occasionally and noncommercially, and - only if you received the object code with such an offer, in accord - with subsection 6b. - - d) Convey the object code by offering access from a designated - place (gratis or for a charge), and offer equivalent access to the - Corresponding Source in the same way through the same place at no - further charge. You need not require recipients to copy the - Corresponding Source along with the object code. If the place to - copy the object code is a network server, the Corresponding Source - may be on a different server (operated by you or a third party) - that supports equivalent copying facilities, provided you maintain - clear directions next to the object code saying where to find the - Corresponding Source. Regardless of what server hosts the - Corresponding Source, you remain obligated to ensure that it is - available for as long as needed to satisfy these requirements. - - e) Convey the object code using peer-to-peer transmission, provided - you inform other peers where the object code and Corresponding - Source of the work are being offered to the general public at no - charge under subsection 6d. - - A separable portion of the object code, whose source code is excluded -from the Corresponding Source as a System Library, need not be -included in conveying the object code work. - - A "User Product" is either (1) a "consumer product", which means any -tangible personal property which is normally used for personal, family, -or household purposes, or (2) anything designed or sold for incorporation -into a dwelling. In determining whether a product is a consumer product, -doubtful cases shall be resolved in favor of coverage. For a particular -product received by a particular user, "normally used" refers to a -typical or common use of that class of product, regardless of the status -of the particular user or of the way in which the particular user -actually uses, or expects or is expected to use, the product. A product -is a consumer product regardless of whether the product has substantial -commercial, industrial or non-consumer uses, unless such uses represent -the only significant mode of use of the product. - - "Installation Information" for a User Product means any methods, -procedures, authorization keys, or other information required to install -and execute modified versions of a covered work in that User Product from -a modified version of its Corresponding Source. The information must -suffice to ensure that the continued functioning of the modified object -code is in no case prevented or interfered with solely because -modification has been made. - - If you convey an object code work under this section in, or with, or -specifically for use in, a User Product, and the conveying occurs as -part of a transaction in which the right of possession and use of the -User Product is transferred to the recipient in perpetuity or for a -fixed term (regardless of how the transaction is characterized), the -Corresponding Source conveyed under this section must be accompanied -by the Installation Information. But this requirement does not apply -if neither you nor any third party retains the ability to install -modified object code on the User Product (for example, the work has -been installed in ROM). - - The requirement to provide Installation Information does not include a -requirement to continue to provide support service, warranty, or updates -for a work that has been modified or installed by the recipient, or for -the User Product in which it has been modified or installed. Access to a -network may be denied when the modification itself materially and -adversely affects the operation of the network or violates the rules and -protocols for communication across the network. - - Corresponding Source conveyed, and Installation Information provided, -in accord with this section must be in a format that is publicly -documented (and with an implementation available to the public in -source code form), and must require no special password or key for -unpacking, reading or copying. - - 7. Additional Terms. - - "Additional permissions" are terms that supplement the terms of this -License by making exceptions from one or more of its conditions. -Additional permissions that are applicable to the entire Program shall -be treated as though they were included in this License, to the extent -that they are valid under applicable law. If additional permissions -apply only to part of the Program, that part may be used separately -under those permissions, but the entire Program remains governed by -this License without regard to the additional permissions. - - When you convey a copy of a covered work, you may at your option -remove any additional permissions from that copy, or from any part of -it. (Additional permissions may be written to require their own -removal in certain cases when you modify the work.) You may place -additional permissions on material, added by you to a covered work, -for which you have or can give appropriate copyright permission. - - Notwithstanding any other provision of this License, for material you -add to a covered work, you may (if authorized by the copyright holders of -that material) supplement the terms of this License with terms: - - a) Disclaiming warranty or limiting liability differently from the - terms of sections 15 and 16 of this License; or - - b) Requiring preservation of specified reasonable legal notices or - author attributions in that material or in the Appropriate Legal - Notices displayed by works containing it; or - - c) Prohibiting misrepresentation of the origin of that material, or - requiring that modified versions of such material be marked in - reasonable ways as different from the original version; or - - d) Limiting the use for publicity purposes of names of licensors or - authors of the material; or - - e) Declining to grant rights under trademark law for use of some - trade names, trademarks, or service marks; or - - f) Requiring indemnification of licensors and authors of that - material by anyone who conveys the material (or modified versions of - it) with contractual assumptions of liability to the recipient, for - any liability that these contractual assumptions directly impose on - those licensors and authors. - - All other non-permissive additional terms are considered "further -restrictions" within the meaning of section 10. If the Program as you -received it, or any part of it, contains a notice stating that it is -governed by this License along with a term that is a further -restriction, you may remove that term. If a license document contains -a further restriction but permits relicensing or conveying under this -License, you may add to a covered work material governed by the terms -of that license document, provided that the further restriction does -not survive such relicensing or conveying. - - If you add terms to a covered work in accord with this section, you -must place, in the relevant source files, a statement of the -additional terms that apply to those files, or a notice indicating -where to find the applicable terms. - - Additional terms, permissive or non-permissive, may be stated in the -form of a separately written license, or stated as exceptions; -the above requirements apply either way. - - 8. Termination. - - You may not propagate or modify a covered work except as expressly -provided under this License. Any attempt otherwise to propagate or -modify it is void, and will automatically terminate your rights under -this License (including any patent licenses granted under the third -paragraph of section 11). - - However, if you cease all violation of this License, then your -license from a particular copyright holder is reinstated (a) -provisionally, unless and until the copyright holder explicitly and -finally terminates your license, and (b) permanently, if the copyright -holder fails to notify you of the violation by some reasonable means -prior to 60 days after the cessation. - - Moreover, your license from a particular copyright holder is -reinstated permanently if the copyright holder notifies you of the -violation by some reasonable means, this is the first time you have -received notice of violation of this License (for any work) from that -copyright holder, and you cure the violation prior to 30 days after -your receipt of the notice. - - Termination of your rights under this section does not terminate the -licenses of parties who have received copies or rights from you under -this License. If your rights have been terminated and not permanently -reinstated, you do not qualify to receive new licenses for the same -material under section 10. - - 9. Acceptance Not Required for Having Copies. - - You are not required to accept this License in order to receive or -run a copy of the Program. Ancillary propagation of a covered work -occurring solely as a consequence of using peer-to-peer transmission -to receive a copy likewise does not require acceptance. However, -nothing other than this License grants you permission to propagate or -modify any covered work. These actions infringe copyright if you do -not accept this License. Therefore, by modifying or propagating a -covered work, you indicate your acceptance of this License to do so. - - 10. Automatic Licensing of Downstream Recipients. - - Each time you convey a covered work, the recipient automatically -receives a license from the original licensors, to run, modify and -propagate that work, subject to this License. You are not responsible -for enforcing compliance by third parties with this License. - - An "entity transaction" is a transaction transferring control of an -organization, or substantially all assets of one, or subdividing an -organization, or merging organizations. If propagation of a covered -work results from an entity transaction, each party to that -transaction who receives a copy of the work also receives whatever -licenses to the work the party's predecessor in interest had or could -give under the previous paragraph, plus a right to possession of the -Corresponding Source of the work from the predecessor in interest, if -the predecessor has it or can get it with reasonable efforts. - - You may not impose any further restrictions on the exercise of the -rights granted or affirmed under this License. For example, you may -not impose a license fee, royalty, or other charge for exercise of -rights granted under this License, and you may not initiate litigation -(including a cross-claim or counterclaim in a lawsuit) alleging that -any patent claim is infringed by making, using, selling, offering for -sale, or importing the Program or any portion of it. - - 11. Patents. - - A "contributor" is a copyright holder who authorizes use under this -License of the Program or a work on which the Program is based. The -work thus licensed is called the contributor's "contributor version". - - A contributor's "essential patent claims" are all patent claims -owned or controlled by the contributor, whether already acquired or -hereafter acquired, that would be infringed by some manner, permitted -by this License, of making, using, or selling its contributor version, -but do not include claims that would be infringed only as a -consequence of further modification of the contributor version. For -purposes of this definition, "control" includes the right to grant -patent sublicenses in a manner consistent with the requirements of -this License. - - Each contributor grants you a non-exclusive, worldwide, royalty-free -patent license under the contributor's essential patent claims, to -make, use, sell, offer for sale, import and otherwise run, modify and -propagate the contents of its contributor version. - - In the following three paragraphs, a "patent license" is any express -agreement or commitment, however denominated, not to enforce a patent -(such as an express permission to practice a patent or covenant not to -sue for patent infringement). To "grant" such a patent license to a -party means to make such an agreement or commitment not to enforce a -patent against the party. - - If you convey a covered work, knowingly relying on a patent license, -and the Corresponding Source of the work is not available for anyone -to copy, free of charge and under the terms of this License, through a -publicly available network server or other readily accessible means, -then you must either (1) cause the Corresponding Source to be so -available, or (2) arrange to deprive yourself of the benefit of the -patent license for this particular work, or (3) arrange, in a manner -consistent with the requirements of this License, to extend the patent -license to downstream recipients. "Knowingly relying" means you have -actual knowledge that, but for the patent license, your conveying the -covered work in a country, or your recipient's use of the covered work -in a country, would infringe one or more identifiable patents in that -country that you have reason to believe are valid. - - If, pursuant to or in connection with a single transaction or -arrangement, you convey, or propagate by procuring conveyance of, a -covered work, and grant a patent license to some of the parties -receiving the covered work authorizing them to use, propagate, modify -or convey a specific copy of the covered work, then the patent license -you grant is automatically extended to all recipients of the covered -work and works based on it. - - A patent license is "discriminatory" if it does not include within -the scope of its coverage, prohibits the exercise of, or is -conditioned on the non-exercise of one or more of the rights that are -specifically granted under this License. You may not convey a covered -work if you are a party to an arrangement with a third party that is -in the business of distributing software, under which you make payment -to the third party based on the extent of your activity of conveying -the work, and under which the third party grants, to any of the -parties who would receive the covered work from you, a discriminatory -patent license (a) in connection with copies of the covered work -conveyed by you (or copies made from those copies), or (b) primarily -for and in connection with specific products or compilations that -contain the covered work, unless you entered into that arrangement, -or that patent license was granted, prior to 28 March 2007. - - Nothing in this License shall be construed as excluding or limiting -any implied license or other defenses to infringement that may -otherwise be available to you under applicable patent law. - - 12. No Surrender of Others' Freedom. - - If conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot convey a -covered work so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you may -not convey it at all. For example, if you agree to terms that obligate you -to collect a royalty for further conveying from those to whom you convey -the Program, the only way you could satisfy both those terms and this -License would be to refrain entirely from conveying the Program. - - 13. Use with the GNU Affero General Public License. - - Notwithstanding any other provision of this License, you have -permission to link or combine any covered work with a work licensed -under version 3 of the GNU Affero General Public License into a single -combined work, and to convey the resulting work. The terms of this -License will continue to apply to the part which is the covered work, -but the special requirements of the GNU Affero General Public License, -section 13, concerning interaction through a network will apply to the -combination as such. - - 14. Revised Versions of this License. - - The Free Software Foundation may publish revised and/or new versions of -the GNU General Public License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. - - Each version is given a distinguishing version number. If the -Program specifies that a certain numbered version of the GNU General -Public License "or any later version" applies to it, you have the -option of following the terms and conditions either of that numbered -version or of any later version published by the Free Software -Foundation. If the Program does not specify a version number of the -GNU General Public License, you may choose any version ever published -by the Free Software Foundation. - - If the Program specifies that a proxy can decide which future -versions of the GNU General Public License can be used, that proxy's -public statement of acceptance of a version permanently authorizes you -to choose that version for the Program. - - Later license versions may give you additional or different -permissions. However, no additional obligations are imposed on any -author or copyright holder as a result of your choosing to follow a -later version. - - 15. Disclaimer of Warranty. - - THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT -HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY -OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM -IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF -ALL NECESSARY SERVICING, REPAIR OR CORRECTION. - - 16. Limitation of Liability. - - IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS -THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY -GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE -USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF -DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD -PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), -EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF -SUCH DAMAGES. - - 17. Interpretation of Sections 15 and 16. - - If the disclaimer of warranty and limitation of liability provided -above cannot be given local legal effect according to their terms, -reviewing courts shall apply local law that most closely approximates -an absolute waiver of all civil liability in connection with the -Program, unless a warranty or assumption of liability accompanies a -copy of the Program in return for a fee. - - END OF TERMS AND CONDITIONS - - How to Apply These Terms to Your New Programs - - If you develop a new program, and you want it to be of the greatest -possible use to the public, the best way to achieve this is to make it -free software which everyone can redistribute and change under these terms. - - To do so, attach the following notices to the program. It is safest -to attach them to the start of each source file to most effectively -state the exclusion of warranty; and each file should have at least -the "copyright" line and a pointer to where the full notice is found. - - - Copyright (C) - - This program is free software: you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation, either version 3 of the License, or - (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this program. If not, see . - -Also add information on how to contact you by electronic and paper mail. - - If the program does terminal interaction, make it output a short -notice like this when it starts in an interactive mode: - - Copyright (C) - This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. - This is free software, and you are welcome to redistribute it - under certain conditions; type `show c' for details. - -The hypothetical commands `show w' and `show c' should show the appropriate -parts of the General Public License. Of course, your program's commands -might be different; for a GUI interface, you would use an "about box". - - You should also get your employer (if you work as a programmer) or school, -if any, to sign a "copyright disclaimer" for the program, if necessary. -For more information on this, and how to apply and follow the GNU GPL, see -. - - The GNU General Public License does not permit incorporating your program -into proprietary programs. If your program is a subroutine library, you -may consider it more useful to permit linking proprietary applications with -the library. If this is what you want to do, use the GNU Lesser General -Public License instead of this License. But first, please read -. + EUROPEAN UNION PUBLIC LICENCE v. 1.2 + EUPL © the European Union 2007, 2016 + +This European Union Public Licence (the ‘EUPL’) applies to the Work (as defined +below) which is provided under the terms of this Licence. Any use of the Work, +other than as authorised under this Licence is prohibited (to the extent such +use is covered by a right of the copyright holder of the Work). + +The Work is provided under the terms of this Licence when the Licensor (as +defined below) has placed the following notice immediately following the +copyright notice for the Work: + + Licensed under the EUPL + +or has expressed by any other means his willingness to license under the EUPL. + +1. Definitions + +In this Licence, the following terms have the following meaning: + +- ‘The Licence’: this Licence. + +- ‘The Original Work’: the work or software distributed or communicated by the + Licensor under this Licence, available as Source Code and also as Executable + Code as the case may be. + +- ‘Derivative Works’: the works or software that could be created by the + Licensee, based upon the Original Work or modifications thereof. This Licence + does not define the extent of modification or dependence on the Original Work + required in order to classify a work as a Derivative Work; this extent is + determined by copyright law applicable in the country mentioned in Article 15. + +- ‘The Work’: the Original Work or its Derivative Works. + +- ‘The Source Code’: the human-readable form of the Work which is the most + convenient for people to study and modify. + +- ‘The Executable Code’: any code which has generally been compiled and which is + meant to be interpreted by a computer as a program. + +- ‘The Licensor’: the natural or legal person that distributes or communicates + the Work under the Licence. + +- ‘Contributor(s)’: any natural or legal person who modifies the Work under the + Licence, or otherwise contributes to the creation of a Derivative Work. + +- ‘The Licensee’ or ‘You’: any natural or legal person who makes any usage of + the Work under the terms of the Licence. + +- ‘Distribution’ or ‘Communication’: any act of selling, giving, lending, + renting, distributing, communicating, transmitting, or otherwise making + available, online or offline, copies of the Work or providing access to its + essential functionalities at the disposal of any other natural or legal + person. + +2. Scope of the rights granted by the Licence + +The Licensor hereby grants You a worldwide, royalty-free, non-exclusive, +sublicensable licence to do the following, for the duration of copyright vested +in the Original Work: + +- use the Work in any circumstance and for all usage, +- reproduce the Work, +- modify the Work, and make Derivative Works based upon the Work, +- communicate to the public, including the right to make available or display + the Work or copies thereof to the public and perform publicly, as the case may + be, the Work, +- distribute the Work or copies thereof, +- lend and rent the Work or copies thereof, +- sublicense rights in the Work or copies thereof. + +Those rights can be exercised on any media, supports and formats, whether now +known or later invented, as far as the applicable law permits so. + +In the countries where moral rights apply, the Licensor waives his right to +exercise his moral right to the extent allowed by law in order to make effective +the licence of the economic rights here above listed. + +The Licensor grants to the Licensee royalty-free, non-exclusive usage rights to +any patents held by the Licensor, to the extent necessary to make use of the +rights granted on the Work under this Licence. + +3. Communication of the Source Code + +The Licensor may provide the Work either in its Source Code form, or as +Executable Code. If the Work is provided as Executable Code, the Licensor +provides in addition a machine-readable copy of the Source Code of the Work +along with each copy of the Work that the Licensor distributes or indicates, in +a notice following the copyright notice attached to the Work, a repository where +the Source Code is easily and freely accessible for as long as the Licensor +continues to distribute or communicate the Work. + +4. Limitations on copyright + +Nothing in this Licence is intended to deprive the Licensee of the benefits from +any exception or limitation to the exclusive rights of the rights owners in the +Work, of the exhaustion of those rights or of other applicable limitations +thereto. + +5. Obligations of the Licensee + +The grant of the rights mentioned above is subject to some restrictions and +obligations imposed on the Licensee. Those obligations are the following: + +Attribution right: The Licensee shall keep intact all copyright, patent or +trademarks notices and all notices that refer to the Licence and to the +disclaimer of warranties. The Licensee must include a copy of such notices and a +copy of the Licence with every copy of the Work he/she distributes or +communicates. The Licensee must cause any Derivative Work to carry prominent +notices stating that the Work has been modified and the date of modification. + +Copyleft clause: If the Licensee distributes or communicates copies of the +Original Works or Derivative Works, this Distribution or Communication will be +done under the terms of this Licence or of a later version of this Licence +unless the Original Work is expressly distributed only under this version of the +Licence — for example by communicating ‘EUPL v. 1.2 only’. The Licensee +(becoming Licensor) cannot offer or impose any additional terms or conditions on +the Work or Derivative Work that alter or restrict the terms of the Licence. + +Compatibility clause: If the Licensee Distributes or Communicates Derivative +Works or copies thereof based upon both the Work and another work licensed under +a Compatible Licence, this Distribution or Communication can be done under the +terms of this Compatible Licence. For the sake of this clause, ‘Compatible +Licence’ refers to the licences listed in the appendix attached to this Licence. +Should the Licensee's obligations under the Compatible Licence conflict with +his/her obligations under this Licence, the obligations of the Compatible +Licence shall prevail. + +Provision of Source Code: When distributing or communicating copies of the Work, +the Licensee will provide a machine-readable copy of the Source Code or indicate +a repository where this Source will be easily and freely available for as long +as the Licensee continues to distribute or communicate the Work. + +Legal Protection: This Licence does not grant permission to use the trade names, +trademarks, service marks, or names of the Licensor, except as required for +reasonable and customary use in describing the origin of the Work and +reproducing the content of the copyright notice. + +6. Chain of Authorship + +The original Licensor warrants that the copyright in the Original Work granted +hereunder is owned by him/her or licensed to him/her and that he/she has the +power and authority to grant the Licence. + +Each Contributor warrants that the copyright in the modifications he/she brings +to the Work are owned by him/her or licensed to him/her and that he/she has the +power and authority to grant the Licence. + +Each time You accept the Licence, the original Licensor and subsequent +Contributors grant You a licence to their contributions to the Work, under the +terms of this Licence. + +7. Disclaimer of Warranty + +The Work is a work in progress, which is continuously improved by numerous +Contributors. It is not a finished work and may therefore contain defects or +‘bugs’ inherent to this type of development. + +For the above reason, the Work is provided under the Licence on an ‘as is’ basis +and without warranties of any kind concerning the Work, including without +limitation merchantability, fitness for a particular purpose, absence of defects +or errors, accuracy, non-infringement of intellectual property rights other than +copyright as stated in Article 6 of this Licence. + +This disclaimer of warranty is an essential part of the Licence and a condition +for the grant of any rights to the Work. + +8. Disclaimer of Liability + +Except in the cases of wilful misconduct or damages directly caused to natural +persons, the Licensor will in no event be liable for any direct or indirect, +material or moral, damages of any kind, arising out of the Licence or of the use +of the Work, including without limitation, damages for loss of goodwill, work +stoppage, computer failure or malfunction, loss of data or any commercial +damage, even if the Licensor has been advised of the possibility of such damage. +However, the Licensor will be liable under statutory product liability laws as +far such laws apply to the Work. + +9. Additional agreements + +While distributing the Work, You may choose to conclude an additional agreement, +defining obligations or services consistent with this Licence. However, if +accepting obligations, You may act only on your own behalf and on your sole +responsibility, not on behalf of the original Licensor or any other Contributor, +and only if You agree to indemnify, defend, and hold each Contributor harmless +for any liability incurred by, or claims asserted against such Contributor by +the fact You have accepted any warranty or additional liability. + +10. Acceptance of the Licence + +The provisions of this Licence can be accepted by clicking on an icon ‘I agree’ +placed under the bottom of a window displaying the text of this Licence or by +affirming consent in any other similar way, in accordance with the rules of +applicable law. Clicking on that icon indicates your clear and irrevocable +acceptance of this Licence and all of its terms and conditions. + +Similarly, you irrevocably accept this Licence and all of its terms and +conditions by exercising any rights granted to You by Article 2 of this Licence, +such as the use of the Work, the creation by You of a Derivative Work or the +Distribution or Communication by You of the Work or copies thereof. + +11. Information to the public + +In case of any Distribution or Communication of the Work by means of electronic +communication by You (for example, by offering to download the Work from a +remote location) the distribution channel or media (for example, a website) must +at least provide to the public the information requested by the applicable law +regarding the Licensor, the Licence and the way it may be accessible, concluded, +stored and reproduced by the Licensee. + +12. Termination of the Licence + +The Licence and the rights granted hereunder will terminate automatically upon +any breach by the Licensee of the terms of the Licence. + +Such a termination will not terminate the licences of any person who has +received the Work from the Licensee under the Licence, provided such persons +remain in full compliance with the Licence. + +13. Miscellaneous + +Without prejudice of Article 9 above, the Licence represents the complete +agreement between the Parties as to the Work. + +If any provision of the Licence is invalid or unenforceable under applicable +law, this will not affect the validity or enforceability of the Licence as a +whole. Such provision will be construed or reformed so as necessary to make it +valid and enforceable. + +The European Commission may publish other linguistic versions or new versions of +this Licence or updated versions of the Appendix, so far this is required and +reasonable, without reducing the scope of the rights granted by the Licence. New +versions of the Licence will be published with a unique version number. + +All linguistic versions of this Licence, approved by the European Commission, +have identical value. Parties can take advantage of the linguistic version of +their choice. + +14. Jurisdiction + +Without prejudice to specific agreement between parties, + +- any litigation resulting from the interpretation of this License, arising + between the European Union institutions, bodies, offices or agencies, as a + Licensor, and any Licensee, will be subject to the jurisdiction of the Court + of Justice of the European Union, as laid down in article 272 of the Treaty on + the Functioning of the European Union, + +- any litigation arising between other parties and resulting from the + interpretation of this License, will be subject to the exclusive jurisdiction + of the competent court where the Licensor resides or conducts its primary + business. + +15. Applicable Law + +Without prejudice to specific agreement between parties, + +- this Licence shall be governed by the law of the European Union Member State + where the Licensor has his seat, resides or has his registered office, + +- this licence shall be governed by Belgian law if the Licensor has no seat, + residence or registered office inside a European Union Member State. + +Appendix + +‘Compatible Licences’ according to Article 5 EUPL are: + +- GNU General Public License (GPL) v. 2, v. 3 +- GNU Affero General Public License (AGPL) v. 3 +- Open Software License (OSL) v. 2.1, v. 3.0 +- Eclipse Public License (EPL) v. 1.0 +- CeCILL v. 2.0, v. 2.1 +- Mozilla Public Licence (MPL) v. 2 +- GNU Lesser General Public Licence (LGPL) v. 2.1, v. 3 +- Creative Commons Attribution-ShareAlike v. 3.0 Unported (CC BY-SA 3.0) for + works other than software +- European Union Public Licence (EUPL) v. 1.1, v. 1.2 +- Québec Free and Open-Source Licence — Reciprocity (LiLiQ-R) or Strong + Reciprocity (LiLiQ-R+). + +The European Commission may update this Appendix to later versions of the above +licences without producing a new version of the EUPL, as long as they provide +the rights granted in Article 2 of this Licence and protect the covered Source +Code from exclusive appropriation. + +All other changes or additions to this Appendix require the production of a new +EUPL version. \ No newline at end of file diff --git a/MANIFEST.in b/MANIFEST.in deleted file mode 100644 index 0081be3..0000000 --- a/MANIFEST.in +++ /dev/null @@ -1,4 +0,0 @@ -# Exclude the following Python files -exclude eppoPynder/api_query.py -exclude eppoPynder/unnest_lists.py -exclude requirements.txt diff --git a/README.md b/README.md index d2aad7b..87ab033 100644 --- a/README.md +++ b/README.md @@ -1,301 +1,60 @@ -# eppoPynder +# eppoPynder -## Overview - -Welcome to the *eppoPynder* package! This package is a wrapper around the public APIs of the European and Mediterranean Plant Protection Organization (EPPO) database. It provides a straightforward way to access a wide range of pest-specific information that has been produced or collected by EPPO. +[![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) -*eppoPynder* is designed for use by researchers and practitioners working in plant protection who need easy access to the EPPO database using Python. +## Overview -## Prerequisites +**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. -To use the *eppoPynder* package, you need a stable internet connection, as it interacts with the EPPO database online services to fetch and manipulate data. A reliable internet connection is essential for the functionality of the package. +The package is intended for researchers, analysts, and practitioners in plant +protection who require convenient programmatic access to EPPO data. ## Installation -You can install the *eppoPynder* package from PyPi using the following command: - -``` -pip install eppoPynder -``` - -Alternatively, if you want to install the package from GitHub (for the latest development version), use: - -``` -pip install git+https://github.com/openefsa/eppoPynder.git -``` - -## Working with API Tokens - -The *eppoPynder* package requires your unique token to be included in each API request for proper functionality. There are three ways to provide this token: - -1. **Using the `.env` file** -2. **Manually adding it to each API request** - -### 1. Setting Environment Variables via `.env` - -The `.env` file is used to specify environment variables that Python loads at the start of every session. It is particularly useful for setting variables, such as API keys, that can be accessed by Python scripts and functions. - -After installing the *eppoPynder* package, you should create a `.env` file in your project's root directory (i.e., the same directory as `setup.py`). This is important because the `python-dotenv` package expects the `.env` file to be in this location by default. - -#### Example Project Structure: - -``` -/eppoPynder - ├── .env # Place your .env file here - ├── setup.py - ├── src/ - │ └── eppoPynder/ - │ └── __init__.py - │ └── module.py - └── README.md -``` - -You can create or modify the `.env` file manually using any text editor. In the `.env` file, you set environment variables in the following format: - -`EPPO_token=your-eppo-token` - -After adding your EPPO token to the `.env` file, save and close the file. Python will automatically read the token when it starts up, and you can access it in any Python session using `os.getenv('EPPO_token')`. - -### 2. Manually adding your token to each API request - -For functions that require an API token, you can manually specify the token in the `token` argument of the function. This method is useful if you want to use different tokens for different function calls or if you don't want to store the token globally. For example: - -`query_the_eppo_for_service(queried_eppocode = "BEMITA", service = "general", token = "your-eppo-token")` - -#### Explanation: - -`query_the_eppo_for_service(queried_eppocode = "BEMITA", service = "general", token = "your-eppo-token")`: This calls the function with the necessary parameters: - -- `queried_eppocode = "BEMITA"`: The EPPO code for which you want to query a service. -- `service = "general"`: Specifies the service you want to query (you can replace this with any valid service type). -- `token = "your-eppo-token"`: Passes the token for authentication. Replace "your-eppo-token" with your actual EPPO token enclosed in quotes. - -## Basic Usage - -The primary functionality of *eppoPynder* is to query the EPPO database for specific EPPO codes and retrieve data across various services. Users can either choose to: 1) query a single service for a given EPPO code or 2) query all available services in the database for more comprehensive information. - -For plant and pest species, the basic available information includes scientific names, synonyms, common names in different languages, and taxonomic position. For each pest of regulatory interest, more detailed information can also be retrieved regarding its host plants and categorization (quarantine status). - -The examples below will guide you on how to use the functions in this package to access these data, but to begin, we need to load the *eppoPynder* package with this command: - -``` -import eppoPynder -``` - -If you want to learn more about the arguments and usage of a particular function, you can use Python's built-in `help()` function. Simply run: - -``` -help(function_name) -``` - -This will display the detailed documentation for the function, including its arguments, return values, and examples. - -For example, if you're working with a function called `query_the_eppo_for_service()`, you would use: - -``` -help(query_the_eppo_for_service) -``` - -## Querying a Specific Service - -To query a specific service (e.g., categorization) for an EPPO code (e.g., "BEMITA"), you can use the `query_the_eppo_for_service()` function as follows: +### From PyPi -``` -categorization_BEMITA = query_the_eppo_for_service("BEMITA", service = "categorization") ``` - -### Expected Output: - -``` ->>> categorization_BEMITA - nomcontinent isocode ... queried_on queried_url -0 America CL ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -1 Asia BH ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -2 Asia KZ ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -3 Europe AZ ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -4 Europe BY ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -5 Europe GE ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -6 Europe MD ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -7 Europe NO ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -8 Europe RU ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -9 Europe RS ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -10 Europe CH ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -11 Europe TR ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -12 Europe UA ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -13 Europe GB ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -14 Oceania NZ ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -15 RPPO/EU 9M ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -16 RPPO/EU 9A ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -17 RPPO/EU 9L ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -18 RPPO/EU 9L ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -19 RPPO/EU 9H ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... - -[20 rows x 11 columns] -``` - -`categorization_BEMITA` is a dataframe containing information about the categorization of the EPPO code "BEMITA", and includes the following columns: - -- **nomcontinent**: The continent where the country is located. -- **isocode**: The ISO country code. -- **country**: The name of the country or region. -- **qlist**: A code representing the pest status or classification. -- **qlistlabel**: A label explaining the pest classification (e.g., "A1 list" or "Quarantine pest"). -- **yr_add**: The year the country was added to the list. -- **yr_del**: The year the country was removed (if applicable). -- **yr_trans**: The year the country transitioned (if applicable). -- **queried_eppocode**: The input EPPO code. -- **queried_on**: The date when the query was performed. -- **queried_url**: The queried URL. - -## Querying All Available Services - -If you wish to query all available services for the EPPO code "BEMITA", you can use the `query_the_whole_eppo()` function. This will return a dictionary of dataframes, each corresponding to a different service. - -``` -result_dict = query_the_whole_eppo("BEMITA") -``` - -### Expected Output: - -``` -# Print the names of the services in the result - ->>> result_dict.keys() -dict_keys(['general', 'names', 'taxonomy', 'categorization', 'hosts', 'pests', 'kingdom']) -``` - -`result_dict.keys()` returns the names of the services: general, names, taxonomy, categorization, hosts, pests, and kingdom. - -``` -# Print the data from a specific service, e.g., categorization - ->>> result_dict["categorization"] - nomcontinent isocode ... queried_on queried_url -0 America CL ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -1 Asia BH ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -2 Asia KZ ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -3 Europe AZ ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -4 Europe BY ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -5 Europe GE ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -6 Europe MD ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -7 Europe NO ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -8 Europe RU ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -9 Europe RS ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -10 Europe CH ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -11 Europe TR ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -12 Europe UA ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -13 Europe GB ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -14 Oceania NZ ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -15 RPPO/EU 9M ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -16 RPPO/EU 9A ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -17 RPPO/EU 9L ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -18 RPPO/EU 9L ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -19 RPPO/EU 9H ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... - -[20 rows x 11 columns] -``` - -Accessing a specific service (e.g., `result_dict["categorization"]`) will show the data related to that particular service for the EPPO code "BEMITA". - -## Wrangling Data - -The *eppoPynder* package also provides a data wrangling function, `taxonomy_ranked()`, which can combine the data fetched from the "taxonomy" and "kingdom" EPPO services to create a unified, integrated dataframe. - -For example, assume you have two dataframes: `taxonomy` and `kingdom`, which were obtained by querying the "taxonomy" and "kingdom" services for the EPPO code "BEMITA" using the `query_the_eppo_for_service()` function. - -You can combine these two dataframes as follows: - -``` -# Query the taxonomy service for the EPPO code "BEMITA" -taxonomy = query_the_eppo_for_service("BEMITA", service = "taxonomy") - -# Query the kingdom service for the EPPO code "BEMITA" -kingdom = query_the_eppo_for_service("BEMITA", service = "kingdom") - -# Combine taxonomy and kingdom data -wrangled_data = taxonomy_ranked(taxonomy, kingdom) +pip install eppopynder ``` -### Expected Output: +### Development version -``` ->>> wrangled_data - rank codeid ... queried_on queried_url -0 kingdom 57021 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -1 57200 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -2 77963 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -3 59061 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -4 58830 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -5 73260 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -6 56905 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -7 57321 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... -8 5935 ... 2024-12-19 https://data.eppo.int/api/rest/1.0/taxon/BEMIT... +To install the latest development version: -[9 rows x 8 columns] ``` - -`wrangled_data` is a dataframe that combines the taxonomy and kingdom information for the EPPO code "BEMITA". This integration provides a more comprehensive view of the organism's taxonomic rank. - -Specifically, the output dataframe contains the following columns: - -- **rank**: The taxonomic rank. -- **codeid**: A unique identifier for each entry. -- **eppocode**: The EPPO code representing the taxonomic group. -- **prefname**: The preferred name of the taxonomic group (e.g., "Animalia", "Insecta"). -- **level**: The taxonomic level in the hierarchy (1 for the broadest category, progressing to more specific levels). -- **queried_eppocode**: The input EPPO code. -- **queried_on**: The date when the query was performed. -- **queried_url**: The queried URL. - -## Retrieving Countries in Regional Plant Protection Organizations - -The `getting_countries()` function allows you to retrieve all the member countries of a specific Regional Plant Protection Organization (RPPO). - -For example, to get the member countries of the EAEU (Eurasian Economic Union), you can use the following command: - -``` -EAEU_countries = getting_countries('EAEU') -``` - -### Expected Output: - -``` ->>> EAEU_countries -'Armenia, Belarus, Kazakhstan, Kyrgyzstan, Russia' +pip install git+https://github.com/openefsa/eppoPynder.git ``` -`EAEU_countries` is a string of country names that are members of the EAEU. +## Requirements -## Data Dump for Multiple EPPO Codes +An active internet connection is required, as the package communicates with +EPPO's online services to fetch and process data. -The `data_dump()` function allows you to retrieve a comprehensive data dump for multiple EPPO codes. This function queries all available EPPO services for a list of input codes. +## Usage -The following is an example of how the function can be used to query all available EPPO services for the EPPO codes "APHIPO" and "LEUCSC": +Once installed, load the package as usual: -``` -data_dump_result = data_dump(["APHIPO", "LEUCSC"]) +```python +from eppopynder import * ``` -### Expected Output: +Basic usage examples and full documentation are available in the package +[guide](docs/guide.md). -``` -# Print the names of the services in the result +## Authors and maintainers ->>> data_dump_result.keys() -dict_keys(['general', 'names', 'taxonomy', 'categorization', 'hosts', 'pests', 'kingdom']) -``` +- **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)). -The output is a dictionary of dataframes, each corresponding to a different service: general, names, taxonomy, categorization, hosts, pests, and kingdom. - -``` -# Print the data from a specific service, e.g., general - ->>> data_dump_result["general"] - pestCode ... queried_url -0 APHIPO ... https://data.eppo.int/api/rest/1.0/taxon/APHIP... -0 LEUCSC ... https://data.eppo.int/api/rest/1.0/taxon/LEUCS... - -[2 rows x 20 columns] -``` +## Links -Accessing a specific service (e.g., `data_dump["general"]`) will show the data related to that particular service for the EPPO codes "APHIPO" and "LEUCSC". The column `queried_eppocode` in the dataframe distinguishes which data have been retrieved for each EPPO code. \ No newline at end of file +- **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). diff --git a/dist/eppoPynder-1.0.0-py3-none-any.whl b/dist/eppoPynder-1.0.0-py3-none-any.whl deleted file mode 100644 index fd886baaac60d74a0168f6d70ec5b18ef2e7c920..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 22743 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 gimCa>8vomQ)RoX~C#0F?z{G5`Po diff --git a/dist/eppopynder-1.0.0.tar.gz b/dist/eppopynder-1.0.0.tar.gz deleted file mode 100644 index a4c3faaf53478acc754b382ddce69240eff891c7..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 27856 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%0A)TRZ^(4^g4?|A3-M-!j5!v-~<1Ig~z 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 YN!T=tRG$Vz#zP<<*TFp$T{M*c17F$BH~;_u diff --git a/docs/guide.md b/docs/guide.md new file mode 100644 index 0000000..d01fa18 --- /dev/null +++ b/docs/guide.md @@ -0,0 +1,342 @@ +# Introduction to 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 + +```bash +$ pip install eppoPynder +``` + +### Development version + +To install the latest development version: + +```bash +$ 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. + +## Working with API keys + +The *eppoPynder* package requires your unique API token to function properly. +You can provide this token in one of two ways: + +1. By setting it in a `.env` file. +2. By including it manually during the client initialization. + +### Setting the API key via `.env` + +A `.env` file is used to define environment variables that Python can load at +runtime. This approach is particularly convenient for sensitive information +like API keys, as it allows you to use them in any Python script or function +without hardcoding them. + +Place the `.env` file in the root directory of you project (for example, +`C:/Users/username/Documents/myProject/.env` on Windows or +`~/Documents/myProject/.env` on Unix-like systems). You can create or edit this +file with any plain text editor. + +Add your EPPO API key in the following format: + +`EPPO_API_KEY=` + +Once the file is saved, the variable will be correctly set for the library to +use during execution. + +### Setting the API key manually during client initialization + +Alternatively, you can provide the API key directly in the `api_key` argument +of client instantiation. This is useful if you prefer not to store the token +globally. For example: + +```python +from eppopynder import Client + +client = Client(api_key="") +``` + +Note that if an API key is explicitly provided, the API key set through the +`.env` file will be ignored, if any. + +## Basic usage + +The main purpose of *eppoPynder* is to query the EPPO database for specific +EPPO codes and retrieve relevant information across various endpoints. For each +endpoint, you can either: + +1. Query all available services to obtain more comprehensive data. +2. Query one or more services to obtain specific data. + +For plant and pest species, the basic information returned includes scientific +names, synonyms, common names in different languages, and taxonomic +classification. For pests of regulatory interest, you can also retrieve more +detailed information, such as host plants and quarantine categorization. + +Below are examples demonstrating how to use the functions in this package. +First, load the *eppoPynder* package: + +```python +from eppopynder import * +``` + +Then, initialize the client by specifying the API key you want to use: + +```python +client = Client() # Use the API key defined in .env file. +client = Client(api_key="") # Manually define the API key. +``` + +To explore the arguments and usage of a specific function, you can run: + +```python +help(function_name) +``` + +This will show the full documentation for the function, including its +arguments, return values, and usage examples. + +For example, if you are working with the `uniform_taxonoy()` function, +you can check its documentation with: + +```python +help(uniform_taxonomy) +``` + +Again, if you want to check the documentation of a function that represents a +category, you can run: + +```python +help(Client.taxon) +``` + +Note that the functions representing the categories are all defined inside the +`Client` class. + +## Querying a specific category + +The *eppoPynder* package allows you to query all categories available in +version 2.0 of the EPPO APIs: General, Taxons, Taxon, Country, Tools, Reporting +Services, and References. + +Each category has a corresponding function in the package with the same name +in *snake_case* format: general(), taxons(), taxon(), country(), tools(), +reporting_service(), and reportings(). By default, these functions return all +data available under the selected category, but you can customize the query by +specifying the desired services. + +For example, to query all services of the Taxon category for the EPPO code +"BEMITA", you can use the following code: + +```python +data = client.taxon(eppo_codes=["BEMITA"]) +``` + +Some services require certain mandatory parameters, which must be provided when +making the request. For example: + +```python +data = client.tools( + services=[ToolsService.NAME2CODES], + params={ + ToolsService.NAME2CODES: { + "name": "Bemisia tabaci" + } + } +) +``` + +Each category comes with a set of service names that can be queried. These are +stored in an enumeration whose name follows the convention Category + +"Service". For example, for the Taxon category, the collection of queryable +services is named `TaxonService`, and its values are `OVERVIEW`, `INFOS`, +`NAMES` and so on, exactly matching the names of the available services. +Keep in mind that services can be provided to the corresponding functions only +through their dedicated enum. + +You can import the enumeration associated with a specific category as shown +below: + +```python +from eppopynder import TaxonService, ToolsService # And so on... +``` + +Alternatively, you can import all of them at once by importing everything from +the library: + +```python +from eppopynder import * +``` + +## Querying a specific service + +To query a specific service within an endpoint, *eppoPynder* allows you to +specify it directly in the function call. For example, to access only the +`/taxons/taxon/categorization` service for the EPPO code "BEMITA", you can use +the `Client.taxon()` function as follows: + +```python +data = client.taxon( + eppo_codes=["BEMITA"], + services=[TaxonService.CATEGORIZATION] +) +``` + +### Expected output + +```python +print(data) +``` +```python +{: queried_eppo_code continent_id continent_name country_iso country_name ... year_add year_delete year_transient queried_url queried_on +0 BEMITA 4 America CL Chile ... 2019 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +1 BEMITA 2 Asia BH Bahrain ... 2003 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +2 BEMITA 2 Asia KZ Kazakhstan ... 2017 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +3 BEMITA 1 Europe AZ Azerbaijan ... 2024 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +4 BEMITA 1 Europe BY Belarus ... 1994 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +5 BEMITA 1 Europe GE Georgia ... 2018 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +6 BEMITA 1 Europe MD Moldova, Republic of ... 2017 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +7 BEMITA 1 Europe NO Norway ... 2012 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +8 BEMITA 1 Europe RU Russian Federation (the) ... 2014 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +9 BEMITA 1 Europe RS Serbia ... 2015 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +10 BEMITA 1 Europe CH Switzerland ... 2019 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +11 BEMITA 1 Europe TR Türkiye ... 2016 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +12 BEMITA 1 Europe UA Ukraine ... 2019 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +13 BEMITA 1 Europe GB United Kingdom ... 2020 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +14 BEMITA 5 Oceania NZ New Zealand ... 2000 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +15 BEMITA 6 RPPO/EU 9M EAEU ... 2016 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +16 BEMITA 6 RPPO/EU 9A EPPO ... 1989 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +17 BEMITA 6 RPPO/EU 9L EU ... 2019 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +18 BEMITA 6 RPPO/EU 9L EU ... 2019 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 +19 BEMITA 6 RPPO/EU 9H OIRSA ... 1992 None None https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 14:58:20.605414 + +[20 rows x 12 columns]} +``` + +All function calls return a dictionary of data frames, each containing the +information from the requested services. + +## Querying all available services + +To fetch data from all available services within a specific endpoint, simply +use the corresponding function without modifying the `services` parameter. Each +function will return a dictionary of data frames, with each data frame +containing information from one service. + +```python +data = client.taxon(eppo_codes=["BEMITA"]) +``` + +### Expected output + +```python +# Print the names of the services in the result. +print(data.keys()) +``` +```python +dict_keys([, , , , , , , , , , , , , , , , ]) +``` + +```python +# Print the data from a specific service. +print(data[TaxonService.OVERVIEW]) +``` +```python + queried_eppo_code eppocode datecreate lastupdate infos replacedby prefname is_active datatype queried_url queried_on +0 BEMITA BEMITA 2002-10-28 00:00:00 2002-10-28 00:00:00 None None Bemisia tabaci True GAI https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 15:08:26.388685 +``` + +Using `data.keys()` will display the names of the queried services. You can +then access a specific service to view the data associated with it. + +## Data wrangling + +The *eppoPynder* package provides a convenient function, `uniform_taxonomy()`, +to create a complete and standardized taxonomy data frame. This function takes +the taxonomy data returned by the taxonomy service and ensures a uniform +structure, including all expected taxonomic ranks, even if some ranks are +missing in the original result. + +For example, assume you have retrieved taxonomy data for the EPPO code "BEMITA" +using the `Client.taxon()` function: + +```python +data = client.taxon(eppo_codes=["BEMITA"], services=[TaxonService.TAXONOMY]) +``` + +You can then generate a uniform taxonomy table with all ranks using: + +```python +taxonomy = uniform_taxonomy(data[TaxonService.TAXONOMY]) +``` + +### Expected output + +```python +print(taxonomy) +``` +```python + type queried_eppo_code eppocode prefname queried_url queried_on +0 Kingdom BEMITA 1ANIMK Animalia https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 15:26:07.594529 +1 Phylum BEMITA 1ARTHP Arthropoda https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 15:26:07.594529 +2 Subphylum BEMITA 1HEXAQ Hexapoda https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 15:26:07.594529 +3 Class BEMITA 1INSEC Insecta https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 15:26:07.594529 +4 Subclass NaN NaN NaN NaN NaT +5 Order BEMITA 1HEMIO Hemiptera https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 15:26:07.594529 +6 Suborder BEMITA 1STERR Sternorrhyncha https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 15:26:07.594529 +7 Family BEMITA 1ALEYF Aleyrodidae https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 15:26:07.594529 +8 Subfamily NaN NaN NaN NaN NaT +9 Genus BEMITA 1BEMIG Bemisia https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 15:26:07.594529 +10 Species BEMITA BEMITA Bemisia tabaci https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 15:26:07.594529 +``` + +## Data retrieval for multiple EPPO or ISO codes + +The `Client.taxon()` and `Client.country()` functions allow you to retrieve +also a complete data dump for multiple EPPO or ISO codes by querying all +available EPPO services for each of them. + +Here is an example showing how to use the function to fetch all available +information for the EPPO codes "BEMITA" and "GOSHI": + +```python +data = client.taxon(eppo_codes=["BEMITA", "GOSHI"]) +``` + +### Expected output + +```python +# Print the names of the services in the result. +print(data.keys()) +``` +```python +dict_keys([, , , , , , , , , , , , , , , , ]) +``` + +```python +# Print the data from a specific service. +print(data[TaxonService.OVERVIEW]) +``` +```python + queried_eppo_code eppocode datecreate lastupdate ... is_active datatype queried_url queried_on +0 BEMITA BEMITA 2002-10-28 00:00:00 2002-10-28 00:00:00 ... True GAI https://api.eppo.int/gd/v2/taxons/taxon/BEMITA... 2025-12-10 15:31:54.300453 +1 GOSHI GOSHI 2004-04-21 00:00:00 2004-04-21 00:00:00 ... True PFL https://api.eppo.int/gd/v2/taxons/taxon/GOSHI/... 2025-12-10 15:31:54.864112 +``` + +Using `data.keys()` will display the names of the queried services. You can +then access a specific service to view the data associated with it. diff --git a/media/logo.png b/media/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..4d48006914546fb3119551ccc274f4e90342ae0b GIT binary patch literal 278029 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�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�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㨞gLRLSk(Mwq9^r z92qT<^PW{g$?V{Zx*=f|Arv9Pp-wnBBW5umGg$pk9&2e0)(B#myfvk} zb}AS?vFd6mWg%C`KHog7&1+j-s%76+Q^(dJ3{YdDet$dv^x>!n(D|TCOm&Kh5~k_V z2BN6I6)@|Sjm*tOIwXpOI#3$dOu7kPdy!JI6*OostmH!;GUz45s0nEXx<(2h+S*np zAbf0Wm1D?zgYWsZsh!yd_zxr&^o0j3xeg=}<+UAGXKaGkJ=(csyFch`jAtxUU!MPC zU-JUqe-!-A{)I2S9U*k*cHesVWxg`-3oUtYHYL`OX8E4EFkH`bFDuypT|oBV%>$qH z4&0h%<-lbQ7^AU96Z$cez|53q*ID9D4uJdZ2&go7*=bn_P(a05yluP=|0mY3PIm?+ ztJ=fqksMDBK%2RpITCQg^F?*Vu$ZVWUC(zW{zKaaej;F>|gcV}+5{9ba(nRh5 zBf?9xJL}GA^+#5OLCsb5DDQekYBZ&|WHnk+vtU*!$18))q{&8`8=AF%6@JS22Zaxn z0Yer#6HSxm`m$=-~;EjImqQ;lQQzF)M-JjAz3ucvDxrnM` z$6BpkPuu%FxELu?*@ztA+AQ=q*JB;NsQtuiDjky5H@vg96XAvSLsOUy;N7phY2RY8 z{hRPvfbT5sP|pi!>vZQ_n4#Z8Mr)t58;($5Cn@oR2JB@lD2=R_GqBP0I85p9#Ky-SBE_ zHcZ^%nJ!(+z1wg~8jXDC_lL2chrR5PecHM}cuqNN(cSEA;IyWKUB6334Dkfv6suM- zlQsFsz@MS|c^NJj%H08HX%4w%EUqd$4Bd?~EOqRCH^E*BjcJ-V&k&E$HuRG=u^>p+ z_C!S)#&hf_^oBSC8@nIT{gz^x*4(Y}hfq;^6T$-Fd?tZM_8r4KU@_($MC*Q50~={H z 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%0DU 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 z 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 literal 0 HcmV?d00001 diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..25eaa24 --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,13 @@ +site_name: eppoPynder +site_description: Python interface to the EPPO Database and Public APIs +site_url: https://openefsa.github.io/eppoPynder +repo_url: https://github.com/openefsa/eppoPynder +docs_dir: docs +site_dir: site + +theme: + name: mkdocs + +nav: + - Home: 'index.md' + - 'Get started': 'guide.md' diff --git a/pyproject.toml b/pyproject.toml index fa7093a..0f7bcf8 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,3 +1,45 @@ [build-system] -requires = ["setuptools>=42"] -build-backend = "setuptools.build_meta" \ No newline at end of file +requires = ["setuptools>=61", "wheel"] +build-backend = "setuptools.build_meta" + +[project] +name = "eppopynder" +version = "2.0.0" +description = "Python interface to the EPPO Database and Public APIs" +readme = "README.md" +authors = [ + { name = "Lorenzo Copelli" }, + { name = "Dayana Stephanie Buzle" }, + { name = "Rafael Vieira" }, + { name = "Agata Kaczmarek" }, + { name = "Luca Belmonte" } +] +maintainers = [ + { name = "Luca Belmonte", email = "luca.belmonte@efsa.europa.eu" } +] +license = "EUPL-1.2" +license-files = ["LICENSE"] +requires-python = ">=3.11" +dependencies = [ + "numpy>=2.0", + "pandas>=2.2", + "requests>=2.32", + "python-dotenv>=1.0" +] + +[project.optional-dependencies] +dev = [ + "coverage>=7.6", + "pytest>=8.0", +] + +[project.urls] +"Homepage" = "https://github.com/openefsa/eppoPynder" +"Repository" = "https://github.com/openefsa/eppoPynder" +"Bug Tracker" = "https://github.com/openefsa/eppoPynder/issues" + +[tool.setuptools] +package-dir = {"" = "src"} + +[tool.setuptools.packages.find] +where = ["src"] diff --git a/requirements.txt b/requirements.txt index 2955c1ed79038af327b83e1022a55c15f1ffeb63..a8a67499b130232ad4ade80c8a31418a03dea884 100644 GIT binary patch literal 1504 zcmZ8h(Nf|-5S-_$x=(>JfF3^h5B>oaAOaGS7=oxDuh%`jlSGP2sLjswbob2e&-dCc zcCga6_Jm(%Q(NG=_xIO{}sSs}sJJ z$oz5~=Fb!UB4yR6TcA#D?+KsCeCB;b=~%g=5#uglJoFLoj-T5O|BU#T5U7Rhwm{fG zCzX`o7$`HapQcKOkpt8x2l%yuir`MwL_FZ@!FgBi&CVl)7P+tPNbXTnyi2Ul?vNOS z7pim{U86z=Js)_p`h#<#GpzqR`UTo5ROq0y?iI3+tReg(us+cfG7q-YNv{;aZnbuF zx2}kqAeOyskVgiZiy?Z8sx7L8o9vsW;p81F5`t!E%q;UBF8j)r?ZGr~$XPfQDxCWI zbe9~o*MRK?Y}xf&P13`N3To&&vE@ZL*ns&3xx1u}?By~2ea6=vY8OE0Qad$WsR$+grjfgSXL?z2W zZV<<6;Rh=WxwYq3>Es1h&6l`-InUwD4@|G_`5e{AwS%(8l|>JA66j=$?>U&#%ayO# z6V3!5#xK%jMf4l=$R+hnSbX36>@#y5GeLb#*BUz|Rz#&9x-0E1PU!{{@MuePIeZ%L z^EB^Mrlu@%b*EjRFzSfc(!Cxq&hX@;ubqufR%h}{w-cv~YQ(I=?WjKLmbrCXXN8qwRNfP9p z{lY3_%YKkdp4cUS_i`t-9Hj!;gHN)NP9lGw+_mtorlRZ;j&dhfq^`)yu!`7@h~20g z6NX1=D+XGDj4#jCwD8J$`9E$R)+)m8bC?au0%cu&t)x!%i#tJR}r- zn!KJ(EhB$4owf3HL`}0QEb$qYFLc~@NnNgT`veD66S_Jd$L%e>cG!J-vV5D1zAU$i ncqK7!?Mh;M*4q>V^KMx|Ug`Dpnsw)HUmsCAFoDbL<`et}_}5|Y diff --git a/setup.py b/setup.py deleted file mode 100644 index 1478d2a..0000000 --- a/setup.py +++ /dev/null @@ -1,49 +0,0 @@ -from setuptools import setup, find_packages - -setup( - name='eppoPynder', - version='1.0.0', - description='A Wrapper for EPPO Codes', - long_description='A wrapper around the European and Mediterranean Plant Protection Organization (EPPO) database public APIs at https://data.eppo.int/. It enables users to retrieve EPPO-related data through searches across the entire EPPO database or by utilizing specific services, including categorization, taxonomy, and more. The package also includes a data wrangling function to integrate taxonomy and rank information, and a function that returns the list of member countries for each Regional Plant Protection Organization acronym which is used in the EPPO database.', - long_description_content_type='text/markdown', - author='Luca Belmonte, Dayana Stephanie Buzle, Rafael Vieira, Agata Kaczmarek', - author_email='luca.belmonte@efsa.europa.eu', - maintainer='Luca Belmonte', - maintainer_email='luca.belmonte@efsa.europa.eu', - url='https://github.com/openefsa/eppoPynder', - project_urls={ - 'Luca Belmonte ORCID': 'https://orcid.org/0000-0002-7977-9170', - 'Dayana Stephanie Buzle ORCID': 'https://orcid.org/0009-0003-2990-7431', - 'Rafael Vieira ORCID': 'https://orcid.org/0009-0009-0289-5438', - 'Agata Kaczmarek ORCID': 'https://orcid.org/0000-0002-7463-5821', - }, - license='GPL-3.0', - packages=find_packages(where='src'), - package_dir={'': 'src'}, - install_requires=[ - 'numpy>=2.1.3', - 'pandas>=2.2.3', - 'python-dateutil>=2.9.0.post0', - 'requests>=2.32.3', - 'certifi>=2024.8.30', - 'charset-normalizer>=3.4.0', - 'idna>=3.10', - 'urllib3>=2.2.3', - 'pytz>=2024.2', - 'tzdata>=2024.2', - 'python-dotenv>=1.0.0' - ], - extras_require={ - 'dev': [ - 'setuptools>=75.3.0', - 'coverage>=7.6.4', - 'colorama>=0.4.6', - 'pytest>=8.3.3', - 'iniconfig>=2.0.0', - 'pluggy>=1.5.0', - 'packaging>=24.1', - 'six>=1.16.0' - ], - }, - python_requires='>=3.11' - ) diff --git a/src/eppoPynder/__init__.py b/src/eppoPynder/__init__.py index e69de29..9191fd5 100644 --- a/src/eppoPynder/__init__.py +++ b/src/eppoPynder/__init__.py @@ -0,0 +1,23 @@ +from .client import Client +from .data_wrangling import uniform_taxonomy +from ._core._general import GeneralService +from ._core._taxons import TaxonsService +from ._core._taxon import TaxonService +from ._core._country import CountryService +from ._core._rppo import RPPOService +from ._core._tools import ToolsService +from ._core._reporting_service import ReportingServiceService +from ._core._references import ReferencesService + +__all__ = [ + "Client", + "GeneralService", + "TaxonsService", + "TaxonService", + "CountryService", + "RPPOService", + "ToolsService", + "ReportingServiceService", + "ReferencesService", + "uniform_taxonomy" +] diff --git a/src/eppoPynder/_core/__init__.py b/src/eppoPynder/_core/__init__.py new file mode 100644 index 0000000..a9a2c5b --- /dev/null +++ b/src/eppoPynder/_core/__init__.py @@ -0,0 +1 @@ +__all__ = [] diff --git a/src/eppoPynder/_core/_country.py b/src/eppoPynder/_core/_country.py new file mode 100644 index 0000000..5f96b38 --- /dev/null +++ b/src/eppoPynder/_core/_country.py @@ -0,0 +1,69 @@ +"""This module contains core functions for working with the Country endpoint of +the EPPO API. +""" + +from enum import StrEnum + +from eppopynder._utils import _checks, _requests, _data + + +class CountryService(StrEnum): + """The list of services supported by the Country endpoint.""" + OVERVIEW = "overview" + CATEGORIZATION = "categorization" + PRESENCE = "presence" + + +def _country(api_key, iso_codes, services=None): + """Query the EPPO API Country endpoint. + + This internal function queries the Country endpoints of the EPPO Global + Database via REST API for one or more ISO code(s) and one or more + service(s). For each ISO code in `iso_codes`, the function sequentially + queries all specified `services` and returns the extracted data through a + list of dataframes. + + Args: + api_key (str): The API key used for authentication. + iso_codes (list[str]): One or more ISO codes to query. + services (list[CountryService], optional): One or more Country services + to query. A validation step ensures that all provided services are + of type `CountryService` and match the supported service names. If + not provided, all services are considered. + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a data + frame with the queried content for all the specified ISO codes. + """ + + _checks._require_type(value=api_key, expected_type=str) + _checks._require_type(value=iso_codes, expected_type=list) + _checks._require_list_of(items=iso_codes, expected_type=str) + if services is None: + services = list(CountryService) + _checks._require_type(value=services, expected_type=list) + _checks._check_services( + services=services, + choices=list(CountryService) + ) + + country_data_ = { + service_: { + iso_code_: _requests._fetch_service( + base_path='/country', + api_key=api_key, + code=iso_code_, + service=service_ + ) + for iso_code_ in iso_codes + } + for service_ in services + } + + country_data_ = _data._merge_batch( + datasets=country_data_, + parent_column_name="queried_iso_code" + ) + + return country_data_ diff --git a/src/eppoPynder/_core/_general.py b/src/eppoPynder/_core/_general.py new file mode 100644 index 0000000..75f522b --- /dev/null +++ b/src/eppoPynder/_core/_general.py @@ -0,0 +1,53 @@ +"""This module contains core functions for working with the General endpoint of +the EPPO API. +""" + +from enum import StrEnum + +from eppopynder._utils import _checks, _requests + + +class GeneralService(StrEnum): + """The list of services supported by the General endpoint.""" + STATUS = "status" + + +def _general(api_key, services=None): + """Query the EPPO API General endpoint. + + This internal function queries the General endpoints of the EPPO Global + Database via REST API. The function sequentially queries all specified + `services` and returns the extracted data. + + Args: + api_key (str): The API key used for authentication. + services (list[GeneralService], optional): One or more General services + to query. A validation step ensures that all provided services are + of type `GeneralService` and match the supported service names. If + not provided, all services are considered. + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a data + frame with the queried content. + """ + + _checks._require_type(value=api_key, expected_type=str) + if services is None: + services = list(GeneralService) + _checks._require_type(value=services, expected_type=list) + _checks._check_services( + services=services, + choices=list(GeneralService) + ) + + general_data_ = { + service_: _requests._fetch_service( + base_path='/', + api_key=api_key, + service=service_ + ) + for service_ in services + } + + return general_data_ diff --git a/src/eppoPynder/_core/_references.py b/src/eppoPynder/_core/_references.py new file mode 100644 index 0000000..d364807 --- /dev/null +++ b/src/eppoPynder/_core/_references.py @@ -0,0 +1,63 @@ +"""This module contains core functions for working with the References endpoint +of the EPPO API. +""" + +from enum import StrEnum + +from eppopynder._utils import _checks, _requests, _data + + +class ReferencesService(StrEnum): + """The list of services supported by the References endpoint.""" + RPPOS = "rppos" + Q_LIST = "qList" + DISTRIBUTION_STATUS = "distributionStatus" + PEST_HOST_CLASSIFICATION = "pestHostClassification" + VECTOR_CLASSIFICATION = "vectorClassification" + COUNTRIES = "countries" + COUNTRIES_STATES = "countriesStates" + + +def _references(api_key, services=None): + """Query the EPPO API References endpoint. + + This internal function queries the References endpoints of the EPPO Global + Database via REST API. The function sequentially queries all specified + `services` and returns the extracted data through a dictionary of data + frames. + + Args: + api_key (str): The API key used for authentication. + services (list[ReferencesService], optional): One or more References + services to query. A validation step ensures that all provided + services are of type `ReferencesService` and match the supported + service names. If not provided, all services are considered. + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a data + frame with the queried content. + """ + + _checks._require_type(value=api_key, expected_type=str) + if services is None: + services = list(ReferencesService) + _checks._require_type(value=services, expected_type=list) + _checks._check_services( + services=services, + choices=list(ReferencesService) + ) + + references_data_ = { + service_: _requests._fetch_service( + base_path='/references', + api_key=api_key, + service=service_ + ) + for service_ in services + } + + references_data_ = _data._transform_references( + references_data=references_data_) + + return references_data_ diff --git a/src/eppoPynder/_core/_reporting_service.py b/src/eppoPynder/_core/_reporting_service.py new file mode 100644 index 0000000..216a742 --- /dev/null +++ b/src/eppoPynder/_core/_reporting_service.py @@ -0,0 +1,65 @@ +"""This module contains core functions for working with the Reporting Service +endpoint of the EPPO API. +""" + +from enum import StrEnum + +from eppopynder._utils import _checks, _requests + + +class ReportingServiceService(StrEnum): + """The list of services supported by the Reporting Service endpoint.""" + LIST = "list" + REPORTING = "reporting" + ARTICLE = "article" + + +def _reporting_service(api_key, services=None, params=None): + """Query the EPPO API Reporting Service endpoint. + + This internal function queries the Reporting Service endpoints of the EPPO + Global Database via REST API. The function sequentially queries all + specified `services` and returns the extracted data through a dictionary of + data frames. + + Args: + api_key (str): The API key used for authentication. + services (list[ReportingServiceService], optional): One or more + Reporting Service services to query. A validation step ensures that + all provided services are of type `ReportingServiceService` and + match the supported service names. If not provided, all services + are considered. + params (dict, optional): A named dictionary of query parameters to + include in the request. The list of available parameters can be + accessed via the EPPO API Documentation platform + (https://data2025.eppo.int/ui/#/docs/GDAPI). + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a data + frame with the queried content. + """ + + _checks._require_type(value=api_key, expected_type=str) + if services is None: + services = list(ReportingServiceService) + _checks._require_type(value=services, expected_type=list) + _checks._check_services(services=services, + choices=list(ReportingServiceService)) + if params is not None: + _checks._require_type(value=params, expected_type=dict) + + reporting_service_data_ = { + service_: _requests._fetch_service( + base_path="/reportings", + api_key=api_key, + service=_requests._build_reporting_service_path( + service=service_, + params=params.get(service_, None) + if params is not None else None + ) + ) + for service_ in services + } + + return reporting_service_data_ diff --git a/src/eppoPynder/_core/_rppo.py b/src/eppoPynder/_core/_rppo.py new file mode 100644 index 0000000..493abef --- /dev/null +++ b/src/eppoPynder/_core/_rppo.py @@ -0,0 +1,68 @@ +"""This module contains core functions for working with the RPPO endpoint of +the EPPO API. +""" + +from enum import StrEnum + +from eppopynder._utils import _checks, _requests, _data + + +class RPPOService(StrEnum): + """The list of services supported by the RPPO endpoint.""" + OVERVIEW = "overview" + CATEGORIZATION = "categorization" + + +def _rppo(api_key, rppo_codes, services=None): + """Query the EPPO API RPPO endpoint. + + This internal function queries the RPPO endpoints of the EPPO Global + Database via REST API for one or more RPPO code(s) and one or more + service(s). For each RPPO code in `rppo_codes`, the function sequentially + queries all specified `services` and returns the extracted data through a + list of dataframes. + + Args: + api_key (str): The API key used for authentication. + rppo_codes (list[str]): One or more RPPO codes to query. + services (list[CountryService], optional): One or more RPPO services + to query. A validation step ensures that all provided services are + of type `RPPOService` and match the supported service names. If + not provided, all services are considered. + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a data + frame with the queried content for all the specified RPPO codes. + """ + + _checks._require_type(value=api_key, expected_type=str) + _checks._require_type(value=rppo_codes, expected_type=list) + _checks._require_list_of(items=rppo_codes, expected_type=str) + if services is None: + services = list(RPPOService) + _checks._require_type(value=services, expected_type=list) + _checks._check_services( + services=services, + choices=list(RPPOService) + ) + + rppo_data_ = { + service_: { + rppo_code_: _requests._fetch_service( + base_path='/rppo', + api_key=api_key, + code=rppo_code_, + service=service_ + ) + for rppo_code_ in rppo_codes + } + for service_ in services + } + + rppo_data_ = _data._merge_batch( + datasets=rppo_data_, + parent_column_name="queried_rppo_code" + ) + + return rppo_data_ diff --git a/src/eppoPynder/_core/_taxon.py b/src/eppoPynder/_core/_taxon.py new file mode 100644 index 0000000..61b82e4 --- /dev/null +++ b/src/eppoPynder/_core/_taxon.py @@ -0,0 +1,82 @@ +"""This module contains core functions for working with the Taxon endpoint of +the EPPO API. +""" + +from enum import StrEnum + +from eppopynder._utils import _checks, _requests, _data + + +class TaxonService(StrEnum): + """The list of services supported by the Taxon endpoint.""" + OVERVIEW = "overview" + INFOS = "infos" + NAMES = "names" + TAXONOMY = "taxonomy" + CATEGORIZATION = "categorization" + KINGDOM = "kingdom" + HOSTS = "hosts" + PESTS = "pests" + VECTORS = "vectors" + VECTOR_OF = "vectorof" + BCA = "bca" + BCA_OF = "bcaof" + PHOTOS = "photos" + REPORTING_ARTICLES = "reporting_articles" + DOCUMENTS = "documents" + STANDARDS = "standards" + DISTRIBUTION = "distribution" + + +def _taxon(api_key, eppo_codes, services=None): + """Query the EPPO API Taxon endpoint. + + This internal function queries the Taxon endpoints of the EPPO Global + Database via REST API for one or more EPPO code(s) and one or more + service(s). For each EPPO code in `eppo_codes`, the function sequentially + queries all specified `services` and returns the extracted data. + + Args: + api_key (str): The API key used for authentication. + eppo_codes (list[str]): One or more EPPO codes to query. + services (list[TaxonService], optional): One or more Taxon services + to query. A validation step ensures that all provided services are + of type `TaxonService` and match the supported service names. If + not provided, all services are considered. + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a data + frame with the queried content for all the specified EPPO codes. + """ + + _checks._require_type(value=api_key, expected_type=str) + _checks._require_type(value=eppo_codes, expected_type=list) + _checks._require_list_of(items=eppo_codes, expected_type=str) + if services is None: + services = list(TaxonService) + _checks._require_type(value=services, expected_type=list) + _checks._check_services( + services=services, + choices=list(TaxonService) + ) + + taxon_data_ = { + service_: { + eppo_code_: _requests._fetch_service( + base_path='/taxons/taxon', + api_key=api_key, + code=eppo_code_, + service=service_ + ) + for eppo_code_ in eppo_codes + } + for service_ in services + } + + taxon_data_ = _data._merge_batch( + datasets=taxon_data_, + parent_column_name="queried_eppo_code" + ) + + return taxon_data_ diff --git a/src/eppoPynder/_core/_taxons.py b/src/eppoPynder/_core/_taxons.py new file mode 100644 index 0000000..6c8727b --- /dev/null +++ b/src/eppoPynder/_core/_taxons.py @@ -0,0 +1,60 @@ +"""This module contains core functions for working with the Taxons endpoint of +the EPPO API. +""" + +from enum import StrEnum + +from eppopynder._utils import _checks, _requests, _data + + +class TaxonsService(StrEnum): + """The list of services supported by the Taxons endpoint.""" + LIST = "list" + + +def _taxons(api_key, services=None, params=None): + """Query the EPPO API Taxons endpoint. + + This internal function queries the Taxons endpoints of the EPPO Global + Database via REST API. The function sequentially queries all specified + `services` and returns the extracted data. + + Args: + api_key (str): The API key used for authentication. + services (list[TaxonsService], optional): One or more Taxons services + to query. A validation step ensures that all provided services are + of type `TaxonsService` and match the supported service names. If + not provided, all services are considered. + params (dict, optional): A named dictionary of query parameters to + include in the request. The list of available parameters can be + accessed via the EPPO API Documentation platform + (https://data2025.eppo.int/ui/#/docs/GDAPI). + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a data + frame with the queried content. + """ + + _checks._require_type(value=api_key, expected_type=str) + if services is None: + services = list(TaxonsService) + _checks._require_type(value=services, expected_type=list) + _checks._check_services(services=services, choices=list(TaxonsService)) + if params is not None: + _checks._require_type(value=params, expected_type=dict) + + taxons_data_ = { + service_: _requests._fetch_service( + base_path="/taxons", + api_key=api_key, + service=service_, + params=params.get(service_, None) + if params is not None else None + ) + for service_ in services + } + + taxons_data_ = _data._transform_taxons(taxons_data=taxons_data_) + + return taxons_data_ diff --git a/src/eppoPynder/_core/_tools.py b/src/eppoPynder/_core/_tools.py new file mode 100644 index 0000000..73eabe7 --- /dev/null +++ b/src/eppoPynder/_core/_tools.py @@ -0,0 +1,59 @@ +"""This module contains core functions for working with the Tools endpoint of +the EPPO API. +""" + +from enum import StrEnum + +from eppopynder._utils import _checks, _requests + + +class ToolsService(StrEnum): + """The list of services supported by the Tools endpoint.""" + NAME2CODES = "name2codes" + + +def _tools(api_key, services=None, params=None): + """Query the EPPO API Tools endpoint. + + This internal function queries the Tools endpoints of the EPPO Global + Database via REST API. The function sequentially queries all specified + `services` and returns the extracted data through a dictionary of data + frames. + + Args: + api_key (str): The API key used for authentication. + services (list[ToolsService], optional): One or more Tools services to + query. A validation step ensures that all provided services are of + type `ToolsService` and match the supported service names. If not + provided, all services are considered. + params (dict, optional): A named dictionary of query parameters to + include in the request. The list of available parameters can be + accessed via the EPPO API Documentation platform + (https://data2025.eppo.int/ui/#/docs/GDAPI). + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a data + frame with the queried content. + """ + + _checks._require_type(value=api_key, expected_type=str) + if services is None: + services = list(ToolsService) + _checks._require_type(value=services, expected_type=list) + _checks._check_services(services=services, choices=list(ToolsService)) + if params is not None: + _checks._require_type(value=params, expected_type=dict) + + tools_data_ = { + service_: _requests._fetch_service( + base_path="/tools", + api_key=api_key, + service=service_, + params=params.get(service_, None) + if params is not None else None + ) + for service_ in services + } + + return tools_data_ diff --git a/src/eppoPynder/_utils/__init__.py b/src/eppoPynder/_utils/__init__.py new file mode 100644 index 0000000..a9a2c5b --- /dev/null +++ b/src/eppoPynder/_utils/__init__.py @@ -0,0 +1 @@ +__all__ = [] diff --git a/src/eppoPynder/_utils/_checks.py b/src/eppoPynder/_utils/_checks.py new file mode 100644 index 0000000..4c007c4 --- /dev/null +++ b/src/eppoPynder/_utils/_checks.py @@ -0,0 +1,147 @@ +"""This module contains internal functions for performing type and data checks. +""" + +import pandas as pd + + +def _require_type(value, expected_type): + """Check that a value is of the expected type. + + Args: + value: The value to check. + expected_type: The expected type. + + Raises: + TypeError: If the value is not of the expected type. + + Returns: + None: The function returns nothing if the check passes. + """ + + if not isinstance(value, expected_type): + raise TypeError(f"Expected type {expected_type}, got {type(value)}") + + +def _require_trailing_slash(string): + """Check that a string starts with a trailing slash. + + Args: + string (str): The string value to check. + + Raises: + ValueError: If the string is not starting with a trailing slash. + + Returns: + None: The function returns nothing if the check passes. + """ + + _require_type(value=string, expected_type=str) + + if not string.startswith('/'): + raise ValueError(f"Expected trailing slash, got {string}") + + +def _require_list_of(items, expected_type): + """Check that a list contains only elements of the expected type. + + Args: + items (list): The list to check. + expected_type (type): The expected type of the elements. + + Raises: + TypeError: If at least one element of the list is not of the expected + type. + + Returns: + None: The function returns nothing if the check passes. + """ + + _require_type(value=items, expected_type=list) + _require_type(value=expected_type, expected_type=type) + + for item_ in items: + if not isinstance(item_, expected_type): + raise TypeError(f"Expected list of {expected_type}") + + +def _check_services(services, choices): + """Validate service names against a set of allowed choices. + + This function checks whether all elements in `services` are included in the + allowed `choices`. If any unsupported services are found, the function + raises an informative exception. + + Args: + services (list): A list of service names to validate. + choices (list): A list containing the allowed service names. + + Raises: + ValueError: If any unsupported services are found. + + Returns: + None: The function returns nothing if the check passes. + """ + + _require_type(value=services, expected_type=list) + _require_list_of(items=services, expected_type=type(choices[0])) + _require_type(value=choices, expected_type=list) + + invalid_services_ = set(services) - set(choices) + + if len(invalid_services_) > 0: + raise ValueError("Unsupported services requested: " + + f"{", ".join(invalid_services_)}") + + +def _require_column_names(dataframe, column_names): + """Check if a dataframe contains the specified column names. + + This function checks whether a dataframe contains the specified column + names. If the condition is not verified, the function raises an informative + exception. + + Args: + dataframe (pd.DataFrame): The dataframe to validate. + column_names (list): The list of required column names. + + Raises: + ValueError: If the required column names are not present in the + dataframe. + + Returns: + None: The function returns nothing if the check passes. + """ + + _require_type(value=dataframe, expected_type=pd.DataFrame) + _require_type(value=column_names, expected_type=list) + + if not all(column_ in dataframe.columns for column_ in column_names): + raise ValueError("Missing required columns in dataframe: " + + f"{", ".join(column_names)}") + + +def _require_not_all_nan(dataframe, column_name): + """Check if a dataframe contains the specified column names. + + This function checks whether a dataframe contains the specified column + names. If the condition is not verified, the function raises an informative + exception. + + Args: + dataframe (pd.DataFrame): The dataframe to check. + column_name (str): The name of the column to check. + + Raises: + ValueError: If the specified column contains only NaN values. + + Returns: + None: The function returns nothing if the check passes. + """ + + _require_type(value=dataframe, expected_type=pd.DataFrame) + _require_type(value=column_name, expected_type=str) + + if (not column_name in dataframe.columns + or not dataframe[column_name].notna().any()): + raise ValueError(f"Column {column_name} must contain at least a " + + "non-NaN value.") diff --git a/src/eppoPynder/_utils/_data.py b/src/eppoPynder/_utils/_data.py new file mode 100644 index 0000000..a9ab186 --- /dev/null +++ b/src/eppoPynder/_utils/_data.py @@ -0,0 +1,275 @@ +"""This module contains internal functions for processing API response data.""" + +import pandas as pd + +from eppopynder._utils import _checks +from eppopynder._core import _taxons, _references + + +def _flatten(nested_data, separator='_'): + """Flattens nested JSON structures into a pandas DataFrame. + + This helper function automatically expands lists into multiple rows and + flattens nested dictionaries. + + Args: + nested_data: The dictionary or list of dictionaries to flatten. + separator (str): The separator to use for nested columns names. + Defaults to '_'. + + Raises: + TypeError: If data is not a dictionary or a list of dictionaries. Data + can be empty. + + Returns: + pandas.DataFrame: A flattened DataFrame, where: + - Lists are expanded into multiple rows. + - Nested dictionaries become columns with separator-notation. + - Parent-level fields are repeated for each child row. + """ + + def _flatten_dictionary(dictionary, sep, parent_key=''): + """Flatten a nested dictionary without expanding lists. + + This helper function recursively traverses a dictionary and creates + flat key-value pairs for nested keys, using the specified separator. + Lists are kept as-is and not expanded by this function. + + Args: + dictionary (dict): The dictionary to flatten. + sep (str): The separator to use between parent and child keys. + parent_key (str, optional): The parent key for the flattened + dictionary. It is the prefix to prepend to keys (used in + recursion). Defaults to ''. + + Returns: + dict: A flattened dictionary with sep-notated keys for nested + structures. + """ + + dictionary_items_ = [] + + for key_, value_ in dictionary.items(): + new_key_ = f"{parent_key}{sep}{key_}" if parent_key else key_ + if isinstance(value_, dict): + dictionary_items_.extend( + _flatten_dictionary(dictionary=value_, sep=sep, + parent_key=new_key_).items()) + else: + dictionary_items_.append((new_key_, value_)) + + return dict(dictionary_items_) + + def _is_dictionary_of_lists(dictionary): + """Check if a dictionary contains only lists as values. + + This helper function identifies the special case where the top-level + dictionary keys represent categories amd all values are lists. + + Args: + dictionary (dict): The dictionary to check. + + Returns: + bool: True if all values in the dictionary are lists, False + otherwise. + """ + + return all(isinstance(value_, list) for value_ in dictionary.values()) + + def _expand_dictionary_of_lists(dictionary, sep): + """Expand a dictionary where all values are lists. + + This helper function handles the special case where each top-level key + maps to a list of items. It creates a "key" column to preserve the + original dictionary key and expands each list item into a separate row. + + Args: + dictionary (dict): The dictionary where all values are lists. + sep (str): The separator for flattening nested dictionaries within + list items. + + Returns: + pandas.DataFrame: DataFrame with a "key" column containing the + original dictionary key and additional columns from the list + items. + """ + + expanded_rows_ = [] + + for key_, value_ in dictionary.items(): + for item_ in value_: + if isinstance(item_, dict): + row_ = {"parent_key": key_} + flat_item_ = _flatten_dictionary(dictionary=item_, sep=sep) + row_.update(flat_item_) + expanded_rows_.append(row_) + else: + expanded_rows_.append({"parent_key": key_, + "atomic_value": item_}) + + return pd.DataFrame(expanded_rows_) + + def _find_list_columns(dictionary): + """Finds dictionary keys that contain lists of dictionaries. + + This helper function identifies columns that need to be expanded into + multiple rows. It only considers lists that contain at least one + dictionary. + + Args: + dictionary (dict): The dictionary to check. + + Returns: + list: The list of keys whose values are lists of dictionaries. + """ + + list_keys_ = [] + + for key_, value_ in dictionary.items(): + if (isinstance(value_, list) and value_ + and any(isinstance(item_, dict) for item_ in value_)): + list_keys_.append(key_) + + return list_keys_ + + def _expand_lists(dictionary, sep): + """Recursively expand lists in a dictionary into DataFrame rows. + + This helper is the main recursive function that handles the expansion + logic. It detects different types of structures and applies the + appropriate expansion strategy. It processes one list level at a time + and recurses for additional nested lists. + + Args: + dictionary (dict): The dictionary to process. + sep (str): The separator for nested column names. + + Returns: + pandas.DataFrame: A DataFrame with all lists expanded into rows and + nested dictionaries flattened. + """ + + if _is_dictionary_of_lists(dictionary=dictionary): + return _expand_dictionary_of_lists(dictionary=dictionary, sep=sep) + + list_keys_ = _find_list_columns(dictionary=dictionary) + + if not list_keys_: + flat_ = _flatten_dictionary(dictionary=dictionary, sep=sep) + return pd.DataFrame([flat_]) + + list_key_ = list_keys_[0] + list_data_ = dictionary[list_key_] + + base_data_ = {key_: value_ for key_, value_ in dictionary.items() + if key_ != list_key_} + + expanded_rows_ = [] + + for item_ in list_data_: + row_data_ = base_data_.copy() + + if isinstance(item_, dict): + for key_, value_ in item_.items(): + row_data_[f"{list_key_}{sep}{key_}"] = value_ + else: + row_data_[list_key_] = item_ + + expanded_rows_.append(_expand_lists(dictionary=row_data_, sep=sep)) + + return pd.concat(expanded_rows_, ignore_index=True) + + if not nested_data: + return pd.DataFrame() + + elif (isinstance(nested_data, list) + and all(isinstance(item_, dict) for item_ in nested_data)): + dataframes_ = [_expand_lists(dictionary=item_, sep=separator) + for item_ in nested_data] + return pd.concat(dataframes_, ignore_index=True) + + elif isinstance(nested_data, dict): + return _expand_lists(dictionary=nested_data, sep=separator) + + raise TypeError("Data must empty, a dictionary or a list of dictionaries") + + +def _transform_taxons(taxons_data): + """Transform EPPO Taxons response data. + + This helper function restructures the raw output returned by the EPPO + Taxons endpoint for each queried service. Depending on the service name, + the function applies the appropriate post-processing steps. + + Args: + taxons_data (dict): The response from the EPPO Taxons endpoint. + + Returns: + dict: The transformed dictionary. + """ + + _checks._require_type(value=taxons_data, expected_type=dict) + + for service_, dataframe_ in taxons_data.items(): + if service_ == _taxons.TaxonsService.LIST: + dataframe_.drop(columns=[ + column_ for column_ in dataframe_.columns + if column_.startswith("pagination") + or column_.startswith("meta") + ], inplace=True, errors="ignore") + + return taxons_data + + +def _transform_references(references_data): + """Transform EPPO References response data. + + This helper function restructures the raw output returned by the EPPO + References endpoint for each queried service. Depending on the service + name, the function applies the appropriate post-processing steps. + + Args: + references_data (dict): The response from the EPPO References endpoint. + + Returns: + dict: The transformed dictionary. + """ + + _checks._require_type(value=references_data, expected_type=dict) + + for service_, dataframe_ in references_data.items(): + if service_ == _references.ReferencesService.COUNTRIES_STATES: + dataframe_.rename(columns={"parent_key": "country_iso"}, + inplace=True) + + return references_data + + +def _merge_batch(datasets, parent_column_name): + """Merge results containing more EPPO or ISO codes. + + This helper function merges results + + Args: + datasets (dict): The response from the EPPO Taxon or Country endpoints. + parent_column_name (str): The name of the new column that will contain + the EPPO or ISO code. + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a data + frame with the queried content for all the specified EPPO or ISO + codes, along with a new column named `parent_column_name`. + """ + + _checks._require_type(value=datasets, expected_type=dict) + _checks._require_type(value=parent_column_name, expected_type=str) + + for service_, value_dictionary_ in datasets.items(): + dataframes_ = [] + for code_, dataframe_ in value_dictionary_.items(): + dataframe_.insert(0, parent_column_name, code_) + dataframes_.append(dataframe_) + datasets[service_] = pd.concat(dataframes_, ignore_index=True) + + return datasets diff --git a/src/eppoPynder/_utils/_requests.py b/src/eppoPynder/_utils/_requests.py new file mode 100644 index 0000000..c691495 --- /dev/null +++ b/src/eppoPynder/_utils/_requests.py @@ -0,0 +1,309 @@ +"""This module contains internal functions for working with EPPO API requests. +""" + +import pandas as pd +import requests +from datetime import datetime +from json import JSONDecodeError + +from eppopynder._utils import _checks +from eppopynder._utils import _data + + +def _build_endpoint(base_path, code=None, service=None): + """Build an EPPO API endpoint path. + + This helper function constructs an endpoint path for retrieving data from + the EPPO API. The result must be appended to the EPPO API base URL. It + allows for the optional inclusion of a specific code and/or service name, + depending on the desired API resource. The function is based on the fact + that EPPO API endpoints follow the pattern: + {base path}/{resource identifier}/{service}. + + Args: + base_path (str): The base path, starting with '/' (e.g. + "/taxons/taxon"). + code (str, optional): The resource identifier (e.g. an EPPO code or + an ISO code). If provided, it will be appended to the base path. + service (str, optional): The desired API service. If provided, it will + be appended to the path after the resource identifier (if any, + otherwise after the base path). + + Returns: + str: A string representing the complete endpoint path to be used in an + API request. + """ + + _checks._require_type(value=base_path, expected_type=str) + _checks._require_trailing_slash(string=base_path) + if code is not None: + _checks._require_type(value=code, expected_type=str) + if service is not None: + _checks._require_type(value=service, expected_type=str) + + endpoint_parts_ = [base_path] + [part_ for part_ in (code, service) + if part_ is not None] + endpoint_path_ = '/'.join(endpoint_parts_) + endpoint_path_ = endpoint_path_.replace("//", '/') + + return endpoint_path_ + + +def _build_reporting_service_path(service, params = None): + """Build the EPPO reporting-related service path. + + This helper function constructs the endpoint path for EPPO API reporting + services based on the service type and parameters provided in the `params` + dictionary. It also handles missing or invalid parameters by raising + informative errors. + + Args: + service (str): The type of service. Supported values are `reporting` + and `article`. + params (dict, optional): A dictionary containing identifiers needed for + the endpoint path. Must include `reporting_id` if service is + "reporting" or `article_id` if service is "article". + + Raises: + ValueError: If a required parameter is missing or invalid for the + specified service. + + Returns: + str: The constructed service path to use with API calls. + """ + + _checks._require_type(value=service, expected_type=str) + if params is not None: + _checks._require_type(value=params, expected_type=dict) + + required_ids_ = { + "reporting": "reporting_id", + "article": "article_id", + } + + required_id_name_ = required_ids_.get(service) + + if required_id_name_ is not None: + if params is None or not params.get(required_id_name_): + raise ValueError("Missing required parameter " + + f"\"{required_id_name_}\"") + + service = f"{service}/{params[required_id_name_]}" + + return service + + +def _perform_request(url, api_key, params=None): + """Build and execute an HTTP GET request to the EPPO API. + + This helper function prepares and sends a GET request to the EPPO API, + setting the necessary headers, authentication key and query parameters. It + then performs the request and returns the corresponding response data. + + Args: + url (str): The full API endpoint URL to query. + api_key (str): The API key used for authentication. + params (dict, optional): Optional query parameters to include in the + request. + + Returns: + class (requests.Response): The HTTP response object returned by + the request. + """ + + _checks._require_type(value=url, expected_type=str) + _checks._require_type(value=api_key, expected_type=str) + if params is not None: + _checks._require_type(value=params, expected_type=dict) + + request_headers_ = { + "X-Api-Key": api_key, + "Accept": "application/json" + } + + response_ = requests.get(url, headers=request_headers_, params=params) + + return response_ + + +def _handle_http_errors(response): + """Handle non-successful HTTP responses from the EPPO API. + + This helper function checks whether an HTTP response from the EPPO API + indicates success (status code 200). If the response contains any other + status code, it attempts to parse the JSON body for an error message and + raises a formatted error. + + Args: + response (requests.Response): The HTTP response object. + + Raises: + requests.exceptions.HTTPError: If the request was not successful. + + Returns: + None: The function returns nothing if the request was successful. + """ + + _checks._require_type(value=response, expected_type=requests.Response) + + handled_error_status_codes_ = [400, 401, 403, 404, 429, 500] + + if response.status_code == 200: + return + + if response.status_code in handled_error_status_codes_: + try: + error_message_ = response.json().get("error", "Unknown error") + except JSONDecodeError as e_: + error_message_ = e_.msg + raise requests.HTTPError(f"API request failed: {error_message_}") + + raise requests.HTTPError("API request failed with status code " + + f"{response.status_code}") + + +def _parse_response(response): + """Parse a JSON API response. + + This helper function parses the JSON body of an API response. + + Args: + response (requests.Response): The HTTP response object. + + Raises: + JSONDecodeError: If the response body can not be parsed as valid JSON. + + Returns: + DataFrame: A Pandas DataFrame representing the parsed JSON response. + """ + + _checks._require_type(value=response, expected_type=requests.Response) + + try: + response_json_ = response.json() + response_data_ = _data._flatten(response_json_) + except (JSONDecodeError, KeyError) as e_: + raise JSONDecodeError(f"Failed to parse API response: {e_.msg}", + e_.doc, e_.pos) + + return response_data_ + + +def _enrich_response(response_data, url): + """Enrich API response data. + + This helper function takes a structure containing API response data and + enriches it with metadata, including the timestamp and the queried URL. + + Args: + response_data (DataFrame): A structure containing the API response + data. + url (str): The URL that was queried. + + Returns: + DataFrame: A Pandas DataFrame containing the original API response + data, along with two additional fields: `queried_on`, the timestamp + when the data was queried, and `queried_url`, the URL used for + the API request. + """ + + _checks._require_type(value=response_data, expected_type=pd.DataFrame) + _checks._require_type(value=url, expected_type=str) + + response_data["queried_on"] = datetime.now() + response_data["queried_url"] = url + + return response_data + + +def _query(endpoint, api_key, params=None): + """Query the EPPO REST API and return the result. + + This function performs a GET request to the EPPO REST API, automatically + builds the full request URL, adds the authentication header, handles HTTP + errors, parses the response and adds metadata about the query. + + Specific HTTP status codes (400, 401, 403, 404, 429 and 500) are handled + explicitly to extract the error message returned by the API; other status + codes trigger a connection error. + + Args: + endpoint (str): The relative path of the endpoint to query, starting + with a forward slash (`/`). + api_key (str): The API key used for authentication. + params (dict, optional): Optional query parameters to include in the + request. + + Returns: + DataFrame: A Pandas DataFrame containing the parsed JSON response from + the API, along with metadata fields. + """ + + _checks._require_type(value=endpoint, expected_type=str) + _checks._require_trailing_slash(string=endpoint) + _checks._require_type(value=api_key, expected_type=str) + if params is not None: + _checks._require_type(value=params, expected_type=dict) + + base_url_ = "https://api.eppo.int/gd/v2" + full_url_ = base_url_ + endpoint + + response_ = _perform_request( + url=full_url_, + api_key=api_key, + params=params + ) + + _handle_http_errors(response=response_) + + response_data_ = _parse_response(response=response_) + + enriched_data_ = _enrich_response(response_data=response_data_, + url=full_url_) + + return enriched_data_ + + +def _fetch_service(base_path, api_key, code=None, service=None, + params=None): + """Fetch data from a specific EPPO API service. + + This function retrieves data from a specific service of the EPPO API. It + builds the appropriate endpoint according to the EPPO API structure, then + queries the API. + + Args: + base_path (str): The base path, starting with '/' (e.g. + "/taxons/taxon"). + api_key (str): The API key used for authentication. + code (str, optional): The resource identifier (e.g. an EPPO code or an + ISO code). + service (str, optional): The desired API service. + params (dict, optional): Optional query parameters to include in the + request. + + Returns: + DataFrame: A Pandas DataFrame containing the data returned by the + specified EPPO API service, along with metadata fields. + """ + + _checks._require_type(value=base_path, expected_type=str) + _checks._require_trailing_slash(string=base_path) + _checks._require_type(value=api_key, expected_type=str) + if code is not None: + _checks._require_type(value=code, expected_type=str) + if service is not None: + _checks._require_type(value=service, expected_type=str) + if params is not None: + _checks._require_type(value=params, expected_type=dict) + + service_endpoint_ = _build_endpoint( + base_path=base_path, + code=code, + service=service + ) + + service_data_ = _query(endpoint=service_endpoint_, api_key=api_key, + params=params) + + return service_data_ diff --git a/src/eppoPynder/api_query.py b/src/eppoPynder/api_query.py deleted file mode 100644 index 8252228..0000000 --- a/src/eppoPynder/api_query.py +++ /dev/null @@ -1,78 +0,0 @@ -import numpy as np -import pandas as pd -import requests -from datetime import date - -from eppoPynder.unnest_lists import unnest_lists - -def api_query(queried_eppocode, queried_url): - """ - Query the EPPO database via REST API to retrieve basic information, - all names, taxonomy, categorization, hosts, pests, or kingdom data about an EPPO code. - - Parameters - ---------- - queried_eppocode : str - A single EPPO code. EPPO codes are unique computer codes developed for plants and pests - (including pathogens) important in agriculture and plant protection. These codes - facilitate the management of plant and pest names in databases and enable data exchange - between IT systems. Each EPPO code consists of 5 to 6 letters, often mnemonic - abbreviations of the scientific name of the organism, and can be freely downloaded - from the EPPO Data Services platform at https://data.eppo.int/. - - queried_url : str - The URL to query. The URL should be in the format: - https://data.eppo.int/api/rest/1.0/taxon/queriedEppocode?authtoken=xxxxxxxxxxxxxxxxxxx - Replace "queriedEppocode" with the EPPO code of interest and add your unique token using the "authtoken" parameter. - - Returns - ------- - df : pd.DataFrame - A dataframe containing the contents of the request converted from JSON. - Based on the query, the output dataframe will contain basic information, all names, - taxonomy, categorization, hosts, pests, or kingdom data about the input EPPO code. - The dataframe will also include the following columns: - - queried_eppocode: The EPPO code requested. - - queried_on: The date when the query was performed. - - queried_url: The URL that was queried. - - Examples - -------- - # Get basic information about Bemisia tabaci: - queried_eppocode = "BEMITA" - queried_url = "https://data.eppo.int/api/rest/1.0/taxon/BEMITA?authtoken=xxxxxxxxxxxxxxxxxxx" - api_query(queried_eppocode, queried_url) - - # Get taxonomy data about Bemisia tabaci: - queried_eppocode = "BEMITA" - queried_url = "https://data.eppo.int/api/rest/1.0/taxon/BEMITA/taxonomy?authtoken=xxxxxxxxxxxxxxxxxxx" - api_query(queried_eppocode, queried_url) - - # Get all names about Aphis pomi: - queried_eppocode = "APHIPO" - queried_url = "https://data.eppo.int/api/rest/1.0/taxon/APHIPO/names?authtoken=xxxxxxxxxxxxxxxxxxx" - api_query(queried_eppocode, queried_url) - """ - assert isinstance(queried_eppocode, str), "queried_eppocode must be a string!" - assert isinstance(queried_url, str), "queried_url must be a string!" - - df = pd.DataFrame() - - try: - requested_service = requests.get(queried_url) - requested_service.raise_for_status() - json_response = requested_service.json() - data = unnest_lists(json_response) - df = pd.json_normalize(data) - - except (requests.exceptions.MissingSchema, requests.exceptions.InvalidURL) as e: - print(f"{e}") - except requests.exceptions.HTTPError as e: - print(f"HTTP error: {e}") - - finally: - df['queried_eppocode'] = pd.Series([queried_eppocode for i in range(len(df)+1)]) - df['queried_on'] = pd.Series([str(date.today()) for i in range(len(df)+1)]) - df['queried_url'] = pd.Series([queried_url for i in range(len(df)+1)]) - - return df diff --git a/src/eppoPynder/client.py b/src/eppoPynder/client.py new file mode 100644 index 0000000..7a5e733 --- /dev/null +++ b/src/eppoPynder/client.py @@ -0,0 +1,448 @@ +import os +from dotenv import load_dotenv + +from eppopynder._utils import _checks +from eppopynder._core import (_general, _taxons, _taxon, _country, _rppo, + _tools, _reporting_service, _references) + + +class Client: + """Client class for working with the EPPO API. + + Attributes: + _api_key (str): The API key used for authentication. + + Methods: + general(services): Query the EPPO API General endpoint. + taxons(services, params): Query the EPPO API Taxons endpoint. + taxon(eppo_codes, services): Query the EPPO API Taxon endpoint. + country(iso_codes, services): Query the EPPO API Country endpoint. + rppo(rppo_codes, services): Query the EPPO API RPPO endpoint. + tools(services, params): Query the EPPO API Tools endpoint. + reporting_service(services, params): Query the EPPO API Reporting + Service endpoint. + references(services): Query the EPPO API References endpoint. + """ + + def __init__(self, api_key=None): + """Initialize the client. + + Args: + api_key (str, optional): The API key used for authentication. + + Examples: + >>> from eppopynder import Client + + >>> # Create a client using the API key defined in the .env file. + >>> client_with_default = Client() + + >>> # Create a client using a manually specified API key. + >>> client_with_api_key = Client(api_key="") + """ + + if api_key is not None: + self._api_key = api_key + else: + load_dotenv() + self._api_key = os.getenv("EPPO_API_KEY") + + if self._api_key is None: + raise ValueError( + "The EPPO_API_KEY environment variable is not set") + + _checks._require_type(value=self._api_key, expected_type=str) + + if not self._api_key.strip(): + raise ValueError("The API key can not be empty") + + def general(self, services=None): + """Query the EPPO API General endpoint. + + This function queries the General endpoints of the EPPO Global Database + via REST API. The function sequentially queries all specified + `services` and returns the extracted data. + + Args: + services (list[GeneralService], optional): One or more General + services to query. A validation step ensures that all provided + services are of type `GeneralService` and match the supported + service names. If not provided, all services are considered. + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a + data frame with the queried content. + + Examples: + >>> from eppopynder import Client, GeneralService + + >>> client = Client() + + >>> # Get information about system health status. + >>> data = client.general(services=[GeneralService.STATUS]) + """ + + return _general._general(api_key=self._api_key, services=services) + + def taxons(self, services=None, params=None): + """Query the EPPO API Taxons endpoint. + + This function queries the Taxons endpoints of the EPPO Global Database + via REST API. The function sequentially queries all specified + `services` and returns the extracted data. + + Args: + services (list[TaxonsService], optional): One or more Taxons + services to query. A validation step ensures that all provided + services are of type `TaxonsService` and match the supported + service names. If not provided, all services are considered. + params (dict, optional): A named dictionary of query parameters to + include in the request. The list of available parameters can be + accessed via the EPPO API Documentation platform + (https://data2025.eppo.int/ui/#/docs/GDAPI). + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a + data frame with the queried content. + + Examples: + >>> from eppopynder import Client, TaxonsService + + >>> client = Client() + + >>> # Get the list of taxons with default parameters. + >>> data = client.taxons(services=[TaxonsService.LIST]) + + >>> # Get the list of taxons with custom parameters. + ... data = client.taxons( + ... services=[TaxonsService.LIST], + ... params={ + ... "list": { + ... "createdFromDate": "2000-01-01", + ... "limit": 5, + ... "offset": 100, + ... "orderAsc": False, + ... "orderBy": "eppocode" + ... } + ... } + ... ) + """ + + return _taxons._taxons(api_key=self._api_key, services=services, + params=params) + + def taxon(self, eppo_codes, services=None): + """Query the EPPO API Taxon endpoint. + + This function queries the Taxon endpoints of the EPPO Global Database + via REST API for one or more EPPO code(s) and one or more service(s). + For each EPPO code in `eppo_codes`, the function sequentially queries + all specified `services` and returns the extracted data. + + Args: + eppo_codes (list[str]): One or more EPPO codes to query. + services (list[TaxonService], optional): One or more Taxon services + to query. A validation step ensures that all provided services + are of type `TaxonService` and match the supported service + names. If not provided, all services are considered. + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a + data frame with the queried content for all the specified EPPO + codes. + + Examples: + >>> from eppopynder import Client, TaxonService + + >>> client = Client() + + >>> # Get all information about Bemisia tabaci. + >>> data = client.taxon(eppo_codes=["BEMITA"]) + + >>> # Get names data about Bemisia tabaci. + >>> data = client.taxon( + ... eppo_codes=["BEMITA"], + ... services=[TaxonService.NAMES] + ... ) + + >>> # Get taxonomy and categorization data about Bemisia tabaci and + >>> # Gossypium hirsutum. + >>> data = client.taxon( + ... eppo_codes=["BEMITA", "GOSHI"], + ... services=[ + ... TaxonService.TAXONOMY, + ... TaxonService.CATEGORIZATION + ... ] + ... ) + """ + + return _taxon._taxon(api_key=self._api_key, eppo_codes=eppo_codes, + services=services) + + def country(self, iso_codes, services=None): + """Query the EPPO API Country endpoint. + + This function queries the Country endpoints of the EPPO Global Database + via REST API for one or more ISO code(s) and one or more service(s). + For each ISO code in `iso_codes`, the function sequentially queries all + specified `services` and returns the extracted data through a list of + dataframes. + + Args: + iso_codes (list[str]): One or more ISO codes to query. + services (list[CountryService], optional): One or more Country + services to query. A validation step ensures that all provided + services are of type `CountryService` and match the supported + service names. If not provided, all services are considered. + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a + data frame with the queried content for all the specified ISO + codes. + + Examples: + >>> from eppopynder import Client, CountryService + + >>> client = Client() + + >>> # Get all information about France. + >>> data = client.country(iso_codes=["FR"]) + + >>> # Get overview data about France. + >>> data = client.country( + ... iso_codes=["FR"], + ... services=[CountryService.OVERVIEW] + ... ) + + >>> # Get overview and categorization data about France and Italy. + >>> data = client.country( + ... iso_codes=["FR", "IT"], + ... services=[ + ... CountryService.OVERVIEW, + ... CountryService.CATEGORIZATION + ... ] + ... ) + """ + + return _country._country(api_key=self._api_key, iso_codes=iso_codes, + services=services) + + def rppo(self, rppo_codes, services=None): + """Query the EPPO API RPPO endpoint. + + This function queries the RPPO endpoints of the EPPO Global Database + via REST API for one or more RPPO code(s) and one or more service(s). + For each RPPO code in `rppo_codes`, the function sequentially queries + all specified `services` and returns the extracted data through a list + of dataframes. + + Args: + rppo_codes (list[str]): One or more RPPO codes to query. + services (list[CountryService], optional): One or more RPPO + services to query. A validation step ensures that all provided + services are of type `RPPOService` and match the supported + service names. If not provided, all services are considered. + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a + data frame with the queried content for all the specified RPPO + codes. + + Examples: + >>> from eppopynder import Client, RPPOService + + >>> client = Client() + + >>> # Get all information about the European and Mediterranean + >>> # Plant Protection Organisation. + >>> data = client.rppo(rppo_codes=["9A"]) + + >>> # Get overview data about the European and Mediterranean + >>> # Plant Protection Organisation. + >>> data = client.rppo( + ... rppo_codes=["9A"], + ... services=[RPPOService.OVERVIEW] + ... ) + + >>> # Get overview and categorization data about the European and + >>> # Mediterranean Plant Protection Organisation and the European + >>> # Union. + >>> data = client.rppo( + ... rppo_codes=["9A", "9L"], + ... services=[ + ... RPPOService.OVERVIEW, + ... RPPOService.CATEGORIZATION + ... ] + ... ) + """ + + return _rppo._rppo(api_key=self._api_key, rppo_codes=rppo_codes, + services=services) + + def tools(self, services=None, params=None): + """Query the EPPO API Tools endpoint. + + This function queries the Tools endpoints of the EPPO Global Database + via REST API. The function sequentially queries all specified + `services` and returns the extracted data through a dictionary of data + frames. + + Args: + services (list[ToolsService], optional): One or more Tools services + to query. A validation step ensures that all provided services + are of type `ToolsService` and match the supported service + names. If not provided, all services are considered. + params (dict, optional): A named dictionary of query parameters to + include in the request. The list of available parameters can be + accessed via the EPPO API Documentation platform + (https://data2025.eppo.int/ui/#/docs/GDAPI). + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a + data frame with the queried content. + + Examples: + >>> from eppopynder import Client, ToolsService + + >>> client = Client() + + >>> # Get the EPPO codes associated to the name Bemisia tabaci. + >>> data = client.tools( + ... services=[ToolsService.NAME2CODES], + ... params={ + ... ToolsService.NAME2CODES: { + ... "name": "Bemisia tabaci", + ... "onlyPreferred": False + ... } + ... } + ... ) + """ + + return _tools._tools(api_key=self._api_key, services=services, + params=params) + + def reporting_service(self, services=None, params=None): + """Query the EPPO API Reporting Service endpoint. + + This function queries the Reporting Service endpoints of the EPPO + Global Database via REST API. The function sequentially queries all + specified `services` and returns the extracted data through a + dictionary of data frames. + + Args: + services (list[ReportingServiceService], optional): One or more + Reporting Service services to query. A validation step ensures + that all provided services are of type + `ReportingServiceService` and match the supported service + names. If not provided, all services are considered. + params (dict, optional): A named dictionary of query parameters to + include in the request. The list of available parameters can be + accessed via the EPPO API Documentation platform + (https://data2025.eppo.int/ui/#/docs/GDAPI). + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a + data frame with the queried content. + + Examples: + >>> from eppopynder import Client, ReportingServiceService + + >>> client = Client() + + >>> # Get the list of reporting service issues. + >>> data = client.reporting_service( + ... services=[ReportingServiceService.LIST] + ... ) + + >>> # Get a specific reporting service issue. + >>> data = client.reporting_service( + ... services=[ReportingServiceService.REPORTING], + ... params={ + ... ReportingServiceService.REPORTING: { + ... "reporting_id": 10 + ... } + ... } + ... ) + + >>> # Get a specific article. + >>> data = client.reporting_service( + ... services=[ReportingServiceService.ARTICLE], + ... params={ + ... ReportingServiceService.ARTICLE: { + ... "article_id": 234 + ... } + ... } + ... ) + + >>> # Get the list of reporting service issues, a specific + >>> # reporting service issue and a specific article. + >>> data = client.reporting_service( + ... params={ + ... ReportingServiceService.REPORTING: { + ... "reporting_id": 10 + ... }, + ... ReportingServiceService.ARTICLE: { + ... "article_id": 234 + ... } + ... } + ... ) + """ + + return _reporting_service._reporting_service( + api_key=self._api_key, + services=services, + params=params + ) + + def references(self, services=None): + """Query the EPPO API References endpoint. + + This function queries the References endpoints of the EPPO Global + Database via REST API. The function sequentially queries all specified + `services` and returns the extracted data through a dictionary of data + frames. + + Args: + services (list[ReferencesService], optional): One or more + References services to query. A validation step ensures that + all provided services are of type `ReferencesService` and match + the supported service names. If not provided, all services are + considered. + + Returns: + dict: A dictionary, in which each entry corresponds to the data + retrieved for each specified service. Each element contains a + data frame with the queried content. + + Examples: + >>> from eppopynder import Client, ReferencesService + + >>> client = Client() + + >>> # Get all references information. + >>> data = client.references() + + >>> # Get information about distribution status codes. + >>> data = client.references( + ... services=[ReferencesService.DISTRIBUTION_STATUS] + ... ) + + # Get information about EPPO list codes and labels and countries. + >>> data = client.references( + ... services=[ + ... ReferencesService.Q_LIST, + ... ReferencesService.COUNTRIES + ... ] + ... ) + """ + + return _references._references( + api_key=self._api_key, + services=services + ) diff --git a/src/eppoPynder/data_dump.py b/src/eppoPynder/data_dump.py deleted file mode 100644 index b0eeab4..0000000 --- a/src/eppoPynder/data_dump.py +++ /dev/null @@ -1,74 +0,0 @@ -from eppoPynder.query_the_eppo_for_service import query_the_eppo_for_service -import pandas as pd -import os -from dotenv import load_dotenv - -# Load environment variables from a .env file (if present) -load_dotenv() - -def data_dump(codes_to_scan, token = os.getenv('EPPO_token')): - """ - Create a dump of the whole EPPO database via REST API for one or more EPPO code(s). - - Parameters - ---------- - codes_to_scan : list of str - One or more EPPO code(s) as a list of strings. - - token : str, optional - Manually add your unique token or set it inside a .env file. - Default is retrieved from the environment variable EPPO_token using os.getenv('EPPO_token'). - - Returns - ------- - dump : dict of {str : pd.DataFrame} - A dictionary of pandas dataframes, each containing basic information, all names, taxonomy, categorization, hosts, pests and kingdom data about the input EPPO code, respectively. - The dataframes will also include the following columns: - - queried_eppocode: The EPPO code requested. - - queried_on: The date when the query was performed. - - queried_url: The URL that was queried. - - Examples - -------- - # Create a dump of all data about Bemisia tabaci: basic information, all names, taxonomy, categorization, hosts, pests and kingdom data. - data_dump(["BEMITA"]) - - # Create a dump of all data about Aphis pomi and Leucoptera malifoliella: basic information, all names, taxonomy, categorization, hosts, pests and kingdom data. - data_dump(["APHIPO", "LEUCSC"]) - """ - if not token: - token = "default_token" - else: - assert isinstance(token, str), "token must be a string!" - - if not isinstance(codes_to_scan, list): - raise AssertionError("Input must be a list!") - if not codes_to_scan: - raise AssertionError("Input list cannot be empty!") - if not all(isinstance(code, str) for code in codes_to_scan): - raise AssertionError("All codes must be strings!") - - general = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="", token=token) for i in codes_to_scan]) - general.insert(0, "pestCode", general[["queried_eppocode"]], True) - - names = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="names", token=token) for i in codes_to_scan]) - names.insert(0, "pestCode", names[["queried_eppocode"]], True) - - taxonomy = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="taxonomy", token=token) for i in codes_to_scan]) - taxonomy.insert(0, "pestCode", taxonomy[["queried_eppocode"]], True) - - categorization = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="categorization", token=token) for i in codes_to_scan]) - categorization.insert(0, "pestCode", categorization[["queried_eppocode"]], True) - - hosts = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="hosts", token=token) for i in codes_to_scan]) - hosts.insert(0, "pestCode", hosts[["queried_eppocode"]], True) - - pests = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="pests", token=token) for i in codes_to_scan]) - pests.insert(0, "pestCode", pests[["queried_eppocode"]], True) - - kingdom = pd.concat([query_the_eppo_for_service(queried_eppocode=i, service="kingdom", token=token) for i in codes_to_scan]) - kingdom.insert(0, "pestCode", kingdom[["queried_eppocode"]], True) - - dump = {"general":general, "names":names, "taxonomy":taxonomy, "categorization":categorization, "hosts":hosts, "pests":pests, "kingdom":kingdom} - - return dump diff --git a/src/eppoPynder/data_wrangling.py b/src/eppoPynder/data_wrangling.py new file mode 100644 index 0000000..f767bf8 --- /dev/null +++ b/src/eppoPynder/data_wrangling.py @@ -0,0 +1,75 @@ +"""This module contains functions for data wrangling.""" + +import pandas as pd + +from eppopynder._utils import _checks + +def uniform_taxonomy(taxonomy_data): + """Create a complete and uniform taxonomy dataframe. + + This function normalizes the taxonomy returned by the EPPO service, + producing a uniform structure that includes all possible taxonomic + categories, even when some of them are not present in the original result. + + Args: + taxonomy_data (pandas.DataFrame): A dataframe containing taxonomy data + provided by the EPPO service for a given EPPO code. + + Returns: + pandas.DataFrame: A dataframe where each row represents one of the + expected taxonomic ranks. Fields corresponding to ranks not present in + the original taxonomy are filled with `NaN`/`NaT`. The `level` column + is excluded from the output. + + Examples: + >>> from eppopynder import Client, TaxonService uniform_taxonomy + + >>> client = Client() + + >>> # Retrieve taxonomy data from the EPPO service. + >>> taxon_data = client.taxon( + ... eppo_codes=["BEMITA"], + ... services=[TaxonService.TAXONOMY] + ... ) + + >>> # Create a uniform taxonomy with all ranks. + >>> taxonomy = uniform_taxonomy( + ... taxonomy_data=taxon_data[TaxonService.TAXONOMY]) + """ + + _checks._require_type(value=taxonomy_data, expected_type=pd.DataFrame) + _checks._require_column_names(dataframe=taxonomy_data, + column_names=["queried_eppo_code", "type"]) + _checks._require_not_all_nan(dataframe=taxonomy_data, + column_name="queried_eppo_code") + + taxonomy_types_ = pd.DataFrame({ + "type": [ + "Kingdom", + "Phylum", + "Subphylum", + "Class", + "Subclass", + "Order", + "Suborder", + "Family", + "Subfamily", + "Genus", + "Species" + ] + }) + + uniformed_taxonomy_data_ = ( + taxonomy_types_ + .merge(taxonomy_data, on="type", how="left") + .drop(columns="level", errors="ignore") + ) + + queried_eppo_code_ = \ + uniformed_taxonomy_data_["queried_eppo_code"].dropna().iloc[0] + + uniformed_taxonomy_data_["queried_eppo_code"] = \ + uniformed_taxonomy_data_["queried_eppo_code"] \ + .fillna(queried_eppo_code_) + + return uniformed_taxonomy_data_ diff --git a/src/eppoPynder/getting_countries.py b/src/eppoPynder/getting_countries.py deleted file mode 100644 index 077318b..0000000 --- a/src/eppoPynder/getting_countries.py +++ /dev/null @@ -1,106 +0,0 @@ -import numpy as np - -def getting_countries(acronym): - """ - Function to translate the acronyms of the Regional Plant Protection Organizations used in the EPPO database to the corresponding member countries. - - Parameters - ---------- - acronym : str - The acronym of the Regional Plant Protection Organization. - - Returns - ------- - countries : str - All the member countries. - - Examples - -------- - getting_countries('OIRSA') - """ - assert isinstance(acronym, str), "acronym must be a string!" - - if acronym == 'EPPO': - countries = ", ".join([ - 'Albania', 'Algeria', 'Austria', 'Azerbaijan', 'Belarus', 'Belgium', - 'Bosnia and Herzegovina', 'Bulgaria', 'Croatia', 'Cyprus', 'Czech Republic', - 'Denmark', 'Estonia', 'Finland', 'France', 'Georgia', 'Germany', 'Greece', - 'Guernsey', 'Hungary', 'Ireland', 'Israel', 'Italy', 'Jersey', 'Jordan', - 'Kazakhstan', 'Kyrgyzstan', 'Latvia', 'Lithuania', 'Luxembourg', 'Malta', - 'Moldova', 'Montenegro', 'Morocco', 'Netherlands', 'North Macedonia', 'Norway', - 'Poland', 'Portugal', 'Romania', 'Russia', 'Serbia', 'Slovakia', 'Slovenia', - 'Spain', 'Sweden', 'Switzerland', 'Tunisia', 'Türkiye', 'Ukraine', 'United Kingdom', - 'Uzbekistan' - ]) - elif acronym == 'OIRSA': - countries = ", ".join([ - 'Belize', 'Costa Rica', 'Dominican Republic', 'El Salvador', 'Guatemala', - 'Honduras', 'Mexico', 'Nicaragua', 'Panama' - ]) - elif acronym == 'EAEU': - countries = ", ".join([ - 'Armenia', 'Belarus', 'Kazakhstan', 'Kyrgyzstan', 'Russia' - ]) - elif acronym == 'COSAVE': - countries = ", ".join([ - 'Argentina', 'Bolivia', 'Brazil', 'Chile', 'Paraguay', 'Peru', 'Uruguay' - ]) - elif acronym == 'EU': - countries = ", ".join([ - 'Austria', 'Belgium', 'Bulgaria', 'Croatia', 'Cyprus', 'Czech Republic', - 'Denmark', 'Estonia', 'Finland', 'France', 'Germany', 'Greece', 'Hungary', - 'Ireland', 'Italy', 'Latvia', 'Lithuania', 'Luxembourg', 'Malta', 'Netherlands', - 'Poland', 'Portugal', 'Romania', 'Slovakia', 'Slovenia', 'Spain', 'Sweden' - ]) - elif acronym == 'APPPC': - countries = ", ".join([ - 'Australia', 'Bangladesh', 'Cambodia', 'China', 'East Timor', 'Fiji', - 'French Polynesia', 'India', 'Indonesia', "Korea Dem. People's Republic", - 'Korea, Republic', 'Laos', 'Malaysia', 'Myanmar', 'Nepal', 'New Zealand', - 'Pakistan', 'Papua New Guinea', 'Philippines', 'Samoa', 'Solomon Islands', - 'Sri Lanka', 'Thailand', 'Tonga', 'Vietnam' - ]) - elif acronym == 'CAHFSA': - countries = ", ".join([ - 'Antigua and Barbuda', 'Bahamas', 'Barbados', 'Belize', 'Dominica', 'Grenada', - 'Guyana', 'Haiti', 'Jamaica', 'Montserrat', 'Saint Lucia', 'St Kitts-Nevis', - 'St Vincent and the Grenadines', 'Suriname', 'Trinidad and Tobago' - ]) - elif acronym == 'CAN': - countries = ", ".join([ - 'Bolivia', 'Colombia', 'Ecuador', 'Peru', 'Venezuela' - ]) - elif acronym == 'IAPSC': - countries = ", ".join([ - 'Algeria', 'Angola', 'Benin', 'Botswana', 'Burkina Faso', 'Burundi', 'Cameroon', - 'Cape Verde', 'Central African Republic', 'Chad', 'Comoros', 'Congo', - 'Congo, Democratic Republic of the', "Cote d'Ivoire", 'Djibouti', 'Egypt', - 'Equatorial Guinea', 'Eritrea', 'Eswatini', 'Ethiopia', 'Gabon', 'Gambia', - 'Ghana', 'Guinea', 'Guinea-Bissau', 'Kenya', 'Lesotho', 'Liberia', 'Libya', - 'Madagascar', 'Malawi', 'Mali', 'Mauritania', 'Mauritius', 'Morocco', 'Mozambique', - 'Namibia', 'Niger', 'Nigeria', 'Rwanda', 'Sao Tome & Principe', 'Senegal', - 'Seychelles', 'Sierra Leone', 'Somalia', 'South Africa', 'South Sudan', 'Sudan', - 'Tanzania', 'Togo', 'Tunisia', 'Uganda', 'Zaire', 'Zambia', 'Zimbabwe' - ]) - elif acronym == 'NAPPO': - countries = ", ".join([ - 'Canada', 'Mexico', 'United States of America' - ]) - elif acronym == 'NEPPO': - countries = ", ".join([ - 'Algeria', 'Egypt', 'Jordan', 'Libya', 'Malta', 'Morocco', 'Pakistan', - 'South Sudan', 'Sudan', 'Syria', 'Tunisia' - ]) - elif acronym == 'PPPO': - countries = ", ".join([ - 'American Samoa', 'Australia', 'Cook Islands', 'Fiji', 'French Polynesia', - 'Guam', 'Kiribati', 'Marshall Islands', 'Micronesia', 'Nauru', 'New Caledonia', - 'New Zealand', 'Niue', 'Northern Mariana Islands', 'Palau', 'Papua New Guinea', - 'Pitcairn', 'Samoa', 'Solomon Islands', 'Tokelau', 'Tonga', 'Tuvalu', 'Vanuatu', - 'Wallis and Futuna Islands' - ]) - else: - countries = np.nan - print("Unknown acronym") - - return countries diff --git a/src/eppoPynder/query_the_eppo_for_service.py b/src/eppoPynder/query_the_eppo_for_service.py deleted file mode 100644 index 5f4c867..0000000 --- a/src/eppoPynder/query_the_eppo_for_service.py +++ /dev/null @@ -1,82 +0,0 @@ -from eppoPynder.api_query import api_query -import numpy as np -import os -from dotenv import load_dotenv - -# Load environment variables from a .env file (if present) -load_dotenv() - -def query_the_eppo_for_service(queried_eppocode, base_url = "https://data.eppo.int/api/rest/1.0/taxon/", service = "categorization", token = os.getenv('EPPO_token')): - """ - Query the EPPO database via REST API by specifying the name of the required service to retrieve - basic information, all names, taxonomy, categorization, hosts, pests, or kingdom data - about an EPPO code. - - Parameters - ---------- - queried_eppocode : str - A single EPPO code. EPPO codes are unique computer codes developed for plants and pests - (including pathogens) important in agriculture and plant protection. These codes - facilitate the management of plant and pest names in databases and enable data exchange - between IT systems. Each EPPO code consists of 5 to 6 letters, often mnemonic - abbreviations of the scientific name of the organism, and can be freely downloaded - from the EPPO Data Services platform at https://data.eppo.int/. - - base_url : str, optional - URL root for all REST API requests. Default is "https://data.eppo.int/api/rest/1.0". - - service : str, optional - The specific service to query. Choose from the following options: - - "" : basic information - - "names" : all names - - "taxonomy" : taxonomy data - - "categorization" : categorization data - - "hosts" : hosts data - - "pests" : pests data - - "kingdom" : kingdom taxonomic rank - Default is "categorization". - - token : str, optional - Manually add your unique token or set it inside a .env file. - Default is retrieved from the environment variable EPPO_token using os.getenv('EPPO_token'). - - Returns - ------- - queried_service : pd.DataFrame - A dataframe containing the contents of the request converted from JSON. - Based on the query, the output dataframe will contain basic information, all names, - taxonomy, categorization, hosts, pests, or kingdom data about the input EPPO code. - The dataframe will also include the following columns: - - queried_eppocode: The EPPO code requested. - - queried_on: The date when the query was performed. - - queried_url: The URL that was queried. - - Examples - -------- - # Get basic information about Bemisia tabaci: - query_the_eppo_for_service("BEMITA", service="") - - # Get all names for Bemisia tabaci: - query_the_eppo_for_service("BEMITA", service="names") - - # Get categorization data for Bemisia tabaci: - query_the_eppo_for_service("BEMITA", service="categorization") - """ - assert isinstance(queried_eppocode, str), "queried_eppocode must be a string!" - assert isinstance(base_url, str), "base_url must be a string!" - assert isinstance(service, str), "service must be a string!" - - if not token: - token = "default_token" - else: - assert isinstance(token, str), "token must be a string!" - - queried_url = base_url+queried_eppocode+"/"+service+"?authtoken="+token - - if service == "": - queried_url = base_url+queried_eppocode+"?authtoken="+token - - queried_service = api_query(queried_eppocode=queried_eppocode, queried_url=queried_url) - - return queried_service - diff --git a/src/eppoPynder/query_the_whole_eppo.py b/src/eppoPynder/query_the_whole_eppo.py deleted file mode 100644 index 2e6a338..0000000 --- a/src/eppoPynder/query_the_whole_eppo.py +++ /dev/null @@ -1,64 +0,0 @@ -from eppoPynder.query_the_eppo_for_service import query_the_eppo_for_service -import numpy as np -import os -from dotenv import load_dotenv - -# Load environment variables from a .env file (if present) -load_dotenv() - -def query_the_whole_eppo(queried_eppocode, base_url = "https://data.eppo.int/api/rest/1.0/taxon/", token = os.getenv('EPPO_token')): - """ - Query the EPPO database via REST API to retrieve basic information, - all names, taxonomy, categorization, hosts, pests, and kingdom data about an EPPO code. - - Parameters - ---------- - queried_eppocode : str - A single EPPO code. EPPO codes are unique computer codes developed for plants and pests - (including pathogens) important in agriculture and plant protection. These codes - facilitate the management of plant and pest names in databases and enable data exchange - between IT systems. Each EPPO code consists of 5 to 6 letters, often mnemonic - abbreviations of the scientific name of the organism, and can be freely downloaded - from the EPPO Data Services platform at https://data.eppo.int/. - - base_url : str, optional - URL root for all REST API requests. Default is "https://data.eppo.int/api/rest/1.0". - - token : str, optional - Manually add your unique token or set it inside a .env file. - Default is retrieved from the environment variable EPPO_token using os.getenv('EPPO_token'). - - Returns - ------- - EPPO_dict : dict of {str : pd.DataFrame} - A dictionary of pandas dataframes, each containing basic information, all names, taxonomy, categorization, hosts, pests and kingdom data about the input EPPO code, respectively. - The dataframes will also include the following columns: - - queried_eppocode: The EPPO code requested. - - queried_on: The date when the query was performed. - - queried_url: The URL that was queried. - - Examples - -------- - # Get all information about Bemisia tabaci: basic information, all names, taxonomy, - # categorization, hosts, pests, and kingdom data. - query_the_whole_eppo("BEMITA") - """ - if not token: - token = "default_token" - else: - assert isinstance(token, str), "token must be a string!" - - assert isinstance(queried_eppocode, str), "queried_eppocode must be a string!" - assert isinstance(base_url, str), "base_url must be a string!" - - services = ["", "names", "taxonomy", "categorization", "hosts", "pests", "kingdom"] - - EPPO_list = [] - - for service in services: - EPPO_list.append(query_the_eppo_for_service(queried_eppocode=queried_eppocode, base_url=base_url, service=service, token=token)) - - services[0]="general" - EPPO_dict = {name: df for name, df in zip(services, EPPO_list)} - - return EPPO_dict diff --git a/src/eppoPynder/taxonomy_ranked.py b/src/eppoPynder/taxonomy_ranked.py deleted file mode 100644 index 1a22c66..0000000 --- a/src/eppoPynder/taxonomy_ranked.py +++ /dev/null @@ -1,34 +0,0 @@ -import numpy as np -import pandas as pd - -def taxonomy_ranked(taxonomy, kingdom): - """ - Merge taxonomy and kingdom information into a single dataframe. - - Parameters - ---------- - taxonomy : pd.DataFrame - A pandas dataframe containing taxonomy data about the queried EPPO code. - - kingdom : pd.DataFrame - A pandas dataframe containing kingdom data about the queried EPPO code. - - Returns - ------- - taxonomy_ranked_ : pd.DataFrame - A pandas dataframe containing taxonomy and kingdom information about the queried EPPO code. - - Examples - -------- - # Get taxonomy and kingdom data about Bemisia tabaci: - taxonomy = query_the_eppo_for_service(queried_eppocode="BEMITA", service="taxonomy") - kingdom = query_the_eppo_for_service(queried_eppocode="BEMITA", service="kingdom") - - # Merge taxonomy and kingdom information about Bemisia tabaci into a single dataframe: - taxonomy_ranked(taxonomy, kingdom) - """ - taxonomy_ranked_ = pd.merge(taxonomy, kingdom[["eppocode", "queried_eppocode", "status"]], how='left', on=["eppocode", "queried_eppocode"]) - taxonomy_ranked_ = taxonomy_ranked_.rename(columns={'status':'rank'}) - taxonomy_ranked_.insert(0, "rank", taxonomy_ranked_.pop("rank")) - taxonomy_ranked_["rank"] = np.where(taxonomy_ranked_["rank"].notnull(), "kingdom", pd.NA) - return taxonomy_ranked_ diff --git a/src/eppoPynder/unnest_lists.py b/src/eppoPynder/unnest_lists.py deleted file mode 100644 index aeda42c..0000000 --- a/src/eppoPynder/unnest_lists.py +++ /dev/null @@ -1,25 +0,0 @@ -def unnest_lists(json_response): - """ - Unnest nested lists and dictionaries in a JSON dictionary of host data retrieved from EPPO. - - Parameters - ---------- - json_response : dict - A JSON dictionary of nested lists and dictionaries containing the contents of a request. - - Returns - ------- - json_response : list - A list of JSON dictionaries containing the contents of a request. - """ - if type(json_response) is dict and len(json_response)>0 and ("Major host" in json_response or "Host" in json_response or "Wild/Weed" in json_response or "Alternate" in json_response or "Experimental" in json_response or "Doubtful host" in json_response or "Non-host" in json_response): - unnest_hosts = (json_response.get("Major host") if json_response.get("Major host") is not None else []) + \ - (json_response.get("Host") if json_response.get("Host") is not None else []) + \ - (json_response.get("Wild/Weed") if json_response.get("Wild/Weed") is not None else []) + \ - (json_response.get("Alternate") if json_response.get("Alternate") is not None else []) + \ - (json_response.get("Experimental") if json_response.get("Experimental") is not None else []) + \ - (json_response.get("Doubtful host") if json_response.get("Doubtful host") is not None else []) + \ - (json_response.get("Non-host") if json_response.get("Non-host") is not None else []) - json_response = unnest_hosts - - return json_response diff --git a/tests/test__checks.py b/tests/test__checks.py new file mode 100644 index 0000000..96af93b --- /dev/null +++ b/tests/test__checks.py @@ -0,0 +1,132 @@ +import unittest +import pandas as pd + +from eppopynder._utils._checks import (_require_type, _require_trailing_slash, + _require_list_of, _check_services, + _require_column_names, + _require_not_all_nan) + + +class TestChecks(unittest.TestCase): + + ################### + # _require_type() # + ################### + + def test__require_type_invalid(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, _require_type, value=123, + expected_type=str) + + def test__require_type_output(self): + """Test the behaviour for valid data.""" + self.assertIsNone(_require_type(value=123, expected_type=int)) + + ############################# + # _require_trailing_slash() # + ############################# + + def test__require_trailing_slash_types(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(TypeError, _require_trailing_slash, string=123) + + def test__require_trailing_slash_invalid(self): + """Test the behaviour for invalid data.""" + self.assertRaises(ValueError, _require_trailing_slash, string="country") + + def test__require_trailing_slash_output(self): + """Test the behaviour for valid data.""" + self.assertIsNone(_require_trailing_slash(string="/country")) + + ###################### + # _require_list_of() # + ###################### + + def test__require_list_of_types(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(TypeError, _require_list_of, items=123, + expected_type=int) + self.assertRaises(TypeError, _require_list_of, items=list(), + expected_type=123) + + def test__require_list_of_invalid(self): + """Test the behaviour for invalid elements.""" + self.assertRaises(TypeError, _require_list_of, items=[1, 2, 'x'], + expected_type=int) + + def test__require_list_of_output(self): + """Test the output for valid elements.""" + self.assertIsNone(_require_list_of(items=[1, 2, 3], expected_type=int)) + + ##################### + # _check_services() # + ##################### + + def test__check_services_types(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(TypeError, _check_services, services=123, + choices=list()) + self.assertRaises(TypeError, _check_services, services=list(), + choices=123) + self.assertRaises(TypeError, _check_services, services=[1, 2], + choices=['x', 'y']) + + def test__check_services_invalid(self): + """Test the behaviour for invalid element types.""" + self.assertRaises(ValueError, _check_services, services=['x', 'a'], + choices=['x', 'y']) + + def test__check_services_output(self): + """Test the output for valid elements.""" + self.assertIsNone(_check_services( + services=['a', 'b'], + choices=['a', 'b', 'c'] + )) + + ########################### + # _require_column_names() # + ########################### + + def test__require_column_names_types(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(TypeError, _require_column_names, dataframe=123, + column_names=list()) + self.assertRaises(TypeError, _require_column_names, + dataframe=pd.DataFrame(), column_names=123) + + def test__require_column_names_invalid(self): + """Test the behaviour for invalid element types.""" + self.assertRaises(ValueError, _require_column_names, + dataframe=pd.DataFrame(), column_names=["column_a"]) + + def test__require_column_names_output(self): + """Test the output for valid elements.""" + self.assertIsNone(_require_column_names( + dataframe=pd.DataFrame({"column_a": [1, 2, 3]}), + column_names=["column_a"] + )) + + ########################## + # _require_not_all_nan() # + ########################## + + def test__require_not_all_nan_types(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(TypeError, _require_not_all_nan, dataframe=123, + column_name="") + self.assertRaises(TypeError, _require_not_all_nan, + dataframe=pd.DataFrame(), column_names=123) + + def test__require_not_all_nan_invalid(self): + """Test the behaviour for invalid element types.""" + self.assertRaises(ValueError, _require_not_all_nan, + dataframe=pd.DataFrame({ + "column_a": [None, None, None]}), + column_name="column_a") + + def test__require_not_all_nan_output(self): + """Test the output for valid elements.""" + self.assertIsNone(_require_not_all_nan( + dataframe=pd.DataFrame({"column_a": [1, None, 1]}), + column_name="column_a" + )) diff --git a/tests/test__country.py b/tests/test__country.py new file mode 100644 index 0000000..256cf01 --- /dev/null +++ b/tests/test__country.py @@ -0,0 +1,103 @@ +import os +import unittest +from unittest.mock import patch +import pandas as pd +from dotenv import load_dotenv +from requests import HTTPError + +from eppopynder._core._country import _country, CountryService + +load_dotenv() + + +class TestCountry(unittest.TestCase): + + ############## + # _country() # + ############## + + def test__country_types(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, _country, api_key=123, iso_codes=[''], + services=list()) + self.assertRaises(TypeError, _country, api_key='', iso_codes=123, + services=123) + self.assertRaises(TypeError, _country, api_key='', iso_codes=[1, 2], + services=list()) + self.assertRaises(TypeError, _country, api_key='', iso_codes=[''], + services=123) + self.assertRaises(TypeError, _country, api_key='', iso_codes=[''], + services=[1, 2]) + + @patch("eppopynder._utils._requests._fetch_service") + def test__country_output(self, mock_fetch_service): + """Test the output dict structure.""" + mock_fetch_service.return_value = pd.DataFrame() + services_ = [CountryService.OVERVIEW] + data_ = _country( + api_key="EPPO_API_KEY", + iso_codes=["FR"], + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[CountryService.OVERVIEW], pd.DataFrame) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__country_output_online(self): + """Test the output dict structure.""" + services_ = [CountryService.OVERVIEW] + data_ = _country( + api_key=os.getenv("EPPO_API_KEY"), + iso_codes=["FR"], + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[CountryService.OVERVIEW], pd.DataFrame) + + @patch("eppopynder._utils._requests._fetch_service") + def test__country_invalid_iso(self, mock_fetch_service): + """Test the behaviour for invalid ISO codes.""" + mock_fetch_service.side_effect = HTTPError + self.assertRaises(HTTPError, _country, + api_key="EPPO_API_KEY", + iso_codes=["BAD_ISO_CODE"]) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__country_invalid_iso_online(self): + """Test the behaviour for invalid ISO codes.""" + self.assertRaises(HTTPError, _country, + api_key=os.getenv("EPPO_API_KEY"), + iso_codes=["BAD_ISO_CODE"]) + + def test__country_invalid_service(self): + """Test the behaviour for invalid services.""" + self.assertRaises(TypeError, _country, + api_key="EPPO_API_KEY", + iso_codes=["FR"], services=["badService"]) + + @patch("eppopynder._utils._requests._fetch_service") + def test__country_invalid_key(self, mock_fetch_service): + """Test the behaviour for invalid API keys.""" + mock_fetch_service.side_effect = HTTPError + self.assertRaises(HTTPError, _country, api_key="BAD_API_KEY", + iso_codes=["FR"]) + mock_fetch_service.side_effect = TypeError + self.assertRaises(TypeError, _country, api_key=None, iso_codes=["FR"]) + + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__country_invalid_key_online(self): + """Test the behaviour for invalid API keys.""" + self.assertRaises(HTTPError, _country, api_key="BAD_API_KEY", + iso_codes=["FR"]) + self.assertRaises(TypeError, _country, + api_key=os.getenv("BAD_API_KEY"), iso_codes=["FR"]) diff --git a/tests/test__data.py b/tests/test__data.py new file mode 100644 index 0000000..d397f55 --- /dev/null +++ b/tests/test__data.py @@ -0,0 +1,209 @@ +import unittest +import pandas as pd + +from eppopynder._utils._data import (_flatten, _transform_taxons, + _transform_references, _merge_batch) +from eppopynder._core._taxons import TaxonsService +from eppopynder._core._references import ReferencesService + + +class TestData(unittest.TestCase): + + ############## + # _flatten() # + ############## + + def test__flatten_invalid(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, _flatten, nested_data=123) + + def test__flatten_empty(self): + """Test the behaviour for empty data.""" + self.assertTrue(_flatten(nested_data=list()).empty) + self.assertTrue(_flatten(nested_data=dict()).empty) + + def test__flatten_sep(self): + flattened_ = _flatten(nested_data={'a': {'b': 1}}) + self.assertEqual(flattened_.keys()[0], "a_b") + flattened_ = _flatten(nested_data={'a': {'b': 1}}, separator='.') + self.assertEqual(flattened_.keys()[0], "a.b") + + def test__flatten_dict1(self): + """Test the behaviour for flattening a dictionary.""" + flattened_ = _flatten(nested_data={ + 'a': 1, + 'b': 2, + 'c': 3, + 'd': { + '1': 4, + '2': 5 + } + }) + self.assertEqual( + list(flattened_.keys()), + ['a', 'b', 'c', "d_1", "d_2"] + ) + + def test__flatten_dict2(self): + """Test the behaviour for flattening a dictionary.""" + flattened_ = _flatten(nested_data={ + 'a': 1, + 'b': 2, + 'c': 3, + 'd': { + '1': 4, + '2': { + '3': 5 + } + } + }) + self.assertEqual( + list(flattened_.keys()), + ['a', 'b', 'c', "d_1", "d_2_3"] + ) + + def test__flatten_dict3(self): + """Test the behaviour for flattening a dictionary.""" + flattened_ = _flatten(nested_data={ + 'a': 1, + 'b': [ + {'x': 1, 'y': 2, 'z': 3}, + {'x': 4, 'y': 5, 'z': 6} + ] + }) + self.assertEqual( + list(flattened_.keys()), + ['a', "b_x", "b_y", "b_z"] + ) + + def test__flatten_dict4(self): + """Test the behaviour for flattening a dictionary.""" + flattened_ = _flatten(nested_data={ + 'a': 1, + 'b': [ + {'x': 1, 'y': 2, 'z': 3}, + {'x': 4, 'y': 5, 'z': 6}, + "some text" + ] + }) + self.assertEqual( + list(flattened_.keys()), + ['a', "b_x", "b_y", "b_z", 'b'] + ) + + def test__flatten_list_of_dicts(self): + """Test the behaviour for flattening a list of dictionaries.""" + flattened_ = _flatten(nested_data=[ + {'a': 1, 'b': 2, 'c': 3}, + {'a': 4, 'b': 5, 'c': 6} + ]) + self.assertEqual(list(flattened_.keys()), ['a', 'b', 'c']) + + def test__flatten_dict_of_lists1(self): + """Test the behaviour for flattening a dictionary of lists.""" + flattened_ = _flatten(nested_data={ + 'a': [ + {'x': 1, 'y': 2, 'z': 3}, + {'x': 4, 'y': 5, 'z': 6} + ], + 'b': [ + {'x': 7, 'y': 8, 'z': 9}, + {'x': 10, 'y': 11, 'z': 12} + ] + }) + self.assertEqual( + list(flattened_.keys()), + ["parent_key", 'x', 'y', 'z'] + ) + + def test__flatten_dict_of_lists2(self): + """Test the behaviour for flattening a dictionary of lists.""" + flattened_ = _flatten(nested_data={ + 'a': [ + {'x': 1, 'y': 2, 'z': 3}, + {'x': 4, 'y': 5, 'z': 6} + ], + 'b': [ + {'x': 7, 'y': 8, 'z': 9}, + "some text" + ] + }) + self.assertEqual( + list(flattened_.keys()), + ["parent_key", 'x', 'y', 'z', "atomic_value"] + ) + + ####################### + # _transform_taxons() # + ####################### + + def test__transform_taxons_invalid(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, _transform_taxons, taxons_data=123) + + def test__transform_taxons_valid(self): + """Test the behaviour for valid data.""" + data_ = _transform_taxons(taxons_data={ + TaxonsService.LIST: pd.DataFrame({ + "pagination_a": [1, 2, 3], + "meta_b": [4, 5, 6], + "other": [7, 8, 9] + }) + }) + self.assertEqual( + list(data_[TaxonsService.LIST].keys()), + ["other"] + ) + + ########################### + # _transform_references() # + ########################### + + def test__transform_references_invalid(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, _transform_references, + references_data=123) + + def test__transform_references_valid(self): + """Test the behaviour for valid data.""" + data_ = _transform_references(references_data={ + ReferencesService.COUNTRIES_STATES: pd.DataFrame({ + "parent_key": [1, 2, 3], + "other_1": [4, 5, 6], + "other_2": [7, 8, 9] + }) + }) + self.assertEqual( + list(data_[ReferencesService.COUNTRIES_STATES].keys()), + ["country_iso", "other_1", "other_2"] + ) + + ################## + # _merge_batch() # + ################## + + def test__merge_batch_invalid(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, _merge_batch, datasets=123, + parent_column_name="") + self.assertRaises(TypeError, _merge_batch, datasets=dict(), + parent_column_name=123) + + def test__merge_batch_valid(self): + """Test the behaviour for valid data.""" + data_ = _merge_batch( + datasets={ + "service1": { + 'A': pd.DataFrame({}), + 'B': pd.DataFrame({}) + } + }, + parent_column_name="parent_name" + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), ["service1"]) + self.assertIsInstance(data_["service1"], pd.DataFrame) + self.assertEqual( + list(data_["service1"].keys()), + ["parent_name"] + ) diff --git a/tests/test__general.py b/tests/test__general.py new file mode 100644 index 0000000..800e936 --- /dev/null +++ b/tests/test__general.py @@ -0,0 +1,73 @@ +import os +import unittest +from unittest.mock import patch +import pandas as pd +from dotenv import load_dotenv +from requests import HTTPError + +from eppopynder._core._general import _general, GeneralService + +load_dotenv() + + +class TestGeneral(unittest.TestCase): + + ############## + # _general() # + ############## + + def test__general_types(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, _general, api_key=123, services=list()) + self.assertRaises(TypeError, _general, api_key='', services=123) + + @patch("eppopynder._utils._requests._fetch_service") + def test__general_output(self, mock_fetch_service): + """Test the output dict structure.""" + mock_fetch_service.return_value = pd.DataFrame() + services_ = [GeneralService.STATUS] + data_ = _general( + api_key="EPPO_API_KEY", + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[GeneralService.STATUS], pd.DataFrame) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__general_output_online(self): + """Test the output dict structure.""" + services_ = [GeneralService.STATUS] + data_ = _general( + api_key=os.getenv("EPPO_API_KEY"), + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[GeneralService.STATUS], pd.DataFrame) + + def test__general_invalid_service(self): + """Test the behaviour for invalid services.""" + self.assertRaises(TypeError, _general, + api_key="EPPO_API_KEY", + services=["badService"]) + + @patch("eppopynder._utils._requests._fetch_service") + def test__general_invalid_key(self, mock_fetch_service): + """Test the behaviour for invalid API keys.""" + mock_fetch_service.side_effect = HTTPError + self.assertRaises(HTTPError, _general, api_key="BAD_API_KEY") + mock_fetch_service.side_effect = TypeError + self.assertRaises(TypeError, _general, api_key=None) + + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__general_invalid_key_online(self): + """Test the behaviour for invalid API keys.""" + self.assertRaises(HTTPError, _general, api_key="BAD_API_KEY") + self.assertRaises(TypeError, _general, + api_key=os.getenv("BAD_API_KEY")) diff --git a/tests/test__references.py b/tests/test__references.py new file mode 100644 index 0000000..3ff5c38 --- /dev/null +++ b/tests/test__references.py @@ -0,0 +1,73 @@ +import os +import unittest +from unittest.mock import patch +import pandas as pd +from dotenv import load_dotenv +from requests import HTTPError + +from eppopynder._core._references import _references, ReferencesService + +load_dotenv() + + +class TestGeneral(unittest.TestCase): + + ################# + # _references() # + ################# + + def test__references_types(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, _references, api_key=123, services=list()) + self.assertRaises(TypeError, _references, api_key='', services=123) + + @patch("eppopynder._utils._requests._fetch_service") + def test__references_output(self, mock_fetch_service): + """Test the output dict structure.""" + mock_fetch_service.return_value = pd.DataFrame() + services_ = [ReferencesService.Q_LIST] + data_ = _references( + api_key="EPPO_API_KEY", + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[ReferencesService.Q_LIST], pd.DataFrame) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__references_output_online(self): + """Test the output dict structure.""" + services_ = [ReferencesService.Q_LIST] + data_ = _references( + api_key=os.getenv("EPPO_API_KEY"), + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[ReferencesService.Q_LIST], pd.DataFrame) + + def test__references_invalid_service(self): + """Test the behaviour for invalid services.""" + self.assertRaises(TypeError, _references, + api_key="EPPO_API_KEY", + services=["badService"]) + + @patch("eppopynder._utils._requests._fetch_service") + def test__references_invalid_key(self, mock_fetch_service): + """Test the behaviour for invalid API keys.""" + mock_fetch_service.side_effect = HTTPError + self.assertRaises(HTTPError, _references, api_key="BAD_API_KEY") + mock_fetch_service.side_effect = TypeError + self.assertRaises(TypeError, _references, api_key=None) + + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__references_invalid_key_online(self): + """Test the behaviour for invalid API keys.""" + self.assertRaises(HTTPError, _references, api_key="BAD_API_KEY") + self.assertRaises(TypeError, _references, + api_key=os.getenv("BAD_API_KEY")) diff --git a/tests/test__reporting_service.py b/tests/test__reporting_service.py new file mode 100644 index 0000000..eb88dc5 --- /dev/null +++ b/tests/test__reporting_service.py @@ -0,0 +1,110 @@ +import os +import unittest +from unittest.mock import patch +import pandas as pd +from dotenv import load_dotenv +from requests import HTTPError + +from eppopynder._core._reporting_service import (_reporting_service, + ReportingServiceService) + +load_dotenv() + + +class TestReportingService(unittest.TestCase): + + ######################## + # _reporting_service() # + ######################## + + def test__reporting_service_types(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, _reporting_service, api_key=123, + services=list(), params=dict()) + self.assertRaises(TypeError, _reporting_service, api_key='', + services=123, params=dict()) + self.assertRaises(TypeError, _reporting_service, api_key='', + services=list(), params=123) + + @patch("eppopynder._utils._requests._fetch_service") + def test__reporting_service_output(self, mock_fetch_service): + """Test the output dict structure.""" + mock_fetch_service.return_value = pd.DataFrame() + services_ = [ReportingServiceService.LIST] + data_ = _reporting_service( + api_key="EPPO_API_KEY", + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance( + data_[ReportingServiceService.LIST], + pd.DataFrame + ) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__reporting_service_output_online(self): + """Test the output dict structure.""" + services_ = [ReportingServiceService.LIST] + data_ = _reporting_service( + api_key=os.getenv("EPPO_API_KEY"), + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance( + data_[ReportingServiceService.LIST], + pd.DataFrame + ) + + @patch("eppopynder._utils._requests._fetch_service") + def test__reporting_service_invalid_param(self, mock_fetch_service): + """Test the behaviour for invalid request parameters.""" + mock_fetch_service.side_effect = ValueError + self.assertRaises(ValueError, _reporting_service, + api_key="EPPO_API_KEY", + params={ReportingServiceService.REPORTING: { + "bad_param": 234 + }}) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__reporting_service_invalid_param_online(self): + """Test the behaviour for invalid request parameters.""" + self.assertRaises(ValueError, _reporting_service, + api_key=os.getenv("EPPO_API_KEY"), + params={ReportingServiceService.REPORTING: { + "bad_param": 234 + }}) + + def test__reporting_service_invalid_service(self): + """Test the behaviour for invalid services.""" + self.assertRaises(TypeError, _reporting_service, + api_key="EPPO_API_KEY", + services=["badService"]) + + @patch("eppopynder._utils._requests._fetch_service") + def test__reporting_service_invalid_key(self, mock_fetch_service): + """Test the behaviour for invalid API keys.""" + mock_fetch_service.side_effect = HTTPError + self.assertRaises(HTTPError, _reporting_service, api_key="BAD_API_KEY", + services=[ReportingServiceService.LIST]) + mock_fetch_service.side_effect = TypeError + self.assertRaises(TypeError, _reporting_service, api_key=None, + services=[ReportingServiceService.LIST]) + + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__reporting_service_invalid_key_online(self): + """Test the behaviour for invalid API keys.""" + self.assertRaises(HTTPError, _reporting_service, api_key="BAD_API_KEY", + services=[ReportingServiceService.LIST]) + self.assertRaises(TypeError, _reporting_service, + api_key=os.getenv("BAD_API_KEY"), + services=[ReportingServiceService.LIST]) diff --git a/tests/test__requests.py b/tests/test__requests.py new file mode 100644 index 0000000..6b2fcc6 --- /dev/null +++ b/tests/test__requests.py @@ -0,0 +1,403 @@ +import os +import json +import unittest +from unittest.mock import patch +import pandas as pd +import requests.exceptions +from dotenv import load_dotenv +from json import JSONDecodeError +from requests import Response, HTTPError + +from eppopynder._utils._requests import (_build_endpoint, _perform_request, + _handle_http_errors, _parse_response, + _enrich_response, _query, + _fetch_service, + _build_reporting_service_path) + +load_dotenv() + + +class TestRequests(unittest.TestCase): + + ##################### + # _build_endpoint() # + ##################### + + def test__build_endpoint_types(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(TypeError, _build_endpoint, base_path=123, code='', + service='') + self.assertRaises(ValueError, _build_endpoint, base_path="general", + code='', service='') + self.assertRaises(TypeError, _build_endpoint, base_path="/general", + code=123, service='') + self.assertRaises(TypeError, _build_endpoint, base_path="/general", + code='', service=123) + + def test__build_endpoint_output1(self): + """Test the behaviour if only the base path is given.""" + self.assertEqual( + _build_endpoint(base_path="/taxons/taxon"), + "/taxons/taxon" + ) + + def test__build_endpoint_output2(self): + """Test the behaviour if a resource identifier is given.""" + self.assertEqual( + _build_endpoint(base_path="/taxon/taxon", code="BEMITA"), + "/taxon/taxon/BEMITA" + ) + + def test__build_endpoint_output3(self): + """Test the behaviour if a service is given.""" + self.assertEqual( + _build_endpoint( + base_path="/country", + code="FR", + service="overview" + ), + "/country/FR/overview" + ) + + def test__build_endpoint_output4(self): + """Test the behaviour if no resource identifier is given.""" + self.assertEqual( + _build_endpoint(base_path="/reportings", service="list"), + "/reportings/list" + ) + + ################################### + # _build_reporting_service_path() # + ################################### + + def test__build_reporting_service_path_types(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(TypeError, _build_reporting_service_path, + service=123, params=dict()) + self.assertRaises(TypeError, _build_reporting_service_path, service='', + params=123) + + def test__build_reporting_service_path_output1(self): + """Test the behaviour for valid parameters.""" + self.assertEqual( + _build_reporting_service_path( + service="reporting", + params={"reporting_id": 234}), + "reporting/234" + ) + self.assertEqual( + _build_reporting_service_path( + service="article", + params={"article_id": 234}), + "article/234" + ) + + def test__build_reporting_service_path_output3(self): + """Test the behaviour for services without parameters.""" + self.assertEqual( + _build_reporting_service_path( + service="list", + params=dict()), + "list" + ) + + def test__build_reporting_service_path_invalid(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(ValueError, _build_reporting_service_path, + service="reporting", params={'a': 10}) + self.assertRaises(ValueError, _build_reporting_service_path, + service="article", params={'a': 234}) + + ###################### + # _perform_request() # + ###################### + + def test__perform_request_types(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(TypeError, _perform_request, url=123, api_key='', + params=None) + self.assertRaises(TypeError, _perform_request, + url="https://example.org", api_key=123, + params=None) + self.assertRaises(TypeError, _perform_request, + url="https://example.org", api_key='', params=123) + + @patch("eppopynder._utils._requests.requests.get") + def test__perform_request_malformed(self, mock_get): + """Test the behaviour for malformed requests.""" + mock_get.side_effect = requests.exceptions.ConnectionError + self.assertRaises(Exception, _perform_request, + url="https://invalid-domain", api_key="EPPO_API_KEY") + + # This test performs real requests. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__perform_request_malformed_online(self): + """Test the behaviour for malformed requests.""" + self.assertRaises(Exception, _perform_request, + url="https://invalid-domain", api_key="EPPO_API_KEY") + + @patch("eppopynder._utils._requests.requests.get") + def test__perform_request_output(self, mock_get): + """Test the output type of the request.""" + mock_get.return_value = Response() + response_ = _perform_request( + url="https://api.eppo.int/gd/v2/taxons/taxon/BEMITA/overview", + api_key="EPPO_API_KEY" + ) + self.assertIsInstance(response_, Response) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__perform_request_output_online(self): + """Test the output type of the request.""" + response_ = _perform_request( + url="https://api.eppo.int/gd/v2/taxons/taxon/BEMITA/overview", + api_key=os.getenv("EPPO_API_KEY") + ) + self.assertIsInstance(response_, Response) + + ######################### + # _handle_http_errors() # + ######################### + + def test__handle_http_errors_types(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(TypeError, _handle_http_errors, response=123) + + def test__handle_http_errors_valid(self): + """Test the behaviour for status code 200.""" + response_ = Response() + response_.status_code = 200 + response_.url = "https://api.eppo.int/gd/v2/status" + response_.method = "GET" + response_.headers["Content-Type"] = "application/json" + response_._content = (json.dumps({"data": "Custom data"}) + .encode("utf-8")) + self.assertIsNone(_handle_http_errors(response=response_)) + + def test__handle_http_errors_handled(self): + """Test the behaviour for handled status codes.""" + response_ = Response() + response_.status_code = 403 + response_.url = "https://api.eppo.int/gd/v2/status" + response_.method = "GET" + response_.headers["Content-Type"] = "application/json" + response_._content = (json.dumps({"error": "Custom message"}) + .encode("utf-8")) + self.assertRaises(HTTPError, _handle_http_errors, response=response_) + + def test__handle_http_errors_handled_invalid(self): + """Test the behaviour for handled status codes.""" + response_ = Response() + response_.status_code = 403 + response_.url = "https://api.eppo.int/gd/v2/status" + response_.method = "GET" + response_.headers["Content-Type"] = "text/html" + response_._content = "content".encode("utf-8") + self.assertRaises( + HTTPError, + _handle_http_errors, + response=response_ + ) + + def test__handle_http_errors_invalid(self): + """Test the behaviour for bad status codes.""" + response_ = Response() + response_.status_code = 502 + response_.url = "https://api.eppo.int/gd/v2/status" + response_.method = "GET" + self.assertRaises(HTTPError, _handle_http_errors, response=response_) + + ##################### + # _parse_response() # + ##################### + + def test__parse_response_types(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(TypeError, _parse_response, response=123) + + def test__parse_response_valid(self): + """Test the behaviour for valid parameters and data.""" + response_ = Response() + response_.status_code = 200 + response_.url = "https://api.eppo.int/gd/v2/status" + response_.method = "GET" + response_.headers["Content-Type"] = "application/json" + response_._content = (json.dumps({"data": "Custom data"}) + .encode("utf-8")) + self.assertIsInstance( + _parse_response(response=response_), + pd.DataFrame + ) + + def test__parse_response_invalid(self): + """Test the behaviour for invalid body data.""" + response_ = Response() + response_.status_code = 200 + response_.url = "https://api.eppo.int/gd/v2/status" + response_.method = "GET" + response_.headers["Content-Type"] = "text/html" + response_._content = "content".encode("utf-8") + self.assertRaises( + JSONDecodeError, + _parse_response, + response=response_ + ) + + ###################### + # _enrich_response() # + ###################### + + def test__enrich_response_types(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(TypeError, _enrich_response, response_data=123, + url='') + self.assertRaises(TypeError, _enrich_response, + response_data=pd.DataFrame(), url=123) + + def test__enrich_response_valid(self): + """Test the behaviour for valid parameters.""" + data_ = _enrich_response( + response_data=pd.DataFrame({"data": ["Custom data"]}), + url="https://example.org" + ) + self.assertTrue("queried_on" in data_) + self.assertTrue("queried_url" in data_) + self.assertEqual(data_["queried_url"].iloc[0], + "https://example.org") + + ############ + # _query() # + ############ + + def test__query_types(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(TypeError, _query, endpoint=123, api_key='', + params=dict()) + self.assertRaises(ValueError, _query, endpoint="general", api_key='', + params=dict()) + self.assertRaises(TypeError, _query, endpoint="/general", api_key=123, + params=dict()) + self.assertRaises(TypeError, _query, endpoint="/general", api_key='', + params=123) + + @patch("eppopynder._utils._requests._perform_request") + def test__query_wrong_endpoint(self, mock_perform_request): + """Test the behaviour if a bad endpoint is given.""" + mock_perform_request.side_effect = HTTPError + self.assertRaises(HTTPError, _query, + endpoint="/taxons/taxon/BEMITA/badService", + api_key="EPPO_API_KEY") + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__query_wrong_endpoint_online(self): + """Test the behaviour if a bad endpoint is given.""" + self.assertRaises(HTTPError, _query, + endpoint="/taxons/taxon/BEMITA/badService", + api_key=os.getenv("EPPO_API_KEY")) + + @patch("eppopynder._utils._requests._perform_request") + def test__query_wrong_api_key(self, mock_perform_request): + """Test the behaviour if a bad API key is given.""" + mock_perform_request.side_effect = HTTPError + self.assertRaises(HTTPError, _query, + endpoint="/taxons/taxon/BEMITA/overview", + api_key="BAD_API_KEY") + + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__query_wrong_api_key_online(self): + """Test the behaviour if a bad API key is given.""" + self.assertRaises(HTTPError, _query, + endpoint="/taxons/taxon/BEMITA/overview", + api_key="BAD_API_KEY") + + @patch("eppopynder._utils._requests._perform_request") + def test__query_valid(self, mock_perform_request): + """Test the behaviour for valid parameters.""" + response_ = Response() + response_.status_code = 200 + response_.url = "https://api.eppo.int/gd/v2/status" + response_.method = "GET" + response_.headers["Content-Type"] = "application/json" + response_._content = (json.dumps({"data": "Custom data"}) + .encode("utf-8")) + mock_perform_request.return_value = response_ + self.assertIsInstance( + _query( + endpoint="/status", + api_key="EPPO_API_KEY" + ), + pd.DataFrame + ) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__query_valid_online(self): + """Test the behaviour for valid parameters.""" + self.assertIsInstance( + _query( + endpoint="/taxons/taxon/BEMITA/overview", + api_key=os.getenv("EPPO_API_KEY") + ), + pd.DataFrame + ) + + #################### + # _fetch_service() # + #################### + + def test__fetch_service_types(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(TypeError, _fetch_service, base_path=123, api_key='', + code='', service='', params=dict()) + self.assertRaises(ValueError, _fetch_service, base_path="taxons/taxon", + api_key='', code='', service='', params=dict()) + self.assertRaises(TypeError, _fetch_service, base_path="/taxons/taxon", + api_key=123, code='', service='', params=dict()) + self.assertRaises(TypeError, _fetch_service, base_path="/taxons/taxon", + api_key='', code=123, service='', params=dict()) + self.assertRaises(TypeError, _fetch_service, base_path="/taxons/taxon", + api_key='', code='', service=123, params=dict()) + self.assertRaises(TypeError, _fetch_service, base_path="/taxons/taxon", + api_key='', code='', service='', params=123 + ) + + @patch("eppopynder._utils._requests._query") + def test__fetch_service_output(self, mock_query): + """Test the output type for valid parameters.""" + mock_query.return_value = pd.DataFrame({'a': [1]}) + self.assertIsInstance( + _fetch_service( + base_path="/taxons/taxon", + api_key="EPPO_API_KEY", + code="BEMITA", + service="overview" + ), + pd.DataFrame + ) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__fetch_service_output_online(self): + """Test the output type for valid parameters.""" + self.assertIsInstance( + _fetch_service( + base_path="/taxons/taxon", + api_key=os.getenv("EPPO_API_KEY"), + code="BEMITA", + service="overview" + ), + pd.DataFrame + ) diff --git a/tests/test__rppo.py b/tests/test__rppo.py new file mode 100644 index 0000000..654e13e --- /dev/null +++ b/tests/test__rppo.py @@ -0,0 +1,101 @@ +import os +import unittest +from unittest.mock import patch +import pandas as pd +from dotenv import load_dotenv +from requests import HTTPError + +from eppopynder._core._rppo import _rppo, RPPOService + +load_dotenv() + + +class TestRPPO(unittest.TestCase): + + ########### + # _rppo() # + ########### + + def test__rppo_types(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, _rppo, api_key=123, rppo_codes=[''], + services=list()) + self.assertRaises(TypeError, _rppo, api_key='', rppo_codes=123, + services=123) + self.assertRaises(TypeError, _rppo, api_key='', rppo_codes=[1, 2], + services=list()) + self.assertRaises(TypeError, _rppo, api_key='', rppo_codes=[''], + services=123) + self.assertRaises(TypeError, _rppo, api_key='', rppo_codes=[''], + services=[1, 2]) + + @patch("eppopynder._utils._requests._fetch_service") + def test__rppo_output(self, mock_fetch_service): + """Test the output dict structure.""" + mock_fetch_service.return_value = pd.DataFrame() + services_ = [RPPOService.OVERVIEW] + data_ = _rppo( + api_key="EPPO_API_KEY", + rppo_codes=["9A"], + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[RPPOService.OVERVIEW], pd.DataFrame) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__rppo_output_online(self): + """Test the output dict structure.""" + services_ = [RPPOService.OVERVIEW] + data_ = _rppo( + api_key=os.getenv("EPPO_API_KEY"), + rppo_codes=["9A"], + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[RPPOService.OVERVIEW], pd.DataFrame) + + @patch("eppopynder._utils._requests._fetch_service") + def test__rppo_invalid_rppo(self, mock_fetch_service): + """Test the behaviour for invalid RPPO codes.""" + mock_fetch_service.side_effect = HTTPError + self.assertRaises(HTTPError, _rppo, api_key="EPPO_API_KEY", + rppo_codes=["BAD_RPPO_CODE"]) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__rppo_invalid_rppo_online(self): + """Test the behaviour for invalid RPPO codes.""" + self.assertRaises(HTTPError, _rppo, + api_key=os.getenv("EPPO_API_KEY"), + rppo_codes=["BAD_RPPO_CODE"]) + + def test__rppo_invalid_service(self): + """Test the behaviour for invalid services.""" + self.assertRaises(TypeError, _rppo, api_key="EPPO_API_KEY", + rppo_codes=["9A"], services=["badService"]) + + @patch("eppopynder._utils._requests._fetch_service") + def test__rppo_invalid_key(self, mock_fetch_service): + """Test the behaviour for invalid API keys.""" + mock_fetch_service.side_effect = HTTPError + self.assertRaises(HTTPError, _rppo, api_key="BAD_API_KEY", + rppo_codes=["9A"]) + mock_fetch_service.side_effect = TypeError + self.assertRaises(TypeError, _rppo, api_key=None, rppo_codes=["9A"]) + + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__rppo_invalid_key_online(self): + """Test the behaviour for invalid API keys.""" + self.assertRaises(HTTPError, _rppo, api_key="BAD_API_KEY", + rppo_codes=["9A"]) + self.assertRaises(TypeError, _rppo, + api_key=os.getenv("BAD_API_KEY"), rppo_codes=["9A"]) diff --git a/tests/test__taxon.py b/tests/test__taxon.py new file mode 100644 index 0000000..6478f53 --- /dev/null +++ b/tests/test__taxon.py @@ -0,0 +1,101 @@ +import os +import unittest +from unittest.mock import patch +import pandas as pd +from dotenv import load_dotenv +from requests import HTTPError + +from eppopynder._core._taxon import _taxon, TaxonService + +load_dotenv() + + +class TestTaxon(unittest.TestCase): + + ############# + # _taxon() # + ############# + + def test__taxon_types(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, _taxon, api_key=123, eppo_codes=[''], + services=list()) + self.assertRaises(TypeError, _taxon, api_key='', eppo_codes=123, + services=123) + self.assertRaises(TypeError, _taxon, api_key='', eppo_codes=[1, 2], + services=list()) + self.assertRaises(TypeError, _taxon, api_key='', eppo_codes=[''], + services=123) + self.assertRaises(TypeError, _taxon, api_key='', eppo_codes=[''], + services=[1, 2]) + + @patch("eppopynder._utils._requests._fetch_service") + def test__taxon_output(self, mock_fetch_service): + """Test the output dict structure.""" + mock_fetch_service.return_value = pd.DataFrame() + services_ = [TaxonService.OVERVIEW] + data_ = _taxon( + api_key="EPPO_API_KEY", + eppo_codes=["BEMITA"], + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[TaxonService.OVERVIEW], pd.DataFrame) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__taxon_output_online(self): + """Test the output dict structure.""" + services_ = [TaxonService.OVERVIEW] + data_ = _taxon( + api_key=os.getenv("EPPO_API_KEY"), + eppo_codes=["BEMITA"], + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[TaxonService.OVERVIEW], pd.DataFrame) + + @patch("eppopynder._utils._requests._fetch_service") + def test__taxon_invalid_eppo(self, mock_fetch_service): + """Test the behaviour for invalid EPPO codes.""" + mock_fetch_service.side_effect = HTTPError + self.assertRaises(HTTPError, _taxon, api_key="EPPO_API_KEY", + eppo_codes=["BAD_EPPO_CODE"]) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__taxon_invalid_eppo_online(self): + """Test the behaviour for invalid EPPO codes.""" + self.assertRaises(HTTPError, _taxon, api_key=os.getenv("EPPO_API_KEY"), + eppo_codes=["BAD_EPPO_CODE"]) + + def test__taxon_invalid_service(self): + """Test the behaviour for invalid services.""" + self.assertRaises(TypeError, _taxon, api_key="EPPO_API_KEY", + eppo_codes=["BEMITA"], services=["badService"]) + + @patch("eppopynder._utils._requests._fetch_service") + def test__taxons_invalid_key(self, mock_fetch_service): + """Test the behaviour for invalid API keys.""" + mock_fetch_service.side_effect = HTTPError + self.assertRaises(HTTPError, _taxon, api_key="BAD_API_KEY", + eppo_codes=["BEMITA"]) + mock_fetch_service.side_effect = TypeError + self.assertRaises(TypeError, _taxon, api_key=None, + eppo_codes=["BEMITA"]) + + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__taxons_invalid_key_online(self): + """Test the behaviour for invalid API keys.""" + self.assertRaises(HTTPError, _taxon, api_key="BAD_API_KEY", + eppo_codes=["BEMITA"]) + self.assertRaises(TypeError, _taxon, api_key=os.getenv("BAD_API_KEY"), + eppo_codes=["BEMITA"]) diff --git a/tests/test__taxons.py b/tests/test__taxons.py new file mode 100644 index 0000000..9505cf0 --- /dev/null +++ b/tests/test__taxons.py @@ -0,0 +1,76 @@ +import os +import unittest +from unittest.mock import patch +import pandas as pd +from dotenv import load_dotenv +from requests import HTTPError + +from eppopynder._core._taxons import _taxons, TaxonsService + +load_dotenv() + + +class TestTaxons(unittest.TestCase): + + ############# + # _taxons() # + ############# + + def test__taxons_types(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, _taxons, api_key=123, services=list(), + params=dict()) + self.assertRaises(TypeError, _taxons, api_key='', services=123, + params=dict()) + self.assertRaises(TypeError, _taxons, api_key='', services=list(), + params=123) + + @patch("eppopynder._utils._requests._fetch_service") + def test__taxons_output(self, mock_fetch_service): + """Test the output dict structure.""" + mock_fetch_service.return_value = pd.DataFrame() + services_ = [TaxonsService.LIST] + data_ = _taxons( + api_key="EPPO_API_KEY", + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[TaxonsService.LIST], pd.DataFrame) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__taxons_output_online(self): + """Test the output dict structure.""" + services_ = [TaxonsService.LIST] + data_ = _taxons( + api_key=os.getenv("EPPO_API_KEY"), + services=services_ + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[TaxonsService.LIST], pd.DataFrame) + + def test__taxons_invalid_service(self): + """Test the behaviour for invalid services.""" + self.assertRaises(TypeError, _taxons, + api_key="EPPO_API_KEY", + services=["badService"]) + + @patch("eppopynder._utils._requests._fetch_service") + def test__taxons_invalid_key(self, mock_fetch_service): + """Test the behaviour for invalid API keys.""" + mock_fetch_service.side_effect = HTTPError + self.assertRaises(HTTPError, _taxons, api_key="BAD_API_KEY") + mock_fetch_service.side_effect = TypeError + self.assertRaises(TypeError, _taxons, api_key=None) + + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__taxons_invalid_key_online(self): + """Test the behaviour for invalid API keys.""" + self.assertRaises(HTTPError, _taxons, api_key="BAD_API_KEY") + self.assertRaises(TypeError, _taxons, api_key=os.getenv("BAD_API_KEY")) diff --git a/tests/test__tools.py b/tests/test__tools.py new file mode 100644 index 0000000..40a775a --- /dev/null +++ b/tests/test__tools.py @@ -0,0 +1,98 @@ +import os +import unittest +from unittest.mock import patch +import pandas as pd +from dotenv import load_dotenv +from requests import HTTPError + +from eppopynder._core._tools import _tools, ToolsService + +load_dotenv() + + +class TestTools(unittest.TestCase): + + ############ + # _tools() # + ############ + + def test__tools_types(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, _tools, api_key=123, services=list(), + params=dict()) + self.assertRaises(TypeError, _tools, api_key='', services=123, + params=dict()) + self.assertRaises(TypeError, _tools, api_key='', services=list(), + params=123) + + @patch("eppopynder._utils._requests._fetch_service") + def test__tools_output(self, mock_fetch_service): + """Test the output dict structure.""" + mock_fetch_service.return_value = pd.DataFrame() + services_ = [ToolsService.NAME2CODES] + data_ = _tools( + api_key="EPPO_API_KEY", + services=services_, + params={ToolsService.NAME2CODES: {"name": "Bemisia tabaci"}} + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[ToolsService.NAME2CODES], pd.DataFrame) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__tools_output_online(self): + """Test the output dict structure.""" + services_ = [ToolsService.NAME2CODES] + data_ = _tools( + api_key=os.getenv("EPPO_API_KEY"), + services=services_, + params={ToolsService.NAME2CODES: {"name": "Bemisia tabaci"}} + ) + self.assertIsInstance(data_, dict) + self.assertEqual(list(data_.keys()), services_) + self.assertIsInstance(data_[ToolsService.NAME2CODES], pd.DataFrame) + + @patch("eppopynder._utils._requests._fetch_service") + def test__tools_invalid_param(self, mock_fetch_service): + """Test the behaviour for invalid parameters.""" + mock_fetch_service.side_effect = HTTPError + self.assertRaises(HTTPError, _tools, api_key="EPPO_API_KEY", + params={"name2codes": {"onlyPreferred": False}}) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__tools_invalid_param_online(self): + """Test the behaviour for invalid parameters.""" + self.assertRaises(HTTPError, _tools, api_key=os.getenv("EPPO_API_KEY"), + params={"name2codes": {"onlyPreferred": False}}) + + def test__tools_invalid_service(self): + """Test the behaviour for invalid services.""" + self.assertRaises(TypeError, _tools, api_key="EPPO_API_KEY", + services=["badService"]) + + @patch("eppopynder._utils._requests._fetch_service") + def test__tools_invalid_key(self, mock_fetch_service): + """Test the behaviour for invalid API keys.""" + params_ = {"name2codes": {"name": "Bemisia tabaci"}} + mock_fetch_service.side_effect = HTTPError + self.assertRaises(HTTPError, _tools, api_key="BAD_API_KEY", + params=params_) + mock_fetch_service.side_effect = TypeError + self.assertRaises(TypeError, _tools, api_key=None, params=params_) + + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test__tools_invalid_key_online(self): + """Test the behaviour for invalid API keys.""" + params_ = {"name2codes": {"name": "Bemisia tabaci"}} + self.assertRaises(HTTPError, _tools, api_key="BAD_API_KEY", + params=params_) + self.assertRaises(TypeError, _tools, api_key=os.getenv("BAD_API_KEY"), + params=params_) diff --git a/tests/test_api_query.py b/tests/test_api_query.py deleted file mode 100644 index 77b7404..0000000 --- a/tests/test_api_query.py +++ /dev/null @@ -1,37 +0,0 @@ -import unittest -from unittest.mock import patch, MagicMock -import pandas as pd -import requests -from datetime import date -from eppoPynder.api_query import api_query - -class TestApiQuery(unittest.TestCase): - - def test_if_wrong_service_is_requested_standard_df_returned(self): - """Test successful API response""" - result = api_query("BEMITA", "https://data.eppo.int/api/rest/1.0/taxon/BEMITA?authtoken=token") - self.assertIn('queried_url', result.columns) - self.assertEqual(result.iloc[0,0], 'BEMITA') - - @patch('builtins.print') - @patch('requests.get') - def test_missing_schema_print(self, mock_get, mock_print): - mock_get.side_effect = requests.exceptions.InvalidURL() - api_query("BEMITA", "https://data.eppo.int/api/rest/1.0/taxon/BEMITA?authtoken=token ") - mock_print.assert_called_once_with('') - - @patch('requests.get') - def test_successful_json_processing(self, mock_get): - # Setup mock response - mock_response = MagicMock() - mock_response.json.return_value = {"name": "Test Name", "nested": [{"value": 1}, {"value": 2}]} - mock_get.return_value = mock_response - - # Call function - result = api_query("BEMITA", "https://data.eppo.int/api/rest/1.0/taxon/BEMITA?authtoken=token") - - # Verify json() was called and DataFrame was created - mock_response.json.assert_called_once() - assert len(result) > 0 - assert 'name' in result.columns - assert result.iloc[0]['name'] == "Test Name" diff --git a/tests/test_client.py b/tests/test_client.py new file mode 100644 index 0000000..6696c68 --- /dev/null +++ b/tests/test_client.py @@ -0,0 +1,251 @@ +import os +import unittest +from unittest.mock import patch +from dotenv import load_dotenv + +from eppopynder.client import Client +from eppopynder._core._general import GeneralService +from eppopynder._core._taxons import TaxonsService +from eppopynder._core._taxon import TaxonService +from eppopynder._core._country import CountryService +from eppopynder._core._rppo import RPPOService +from eppopynder._core._tools import ToolsService +from eppopynder._core._reporting_service import ReportingServiceService +from eppopynder._core._references import ReferencesService + +load_dotenv() + + +class TestClient(unittest.TestCase): + + ############## + # __init__() # + ############## + + def test___init___types(self): + """Test the behaviour for invalid data.""" + self.assertRaises(TypeError, Client, api_key=123) + self.assertRaises(ValueError, Client, api_key='') + + def test___init___invalid_key(self): + """Test that ValueError is raised when EPPO_API_KEY is not set.""" + with patch.dict(os.environ, {}, clear=True): + with patch("eppopynder.client.load_dotenv"): + self.assertRaises(ValueError, Client) + + def test___init__1(self): + """Test the correct creation of the object.""" + with patch.dict(os.environ, { + "EPPO_API_KEY": "EPPO_API_KEY", + }, clear=True): + with patch("eppopynder.client.load_dotenv"): + self.assertIsInstance(Client(api_key="EPPO_API_KEY"), Client) + + # This test requires the EPPO_API_KEY environment variable to be set. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test___init__1_online(self): + """Test the correct creation of the object.""" + self.assertIsInstance(Client(), Client) + + def test___init__2(self): + """Test the correct creation of the object.""" + self.assertIsInstance(Client(api_key="EPPO_API_KEY"), Client) + + ############# + # general() # + ############# + + @patch("eppopynder._core._general._general") + def test_general(self, mock_general): + """Test the General endpoint.""" + mock_general.return_value = {} + client_ = Client(api_key="EPPO_API_KEY") + services_ = [GeneralService.STATUS] + data_ = client_.general(services=services_) + self.assertIsInstance(data_, dict) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test_general_online(self): + """Test the General endpoint.""" + client_ = Client() + services_ = [GeneralService.STATUS] + data_ = client_.general(services=services_) + self.assertIsInstance(data_, dict) + + ############ + # taxons() # + ############ + + @patch("eppopynder._core._taxons._taxons") + def test_taxons(self, mock_taxons): + """Test the Taxons endpoint.""" + mock_taxons.return_value = {} + client_ = Client(api_key="EPPO_API_KEY") + services_ = [TaxonsService.LIST] + data_ = client_.taxons(services=services_) + self.assertIsInstance(data_, dict) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test_taxons_online(self): + """Test the Taxons endpoint.""" + client_ = Client() + services_ = [TaxonsService.LIST] + data_ = client_.taxons(services=services_) + self.assertIsInstance(data_, dict) + + ########### + # taxon() # + ########### + + @patch("eppopynder._core._taxon._taxon") + def test_taxon(self, mock_taxon): + """Test the Taxon endpoint.""" + mock_taxon.return_value = {} + client_ = Client(api_key="EPPO_API_KEY") + services_ = [TaxonService.OVERVIEW] + data_ = client_.taxon(eppo_codes=["BEMITA"], services=services_) + self.assertIsInstance(data_, dict) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test_taxon_online(self): + """Test the Taxon endpoint.""" + client_ = Client() + services_ = [TaxonService.OVERVIEW] + data_ = client_.taxon(eppo_codes=["BEMITA"], services=services_) + self.assertIsInstance(data_, dict) + + ############# + # country() # + ############# + + @patch("eppopynder._core._country._country") + def test_country(self, mock_country): + """Test the Country endpoint.""" + mock_country.return_value = {} + client_ = Client(api_key="EPPO_API_KEY") + services_ = [CountryService.OVERVIEW] + data_ = client_.country(iso_codes=["FR"], services=services_) + self.assertIsInstance(data_, dict) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test_country_online(self): + """Test the Country endpoint.""" + client_ = Client() + services_ = [CountryService.OVERVIEW] + data_ = client_.country(iso_codes=["FR"], services=services_) + self.assertIsInstance(data_, dict) + + ########## + # rppo() # + ########## + + @patch("eppopynder._core._rppo._rppo") + def test_rppo(self, mock_rppo): + """Test the RPPO endpoint.""" + mock_rppo.return_value = {} + client_ = Client(api_key="EPPO_API_KEY") + services_ = [RPPOService.OVERVIEW] + data_ = client_.rppo(rppo_codes=["9A"], services=services_) + self.assertIsInstance(data_, dict) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test_rppo_online(self): + """Test the RPPO endpoint.""" + client_ = Client() + services_ = [RPPOService.OVERVIEW] + data_ = client_.rppo(rppo_codes=["9A"], services=services_) + self.assertIsInstance(data_, dict) + + ########### + # tools() # + ########### + + @patch("eppopynder._core._tools._tools") + def test_tools(self, mock_tools): + """Test the Tools endpoint.""" + mock_tools.return_value = {} + client_ = Client(api_key="EPPO_API_KEY") + services_ = [ToolsService.NAME2CODES] + data_ = client_.tools( + services=services_, + params={ToolsService.NAME2CODES: {"name": "Bemisia tabaci"}} + ) + self.assertIsInstance(data_, dict) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test_tools_online(self): + """Test the Tools endpoint.""" + client_ = Client() + services_ = [ToolsService.NAME2CODES] + data_ = client_.tools( + services=services_, + params={ToolsService.NAME2CODES: {"name": "Bemisia tabaci"}} + ) + self.assertIsInstance(data_, dict) + + ####################### + # reporting_service() # + ####################### + + @patch("eppopynder._core._reporting_service._reporting_service") + def test_reporting_service(self, mock_reporting_service): + """Test the Reporting Service endpoint.""" + mock_reporting_service.return_value = {} + client_ = Client(api_key="EPPO_API_KEY") + services_ = [ReportingServiceService.LIST] + data_ = client_.reporting_service(services=services_) + self.assertIsInstance(data_, dict) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test_reporting_service_online(self): + """Test the Reporting Service endpoint.""" + client_ = Client() + services_ = [ReportingServiceService.LIST] + data_ = client_.reporting_service(services=services_) + self.assertIsInstance(data_, dict) + + ################ + # references() # + ################ + + @patch("eppopynder._core._references._references") + def test_references(self, mock_references): + """Test the References endpoint.""" + mock_references.return_value = {} + client_ = Client(api_key="EPPO_API_KEY") + services_ = [ReferencesService.Q_LIST] + data_ = client_.references(services=services_) + self.assertIsInstance(data_, dict) + + # This test requires the EPPO_API_KEY environment variable to be set. + # This test performs real requests to the EPPO API. + @unittest.skipIf(os.getenv("SKIP_ONLINE_TESTS") == "true", + "Skip online tests") + def test_references_online(self): + """Test the References endpoint.""" + client_ = Client() + services_ = [ReferencesService.Q_LIST] + data_ = client_.references(services=services_) + self.assertIsInstance(data_, dict) diff --git a/tests/test_data_dump.py b/tests/test_data_dump.py deleted file mode 100644 index 174b5ba..0000000 --- a/tests/test_data_dump.py +++ /dev/null @@ -1,50 +0,0 @@ -import unittest -from unittest.mock import patch -import pandas as pd -from eppoPynder.data_dump import data_dump - - -class DataDumpEppo(unittest.TestCase): - - def test_data_dump(self): - # Call the function being tested - result = data_dump(["BEMITA", "LEUCSC"]) - - # Ensure the dictionary contains the expected keys - services = ["general", "names", "taxonomy", "categorization", - "hosts", "pests", "kingdom"] - - self.assertTrue( - set(services).issubset(result.keys()), - "The keys in the dictionary do not match the expected services.") - - def test_input_type_validation(self): - with self.assertRaises(AssertionError) as context: - data_dump("not_a_list") - self.assertEqual(str(context.exception), "Input must be a list!") - - with self.assertRaises(AssertionError) as context: - data_dump([]) - self.assertEqual(str(context.exception), "Input list cannot be empty!") - - with self.assertRaises(AssertionError) as context: - data_dump(["BEMITA", 123]) - self.assertEqual(str(context.exception), "All codes must be strings!") - - def test_non_string_token_raises_assertion_error(self): - with self.assertRaisesRegex(AssertionError, "token must be a string!"): - data_dump(["BEMITA"], token=123) - - def test_default_token_assignment(self): - with patch('eppoPynder.data_dump.query_the_eppo_for_service') as mock_query: - # Configure mock to return a DataFrame with required columns - mock_query.return_value = pd.DataFrame({'queried_eppocode': ['BEMITA']}) - - # Call function without a token - result = data_dump(["BEMITA"], token=None) - - # Get the first call to verify token value - first_call = mock_query.call_args_list[0] - - # Verify that default_token was used - self.assertEqual(first_call.kwargs['token'], 'default_token') diff --git a/tests/test_data_wrangling.py b/tests/test_data_wrangling.py new file mode 100644 index 0000000..8d4e483 --- /dev/null +++ b/tests/test_data_wrangling.py @@ -0,0 +1,36 @@ +import unittest +import pandas as pd + +from eppopynder.data_wrangling import uniform_taxonomy + + +class TestDataWrangling(unittest.TestCase): + + ###################### + # uniform_taxonomy() # + ###################### + + def test_uniform_taxonomy_types(self): + """Test if the parameters are of the correct types.""" + self.assertRaises(TypeError, uniform_taxonomy, taxonomy_data=123) + self.assertRaises(ValueError, uniform_taxonomy, + taxonomy_data=pd.DataFrame()) + self.assertRaises(ValueError, uniform_taxonomy, + taxonomy_data=pd.DataFrame({ + "queried_eppo_code": [None], + "type": ["type_a"] + })) + + def test_output(self): + """Test the output for correct parameters.""" + taxonomy_ = pd.DataFrame({ + "queried_eppo_code": ['A', 'A', 'A'], + "eppocode": ['D', 'E', 'F'], + "prefname": ['G', 'H', 'I'], + "level": ['1', '2', '3'], + "type": ['Kingdom', 'Class', 'Order'], + "queried_url": ['M', 'N', 'O'], + "queried_on": ['P', 'Q', 'R'], + }) + self.assertIsInstance(uniform_taxonomy(taxonomy_data=taxonomy_), + pd.DataFrame) diff --git a/tests/test_getting_countries.py b/tests/test_getting_countries.py deleted file mode 100644 index 100b973..0000000 --- a/tests/test_getting_countries.py +++ /dev/null @@ -1,96 +0,0 @@ -import unittest -import numpy as np -from io import StringIO -import sys - -from eppoPynder.getting_countries import getting_countries - -class TestGettingCountries(unittest.TestCase): - - def test_EPPO(self): - """Test if a concatenation of countries corresponding to the acronym 'EPPO' is returned.""" - result = getting_countries("EPPO") - expected = "Albania, Algeria, Austria, Azerbaijan, Belarus, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Georgia, Germany, Greece, Guernsey, Hungary, Ireland, Israel, Italy, Jersey, Jordan, Kazakhstan, Kyrgyzstan, Latvia, Lithuania, Luxembourg, Malta, Moldova, Montenegro, Morocco, Netherlands, North Macedonia, Norway, Poland, Portugal, Romania, Russia, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, Tunisia, Türkiye, Ukraine, United Kingdom, Uzbekistan" - self.assertEqual(result, expected) - - def test_OIRSA(self): - """Test if a concatenation of countries corresponding to the acronym 'OIRSA' is returned.""" - result = getting_countries("OIRSA") - expected = "Belize, Costa Rica, Dominican Republic, El Salvador, Guatemala, Honduras, Mexico, Nicaragua, Panama" - self.assertEqual(result, expected) - - def test_EAEU(self): - """Test if a concatenation of countries corresponding to the acronym 'EAEU' is returned.""" - result = getting_countries("EAEU") - expected = "Armenia, Belarus, Kazakhstan, Kyrgyzstan, Russia" - self.assertEqual(result, expected) - - def test_COSAVE(self): - """Test if a concatenation of countries corresponding to the acronym 'COSAVE' is returned.""" - result = getting_countries("COSAVE") - expected = "Argentina, Bolivia, Brazil, Chile, Paraguay, Peru, Uruguay" - self.assertEqual(result, expected) - - def test_EU(self): - """Test if a concatenation of countries corresponding to the acronym 'EU' is returned.""" - result = getting_countries("EU") - expected = "Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden" - self.assertEqual(result, expected) - - def test_APPPC(self): - """Test if a concatenation of countries corresponding to the acronym 'APPPC' is returned.""" - result = getting_countries("APPPC") - expected = "Australia, Bangladesh, Cambodia, China, East Timor, Fiji, French Polynesia, India, Indonesia, Korea Dem. People's Republic, Korea, Republic, Laos, Malaysia, Myanmar, Nepal, New Zealand, Pakistan, Papua New Guinea, Philippines, Samoa, Solomon Islands, Sri Lanka, Thailand, Tonga, Vietnam" - self.assertEqual(result, expected) - - def test_CAHFSA(self): - """Test if a concatenation of countries corresponding to the acronym 'CAHFSA' is returned.""" - result = getting_countries("CAHFSA") - expected = "Antigua and Barbuda, Bahamas, Barbados, Belize, Dominica, Grenada, Guyana, Haiti, Jamaica, Montserrat, Saint Lucia, St Kitts-Nevis, St Vincent and the Grenadines, Suriname, Trinidad and Tobago" - self.assertEqual(result, expected) - - def test_CAN(self): - """Test if a concatenation of countries corresponding to the acronym 'CAN' is returned.""" - result = getting_countries("CAN") - expected = "Bolivia, Colombia, Ecuador, Peru, Venezuela" - self.assertEqual(result, expected) - - def test_IAPSC(self): - """Test if a concatenation of countries corresponding to the acronym 'IAPSC' is returned.""" - result = getting_countries("IAPSC") - expected = "Algeria, Angola, Benin, Botswana, Burkina Faso, Burundi, Cameroon, Cape Verde, Central African Republic, Chad, Comoros, Congo, Congo, Democratic Republic of the, Cote d'Ivoire, Djibouti, Egypt, Equatorial Guinea, Eritrea, Eswatini, Ethiopia, Gabon, Gambia, Ghana, Guinea, Guinea-Bissau, Kenya, Lesotho, Liberia, Libya, Madagascar, Malawi, Mali, Mauritania, Mauritius, Morocco, Mozambique, Namibia, Niger, Nigeria, Rwanda, Sao Tome & Principe, Senegal, Seychelles, Sierra Leone, Somalia, South Africa, South Sudan, Sudan, Tanzania, Togo, Tunisia, Uganda, Zaire, Zambia, Zimbabwe" - self.assertEqual(result, expected) - - def test_NAPPO(self): - """Test if a concatenation of countries corresponding to the acronym 'NAPPO' is returned.""" - result = getting_countries("NAPPO") - expected = "Canada, Mexico, United States of America" - self.assertEqual(result, expected) - - def test_NEPPO(self): - """Test if a concatenation of countries corresponding to the acronym 'NEPPO' is returned.""" - result = getting_countries("NEPPO") - expected = "Algeria, Egypt, Jordan, Libya, Malta, Morocco, Pakistan, South Sudan, Sudan, Syria, Tunisia" - self.assertEqual(result, expected) - - def test_PPPO(self): - """Test if a concatenation of countries corresponding to the acronym 'PPPO' is returned.""" - result = getting_countries("PPPO") - expected = "American Samoa, Australia, Cook Islands, Fiji, French Polynesia, Guam, Kiribati, Marshall Islands, Micronesia, Nauru, New Caledonia, New Zealand, Niue, Northern Mariana Islands, Palau, Papua New Guinea, Pitcairn, Samoa, Solomon Islands, Tokelau, Tonga, Tuvalu, Vanuatu, Wallis and Futuna Islands" - self.assertEqual(result, expected) - - def test_unknown_acronym(self): - """Test if np.nan and print message are returned for unknown acronyms.""" - # Capture print output - captured_output = StringIO() - sys.stdout = captured_output - - # Test unknown acronym - result = getting_countries("XYZ") - - # Reset stdout - sys.stdout = sys.__stdout__ - - # Verify results - self.assertTrue(np.isnan(result)) - self.assertEqual(captured_output.getvalue().strip(), "Unknown acronym") diff --git a/tests/test_query_the_eppo_for_service.py b/tests/test_query_the_eppo_for_service.py deleted file mode 100644 index 46a7d02..0000000 --- a/tests/test_query_the_eppo_for_service.py +++ /dev/null @@ -1,34 +0,0 @@ -import unittest -from unittest.mock import patch -import pandas as pd - -from eppoPynder.query_the_eppo_for_service import query_the_eppo_for_service - -class TestQueryTheEPPOForService(unittest.TestCase): - - def test_if_code_is_passed_dataframe_is_returned(self): - result = query_the_eppo_for_service("BEMITA") - self.assertTrue(isinstance(result, pd.DataFrame)) - - @patch('eppoPynder.query_the_eppo_for_service') - def test_if_wrong_service_is_requested_standard_df_returned(self, mock_query): - mock_query.return_value = pd.DataFrame(columns=['col1', 'col2', 'col3']) - result = query_the_eppo_for_service("BEMITA", service="wrongservice") - self.assertEqual(result.shape[1], 3) - - def test_default_token_assignment(self): - with patch('eppoPynder.query_the_eppo_for_service.api_query') as mock_api: - # Configure mock to return an empty DataFrame - mock_api.return_value = pd.DataFrame() - - # Call function without a token - result = query_the_eppo_for_service("BEMITA", token=None) - - # Get the call arguments - call_args = mock_api.call_args - - # Extract the queried_url from the kwargs - queried_url = call_args.kwargs['queried_url'] - - # Verify that default_token was used in the URL - self.assertIn('authtoken=default_token', queried_url) diff --git a/tests/test_query_the_whole_eppo.py b/tests/test_query_the_whole_eppo.py deleted file mode 100644 index 8bd762d..0000000 --- a/tests/test_query_the_whole_eppo.py +++ /dev/null @@ -1,37 +0,0 @@ -import unittest -from unittest.mock import patch -import pandas as pd -from eppoPynder.query_the_whole_eppo import query_the_whole_eppo - -class TestQueryTheWholeEPPO(unittest.TestCase): - - def test_getting_7_dataframes_are_returned(self): - result = query_the_whole_eppo('BEMITA') - self.assertEqual(len(result), 7) - - def test_getting_the_right_names(self): - services = ["general", "names", "taxonomy", "categorization", "hosts", "pests", "kingdom"] - result = query_the_whole_eppo('BEMITA') - - self.assertEqual(list(result.keys()), services) - - def test_non_string_token_raises_assertion_error(self): - with self.assertRaisesRegex(AssertionError, "token must be a string!"): - query_the_whole_eppo("BEMITA", token=123) - - def test_default_token_assignment(self): - # Using the full import path for the mock - with patch('eppoPynder.query_the_whole_eppo.query_the_eppo_for_service') as mock_query: - # Configure mock to return an empty DataFrame - mock_query.return_value = pd.DataFrame() - - # Call function without a token - result = query_the_whole_eppo("BEMITA", token=None) - - # Get the first call to verify token value - first_call = mock_query.call_args_list[0] - - # Verify that default_token was used - self.assertEqual(first_call.kwargs['token'], 'default_token') - - \ No newline at end of file diff --git a/tests/test_taxonomy_ranked.py b/tests/test_taxonomy_ranked.py deleted file mode 100644 index 9908852..0000000 --- a/tests/test_taxonomy_ranked.py +++ /dev/null @@ -1,27 +0,0 @@ -import unittest -import pandas as pd -from eppoPynder.taxonomy_ranked import taxonomy_ranked - -class TaxonomyRanked(unittest.TestCase): - def test_taxonomy_ranked_merge_and_transform(self): - # Create test input data - taxonomy = pd.DataFrame({ - 'eppocode': ['CODE1'], - 'queried_eppocode': ['BEMITA'], - 'name': ['Test Species'] - }) - - kingdom = pd.DataFrame({ - 'eppocode': ['CODE1'], - 'queried_eppocode': ['BEMITA'], - 'status': ['Animalia'] - }) - - # Call the function - result = taxonomy_ranked(taxonomy, kingdom) - - # Verify the results - assert 'rank' in result.columns - assert result.columns[0] == 'rank' # Check if rank is first column - assert result.iloc[0]['rank'] == 'kingdom' - assert len(result) == 1 \ No newline at end of file diff --git a/tests/test_unnest_lists.py b/tests/test_unnest_lists.py deleted file mode 100644 index fdd55df..0000000 --- a/tests/test_unnest_lists.py +++ /dev/null @@ -1,70 +0,0 @@ -import unittest - -from eppoPynder.unnest_lists import unnest_lists - -class TestUnnestLists(unittest.TestCase): - - def test_unnest_lists_all_keys_present(self): - # Test when all keys are present and the lists are non-empty - input_data = { - "Major host": ["Host1", "Host2"], - "Host": ["Host3", "Host4"], - "Wild/Weed": ["Host5"], - "Alternate": ["Host6", "Host7"], - "Experimental": ["Host8"], - "Doubtful host": [], - "Non-host": ["Host9"] - } - expected_output = [ - "Host1", "Host2", "Host3", "Host4", "Host5", - "Host6", "Host7", "Host8", "Host9" - ] - result = unnest_lists(input_data) - self.assertEqual(result, expected_output) - - def test_unnest_lists_some_keys_missing(self): - # Test when some keys are missing - input_data = { - "Major host": ["Host1", "Host2"], - "Host": ["Host3"] - } - expected_output = ["Host1", "Host2", "Host3"] - result = unnest_lists(input_data) - self.assertEqual(result, expected_output) - - def test_unnest_lists_non_dict_input(self): - # Test when the input is not a dictionary (edge case) - input_data = ["Some", "List"] - expected_output = ["Some", "List"] - result = unnest_lists(input_data) - self.assertEqual(result, expected_output) - - def test_unnest_lists_with_empty_lists(self): - # Test when input has empty lists for some of the keys - input_data = { - "Major host": ["Host1"], - "Host": [], - "Wild/Weed": [], - "Alternate": [], - "Experimental": [], - "Doubtful host": [], - "Non-host": ["Host2"] - } - expected_output = ["Host1", "Host2"] - result = unnest_lists(input_data) - self.assertEqual(result, expected_output) - - def test_unnest_lists_with_none_values(self): - # Test when the input has None for some values of the lists - input_data = { - "Major host": None, - "Host": ["Host1"], - "Wild/Weed": None, - "Alternate": None, - "Experimental": ["Host2"], - "Doubtful host": None, - "Non-host": ["Host3"] - } - expected_output = ["Host1", "Host2", "Host3"] - result = unnest_lists(input_data) - self.assertEqual(result, expected_output) \ No newline at end of file From 5f749dc5958be9df020a9e4bafc785897a897795 Mon Sep 17 00:00:00 2001 From: Lorenzo Copelli Date: Wed, 8 Apr 2026 11:25:25 +0200 Subject: [PATCH 37/43] Fixed project name. (#2) --- pyproject.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pyproject.toml b/pyproject.toml index 0f7bcf8..1d6c405 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -3,7 +3,7 @@ requires = ["setuptools>=61", "wheel"] build-backend = "setuptools.build_meta" [project] -name = "eppopynder" +name = "eppoPynder" version = "2.0.0" description = "Python interface to the EPPO Database and Public APIs" readme = "README.md" From bc737652c6623efdbeb27f91ed9ebd46acfffe8f Mon Sep 17 00:00:00 2001 From: Lorenzo Copelli Date: Wed, 8 Apr 2026 11:32:40 +0200 Subject: [PATCH 38/43] Added temporary tests. (#3) --- .github/workflows/codecov.yml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.github/workflows/codecov.yml b/.github/workflows/codecov.yml index 204f6df..98390f4 100644 --- a/.github/workflows/codecov.yml +++ b/.github/workflows/codecov.yml @@ -22,6 +22,9 @@ jobs: pip install -r requirements.txt pip install codecov pip install -e . + pip list + python -c "import sys; print(sys.path)" + python -c "import eppopynder; print(eppopynder.__file__)" - name: Run tests with coverage env: From de14bbc7cff94465f4ccc2ede6518fa30a33c843 Mon Sep 17 00:00:00 2001 From: Lorenzo Copelli Date: Wed, 8 Apr 2026 11:51:23 +0200 Subject: [PATCH 39/43] Fixed pyproject.toml. (#4) --- .github/workflows/codecov.yml | 3 --- pyproject.toml | 4 +--- 2 files changed, 1 insertion(+), 6 deletions(-) diff --git a/.github/workflows/codecov.yml b/.github/workflows/codecov.yml index 98390f4..204f6df 100644 --- a/.github/workflows/codecov.yml +++ b/.github/workflows/codecov.yml @@ -22,9 +22,6 @@ jobs: pip install -r requirements.txt pip install codecov pip install -e . - pip list - python -c "import sys; print(sys.path)" - python -c "import eppopynder; print(eppopynder.__file__)" - name: Run tests with coverage env: diff --git a/pyproject.toml b/pyproject.toml index 1d6c405..ab4ba7b 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -40,6 +40,4 @@ dev = [ [tool.setuptools] package-dir = {"" = "src"} - -[tool.setuptools.packages.find] -where = ["src"] +packages = ["eppopynder"] From 87a8ff0453feeade103e81d9f644d426265702f8 Mon Sep 17 00:00:00 2001 From: Lorenzo Copelli Date: Wed, 8 Apr 2026 14:39:09 +0200 Subject: [PATCH 40/43] Fixed package name. (#5) * Restored pyproject.toml. * Renamed package folder, step 1 (temporary name). * Renamed (fixed) package name, step 2 (final name). --- pyproject.toml | 4 +++- src/{eppoPynder => eppopynder}/__init__.py | 0 src/{eppoPynder => eppopynder}/_core/__init__.py | 0 src/{eppoPynder => eppopynder}/_core/_country.py | 0 src/{eppoPynder => eppopynder}/_core/_general.py | 0 src/{eppoPynder => eppopynder}/_core/_references.py | 0 src/{eppoPynder => eppopynder}/_core/_reporting_service.py | 0 src/{eppoPynder => eppopynder}/_core/_rppo.py | 0 src/{eppoPynder => eppopynder}/_core/_taxon.py | 0 src/{eppoPynder => eppopynder}/_core/_taxons.py | 0 src/{eppoPynder => eppopynder}/_core/_tools.py | 0 src/{eppoPynder => eppopynder}/_utils/__init__.py | 0 src/{eppoPynder => eppopynder}/_utils/_checks.py | 0 src/{eppoPynder => eppopynder}/_utils/_data.py | 0 src/{eppoPynder => eppopynder}/_utils/_requests.py | 0 src/{eppoPynder => eppopynder}/client.py | 0 src/{eppoPynder => eppopynder}/data_wrangling.py | 0 17 files changed, 3 insertions(+), 1 deletion(-) rename src/{eppoPynder => eppopynder}/__init__.py (100%) rename src/{eppoPynder => eppopynder}/_core/__init__.py (100%) rename src/{eppoPynder => eppopynder}/_core/_country.py (100%) rename src/{eppoPynder => eppopynder}/_core/_general.py (100%) rename src/{eppoPynder => eppopynder}/_core/_references.py (100%) rename src/{eppoPynder => eppopynder}/_core/_reporting_service.py (100%) rename src/{eppoPynder => eppopynder}/_core/_rppo.py (100%) rename src/{eppoPynder => eppopynder}/_core/_taxon.py (100%) rename src/{eppoPynder => eppopynder}/_core/_taxons.py (100%) rename src/{eppoPynder => eppopynder}/_core/_tools.py (100%) rename src/{eppoPynder => eppopynder}/_utils/__init__.py (100%) rename src/{eppoPynder => eppopynder}/_utils/_checks.py (100%) rename src/{eppoPynder => eppopynder}/_utils/_data.py (100%) rename src/{eppoPynder => eppopynder}/_utils/_requests.py (100%) rename src/{eppoPynder => eppopynder}/client.py (100%) rename src/{eppoPynder => eppopynder}/data_wrangling.py (100%) diff --git a/pyproject.toml b/pyproject.toml index ab4ba7b..1d6c405 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -40,4 +40,6 @@ dev = [ [tool.setuptools] package-dir = {"" = "src"} -packages = ["eppopynder"] + +[tool.setuptools.packages.find] +where = ["src"] diff --git a/src/eppoPynder/__init__.py b/src/eppopynder/__init__.py similarity index 100% rename from src/eppoPynder/__init__.py rename to src/eppopynder/__init__.py diff --git a/src/eppoPynder/_core/__init__.py b/src/eppopynder/_core/__init__.py similarity index 100% rename from src/eppoPynder/_core/__init__.py rename to src/eppopynder/_core/__init__.py diff --git a/src/eppoPynder/_core/_country.py b/src/eppopynder/_core/_country.py similarity index 100% rename from src/eppoPynder/_core/_country.py rename to src/eppopynder/_core/_country.py diff --git a/src/eppoPynder/_core/_general.py b/src/eppopynder/_core/_general.py similarity index 100% rename from src/eppoPynder/_core/_general.py rename to src/eppopynder/_core/_general.py diff --git a/src/eppoPynder/_core/_references.py b/src/eppopynder/_core/_references.py similarity index 100% rename from src/eppoPynder/_core/_references.py rename to src/eppopynder/_core/_references.py diff --git a/src/eppoPynder/_core/_reporting_service.py b/src/eppopynder/_core/_reporting_service.py similarity index 100% rename from src/eppoPynder/_core/_reporting_service.py rename to src/eppopynder/_core/_reporting_service.py diff --git a/src/eppoPynder/_core/_rppo.py b/src/eppopynder/_core/_rppo.py similarity index 100% rename from src/eppoPynder/_core/_rppo.py rename to src/eppopynder/_core/_rppo.py diff --git a/src/eppoPynder/_core/_taxon.py b/src/eppopynder/_core/_taxon.py similarity index 100% rename from src/eppoPynder/_core/_taxon.py rename to src/eppopynder/_core/_taxon.py diff --git a/src/eppoPynder/_core/_taxons.py b/src/eppopynder/_core/_taxons.py similarity index 100% rename from src/eppoPynder/_core/_taxons.py rename to src/eppopynder/_core/_taxons.py diff --git a/src/eppoPynder/_core/_tools.py b/src/eppopynder/_core/_tools.py similarity index 100% rename from src/eppoPynder/_core/_tools.py rename to src/eppopynder/_core/_tools.py diff --git a/src/eppoPynder/_utils/__init__.py b/src/eppopynder/_utils/__init__.py similarity index 100% rename from src/eppoPynder/_utils/__init__.py rename to src/eppopynder/_utils/__init__.py diff --git a/src/eppoPynder/_utils/_checks.py b/src/eppopynder/_utils/_checks.py similarity index 100% rename from src/eppoPynder/_utils/_checks.py rename to src/eppopynder/_utils/_checks.py diff --git a/src/eppoPynder/_utils/_data.py b/src/eppopynder/_utils/_data.py similarity index 100% rename from src/eppoPynder/_utils/_data.py rename to src/eppopynder/_utils/_data.py diff --git a/src/eppoPynder/_utils/_requests.py b/src/eppopynder/_utils/_requests.py similarity index 100% rename from src/eppoPynder/_utils/_requests.py rename to src/eppopynder/_utils/_requests.py diff --git a/src/eppoPynder/client.py b/src/eppopynder/client.py similarity index 100% rename from src/eppoPynder/client.py rename to src/eppopynder/client.py diff --git a/src/eppoPynder/data_wrangling.py b/src/eppopynder/data_wrangling.py similarity index 100% rename from src/eppoPynder/data_wrangling.py rename to src/eppopynder/data_wrangling.py From bccdb790f270e6390d8069af5419eae6db13ecec Mon Sep 17 00:00:00 2001 From: Lorenzo Copelli Date: Wed, 8 Apr 2026 15:10:38 +0200 Subject: [PATCH 41/43] Minor fixes. (#6) --- src/eppopynder/_utils/_checks.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/eppopynder/_utils/_checks.py b/src/eppopynder/_utils/_checks.py index 4c007c4..93d6c82 100644 --- a/src/eppopynder/_utils/_checks.py +++ b/src/eppopynder/_utils/_checks.py @@ -90,7 +90,7 @@ def _check_services(services, choices): if len(invalid_services_) > 0: raise ValueError("Unsupported services requested: " - + f"{", ".join(invalid_services_)}") + + f"{', '.join(invalid_services_)}") def _require_column_names(dataframe, column_names): @@ -117,7 +117,7 @@ def _require_column_names(dataframe, column_names): if not all(column_ in dataframe.columns for column_ in column_names): raise ValueError("Missing required columns in dataframe: " - + f"{", ".join(column_names)}") + + f"{', '.join(column_names)}") def _require_not_all_nan(dataframe, column_name): From b7b1f4e24dcaedaf65bae0583b08a42bb3625233 Mon Sep 17 00:00:00 2001 From: Lorenzo Copelli Date: Tue, 14 Apr 2026 14:47:02 +0200 Subject: [PATCH 42/43] Minor fixes. (#8) --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 87ab033..e5b186f 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# eppoPynder +# eppoPynder [![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) From ee3f454ad4bc6873f1e818e2342ab78650df3953 Mon Sep 17 00:00:00 2001 From: Lorenzo Copelli Date: Tue, 14 Apr 2026 16:42:25 +0200 Subject: [PATCH 43/43] Minor fixes. (#10) --- .github/workflows/mkdocs.yml | 2 -- 1 file changed, 2 deletions(-) diff --git a/.github/workflows/mkdocs.yml b/.github/workflows/mkdocs.yml index b40ad50..fac16a9 100644 --- a/.github/workflows/mkdocs.yml +++ b/.github/workflows/mkdocs.yml @@ -26,8 +26,6 @@ jobs: 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