nasa-apis-wrapper 0.1.0__tar.gz

nasa_apis_wrapper-0.1.0/.claude/settings.local.json

@@ -0,0 +1,71 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(poetry run *)",
+      "Bash(python -m pytest --tb=short)",
+      "Bash(python3 -m pytest --tb=short)",
+      "Read(//Users/jonathanroddev/.local/bin/**)",
+      "Read(//opt/**)",
+      "Bash(uv --version)",
+      "Bash(uv sync *)",
+      "Bash(uv run *)",
+      "WebFetch(domain:pypi.org)",
+      "WebSearch",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:pypistats.org)",
+      "WebFetch(domain:eonet.gsfc.nasa.gov)",
+      "WebFetch(domain:api.nasa.gov)",
+      "WebFetch(domain:epic.gsfc.nasa.gov)",
+      "WebFetch(domain:exoplanetarchive.ipac.caltech.edu)",
+      "WebFetch(domain:kauai.ccmc.gsfc.nasa.gov)",
+      "WebFetch(domain:ccmc.gsfc.nasa.gov)",
+      "WebFetch(domain:nasa-gibs.github.io)",
+      "WebFetch(domain:gibs.earthdata.nasa.gov)",
+      "WebFetch(domain:aionasa.nwunder.com)",
+      "WebFetch(domain:mars-insight.readthedocs.io)",
+      "WebFetch(domain:images.nasa.gov)",
+      "WebFetch(domain:images-api.nasa.gov)",
+      "WebFetch(domain:www.postman.com)",
+      "WebFetch(domain:osdr.nasa.gov)",
+      "WebFetch(domain:www.nasa.gov)",
+      "WebFetch(domain:visualization.osdr.nasa.gov)",
+      "WebFetch(domain:osdr-tutorials.readthedocs.io)",
+      "WebFetch(domain:sscweb.gsfc.nasa.gov)",
+      "WebFetch(domain:ssd-api.jpl.nasa.gov)",
+      "WebFetch(domain:techport.nasa.gov)",
+      "WebFetch(domain:data.nasa.gov)",
+      "WebFetch(domain:apis.guru)",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "Bash(curl -s \"https://techport.nasa.gov/api/projects/search?limit=3&titleSearch=mars&offset=0\")",
+      "Bash(python3 -c \"import json,sys; d=json.load\\(sys.stdin\\); print\\('total:', d.get\\('total'\\)\\); print\\('keys:', list\\(d.keys\\(\\)\\)\\); [print\\(r.get\\('title','?'\\)\\) for r in d.get\\('results',[]\\)]\")",
+      "Bash(curl -s \"https://techport.nasa.gov/api/projects/search?limit=1&offset=0\")",
+      "Bash(python3 -c \"import json,sys; d=json.load\\(sys.stdin\\); print\\('top keys:', list\\(d.keys\\(\\)\\)\\); print\\('total:', d.get\\('total'\\)\\); print\\('offset:', d.get\\('offset'\\)\\); print\\('stats:', d.get\\('stats'\\)\\); print\\('spellingSuggestions:', d.get\\('spellingSuggestions'\\)\\)\")",
+      "Bash(python3 -c \"import json,sys; d=json.load\\(sys.stdin\\); print\\('total:', d.get\\('total'\\)\\); [print\\(r.get\\('title','?'\\)\\) for r in d.get\\('results',[]\\)]\")",
+      "Bash(curl -s \"https://techport.nasa.gov/api/projects/182467\")",
+      "Bash(python3 -c ' *)",
+      "Bash(curl -s \"https://techport.nasa.gov/api/projects?updatedSince=2026-05-01\")",
+      "Bash(curl -s \"https://techport.nasa.gov/api/projects/search?limit=2&offset=0\")",
+      "Bash(curl -s \"https://techport.nasa.gov/api/projects\")",
+      "Bash(curl -s \"https://techport.nasa.gov/api/contacts\")",
+      "Bash(curl -s \"https://techport.nasa.gov/api/programs/73\")",
+      "Bash(curl -s \"https://techport.nasa.gov/api/organizations/4941\")",
+      "Bash(curl -s \"https://techport.nasa.gov/api/projects/search?limit=2&offset=0&text=mars\")",
+      "Bash(curl -sv \"https://techport.nasa.gov/api/projects/182467\")",
+      "Bash(curl -s \"https://techport.nasa.gov/v3/api-docs\")",
+      "Bash(curl -s \"https://techport.nasa.gov/api-docs/swagger-ui-init.js\")",
+      "Bash(curl -s \"https://techport.nasa.gov/openapi.json\")",
+      "Bash(curl -s \"https://techport.nasa.gov/techport-app/assets/index-0a8cb9fd.js\")",
+      "Bash(grep -oP '\"\\(/api/[^\"]{3,80}\\)\"')",
+      "Bash(curl -s \"https://techport.nasa.gov/api/enums\")",
+      "Bash(curl -s \"https://api.nasa.gov/mars-photos/api/v1/rovers?api_key=DEMO_KEY\")",
+      "Bash(python3 -c \"import sys,json; d=json.load\\(sys.stdin\\); print\\(list\\(d.keys\\(\\)\\)\\)\")",
+      "Bash(curl -s \"https://api.nasa.gov/mars-photos/api/v1/rovers?api_key=DEMO_KEY\" -o /tmp/rovers.json)",
+      "Bash(python3 -c \"import json; d=json.load\\(open\\('/tmp/rovers.json'\\)\\); print\\(list\\(d.keys\\(\\)\\)\\); r=d['rovers'][0]; print\\(list\\(r.keys\\(\\)\\)\\)\")",
+      "Bash(curl -v \"https://api.nasa.gov/mars-photos/api/v1/rovers?api_key=DEMO_KEY\")",
+      "Bash(curl -s --max-time 15 \"https://api.nasa.gov/mars-photos/api/v1/rovers?api_key=DEMO_KEY\")",
+      "Bash(echo \"exit: $?\")",
+      "Read(//private/tmp/**)",
+      "Bash(python3 -c \"import json; d=json.load\\(open\\('/tmp/rovers.json'\\)\\); r=d['rovers'][0]; print\\(list\\(r.keys\\(\\)\\)\\)\")"
+    ]
+  }
+}

nasa_apis_wrapper-0.1.0/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

nasa_apis_wrapper-0.1.0/.gitignore

@@ -0,0 +1,166 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+local.py
+*~
+pytest-cache-files-dvdpibc0
+.vscode/settings.json
+smoke_test.py

nasa_apis_wrapper-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jonathan Rodríguez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nasa_apis_wrapper-0.1.0/PKG-INFO

@@ -0,0 +1,369 @@
+Metadata-Version: 2.4
+Name: nasa-apis-wrapper
+Version: 0.1.0
+Summary: Python wrapper for NASA APIs
+Project-URL: Homepage, https://github.com/jonathanroddev/nasa-apis-wrapper
+Project-URL: Repository, https://github.com/jonathanroddev/nasa-apis-wrapper
+Project-URL: Bug Tracker, https://github.com/jonathanroddev/nasa-apis-wrapper/issues
+Author-email: Jonathan Rodríguez <jonathanroddev@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Jonathan Rodríguez
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: api,apod,astronomy,cneos,donki,eonet,epic,exoplanet,gibs,nasa,neows,pydantic,space,wrapper
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: pydantic>=2.9
+Requires-Dist: requests>=2.32
+Description-Content-Type: text/markdown
+
+# nasa-apis-wrapper
+
+> **Disclaimer:** This is an unofficial, community-maintained Python wrapper. It is not affiliated with, endorsed by, or in any way connected to NASA.
+
+A typed Python wrapper for [NASA's public APIs](https://api.nasa.gov/), built on **Pydantic v2** and **requests**. Every response is a validated model with IDE autocompletion — no raw dicts.
+
+## Installation
+
+```bash
+pip install nasa-apis-wrapper
+```
+
+Requires Python 3.12+.
+
+## API Key
+
+Most NASA APIs accept a free API key from [api.nasa.gov](https://api.nasa.gov/). Without one you can use the demo key `DEMO_KEY`, which has stricter rate limits (30 requests/hour, 50/day).
+
+Pass the key when constructing any service that requires it:
+
+```python
+from nasa_apis_wrapper import APODService
+
+apod = APODService(api_key="YOUR_KEY_HERE")
+```
+
+Services that don't require a key (EONET, EPIC, Exoplanet, GIBS, Image Library, CNEOS, SSC, OSDR, Trek) are instantiated without arguments.
+
+## API Coverage
+
+| Service | Class | API Key | Status |
+|---------|-------|---------|--------|
+| Astronomy Picture of the Day | `APODService` | Required | ✓ |
+| Asteroids — NeoWs | `NeoWsService` | Required | ✓ |
+| DONKI (space weather) | `DonkiService` | Required | ✓ |
+| Earth imagery | `EarthService` | Required | ✗ Backend down |
+| EONET (natural events) | `EONETService` | No | ✓ |
+| EPIC (Earth polychromatic imaging) | `EPICService` | No | ✓ |
+| Exoplanet Archive | `ExoplanetService` | No | ✓ |
+| GIBS (satellite imagery tiles) | `GIBSService` | No | ✓ |
+| NASA Image & Video Library | `ImageLibraryService` | No | ✓ |
+| InSight Mars weather | `InsightService` | Required | ✓ (data frozen Dec 2022) |
+| Mars Rover Photos | `MarsRoverService` | Required | ✗ Backend down |
+| OSDR (space biology data) | `OSDRService` + `RadLabService` + `BioDataService` | No | ✓ |
+| SSD/CNEOS (small bodies) | `CNEOSService` | No | ✓ |
+| Satellite Situation Center | `SSCService` | No | ✓ |
+| TechPort (NASA projects) | `TechportService` | No | ✗ 403 Forbidden |
+| TechTransfer | `TechTransferService` | Required | ✗ 404 Endpoint removed |
+| TLE (orbital elements) | `TLEService` | No | ✗ Service down |
+| Vesta/Moon/Mars Trek WMTS | `TrekService` | No | ✓ (tile endpoints only) |
+
+## Usage
+
+### APOD — Astronomy Picture of the Day
+
+```python
+from nasa_apis_wrapper import APODService, APODRequest
+
+apod = APODService(api_key="YOUR_KEY")
+
+# Today's picture
+pic = apod.get_astronomy_picture_of_day()
+print(pic.title, pic.url)
+
+# Specific date
+pic = apod.get_astronomy_picture_of_day(APODRequest(date="2024-01-01"))
+
+# Random batch
+pics = apod.get_astronomy_pictures(APODRequest(count=5))
+
+# Date range
+pics = apod.get_astronomy_pictures(APODRequest(start_date="2024-01-01", end_date="2024-01-07"))
+```
+
+### NeoWs — Near Earth Objects
+
+```python
+from nasa_apis_wrapper import NeoWsService, NeoFeedRequest
+
+neows = NeoWsService(api_key="YOUR_KEY")
+
+feed = neows.feed(NeoFeedRequest(start_date="2024-01-01", end_date="2024-01-07"))
+print(feed.element_count, "NEOs this week")
+
+neo = neows.lookup(2000433)  # 433 Eros by SPK-ID
+print(neo.name, neo.is_potentially_hazardous_asteroid)
+
+page = neows.browse()  # paginated full catalogue
+```
+
+### DONKI — Space Weather
+
+```python
+from nasa_apis_wrapper import DonkiService, GenericDonkiRequest, DonkiIPSRequest
+
+donki = DonkiService(api_key="YOUR_KEY")
+req = GenericDonkiRequest(startDate="2024-01-01", endDate="2024-01-31")
+
+cmes        = donki.cme(req)               # Coronal Mass Ejections
+flares      = donki.flr(req)               # Solar Flares
+storms      = donki.gst(req)               # Geomagnetic Storms
+particles   = donki.sep(req)               # Solar Energetic Particles
+streams     = donki.hss(req)               # High Speed Streams
+shocks      = donki.ips(DonkiIPSRequest(startDate="2024-01-01", endDate="2024-01-31"))
+simulations = donki.wsa_enlil_simulation(req)
+```
+
+### EONET — Natural Events
+
+```python
+from nasa_apis_wrapper import EONETService, EONETEventsRequest
+
+eonet = EONETService()
+
+events = eonet.events(EONETEventsRequest(category="wildfires", days=30))
+for e in events.events:
+    print(e.id, e.title)
+
+categories = eonet.categories()
+layers = eonet.layers("wildfires")
+```
+
+### EPIC — Earth Polychromatic Imaging Camera
+
+```python
+from nasa_apis_wrapper import EPICService
+
+epic = EPICService()
+
+images = epic.images()                          # latest natural colour
+images = epic.images("enhanced")               # latest enhanced
+images = epic.images("natural", date="2024-01-15")
+
+for img in images:
+    url = epic.image_url(img, "natural", "png")
+    print(img.date, url)
+
+dates = epic.available_dates()
+```
+
+### Exoplanet Archive
+
+```python
+from nasa_apis_wrapper import ExoplanetService
+
+exo = ExoplanetService()
+
+planets = exo.confirmed_planets(limit=10)
+transits = exo.planets_by_method("Transit", limit=5)
+trappist = exo.planet("TRAPPIST-1 b")
+print(trappist.pl_name, trappist.hostname, trappist.pl_orbper)
+
+# Raw ADQL query
+rows = exo.query("SELECT TOP 5 pl_name, hostname, disc_year FROM pscomppars")
+```
+
+### GIBS — Global Imagery Browse Services
+
+Serves NASA satellite imagery tiles (WMTS/WMS).
+
+```python
+from nasa_apis_wrapper import GIBSService
+
+gibs = GIBSService()
+
+# Build tile/WMS URLs
+url = gibs.tile_url("MODIS_Terra_CorrectedReflectance_TrueColor", "250m", 3, 2, 5, date="2024-01-15")
+wms = gibs.wms_url("MODIS_Terra_CorrectedReflectance_TrueColor", "-180,-90,180,90", 512, 256, date="2024-01-15")
+
+# Download tile bytes
+tile_bytes = gibs.get_tile("MODIS_Terra_CorrectedReflectance_TrueColor", "250m", 0, 0, 0, date="2024-01-15")
+
+domains = gibs.describe_domains("MODIS_Terra_CorrectedReflectance_TrueColor", "250m")
+print(domains.start_date, domains.end_date)
+```
+
+### NASA Image & Video Library
+
+```python
+from nasa_apis_wrapper import ImageLibraryService, ImageLibrarySearchRequest
+
+lib = ImageLibraryService()
+
+results = lib.search(ImageLibrarySearchRequest(q="Apollo 11", media_type="image", page_size=10))
+print(results.collection.metadata.total_hits, "results")
+
+for item in results.collection.items:
+    print(item.metadata.nasa_id, item.metadata.title)
+    print(item.thumbnail)  # preview URL
+
+asset = lib.asset("as11-40-5931")
+print(asset.urls)  # all rendition URLs
+
+album = lib.album("Apollo-at-50")
+```
+
+### SSD/CNEOS — Small Body Database
+
+```python
+from nasa_apis_wrapper import CNEOSService, FireballRequest, CADRequest
+
+cneos = CNEOSService()
+
+fireballs = cneos.fireballs(FireballRequest(date_min="2024-01-01"))
+for fb in fireballs.records:
+    print(fb.date, fb.energy)
+
+cad = cneos.close_approaches(CADRequest(date_min="2024-01-01", dist_max="0.05"))
+for c in cad.records:
+    print(c.des, c.cd, c.dist)
+
+body = cneos.object(sstr="ceres")      # by name
+body = cneos.object(des="433")         # by designation
+
+sentry = cneos.sentry_summary()        # impact risk objects
+nhats  = cneos.nhats_summary()         # human-accessible NEOs
+
+cal = cneos.jd_to_date(2451545.0)
+print(cal.cd)                          # "2000-01-01 12:00:00"
+```
+
+### SSC — Satellite Situation Center
+
+```python
+from nasa_apis_wrapper import SSCService
+
+ssc = SSCService()
+
+observatories = ssc.observatories()
+iss = ssc.observatories(id="iss")[0]
+print(iss.Id, iss.Name)
+
+stations = ssc.ground_stations()
+```
+
+### OSDR — Open Science Data Repository
+
+Three sub-services under the OSDR umbrella:
+
+```python
+from nasa_apis_wrapper import OSDRService, OSDRSearchRequest, RadLabService, RadLabRequest, BioDataService
+
+# Search space biology studies
+osdr = OSDRService()
+results = osdr.search(OSDRSearchRequest(term="microgravity"))
+print(results.hits.total, "studies")
+
+for hit in results.hits.hits:
+    print(hit.source.accession, hit.source.study_title)
+
+files = osdr.study_files("OSD-48")
+
+# Radiation measurements
+radlab = RadLabService()
+measurements = radlab.measurements(RadLabRequest(instrument="TEPC"))
+for m in measurements:
+    print(m.timestamp, m.instrument_id)
+
+# Biological data
+bio = BioDataService()
+datasets = bio.datasets()          # {accession: url}
+assays = bio.assays("OSD-48")
+samples = bio.samples("OSD-48", assays[0])
+```
+
+### Trek WMTS — Vesta / Moon / Mars
+
+```python
+from nasa_apis_wrapper import TrekService
+
+trek = TrekService()
+
+# Build tile/WMS URLs (body = "mars", "moon", or "vesta")
+tile_url = trek.tile_url("mars", "Mars_Viking_MDIM21_ClrMosaic_global_232m", 0, 0, 0)
+wms_url  = trek.wms_url("moon", "LRO_WAC_Mosaic_Global_303m", "-180,-90,180,90", 512, 256)
+
+# Download tile bytes
+tile = trek.get_tile("mars", "Mars_Viking_MDIM21_ClrMosaic_global_232m", 0, 0, 0)
+```
+
+### InSight — Mars Weather
+
+Data from the InSight lander. The mission ended in December 2022 — the last 7 sols (675–681) are always returned.
+
+```python
+from nasa_apis_wrapper import InsightService
+
+insight = InsightService(api_key="YOUR_KEY")
+weather = insight.weather()
+for sol in weather.sol_keys:
+    data = getattr(weather, sol)
+    print(f"Sol {sol}: {data}")
+```
+
+## Error Handling
+
+All network errors, HTTP errors, and malformed responses raise `NasaAPIException`:
+
+```python
+from nasa_apis_wrapper import APODService, NasaAPIException
+
+try:
+    apod = APODService(api_key="INVALID_KEY")
+    pic = apod.get_astronomy_picture_of_day()
+except NasaAPIException as e:
+    print(e)
+```
+
+## Development
+
+```bash
+uv run pytest
+uv run pytest --cov --cov-report term-missing
+uv run black nasa_apis_wrapper tests
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+## Official documentation
+
+[https://api.nasa.gov/](https://api.nasa.gov/)