diff --git a/dvc/api.py b/dvc/api.py index d7c584b36d..f9b2f4fe52 100644 --- a/dvc/api.py +++ b/dvc/api.py @@ -20,7 +20,7 @@ def get_url(path, repo=None, rev=None, remote=None): in a DVC repo. For Git repos, HEAD is used unless a rev argument is supplied. The default remote is tried unless a remote argument is supplied. - Raises OutputNotFoundError if the file is not a dvc-tracked file. + Raises OutputNotFoundError if the file is not tracked by DVC. NOTE: This function does not check for the actual existence of the file or directory in the remote storage. diff --git a/dvc/command/metrics.py b/dvc/command/metrics.py index 9daf5984a7..de11479691 100644 --- a/dvc/command/metrics.py +++ b/dvc/command/metrics.py @@ -171,9 +171,8 @@ def add_parser(subparsers, parent_parser): "targets", nargs="*", help=( - "Limit command scope to these metric files (supports any file, " - "even when not found as `metrics` in `dvc.yaml`). Using -R, " - "directories to search metric files in can also be given." + "Limit command scope to these metrics files. Using -R, " + "directories to search metrics files in can also be given." ), ).complete = completion.FILE metrics_show_parser.add_argument( @@ -209,7 +208,7 @@ def add_parser(subparsers, parent_parser): default=False, help=( "If any target is a directory, recursively search and process " - "metric files." + "metrics files." ), ) metrics_show_parser.set_defaults(func=CmdMetricsShow) @@ -237,8 +236,8 @@ def add_parser(subparsers, parent_parser): "--targets", nargs="*", help=( - "Limit command scope to these metric files. Using -R, " - "directories to search metric files in can also be given." + "Limit command scope to these metrics files. Using -R, " + "directories to search metrics files in can also be given." ), metavar="", ).complete = completion.FILE @@ -249,7 +248,7 @@ def add_parser(subparsers, parent_parser): default=False, help=( "If any target is a directory, recursively search and process " - "metric files." + "metrics files." ), ) metrics_diff_parser.add_argument( diff --git a/dvc/command/plots.py b/dvc/command/plots.py index e100c91891..ed4ade7722 100644 --- a/dvc/command/plots.py +++ b/dvc/command/plots.py @@ -124,7 +124,7 @@ def add_parser(subparsers, parent_parser): fix_subparsers(plots_subparsers) - SHOW_HELP = "Generate plots from metric files." + SHOW_HELP = "Generate plots from metrics files." plots_show_parser = plots_subparsers.add_parser( "show", parents=[parent_parser], @@ -176,7 +176,7 @@ def add_parser(subparsers, parent_parser): _add_output_arguments(plots_diff_parser) plots_diff_parser.set_defaults(func=CmdPlotsDiff) - PLOTS_MODIFY_HELP = "Modify display properties of plot metric files." + PLOTS_MODIFY_HELP = "Modify display properties of plot metrics files." plots_modify_parser = plots_subparsers.add_parser( "modify", parents=[parent_parser], diff --git a/dvc/command/run.py b/dvc/command/run.py index 3278eaceb6..735fc044e9 100644 --- a/dvc/command/run.py +++ b/dvc/command/run.py @@ -134,7 +134,7 @@ def add_parser(subparsers, parent_parser): "--metrics", action="append", default=[], - help="Declare output metric file.", + help="Declare output metrics file.", metavar="", ) run_parser.add_argument( @@ -142,7 +142,7 @@ def add_parser(subparsers, parent_parser): "--metrics-no-cache", action="append", default=[], - help="Declare output metric file (do not put into DVC cache).", + help="Declare output metrics file (do not put into DVC cache).", metavar="", ) run_parser.add_argument( diff --git a/dvc/dependency/__init__.py b/dvc/dependency/__init__.py index 76e1c87cce..7ed45fd967 100644 --- a/dvc/dependency/__init__.py +++ b/dvc/dependency/__init__.py @@ -49,7 +49,7 @@ # NOTE: schema for dependencies is basically the same as for outputs, but # without output-specific entries like 'cache' (whether or not output is # cached, see -o and -O flags for `dvc run`) and 'metric' (whether or not -# output is a metric file and how to parse it, see `-M` flag for `dvc run`). +# output is a metrics file and how to parse it, see `-M` flag for `dvc run`). SCHEMA = output.SCHEMA.copy() del SCHEMA[BaseOutput.PARAM_CACHE] del SCHEMA[BaseOutput.PARAM_METRIC] diff --git a/dvc/exceptions.py b/dvc/exceptions.py index fad60df909..783e4eec9c 100644 --- a/dvc/exceptions.py +++ b/dvc/exceptions.py @@ -42,7 +42,7 @@ def __init__(self, output, stages): class OutputNotFoundError(DvcException): - """Thrown if a file/directory not found in repository pipelines. + """Thrown if a file/directory is not found as an output in any pipeline. Args: output (unicode): path to the file/directory. @@ -105,7 +105,7 @@ def __init__(self, path): class MoveNotDataSourceError(DvcException): - """Thrown if attempted to move a file/directory that is not an output + """Thrown when trying to move a file/directory that is not an output in a data source stage. Args: @@ -164,7 +164,7 @@ class BadMetricError(DvcException): def __init__(self, paths): super().__init__( "the following metrics do not exist, " - "are not metric files or are malformed: {paths}".format( + "are not metrics files or are malformed: {paths}".format( paths=", ".join(f"'{path}'" for path in paths) ) ) diff --git a/dvc/repo/metrics/show.py b/dvc/repo/metrics/show.py index 81a34151e8..9d3d2c9562 100644 --- a/dvc/repo/metrics/show.py +++ b/dvc/repo/metrics/show.py @@ -100,12 +100,12 @@ def show( if not res: if metrics_found: msg = ( - "Could not parse metric files. Use `-v` option to see more " + "Could not parse metrics files. Use `-v` option to see more " "details." ) else: msg = ( - "no metric files in this repository. Use `-m/-M` options for " + "no metrics files in this repository. Use `-m/-M` options for " "`dvc run` to mark stage outputs as metrics." ) raise NoMetricsError(msg)