mlcflow 1.2.2__tar.gz → 1.2.3__tar.gz

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 (28) hide show
  1. {mlcflow-1.2.2 → mlcflow-1.2.3}/PKG-INFO +1 -1
  2. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/main.py +5 -3
  3. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/script_action.py +94 -16
  4. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlcflow.egg-info/PKG-INFO +1 -1
  5. {mlcflow-1.2.2 → mlcflow-1.2.3}/pyproject.toml +1 -1
  6. {mlcflow-1.2.2 → mlcflow-1.2.3}/LICENSE.md +0 -0
  7. {mlcflow-1.2.2 → mlcflow-1.2.3}/README.md +0 -0
  8. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/__init__.py +0 -0
  9. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/__main__.py +0 -0
  10. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/action.py +0 -0
  11. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/action_factory.py +0 -0
  12. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/cache_action.py +0 -0
  13. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/cfg_action.py +0 -0
  14. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/error_codes.py +0 -0
  15. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/experiment_action.py +0 -0
  16. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/index.py +0 -0
  17. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/item.py +0 -0
  18. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/logger.py +0 -0
  19. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/meta_schema.py +0 -0
  20. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/repo.py +0 -0
  21. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/repo_action.py +0 -0
  22. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlc/utils.py +0 -0
  23. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlcflow.egg-info/SOURCES.txt +0 -0
  24. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlcflow.egg-info/dependency_links.txt +0 -0
  25. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlcflow.egg-info/entry_points.txt +0 -0
  26. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlcflow.egg-info/requires.txt +0 -0
  27. {mlcflow-1.2.2 → mlcflow-1.2.3}/mlcflow.egg-info/top_level.txt +0 -0
  28. {mlcflow-1.2.2 → mlcflow-1.2.3}/setup.cfg +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mlcflow
3
- Version: 1.2.2
3
+ Version: 1.2.3
4
4
  Summary: An automation interface tailored for CPU/GPU benchmarking
5
5
  Author-email: MLCommons <systems@mlcommons.org>
6
6
  License:
@@ -570,11 +570,13 @@ def main():
570
570
  help_text += method.__doc__
571
571
  elif pre_args.action and pre_args.target:
572
572
  actions = get_action(pre_args.target, default_parent)
573
+ action_name = pre_args.action.replace("-", "_")
573
574
  try:
574
- method = getattr(actions, pre_args.action)
575
+ method = getattr(actions, action_name)
575
576
  help_text += actions.__doc__
576
- help_text += method.__doc__
577
- except BaseException:
577
+ if method.__doc__:
578
+ help_text += method.__doc__
579
+ except AttributeError:
578
580
  logger.error(
579
581
  f"Error: '{pre_args.action}' is not supported for {pre_args.target}.")
580
582
  if help_text != "":
@@ -377,25 +377,37 @@ Main Script Meta:""")
377
377
  Flags Available:
378
378
 
379
379
  1. --docker_dt or --docker_detached:
380
- Runs the specified script inside a Docker container in detached mode (e.g., `mlc docker run --tags=detect,os --docker_dt).
380
+ Runs the specified script inside a Docker container in detached mode.
381
381
  By default, the Docker container is launched in interactive mode.
382
382
  2. --docker_cache:
383
- Disabling this flag forces Docker to build all layers from scratch, ignoring cached layers. (e.g., mlc docker run --tags=detect,os --docker_cache=no)
384
- By default, the value is set to true/yes.
383
+ Disabling this flag forces Docker to build all layers from scratch, ignoring cached layers (default: yes)
385
384
  3. --docker_rebuild:
386
- Enables rebuilding the Docker container even if an existing container with the same tag is present. (e.g., mlc docker run --tags=detect,os --docker_rebuild)
387
- By default, the value is set to False.
388
- 4. --dockerfile_recreate:
389
- Forces recreation of the **Dockerfile** during execution. (e.g., mlc docker run --tags=detect,os --docker_rebuild --dockerfile_recreate)
390
- By default, the value is set to False.
385
+ Rebuilds the Docker image even if one with the same tag already exists (default: False)
386
+ 4. --docker_noregenerate:
387
+ Skip regeneration of the Dockerfile during execution (default: False)
388
+ 5. --docker_image_repo:
389
+ Custom Docker image repository name
390
+ 6. --docker_verbose:
391
+ Enable verbose output during Docker operations
392
+ 7. --docker_silent:
393
+ Suppress output during Docker operations
394
+ 8. --docker_host_mlc_repos:
395
+ Mount host MLC repos inside the container
396
+ 9. --docker_upload:
397
+ Push the built Docker image after execution
398
+ 10. --docker_run_cmd_prefix:
399
+ Prefix to prepend to the run command inside the container
391
400
 
392
401
  Example Command:
393
402
 
394
403
  mlc docker script --tags=detect,os -j
404
+ mlcd detect,os -j
395
405
 
396
406
  """
397
407
  return self.call_script_module_function("docker", run_args)
398
408
 
409
+ docker.__doc__ = docker_run.__doc__
410
+
399
411
  def remote_run(self, run_args):
400
412
  """
401
413
  ####################################################################################################################
@@ -409,13 +421,32 @@ Main Script Meta:""")
409
421
  Flags Available:
410
422
 
411
423
  1. --remote_host:
412
- IP or hostnanme for the remote machine
424
+ IP or hostname for the remote machine (default: localhost)
413
425
  2. --remote_port:
