nextmv 1.0.0.dev4__py3-none-any.whl → 1.0.0.dev6__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. nextmv/__about__.py +1 -1
  2. nextmv/__entrypoint__.py +1 -2
  3. nextmv/__init__.py +0 -4
  4. nextmv/cli/cloud/app/push.py +294 -204
  5. nextmv/cli/cloud/input_set/__init__.py +2 -0
  6. nextmv/cli/cloud/input_set/delete.py +67 -0
  7. nextmv/cli/cloud/run/create.py +4 -9
  8. nextmv/cli/cloud/shadow/stop.py +14 -2
  9. nextmv/cli/cloud/switchback/stop.py +14 -2
  10. nextmv/cli/community/clone.py +11 -197
  11. nextmv/cli/community/list.py +46 -116
  12. nextmv/cli/confirm.py +5 -3
  13. nextmv/cloud/__init__.py +4 -38
  14. nextmv/cloud/acceptance_test.py +1 -65
  15. nextmv/cloud/account.py +1 -6
  16. nextmv/cloud/application/__init__.py +1 -198
  17. nextmv/cloud/application/_batch_scenario.py +2 -17
  18. nextmv/cloud/application/_input_set.py +42 -6
  19. nextmv/cloud/application/_instance.py +1 -1
  20. nextmv/cloud/application/_managed_input.py +1 -1
  21. nextmv/cloud/application/_shadow.py +10 -4
  22. nextmv/cloud/application/_switchback.py +11 -2
  23. nextmv/cloud/application/_version.py +1 -1
  24. nextmv/cloud/batch_experiment.py +3 -1
  25. nextmv/cloud/community.py +441 -0
  26. nextmv/cloud/shadow.py +25 -0
  27. nextmv/deprecated.py +5 -3
  28. nextmv/input.py +0 -52
  29. nextmv/local/runner.py +1 -1
  30. nextmv/options.py +11 -256
  31. nextmv/output.py +0 -62
  32. nextmv/run.py +1 -10
  33. nextmv/status.py +1 -51
  34. {nextmv-1.0.0.dev4.dist-info → nextmv-1.0.0.dev6.dist-info}/METADATA +3 -1
  35. {nextmv-1.0.0.dev4.dist-info → nextmv-1.0.0.dev6.dist-info}/RECORD +38 -36
  36. {nextmv-1.0.0.dev4.dist-info → nextmv-1.0.0.dev6.dist-info}/WHEEL +0 -0
  37. {nextmv-1.0.0.dev4.dist-info → nextmv-1.0.0.dev6.dist-info}/entry_points.txt +0 -0
  38. {nextmv-1.0.0.dev4.dist-info → nextmv-1.0.0.dev6.dist-info}/licenses/LICENSE +0 -0
@@ -5,6 +5,7 @@ This module defines the cloud input-set command tree for the Nextmv CLI.
5
5
  import typer
6
6
 
7
7
  from nextmv.cli.cloud.input_set.create import app as create_app
8
+ from nextmv.cli.cloud.input_set.delete import app as delete_app
8
9
  from nextmv.cli.cloud.input_set.get import app as get_app
9
10
  from nextmv.cli.cloud.input_set.list import app as list_app
10
11
  from nextmv.cli.cloud.input_set.update import app as update_app
@@ -12,6 +13,7 @@ from nextmv.cli.cloud.input_set.update import app as update_app
12
13
  # Set up subcommand application.
13
14
  app = typer.Typer()
14
15
  app.add_typer(create_app)
16
+ app.add_typer(delete_app)
15
17
  app.add_typer(get_app)
16
18
  app.add_typer(list_app)
17
19
  app.add_typer(update_app)
