reuse URL address in publish_app()

Author: pplonski

README.md

@@ -111,6 +111,8 @@ or publish it quickly:
 automl.publish_app()
 ```
 
+`publish_app()` creates an app URL on the first publish and then reuses the last successfully published URL by default.
+
 The generated app can include:
 - single prediction dashboard,
 - batch prediction from CSV files,

docs/docs/features/apps.md

@@ -89,17 +89,20 @@ automl.publish_app()
 This helper:
 
 - signs in through `platform.mljar.com`
-- creates or updates the app URL
+- creates a new app URL on the first publish
+- reuses the last successfully published app URL on later publishes
 - uploads the generated runtime files
 - prints progress and friendly error messages
 - remembers the last successfully published app URL
 
-If you want to reuse a specific published app URL:
+If you want to update a specific published app URL:
 
 ```python
 automl.publish_app(url="https://your-app.ismvp.org")
 ```
 
+The remembered URL is stored in `publish_app_state.json` inside the AutoML `results_path`.
+
 ## Publish or host manually
 
 Using `platform.mljar.com` is simply the fastest path, but it is not required.

docs/docs/tutorials/app-classification.md

@@ -124,7 +124,8 @@ automl.publish_app()
 This helper will:
 
 - sign you in through `platform.mljar.com`,
-- create the app URL,
+- create the app URL on the first publish,
+- reuse the last successfully published app URL on later publishes,
 - upload the generated app files,
 - and print the final app address.
 

docs/docs/tutorials/app-regression.md

@@ -146,7 +146,8 @@ automl.publish_app()
 This helper will:
 
 - sign you in through `platform.mljar.com`,
-- create the app URL,
+- create the app URL on the first publish,
+- reuse the last successfully published app URL on later publishes,
 - upload the generated files,
 - and print the final app address.
 

supervised/apps/publisher.py

@@ -437,9 +437,9 @@ def publish_app_from_automl(
     verbose=True,
 ):
     try:
+        previous_url = _load_publish_state(automl).get("last_published_url")
         if verbose:
             print("Start app publish")
-            previous_url = _load_publish_state(automl).get("last_published_url")
             if previous_url:
                 print(f"Last published app URL: {previous_url}")
         overwrite_output = overwrite or path is None
@@ -458,12 +458,23 @@ def publish_app_from_automl(
         token = session.authenticate()
         client = PlatformClient(base_url=DEFAULT_PLATFORM_BASE_URL, token=token)
 
-        if url:
+        target_url = url or previous_url
+        if target_url:
             if verbose:
-                print(f"Checking existing app URL: {url}")
-            site = client.find_site_by_url(url)
+                print(f"Checking existing app URL: {target_url}")
+            site = client.find_site_by_url(target_url)
             if site is None:
-                raise AutoMLException(f"Could not find Mercury app for URL '{url}'.")
+                if url:
+                    raise AutoMLException(f"Could not find Mercury app for URL '{url}'.")
+                site_title = _workspace_title(output_path, fallback_title=title)
+                if verbose:
+                    print(
+                        f"Last published app URL not found on platform: {target_url}"
+                    )
+                    print("Creating app URL")
+                site = _create_site_with_generated_slug(client, site_title)
+                if verbose:
+                    print(f"Created app URL: {_site_url(site)}")
         else:
             site_title = _workspace_title(output_path, fallback_title=title)
             if verbose:
@@ -472,7 +483,7 @@ def publish_app_from_automl(
             if verbose:
                 print(f"Created app URL: {_site_url(site)}")
 
-        if verbose and url:
+        if verbose and target_url and site is not None:
             print(f"Using app URL: {_site_url(site)}")
 
         _upload_workspace_files(client, site, output_path, verbose=verbose)

tests/tests_automl/test_automl_publish_app.py

@@ -251,12 +251,48 @@ def test_publish_app_saves_and_prints_last_successful_url(
             state = json.load(fin)
         self.assertEqual(state.get("last_published_url"), first_url)
 
+        FakePublishingClient.sites = [FakePublishingClient.created_site]
+        FakePublishingClient.created_site = None
+
         second_stdout = io.StringIO()
         with patch("sys.stdout", second_stdout):
             second_url = model.publish_app(open_browser=False)
 
         self.assertEqual(second_url, first_url)
+        self.assertIsNone(FakePublishingClient.created_site)
         self.assertIn(f"Last published app URL: {first_url}", second_stdout.getvalue())
+        self.assertIn(f"Checking existing app URL: {first_url}", second_stdout.getvalue())
+        self.assertIn(f"Using app URL: {first_url}", second_stdout.getvalue())
+
+    @patch("supervised.apps.publisher.generate_machine_learning_slug", return_value="feature-lab")
+    @patch("supervised.apps.publisher.PlatformClient", FakePublishingClient)
+    @patch("supervised.apps.publisher.BrowserTokenSession.authenticate", return_value="app.jwt.token")
+    def test_publish_app_creates_new_site_when_last_published_url_is_missing(
+        self, _mock_authenticate, _mock_slug
+    ):
+        model = self._trained_model()
+
+        first_stdout = io.StringIO()
+        with patch("sys.stdout", first_stdout):
+            first_url = model.publish_app(open_browser=False)
+
+        self.assertEqual(first_url, "https://feature-lab.ismvp.org")
+        FakePublishingClient.created_site = None
+        FakePublishingClient.sites = []
+
+        second_stdout = io.StringIO()
+        with patch("sys.stdout", second_stdout):
+            second_url = model.publish_app(open_browser=False)
+
+        self.assertEqual(second_url, first_url)
+        self.assertIsNotNone(FakePublishingClient.created_site)
+        output = second_stdout.getvalue()
+        self.assertIn(f"Checking existing app URL: {first_url}", output)
+        self.assertIn(
+            f"Last published app URL not found on platform: {first_url}",
+            output,
+        )
+        self.assertIn("Creating app URL", output)
 
     @patch("supervised.apps.publisher.PlatformClient", FakePublishingClient)
     @patch("supervised.apps.publisher.BrowserTokenSession.authenticate", return_value="app.jwt.token")