414
- ssh port for the remote machineIP or hostnanme for the remote machine
426
+ SSH port for the remote machine (default: 22)
427
+ 3. --remote_user:
428
+ Username for SSH login on the remote machine
429
+ 4. --remote_password:
430
+ Password for SSH authentication
431
+ 5. --remote_ssh_key_file:
432
+ Path to the SSH private key file for authentication
433
+ 6. --remote_skip_host_verify:
434
+ Skip SSH host key verification
435
+ 7. --remote_python_venv:
436
+ Name of the Python virtual environment on the remote machine (default: mlcflow)
437
+ 8. --remote_pull_mlc_repos:
438
+ Pull MLC repos on the remote machine before running
439
+ 9. --remote_copy_directory:
440
+ Remote directory to copy files to (default: mlc-remote-artifacts)
441
+ 10. --remote_pre_run_cmds:
442
+ Commands to run on the remote machine before the main script
443
+ 11. --remote_client_refresh:
444
+ Refresh the SSH client connection
415
445
 
416
446
  Example Command:
417
447
 
418
448
  mlc remote-run script --tags=detect,os -j
449
+ mlcrr detect,os -j
419
450
 
420
451
  """
421
452
  return self.call_script_module_function("remote_run", run_args)
@@ -539,12 +570,23 @@ Main Script Meta:""")
539
570
  Action: Experiment
540
571
  ####################################################################################################################
541
572
 
542
- The `experiment` action currently does the function same as of run script, proper workflow will be added in future.
543
- experiment-specific functionality.
573
+ The `experiment` action automates exploration runs of MLC scripts.
574
+
575
+ Flags Available:
576
+
577
+ 1. --exp_tags:
578
+ Comma-separated extra tags for the experiment run
579
+ 2. --exp_skip_state_save:
580
+ Skip saving the system state during the experiment (default: False)
581
+ 3. --exp.<key>=<value>:
582
+ Pass experiment-specific parameters using the `exp.` prefix (e.g., --exp.batch_size=32)
583
+
584
+ In addition, all flags supported by the `run` action are also available.
544
585
 
545
586
  Example Command:
546
587
 
547
588
  mlc experiment script --tags=detect,os -j
589
+ mlce detect,os -j
548
590
 
549
591
  """
550
592
  return self.call_script_module_function("experiment", run_args)
@@ -561,9 +603,27 @@ Main Script Meta:""")
561
603
  Flags Available:
562
604
 
563
605
  1. --remote_host:
564
- IP or hostname for the remote machine
606
+ IP or hostname for the remote machine (default: localhost)
565
607
  2. --remote_port:
566
- ssh port for the remote machine
608
+ SSH port for the remote machine (default: 22)
609
+ 3. --remote_user:
610
+ Username for SSH login on the remote machine
611
+ 4. --remote_password:
612
+ Password for SSH authentication
613
+ 5. --remote_ssh_key_file:
614
+ Path to the SSH private key file for authentication
615
+ 6. --remote_skip_host_verify:
616
+ Skip SSH host key verification
617
+ 7. --remote_python_venv:
618
+ Name of the Python virtual environment on the remote machine (default: mlcflow)
619
+ 8. --remote_pull_mlc_repos:
620
+ Pull MLC repos on the remote machine before running
621
+ 9. --remote_copy_directory:
622
+ Remote directory to copy files to (default: mlc-remote-artifacts)
623
+ 10. --remote_pre_run_cmds:
624
+ Commands to run on the remote machine before the main script
625
+ 11. --remote_client_refresh:
626
+ Refresh the SSH client connection
567
627
 
568
628
  Example Command:
569
629
 
@@ -586,9 +646,27 @@ Main Script Meta:""")
586
646
  Flags Available:
587
647
 
588
648
  1. --remote_host:
589
- IP or hostname for the remote machine
649
+ IP or hostname for the remote machine (default: localhost)
590
650
  2. --remote_port:
591
- ssh port for the remote machine
651
+ SSH port for the remote machine (default: 22)
652
+ 3. --remote_user:
653
+ Username for SSH login on the remote machine
654
+ 4. --remote_password:
655
+ Password for SSH authentication
656
+ 5. --remote_ssh_key_file:
657
+ Path to the SSH private key file for authentication
658
+ 6. --remote_skip_host_verify:
659
+ Skip SSH host key verification
660
+ 7. --remote_python_venv:
661
+ Name of the Python virtual environment on the remote machine (default: mlcflow)
662
+ 8. --remote_pull_mlc_repos:
663
+ Pull MLC repos on the remote machine before running
664
+ 9. --remote_copy_directory:
665
+ Remote directory to copy files to (default: mlc-remote-artifacts)
666
+ 10. --remote_pre_run_cmds:
667
+ Commands to run on the remote machine before the main script
668
+ 11. --remote_client_refresh:
669
+ Refresh the SSH client connection
592
670
 
593
671
  Example Command:
594
672
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mlcflow
3
- Version: 1.2.2
3
+ Version: 1.2.3
4
4
  Summary: An automation interface tailored for CPU/GPU benchmarking
5
5
  Author-email: MLCommons <systems@mlcommons.org>
6
6
  License:
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "mlcflow"
7
- version = "1.2.2"
7
+ version = "1.2.3"
8
8
 
9
9
  description = "An automation interface tailored for CPU/GPU benchmarking"
10
10
  authors = [
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes