[AIENG-414] Removed split-subset command by Rebecca-Smith2 · Pull Request #1277 · cloudbees-oss/smart-tests-cli

Rebecca-Smith2 · 2026-04-14T12:58:48Z

Removed the split-subset command and updated the CLI reference documentation for clarity and consistency, including rephrasing sentences and improving link formatting.

ono-max · 2026-04-16T02:55:36Z


 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--repo-branch-map` REPO_NAME=BRANCH_NAME
-|Set repository name and branch name when you use --no-commit-collection option. Please use the same repository name with a commit option (can be specified multiple times)


This explanation is generated from the following place. Please modify:

smart-tests-cli/smart_tests/commands/record/build.py

Line 50 in 588ca52

help="Set repository name and branch name when you use --no-commit-collection option. "

ono-max · 2026-04-16T02:56:53Z


 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--branch` NAME
-|Set branch name. A branch is a set of test sessions grouped and this option value will be used for a branch name.


This explanation is generated in the following place. Please modify:

smart-tests-cli/smart_tests/commands/record/build.py

Line 44 in 588ca52

help="Set branch name. A branch is a set of test sessions grouped and this option value will be used for a branch name.",

ono-max · 2026-04-16T03:21:45Z


 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--commit` REPO_NAME=COMMIT_HASH
-|Set repository name and commit hash when you use --no-commit-collection option (can be specified multiple times)


This explanation is generated from the following place. Please modify:

smart-tests-cli/smart_tests/commands/record/build.py

Line 76 in 588ca52

help="Set repository name and commit hash when you use --no-commit-collection option",

ono-max · 2026-04-16T03:35:22Z

 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--source` DIR
-|Path to local Git workspace, optionally prefixed by a label. like --source path/to/ws or --source main=path/to/ws (can be specified multiple times)
+|Path to local Git workspace, optionally prefixed by a label. Like --source path/to/ws or --source main=path/to/ws (can be specified multiple times)


smart-tests-cli/smart_tests/commands/record/build.py

Line 56 in 588ca52

help="Path to local Git workspace, optionally prefixed by a label. "

ono-max · 2026-04-16T03:35:46Z

 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--timestamp` TIMESTAMP
-|Used to overwrite the build time when importing historical data. Note: Format must be `YYYY-MM-DDThh:mm:ssTZD` or `YYYY-MM-DDThh:mm:ss` (local timezone applied)
+|Overwrites the build time when importing historical data. Note: Format must be `YYYY-MM-DDThh:mm:ssTZD` or `YYYY-MM-DDThh:mm:ss` (local timezone applied)


smart-tests-cli/smart_tests/commands/record/build.py

Line 80 in 588ca52

help="Used to overwrite the build time when importing historical data. "

ono-max · 2026-04-16T03:36:27Z


 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--no-build`
-|If you want to only send test reports, please use this option


smart-tests-cli/smart_tests/commands/record/session.py

Line 59 in 588ca52

help="If you want to only send test reports, please use this option"

ono-max · 2026-04-16T03:36:49Z


 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--test-suite` NAME
-|Set test suite name. A test suite is a collection of test sessions. Setting a test suite allows you to manage data over test sessions and lineages.


smart-tests-cli/smart_tests/commands/record/session.py

Line 34 in 588ca52

help="Set test suite name. A test suite is a collection of test sessions. Setting a test suite allows you to "

ono-max · 2026-04-16T03:37:39Z


 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--timestamp` TIMESTAMP
-|Used to overwrite the session time when importing historical data. Note: Format must be `YYYY-MM-DDThh:mm:ssTZD` or `YYYY-MM-DDThh:mm:ss` (local timezone applied)


smart-tests-cli/smart_tests/commands/record/session.py

Line 62 in 588ca52

help="Used to overwrite the session time when importing historical data. Note: Format must be "

