madrigal-jl 0.1.0__tar.gz

madrigal_jl-0.1.0/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: madrigal-jl
+Version: 0.1.0
+Summary: Python wrapper for Madrigal.jl - access the Madrigal database via Julia
+Keywords: madrigal,julia,atmospheric-science,ionosphere
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
+Project-URL: Homepage, https://github.com/JuliaSpacePhysics/Madrigal.jl
+Project-URL: Repository, https://github.com/JuliaSpacePhysics/Madrigal.jl
+Requires-Python: >=3.9
+Requires-Dist: juliacall>=0.9.20
+Description-Content-Type: text/markdown
+
+# Madrigal
+
+Python wrapper for [Madrigal.jl](https://github.com/JuliaSpacePhysics/Madrigal.jl) - access the Madrigal upper atmospheric science database from Python.
+
+## Installation
+
+With pip (requires Julia to be installed separately):
+
+```bash
+pip install madrigal-jl
+```
+
+With pixi (installs Julia automatically):
+
+```bash
+pixi add madrigal-jl
+```
+
+The Julia package installs automatically on first use.
+
+## Usage
+
+```python
+import madrigal
+
+# Get all instruments
+instruments = madrigal.get_instruments()
+
+# Get experiments for Millstone Hill radar (kinst=30)
+experiments = madrigal.get_experiments(30, "2020-01-01", "2020-01-31")
+
+# Get files from an experiment
+files = madrigal.get_experiment_files(experiments[0])
+
+# Download a file
+path = madrigal.download_file(files[0])
+```
+
+## Configuration
+
+```python
+madrigal.set_default_server("https://cedar.openmadrigal.org")
+madrigal.set_default_user("Your Name", "email@example.com", "Institution")
+```
+
+## API
+
+All functions from Madrigal.jl are available:
+
+- `get_instruments(server=None, source=:cache)`
+- `get_experiments(code, t0, t1, server=None, source=:cache)`
+- `get_experiment_files(experiment, server=None, source=:cache)`
+- `get_experiment_file_parameters(file, server=None)`
+- `download_file(file, destination=None, format=:hdf5, ...)`
+- `download_files(inst, kindat, t0, t1, ...)`
+- `get_metadata(id, server=None)`
+
+See the [Madrigal.jl documentation](https://juliaspacePhysics.github.io/Madrigal.jl) for full details.

madrigal_jl-0.1.0/README.md

@@ -0,0 +1,58 @@
+# Madrigal
+
+Python wrapper for [Madrigal.jl](https://github.com/JuliaSpacePhysics/Madrigal.jl) - access the Madrigal upper atmospheric science database from Python.
+
+## Installation
+
+With pip (requires Julia to be installed separately):
+
+```bash
+pip install madrigal-jl
+```
+
+With pixi (installs Julia automatically):
+
+```bash
+pixi add madrigal-jl
+```
+
+The Julia package installs automatically on first use.
+
+## Usage
+
+```python
+import madrigal
+
+# Get all instruments
+instruments = madrigal.get_instruments()
+
+# Get experiments for Millstone Hill radar (kinst=30)
+experiments = madrigal.get_experiments(30, "2020-01-01", "2020-01-31")
+
+# Get files from an experiment
+files = madrigal.get_experiment_files(experiments[0])
+
+# Download a file
+path = madrigal.download_file(files[0])
+```
+
+## Configuration
+
+```python
+madrigal.set_default_server("https://cedar.openmadrigal.org")
+madrigal.set_default_user("Your Name", "email@example.com", "Institution")
+```
+
+## API
+
+All functions from Madrigal.jl are available:
+
+- `get_instruments(server=None, source=:cache)`
+- `get_experiments(code, t0, t1, server=None, source=:cache)`
+- `get_experiment_files(experiment, server=None, source=:cache)`
+- `get_experiment_file_parameters(file, server=None)`
+- `download_file(file, destination=None, format=:hdf5, ...)`
+- `download_files(inst, kindat, t0, t1, ...)`
+- `get_metadata(id, server=None)`
+
+See the [Madrigal.jl documentation](https://juliaspacePhysics.github.io/Madrigal.jl) for full details.

madrigal_jl-0.1.0/pyproject.toml

@@ -0,0 +1,63 @@
+[project]
+name = "madrigal-jl"
+version = "0.1.0"
+description = "Python wrapper for Madrigal.jl - access the Madrigal database via Julia"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+keywords = [
+    "madrigal",
+    "julia",
+    "atmospheric-science",
+    "ionosphere",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering :: Atmospheric Science",
+]
+dependencies = [
+    "juliacall>=0.9.20",
+]
+
+[project.urls]
+Homepage = "https://github.com/JuliaSpacePhysics/Madrigal.jl"
+Repository = "https://github.com/JuliaSpacePhysics/Madrigal.jl"
+
+[build-system]
+requires = [
+    "pdm-backend",
+]
+build-backend = "pdm.backend"
+
+[tool.pdm.build]
+package-dir = "src"
+includes = [
+    "madrigal",
+]
+
+[tool.pixi.workspace]
+channels = [
+    "conda-forge",
+]
+platforms = [
+    "linux-64",
+    "osx-arm64",
+    "osx-64",
+    "win-64",
+]
+
+[tool.pixi.dependencies]
+pdm = "*"
+
+[tool.pixi.pypi-dependencies]
+pytest = "*"
+twine = "*"
+
+[tool.pixi.pypi-dependencies.madrigal-jl]
+path = "."
+editable = true
+
+[tool.pixi.tasks]
+test = "pytest"

madrigal_jl-0.1.0/tests/test_wrapper.py

@@ -0,0 +1,7 @@
+import pytest
+
+def test_import():
+    import madrigal
+    assert hasattr(madrigal, "get_instruments")
+    assert hasattr(madrigal, "get_experiments")
+    assert hasattr(madrigal, "download_file")