microlens-submit 0.12.2__py3-none-any.whl → 0.16.1__py3-none-any.whl

{microlens_submit-0.12.2.dist-info → microlens_submit-0.16.1.dist-info}/METADATA

@@ -1,7 +1,9 @@
 Metadata-Version: 2.4
 Name: microlens-submit
-Version: 0.12.2
-Summary: A toolkit for managing microlensing data challenge submissions
+Version: 0.16.1
+Summary: A tool for managing and submitting microlensing solutions
+Home-page: https://github.com/AmberLee2427/microlens-submit
+Author: Amber Malpas
 Author-email: Amber Malpas <malpas.1@osu.edu>, Roman Science Platform Team <roman-science-platform@stsci.edu>
 License: MIT
 Project-URL: Homepage, https://github.com/AmberLee2427/microlens-submit
@@ -27,6 +29,7 @@ Requires-Dist: typer[all]>=0.9.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: markdown>=3.4.0
+Requires-Dist: importlib_resources>=1.0.0; python_version < "3.9"
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -37,7 +40,11 @@ Requires-Dist: black; extra == "dev"
 Requires-Dist: isort; extra == "dev"
 Requires-Dist: sphinx; extra == "dev"
 Requires-Dist: sphinx_rtd_theme; extra == "dev"
+Requires-Dist: importlib_resources; extra == "dev"
+Dynamic: author
+Dynamic: home-page
 Dynamic: license-file
+Dynamic: requires-python
 
 <p align="center">
   <a href="https://github.com/AmberLee2427/microlens-submit">
@@ -49,15 +56,13 @@ Dynamic: license-file
 
 *A stateful submission toolkit for the RGES-PIT Microlensing Data Challenge.*
 