ono-max · 2026-04-16T03:38:45Z


 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--no-base-path-inference`
-|Do not guess the base path to relativize the test file paths. By default, if the test file paths are absolute file paths, it automatically guesses the repository root directory and relativize the paths. With this option, the command doesn't do this guess work. If --base-path is specified, the absolute file paths are relativized to the specified path irrelevant to this option. Use it if the guessed base path is incorrect.


smart-tests-cli/smart_tests/commands/record/tests.py

Line 140 in 588ca52

help="Do not guess the base path to relativize the test file paths. By default, if the test file paths are "

ono-max · 2026-04-16T03:40:29Z

 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--session` SESSION
-|Session ID obtained by calling 'smart-tests record session'. It also accepts '@path/to/file' if the session ID is stored in a file 
+|Session ID from calling 'smart-tests record session'. Also accepts '@path/to/file' if a file stores the session ID 


smart-tests-cli/smart_tests/utils/session.py

Line 76 in 588ca52

help="Session ID obtained by calling 'smart-tests record session'. It also accepts '@path/to/file' if the session ID is stored in a file ", # noqa E501

ono-max · 2026-04-16T03:41:27Z

 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--days` INT
-|How many days of test sessions in the past to be stat
+|Number of days of test sessions to include in statistics


smart-tests-cli/smart_tests/commands/stats/test_sessions.py

Line 17 in 588ca52

help="How many days of test sessions in the past to be stat"

ono-max · 2026-04-16T03:42:08Z

 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--flavor` KEY=VALUE
-|flavors (can be specified multiple times)
+|Flavors (can be specified multiple times)


smart-tests-cli/smart_tests/commands/stats/test_sessions.py

Line 21 in 588ca52

help="flavors",

ono-max · 2026-04-16T03:43:15Z


 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--ignore-flaky-tests-above` N
-|Ignore flaky tests above the value set by this option. You can confirm flaky scores in WebApp


smart-tests-cli/smart_tests/commands/subset.py

Line 171 in 588ca52

help="Ignore flaky tests above the value set by this option. You can confirm flaky scores in WebApp",

ono-max · 2026-04-16T03:43:29Z

 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--ignore-new-tests`
-|Ignore tests that were added recently. NOTICE: this option will ignore tests that you added just now as well
+|Ignore tests added recently. NOTICE: This option will ignore tests just added now as well


smart-tests-cli/smart_tests/commands/subset.py

Line 154 in 588ca52

help="Ignore tests that were added recently. "

ono-max · 2026-04-16T03:43:42Z

 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--no-base-path-inference`
-|Do not guess the base path to relativize the test file paths. By default, if the test file paths are absolute file paths, it automatically guesses the repository root directory and relativize the paths. With this option, the command doesn't do this guess work. If --base is specified, the absolute file paths are relativized to the specified path irrelevant to this option. Use it if the guessed base path is incorrect.
+|Do not guess the base path to convert the test file paths to relative paths. By default, if the test file paths are absolute file paths, the command automatically guesses the repository root directory and converts the paths to relative paths. With this option, the command skips this inference. If --base specifies a path, the command converts the absolute file paths to relative paths based on that path regardless of this option. Use this option if the guessed base path is incorrect.


smart-tests-cli/smart_tests/commands/subset.py

Line 145 in 588ca52

help="Do not guess the base path to relativize the test file paths. "

ono-max · 2026-04-16T03:44:08Z

 // GENERATED. MODIFY IN CLI SOURCE CODE
 |`--rest` FILE
-|Output the subset remainder to a file, e.g. --rest=remainder.txt
+|Output the subset remainder to a file, for example --rest=remainder.txt


smart-tests-cli/smart_tests/commands/subset.py

Line 136 in 588ca52

help="Output the subset remainder to a file, e.g. --rest=remainder.txt",

ono-max

After addressing comments, please generate the CLI reference by running tools/generate_reference.py. Here is the example.

$ uv run python tools/generate_reference.py smart_tests/docs/modules/resources/pages/cli-reference.adoc

Removed split-subset command

41c0190

Removed the split-subset command and updated the CLI reference documentation for clarity and consistency, including rephrasing sentences and improving link formatting.

ono-max reviewed Apr 16, 2026

View reviewed changes

Conversation

Rebecca-Smith2 commented Apr 14, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ono-max left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ono-max left a comment •

edited

Loading