@@ -0,0 +1,67 @@
1
+ """
2
+ This module defines the cloud input-set delete command for the Nextmv CLI.
3
+ """
4
+
5
+ from typing import Annotated
6
+
7
+ import typer
8
+
9
+ from nextmv.cli.configuration.config import build_app
10
+ from nextmv.cli.confirm import get_confirmation
11
+ from nextmv.cli.message import info, success
12
+ from nextmv.cli.options import AppIDOption, InputSetIDOption, ProfileOption
13
+
14
+ # Set up subcommand application.
15
+ app = typer.Typer()
16
+
17
+
18
+ @app.command()
19
+ def delete(
20
+ app_id: AppIDOption,
21
+ input_set_id: InputSetIDOption,
22
+ yes: Annotated[
23
+ bool,
24
+ typer.Option(
25
+ "--yes",
26
+ "-y",
27
+ help="Agree to deletion confirmation prompt. Useful for non-interactive sessions.",
28
+ ),
29
+ ] = False,
30
+ profile: ProfileOption = None,
31
+ ) -> None:
32
+ """
33
+ Deletes a Nextmv Cloud input set.
34
+
35
+ This action is permanent and cannot be undone. The input set and all
36
+ associated data will be deleted. Use the --yes flag to skip the
37
+ confirmation prompt.
38
+
39
+ [bold][underline]Examples[/underline][/bold]
40
+
41
+ - Delete the input set with the ID [magenta]hop-analysis[/magenta] from application
42
+ [magenta]hare-app[/magenta].
43
+ $ [dim]nextmv cloud input-set delete --app-id hare-app --input-set-id hop-analysis[/dim]
44
+
45
+ - Delete the input set without confirmation prompt.
46
+ $ [dim]nextmv cloud input-set delete --app-id hare-app --input-set-id carrot-routes --yes[/dim]
47
+ """
48
+
49
+ if not yes:
50
+ confirm = get_confirmation(
51
+ f"Are you sure you want to delete input set [magenta]{input_set_id}[/magenta] "
52
+ f"from application [magenta]{app_id}[/magenta]? This action cannot be undone.",
53
+ )
54
+
55
+ if not confirm:
56
+ info(
57
+ msg=f"Input set [magenta]{input_set_id}[/magenta] will not be deleted.",
58
+ emoji=":bulb:",
59
+ )
60
+ return
61
+
62
+ cloud_app = build_app(app_id=app_id, profile=profile)
63
+ cloud_app.delete_input_set(input_set_id=input_set_id)
64
+ success(
65
+ f"Input set [magenta]{input_set_id}[/magenta] deleted successfully "
66
+ f"from application [magenta]{app_id}[/magenta]."
67
+ )
@@ -129,7 +129,7 @@ def create(
129
129
  metavar="INSTANCE_ID",
130
130
  rich_help_panel="Run configuration",
131
131
  ),