-[![PyPI - v0.12.2](https://img.shields.io/pypi/v/microlens-submit.svg)](https://pypi.org/project/microlens-submit/)
-[![CI](https://github.com/AmberLee2427/microlens-submit/actions/workflows/ci.yml/badge.svg)](https://github.com/AmberLee2427/microlens-submit/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI - v0.16.0](https://img.shields.io/pypi/v/microlens-submit.svg)](https://pypi.org/project/microlens-submit/)[![Read the Docs](https://readthedocs.org/projects/microlens-submit/badge/?version=latest)](https://microlens-submit.readthedocs.io/en/latest/?badge=latest)[![CI](https://github.com/AmberLee2427/microlens-submit/actions/workflows/ci.yml/badge.svg)](https://github.com/AmberLee2427/microlens-submit/actions/workflows/ci.yml)[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/microlens-submit.svg)](https://pypi.org/project/microlens-submit/)[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
 <br>
 
 `microlens-submit` provides a robust, version-controlled workflow for managing, validating, and packaging your challenge submission over a long period. It supports both a programmatic Python API and a full-featured Command Line Interface (CLI) for language-agnostic use.
 
-Full documentation is hosted on [Read the Docs](https://microlens-submit.readthedocs.io/en/latest/). A comprehensive tutorial notebook is available at `docs/Submission_Tool_Tutorial.ipynb`. Challenge participants who prefer not to use this tool can consult [SUBMISSION_MANUAL.md](SUBMISSION_MANUAL.md) for the manual submission format.
+Full documentation is hosted on [Read the Docs](https://microlens-submit.readthedocs.io/en/latest/). A comprehensive tutorial notebook is available at `docs/Submission_Tool_Tutorial.ipynb`. Challenge participants who prefer not to use this tool can consult the [Submission Manual](https://microlens-submit.readthedocs.io/en/latest/submission_manual.html) for the manual submission format.
 
 ## Key Features
 
@@ -72,10 +77,11 @@ Full documentation is hosted on [Read the Docs](https://microlens-submit.readthe
 * **Environment Capture:** Automatically records your Python dependencies for each specific model fit, ensuring reproducibility.
 * **Optional Posterior Storage:** Record the path to posterior samples for any solution.
 * **Simple Export:** Packages all your active solutions into a clean, standardized `.zip` archive for final submission.
+* **Bulk Import:** Import multiple solutions at once from a CSV file using the `import-solutions` CLI command. Supports column mapping, alias handling, duplicate handling, notes, dry-run, and validation options.
 
 ## Installation
 
-The package is be available on PyPI:
+The package is available on PyPI:
 
 ```bash
 pip install microlens-submit
@@ -87,8 +93,21 @@ The CLI is the recommended way to interact with your submission project.
 
 You can pass ``--no-color`` to any command if your terminal does not support ANSI colors.
 
-1. Initialize your project: `microlens-submit init --team-name "Planet Pounders" --tier "advanced"`
+1. Initialize your project:
+
+   ```bash
+   microlens-submit init --team-name "Planet Pounders" --tier "advanced"
+   # if a project directory was provided to `init`, you should now `cd` into that project
+   ```
+
+   To pass validation, you need to have provided a `repo_url` and `hardware_info` to the project and have a git project initialized in your sumission-project directory.
+
+   ```bash
+   microlens-submit set-repo-url <url> ./
+   microlens-submit set-hardware-info --cpu-details "intel i7 xxx" --ram-gb 32 ./
+   ```
 2. Add a new solution to an event:
+
    ```bash
    microlens-submit add-solution ogle-2025-blg-0042 1S2L \
        --param t0=555.5 \
@@ -96,14 +115,29 @@ You can pass ``--no-color`` to any command if your terminal does not support ANS
        --param tE=25.0 \
        --notes "This is a great fit!"
    ```
+
    Model types must be one of `1S1L`, `1S2L`, `2S1L`, `2S2L`, `1S3L`, `2S3L`, or `other`.
    This will create a new solution and print its unique `solution_id`.
+
    You can run the same command with `--dry-run` first to verify the
    parsed input without saving anything.
-3. Deactivate a solution that didn't work out: `microlens-submit deactivate <solution_id>`
-4. List all solutions for an event: `microlens-submit list-solutions ogle-2025-blg-0042`
-5. Validate solutions and check for issues: `microlens-submit validate-solution <solution_id>`
-6. Export your final submission: `microlens-submit export final_submission.zip`
+
+3. **Bulk import multiple solutions from a CSV file:**
+
+   ```bash
+   microlens-submit import-solutions tests/data/test_import.csv --dry-run
+   ```
+
+   See the file `tests/data/test_import.csv` for a comprehensive example covering all features and edge cases.
+   You can use this file as a template for your own imports.
+
+4. Deactivate a solution that didn't work out: `microlens-submit deactivate <solution_id>`
+
+5. List all solutions for an event: `microlens-submit list-solutions ogle-2025-blg-0042`
+
+6. Validate solutions and check for issues: `microlens-submit validate-solution <solution_id>`
+
+7. Export your final submission: `microlens-submit export final_submission.zip`
 
 **Note:** When you add a solution, it's automatically validated and any warnings are displayed. Use `--dry-run` to check validation without saving.
 
@@ -139,7 +173,8 @@ sub.export("final_submission.zip")
 
 The full development plan can be found in agents.md. Contributions are welcome!
 
-To build and test this project, the development environment needs the following Python libraries. You can provide these to Codex or set up a `requirements-dev.txt` file.
+To build and test this project, install the development dependencies using either `pip install -e .[dev]` or `pip install -r requirements-dev.txt`. These packages are required to run the test suite and are listed in `requirements-dev.txt`.
+After installing the dependencies, run `pre-commit install` to set up the Git hooks for automatic formatting and linting. The development environment needs the following Python libraries.
 
 ### Core Dependencies:
 * **`typer[all]`**: For building the powerful command-line interface. The `[all]` extra ensures shell completion support is included.
@@ -153,9 +188,12 @@ To build and test this project, the development environment needs the following
 * **`build`**: For building the package from the `pyproject.toml` file.
 * **`twine`**: For uploading the final package to PyPI.
 
+### Test Data
+
+A comprehensive test CSV file is provided at `tests/data/test_import.csv`. This file is used in the test suite and can be copied or adapted for your own bulk imports or for development/testing purposes.
+
 ## Citation
 
 If you use **microlens-submit** in your research, please cite the project using
 the metadata provided in the `CITATION.cff` file. Most reference managers can
 import this file directly.
-

microlens_submit-0.16.1.dist-info/RECORD

@@ -0,0 +1,32 @@
+microlens_submit/__init__.py,sha256=cU8vO5jdCuI4cWhdTh0M3fV0L0qYtme1WDjtKq6osuw,399
+microlens_submit/error_messages.py,sha256=BuTkzc1B2lve-G4-4wAUX5p3y6CthPFOcMJM6_eMN2I,10262
+microlens_submit/tier_validation.py,sha256=mbE9MjXRHbsPBB12aD2lyYUdvXiBacweRG2OTWgP7Fs,6168
+microlens_submit/utils.py,sha256=3kEinJXr5OWHjrQUGHhUFA6L2rNdqaLy2ogmQNx_TfY,14358
+microlens_submit/validate_parameters.py,sha256=_RBzdbY2sFwtNNd5f69bwxTpHjlNq_np3iDYvio4Oow,37645
+microlens_submit/assets/github-desktop_logo.png,sha256=pb4rallKrYQPHt6eC0TmJe_UyyMtf1IrP8_OWK19nH8,479821
+microlens_submit/assets/rges-pit_logo.png,sha256=45AJypXCymvt3lMeK7MHt1SBhwPpnKCMj6S000Cejtc,537645
+microlens_submit/cli/__init__.py,sha256=u4ZgVOzUe_gf89FBhY61XWjcfK4oxXCStabYTjBuRRo,82
+microlens_submit/cli/__main__.py,sha256=_7x5Hd_9ehQwYHphd3iPB3LMVvKAVmxz-e0E4pWi0lk,112
+microlens_submit/cli/main.py,sha256=iJ2bkQZ-OiuCUCVqs_EGbhpa240zB7agrYNZj6p5_3g,3938
+microlens_submit/cli/commands/__init__.py,sha256=rzIgY7T2Bz4Lhzts_RiWeoBbMoCuxODxeoktnUhH4rw,49
+microlens_submit/cli/commands/dossier.py,sha256=6gRJNzUgr29YmYJRcUj9aoiRhjb1r9Uy4dip6z2LaHI,5100
+microlens_submit/cli/commands/export.py,sha256=Hr9frquBdla69s7Bi-Vx3XBQ0AJte562coIParmLQL8,6600
+microlens_submit/cli/commands/init.py,sha256=LOnG63YJupk3ELFCRl9itDymtAe0eu9xf2BQ6D5xu50,7074
+microlens_submit/cli/commands/solutions.py,sha256=E0aU4rtjRWToh8l1yrSJnPo6CRnLsx-2QAF5Rv1yMVs,30051
+microlens_submit/cli/commands/validation.py,sha256=XNbuIy837IPV45ze4dvJaKx9-UCx24VXiGW_y4dl4YE,8841
+microlens_submit/dossier/__init__.py,sha256=INAacbrY0Wi5ueH8c7b156bGzelyUFcynbE7_YRiku0,1948
+microlens_submit/dossier/dashboard.py,sha256=4OvTUCxIC4LbAqKwimIFhi65fNo5MMJswiQ5OWtyWFA,19907
+microlens_submit/dossier/event_page.py,sha256=F9waw-Ce2_4ikdCPo-hNURUSYEPGMCfvsY3PbCXpsFg,14425
+microlens_submit/dossier/full_report.py,sha256=zQXoo6ZQfwv_NNFFel3ZYW1DgnqD--VU0L7J7p9yEng,12864
+microlens_submit/dossier/solution_page.py,sha256=qp2JaDamHD__3bwOzZ3CRj2UUSCiOf94wNyOfkQUGGU,23593
+microlens_submit/dossier/utils.py,sha256=LopBbVg6nzQasL1lnaI63y3bpmqYqBeDEwfB_NqEeCA,3845
+microlens_submit/models/__init__.py,sha256=1sHFjAWyFtGgQBRSo8lBYiPzToo4tIoHP3uBjtgJSPY,861
+microlens_submit/models/event.py,sha256=j5ulKGF2lVWXpIVcilCPftoXxMHwuYgD9ZjUz5vhlek,16941
+microlens_submit/models/solution.py,sha256=0prKFYM3oxKXZjtzhaAaS7E5cYP2maxfbYNQhkL-IY0,23339
+microlens_submit/models/submission.py,sha256=WgSgw6-60ZwLgsFjl2u1FX76ydATJ5t_DpGUQOekpg4,26116
+microlens_submit-0.16.1.dist-info/licenses/LICENSE,sha256=cy1qkVR-kGxD6FXVsparmU2vHJXYeoyAAHv6SgT67sw,1069
+microlens_submit-0.16.1.dist-info/METADATA,sha256=66B9Hiu35zyo6RjmNh8fe8RnZbnPrBk14PigILkKa1M,9487
+microlens_submit-0.16.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+microlens_submit-0.16.1.dist-info/entry_points.txt,sha256=kA85yhxYrpQnUvVZCRS2giz52gaf1ZOfZFjY4RHIZ2s,62
+microlens_submit-0.16.1.dist-info/top_level.txt,sha256=uJ9_bADYRySlhEpP-8vTm90ZLV2SrKEzutAaRx8WF0k,17
+microlens_submit-0.16.1.dist-info/RECORD,,