# SPDX-License-Identifier: EUPL-1.2
# Contact: felixd@gfz.de, besnard@gfz.de, urbazaev@gfz.de and amelia.holcomb@gmail.com.
# SPDX-FileCopyrightText: 2026 Felix Dombrowski
# SPDX-FileCopyrightText: 2026 Mikhail Urbazaev
# SPDX-FileCopyrightText: 2026 Simon Besnard
# SPDX-FileCopyrightText: 2026 Amelia Holcomb
# SPDX-FileCopyrightText: 2026 Helmholtz Centre Potsdam - GFZ German Research Centre for Geosciences


"""
Authenticating with NASA EarthData API
======================================

This example demonstrates how to authenticate with the NASA EarthData API using the `EarthDataAuthenticator` class.
The authentication process involves managing `.netrc` and cookie files to ensure seamless automated login.

Before running this example:

1. Ensure you have a valid EarthData account. You can create one at https://urs.earthdata.nasa.gov.
2. Install `wget`, which is used to fetch cookies. You can install it via your system's package manager (e.g., `apt-get install wget` on Debian/Ubuntu).
"""

from pathlib import Path

from icesat2db.downloader.authentication import EarthDataAuthenticator

# Specify the directory where `.netrc` and cookies will be stored
earth_data_dir = Path.home()

# Initialize the authenticator
authenticator = EarthDataAuthenticator(earth_data_dir=earth_data_dir, strict=False)

# Authenticate and ensure `.netrc` and cookies are valid
authenticator.authenticate()

# Expected Output:
# ----------------
# INFO:__main__:EarthData authentication setup incomplete; starting setup.
# Please enter your Earthdata Login username: <your_username>
# Please enter your Earthdata Login password:
# INFO:__main__:Credentials added to .netrc file.
# INFO:__main__:Attempting to fetch Earthdata cookies and save to /home/username/.earthdata_auth/.cookies
# INFO:__main__:Earthdata cookies successfully fetched and saved to /home/username/.earthdata_auth/.cookies.
# Authentication complete.