132
- ] = "latest",
132
+ ] = None,
133
133
  integration_id: Annotated[
134
134
  str | None,
135
135
  typer.Option(
@@ -240,12 +240,11 @@ def create(
240
240
  specify the instance with the --instance-id flag. These are the possible
241
241
  values for this flag:
242
242
 
243
+ - [yellow]unspecified[/yellow]: Run against the default instance of the
244
+ application. When an application is created, the default instance is [magenta]latest[/magenta].
243
245
  - [yellow]latest[/yellow]: uses the special [magenta]latest[/magenta]
244
246
  instance of the application. This corresponds to the latest pushed
245
- executable. This is the default behavior.
246
- - [yellow]default[/yellow]: if the application has a [italic]default[/italic]
247
- instance configured, then it uses that instance. Setting the flag's value
248
- to [magenta]''[/magenta] (empty string) has the same effect.
247
+ executable.
249
248
  - [yellow]<INSTANCE_ID>[/yellow]: uses the instance with the given ID.
250
249
 
251
250
  [bold][underline]Examples[/underline][/bold]
@@ -319,10 +318,6 @@ def create(
319
318
  )
320
319
  run_options = build_run_options(options)
321
320
 
322
- # Handles the default instance.
323
- if instance_id == "default":
324
- instance_id = ""
325
-
326
321
  # Start the run before deciding if we should poll or not.
327
322
  input_kwarg = resolve_input_kwarg(
328
323
  stdin=stdin,
@@ -2,11 +2,14 @@
2
2
  This module defines the cloud shadow stop command for the Nextmv CLI.
3
3
  """
4
4
 
5
+ from typing import Annotated
6
+
5
7
  import typer
6
8
 
7
9
  from nextmv.cli.configuration.config import build_app
8
- from nextmv.cli.message import in_progress, success
10
+ from nextmv.cli.message import enum_values, in_progress, success
9
11
  from nextmv.cli.options import AppIDOption, ProfileOption, ShadowTestIDOption
12
+ from nextmv.cloud.shadow import StopIntent
10
13
 
11
14
  # Set up subcommand application.
12
15
  app = typer.Typer()
@@ -15,6 +18,15 @@ app = typer.Typer()
15
18
  @app.command()
16
19
  def stop(
17
20
  app_id: AppIDOption,
21
+ intent: Annotated[
22
+ StopIntent,
23
+ typer.Option(
24
+ "--intent",
25
+ "-i",
26
+ help=f"Intent for stopping the shadow test. Allowed values are: {enum_values(StopIntent)}.",
27
+ metavar="INTENT",
28
+ ),
29
+ ],
18
30
  shadow_test_id: ShadowTestIDOption,
19
31
  profile: ProfileOption = None,
20
32
  ) -> None:
@@ -34,7 +46,7 @@ def stop(
34
46
 
35
47
  in_progress(msg="Stopping shadow test...")
36
48
  cloud_app = build_app(app_id=app_id, profile=profile)
37
- cloud_app.stop_shadow_test(shadow_test_id=shadow_test_id)
49
+ cloud_app.stop_shadow_test(shadow_test_id=shadow_test_id, intent=StopIntent(intent))
38
50
  success(
39
51
  f"Shadow test [magenta]{shadow_test_id}[/magenta] stopped successfully "
40
52
  f"in application [magenta]{app_id}[/magenta]."
@@ -2,11 +2,14 @@
2
2
  This module defines the cloud switchback stop command for the Nextmv CLI.
3
3
  """
4
4
 
5
+ from typing import Annotated
6
+
5
7
  import typer
6
8
 
7
9
  from nextmv.cli.configuration.config import build_app
8
- from nextmv.cli.message import in_progress, success
10
+ from nextmv.cli.message import enum_values, in_progress, success
9
11
  from nextmv.cli.options import AppIDOption, ProfileOption, SwitchbackTestIDOption
12
+ from nextmv.cloud.shadow import StopIntent
10
13
 
11
14
  # Set up subcommand application.
12
15
  app = typer.Typer()
@@ -15,6 +18,15 @@ app = typer.Typer()
15
18
  @app.command()
16
19
  def stop(
17
20
  app_id: AppIDOption,
21
+ intent: Annotated[
22
+ StopIntent,
23
+ typer.Option(
24
+ "--intent",
25
+ "-i",
26
+ help=f"Intent for stopping the switchback test. Allowed values are: {enum_values(StopIntent)}.",
27
+ metavar="INTENT",
28
+ ),
29
+ ],
18
30
  switchback_test_id: SwitchbackTestIDOption,
19
31
  profile: ProfileOption = None,
20
32
  ) -> None:
@@ -34,7 +46,7 @@ def stop(
34
46
 
35
47
  in_progress(msg="Stopping switchback test...")
36
48
  cloud_app = build_app(app_id=app_id, profile=profile)
37
- cloud_app.stop_switchback_test(switchback_test_id=switchback_test_id)
49
+ cloud_app.stop_switchback_test(switchback_test_id=switchback_test_id, intent=StopIntent(intent))
38
50
  success(
39
51
  f"Switchback test [magenta]{switchback_test_id}[/magenta] stopped successfully "
40
52
  f"in application [magenta]{app_id}[/magenta]."
@@ -2,19 +2,14 @@
2
2
  This module defines the community clone command for the Nextmv CLI.
3
3
  """
4
4
 
5
- import os
6
- import shutil
7
- import tarfile
8
- import tempfile
9
- from collections.abc import Callable
10
5
  from typing import Annotated
11
6
 
12
- import rich
13
7
  import typer
14
8
 
15
- from nextmv.cli.community.list import download_file, download_manifest, find_app, versions_table
16
- from nextmv.cli.message import error, success
9
+ from nextmv.cli.configuration.config import build_client
10
+ from nextmv.cli.message import error
17
11
  from nextmv.cli.options import ProfileOption
12
+ from nextmv.cloud.community import clone_community_app
18
13
 
19
14
  # Set up subcommand application.
20
15
  app = typer.Typer()
@@ -77,196 +72,15 @@ def clone(
77
72
  $ [dim]nextmv community clone --app go-nextroute --profile hare[/dim]
78
73
  """
79
74
 
80
- manifest = download_manifest(profile=profile)
81
- app_obj = find_app(manifest, app)
82
-
83
75
  if version is not None and version == "":
84
76
  error("The --version flag cannot be an empty string.")
85
77
 
86
- if not app_has_version(app_obj, version):
87
- # We don't use error() here to allow printing something before exiting.
88
- rich.print(
89
- f"[red]Error:[/red] Version [magenta]{version}[/magenta] not found "
90
- f"for community app [magenta]{app}[/magenta]. Available versions are:"
91
- )
92
- versions_table(manifest, app)
93
-
94
- raise typer.Exit(code=1)
95
-
96
- original_version = version
97
- if version == LATEST_VERSION:
98
- version = app_obj.get("latest_app_version")
99
-
100
- # Clean and normalize directory path in an OS-independent way
101
- if directory is not None and directory != "":
102
- destination = os.path.normpath(directory)
103
- else:
104
- destination = app
105
-
106
- full_destination = get_valid_path(destination, os.stat)
107
- os.makedirs(full_destination, exist_ok=True)
108
-
109
- tarball = f"{app}_{version}.tar.gz"
110
- s3_file_path = f"{app}/{version}/{tarball}"
111
- downloaded_object = download_object(
112
- file=s3_file_path,
113
- path="community-apps",
114
- output_dir=full_destination,
115
- output_file=tarball,
116
- profile=profile,
117
- )
118
-
119
- # Extract the tarball to a temporary directory to handle nested structure
120
- with tempfile.TemporaryDirectory() as temp_dir:
121
- with tarfile.open(downloaded_object, "r:gz") as tar:
122
- tar.extractall(path=temp_dir)
123
-
124
- # Find the extracted directory (typically the app name)
125
- extracted_items = os.listdir(temp_dir)
126
- if len(extracted_items) == 1 and os.path.isdir(os.path.join(temp_dir, extracted_items[0])):
127
- # Move contents from the extracted directory to full_destination
128
- extracted_dir = os.path.join(temp_dir, extracted_items[0])
129
- for item in os.listdir(extracted_dir):
130
- shutil.move(os.path.join(extracted_dir, item), full_destination)
131
- else:
132
- # If structure is unexpected, move everything directly
133
- for item in extracted_items:
134
- shutil.move(os.path.join(temp_dir, item), full_destination)
135
-
136
- # Remove the tarball after extraction
137
- os.remove(downloaded_object)
138
-
139
- success(
140
- f"Successfully cloned the [magenta]{app}[/magenta] community app, "
141
- f"using version [magenta]{original_version}[/magenta] in path: [magenta]{full_destination}[/magenta]."
78
+ client = build_client(profile)
79
+ clone_community_app(
80
+ client=client,
81
+ app=app,
82
+ directory=directory,
83
+ version=version,
84
+ verbose=True,
85
+ rich_print=True,
142
86
  )
143
-
144
-
145
- def app_has_version(app_obj: dict, version: str) -> bool:
146
- """
147
- Check if the given app object has the specified version.
148
-
149
- Parameters
150
- ----------
151
- app_obj : dict
152
- The community app object.
153
- version : str
154
- The version to check.
155
-
156
- Returns
157
- -------
158
- bool
159
- True if the app has the specified version, False otherwise.
160
- """
161
-
162
- if version == LATEST_VERSION:
163
- version = app_obj.get("latest_app_version")
164
-
165
- if version in app_obj.get("app_versions", []):
166
- return True
167
-
168
- return False
169
-
170
-
171
- def get_valid_path(path: str, stat_fn: Callable[[str], os.stat_result], ending: str = "") -> str:
172
- """
173
- Validates and returns a non-existing path. If the path exists,
174
- it will append a number to the path and return it. If the path does not
175
- exist, it will return the path as is.
176
-
177
- The ending parameter is used to check if the path ends with a specific
178
- string. This is useful to specify if it is a file (like foo.json, in which
179
- case the next iteration is foo-1.json) or a directory (like foo, in which
180
- case the next iteration is foo-1).
181
-
182
- Parameters
183
- ----------
184
- path : str
185
- The initial path to validate.
186
- stat_fn : Callable[[str], os.stat_result]
187
- A function that takes a path and returns its stat result.
188
- ending : str, optional
189
- The expected ending of the path (e.g., file extension), by default "".
190
-
191
- Returns
192
- -------
193
- str
194
- A valid, non-existing path.
195
-
196
- Raises
197
- ------
198
- Exception
199
- If an unexpected error occurs during path validation
200
- """
201
- base_name = os.path.basename(path)
202
- name_without_ending = base_name.removesuffix(ending) if ending else base_name
203
-
204
- while True:
205
- try:
206
- stat_fn(path)
207
- # If we get here, the path exists
208
- # Get folder/file name number, increase it and create new path
209
- name = os.path.basename(path)
210
-
211
- # Get folder/file name number
212
- parts = name.split("-")
213
- last = parts[-1].removesuffix(ending) if ending else parts[-1]
214
-
215
- # Save last folder name index to be changed
216
- i = path.rfind(name)
217
-
218
- try:
219
- num = int(last)
220
- # Increase number and create new path
221
- if ending:
222
- temp_path = path[:i] + f"{name_without_ending}-{num + 1}{ending}"
223
- else:
224
- temp_path = path[:i] + f"{base_name}-{num + 1}"
225
- path = temp_path
226
- except ValueError:
227
- # If there is no number, add it
228
- if ending:
229
- temp_path = path[:i] + f"{name_without_ending}-1{ending}"
230
- else:
231
- temp_path = path[:i] + f"{name}-1"
232
- path = temp_path
233
-
234
- except FileNotFoundError:
235
- # Path doesn't exist, we can use it
236
- return path
237
- except Exception:
238
- # Re-raise unexpected errors
239
- error(f"An unexpected error occurred while validating the path: {path}")
240
-
241
-
242
- def download_object(file: str, path: str, output_dir: str, output_file: str, profile: str | None = None) -> str:
243
- """
244
- Downloads an object from the internal bucket and saves it to the specified
245
- output directory.
246
-
247
- Parameters
248
- ----------
249
- file : str
250
- The name of the file to download.
251
- path : str
252
- The directory in the bucket where the file is located.
253
- output_dir : str
254
- The local directory where the file will be saved.
255
- output_file : str
256
- The name of the output file.
257
- profile : str | None
258
- The profile name to use. If None, the default profile is used.
259
-
260
- Returns
261
- -------
262
- str
263
- The path to the downloaded file.
264
- """
265
-
266
- response = download_file(directory=path, file=file, profile=profile)
267
- file_name = os.path.join(output_dir, output_file)
268
-
269
- with open(file_name, "wb") as f:
270
- f.write(response.content)
271
-
272
- return file_name