ENG-4277 Create workflow for PyPI and TestPYPI

Author: sebastian-quintero

.github/workflows/publish.yml

@@ -1,26 +1,41 @@
 name: publish
 
 on:
-    release:
-        types: [created]
+  release:
+    types: [created]
 
 jobs:
-    deploy:
-        runs-on: ubuntu-latest
-        steps:
-            - uses: actions/checkout@v4
-            - name: Set up Python
-              uses: actions/setup-python@v4
-              with:
-                  python-version: "3.x"
-            - name: Install dependencies
-              run: |
-                  python -m pip install --upgrade pip
-                  pip install setuptools wheel twine
-            - name: Build and publish
-              env:
-                  TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
-                  TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
-              run: |
-                  python setup.py sdist bdist_wheel
-                  twine upload dist/*
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: git clone
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.12"
+
+      - name: install dependencies
+        run: |
+          pip install --upgrade pip
+          pip install build twine
+
+      - name: build binary wheel and source tarball
+        env:
+          TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+          TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+        run: |
+          python -m build
+
+      - name: publish to TestPyPI
+        env:
+          TWINE_USERNAME: ${{ secrets.TESTPYPI_USERNAME }}
+          TWINE_PASSWORD: ${{ secrets.TESTPYPI_PASSWORD }}
+        run: twine upload --repository testpypi dist/*
+
+      - name: publish to PyPI
+        env:
+          TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+          TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+        run: twine upload dist/*

.github/workflows/python-lint.yml

@@ -8,7 +8,7 @@ jobs:
         python-version: ["3.10", "3.11", "3.12"]
     steps:
       - name: git clone
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v4

.github/workflows/python-test.yml

@@ -8,7 +8,7 @@ jobs:
         python-version: ["3.10", "3.11", "3.12"]
     steps:
       - name: git clone
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v4

README.md

@@ -1,3 +1,71 @@
-# nextmv python package
+# Nextmv Python SDK
 
-This is a placeholder for Nextmv's Python package. Stay tuned for more information.
+This is the Python SDK for the Nextmv Platform. Before starting:
+
+1. [Sign up][signup] for a Nextmv account.
+2. Get your API key. Go to [Team > API Key][api-key].
+
+Visit the [docs][docs] for more information.
+
+## Installation
+
+Install using `pip`:
+
+```bash
+pip install nextmv
+```
+
+## Usage
+
+Make sure that you have your API key set as an environment variable:
+
+```bash
+export NEXTMV_API_KEY=<your-API-key>
+```
+
+Additionally, you must have a valid app pushed to the Nextmv Cloud.
+
+- Make a run and get the results.
+
+```python
+import os
+
+from nextmv.cloud import Application, Client
+
+input = {
+    "defaults": {"vehicles": {"speed": 20}},
+    "stops": [
+        {
+            "id": "Nijō Castle",
+            "location": {"lon": 135.748134, "lat": 35.014239},
+            "quantity": -1,
+        },
+        {
+            "id": "Kyoto Imperial Palace",
+            "location": {"lon": 135.762057, "lat": 35.025431},
+            "quantity": -1,
+        },
+    ],
+    "vehicles": [
+        {
+            "id": "v2",
+            "capacity": 2,
+            "start_location": {"lon": 135.728898, "lat": 35.039705},
+        },
+    ],
+}
+
+client = Client(api_key=os.getenv("NEXTMV_API_KEY"))
+app = Application(client=client, id="your-app-id")
+result = app.new_run_with_result(
+    input=input,
+    instance_id="latest",
+    run_options={"solve.duration": "1s"},
+)
+print(result.to_dict())
+
+```
+
+[signup]: https://cloud.nextmv.io
+[docs]: https://nextmv.io/docs
+[api-key]: https://cloud.nextmv.io/team/api-keys

nextmv/cloud/application.py

@@ -56,12 +56,12 @@ class Metadata(BaseModel):
 class PollingOptions(BaseModel):
     """Options to use when polling for a run result."""
 
-    backoff: float = 1.5
+    backoff: float = 1
     """Backoff factor to use between polls."""
     delay: float = 1
     """Delay to use between polls, in seconds."""
     initial_delay: float = 1
-    """Initial delay to use between polls, in seconds."""
+    """Initial delay to use before polling, in seconds."""
     max_duration: float = 60
     """Maximum duration of the polling strategy, in seconds."""
     max_tries: int = 10

pyproject.toml

@@ -11,18 +11,32 @@ license = {file = "LICENSE"}
 authors = [
     { name = "Nextmv", email = "tech@nextmv.io" }
 ]
-keywords = ["nextmv", "optimization", "solver", "vehicle routing problem", "operations research", "decisions", "decision engineering"]
+keywords = [
+    "nextmv", 
+    "optimization", 
+    "decision science",
+    "operations research", 
+    "solver", 
+    "vehicle routing problem",
+    "shift scheduling",
+    "decisions", 
+    "decision engineering", 
+]
 classifiers = [
     "Programming Language :: Python :: 3",
     "License :: OSI Approved :: Apache Software License",
     "Operating System :: OS Independent",
 ]
-version = "0.1.0"
+version = "0.1.0-dev.0"
+dependencies = [
+    "pydantic>=2.5.2,<3.0.0",
+    "requests>=2.31.0,<3.0.0",
+]
 
 [project.urls]
 Homepage = "https://www.nextmv.io"
 Documentation = "https://www.nextmv.io/docs"
-Repository = "https://github.com/nextmv-io/sdk-python"
+Repository = "https://github.com/nextmv-io/nextmv-py"
 
 [tool.ruff]
 target-version = "py312"

requirements.txt

@@ -1,5 +1,5 @@
-pydantic==2.5.2
-requests==2.31.0
-ruff==0.1.7
-setuptools==69.0.2
-wheel==0.42.0
+build==1.0.3,<2.0.0
+pydantic>=2.5.2,<3.0.0
+requests==2.31.0,<3.0.0
+ruff==0.1.7,<0.2.0
+twine==4.0.2,<5.0.0