Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ref: repro accepts outputs as targets #2362

Closed
wants to merge 10 commits into from
11 changes: 9 additions & 2 deletions content/docs/command-reference/repro.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ usage: dvc repro [-h] [-q | -v] [-f] [-s] [-m] [--dry] [-i]
[targets [<target> ...]]

positional arguments:
targets Stages to reproduce. 'dvc.yaml' by default.
targets Stages or output files to reproduce. 'dvc.yaml' by default.
jorgeorpinel marked this conversation as resolved.
Show resolved Hide resolved
```

> See [`targets`](#options) for more details.
Expand Down Expand Up @@ -109,14 +109,21 @@ up-to-date and only execute the final stage.
- `dvc repro -R pipelines/`: Directory path to explore recursively for
`dvc.yaml` files
- `dvc repro train-model`: Specific stage in `./dvc.yaml`
- `dvc repro model.pt`: Specific output file or directory listed in `./dvc.yaml` (`outs` field.)
- `dvc repro modeling/dvc.yaml:prepare`: Stage in a specific `dvc.yaml` file
- `dvc repro --glob train-*`: Pattern to match groups of stages
- `dvc repro --glob-stages 'train-*'`: Pattern to match groups of stages
- `dvc repro --glob '*output*'`: Pattern to match groups of output filenames
jorgeorpinel marked this conversation as resolved.
Show resolved Hide resolved

- `-R`, `--recursive` - looks for `dvc.yaml` files to reproduce in any
directories given as `targets`, and in their subdirectories. If there are no
directories among the targets, this option has no effect.

- `--glob` - causes the `targets` to be interpreted as wildcard
[patterns](https://docs.python.org/3/library/glob.html) to match for output
names. For example: `output*` (certain output names). Note that it
Copy link
Contributor

@jorgeorpinel jorgeorpinel Apr 7, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
names. For example: `output*` (certain output names). Note that it
files or directories. For example: `output*` (certain outputs). Note that it

matches patterns with all defined output names.
jorgeorpinel marked this conversation as resolved.
Show resolved Hide resolved

- `--glob-stages` - causes the `targets` to be interpreted as wildcard
[patterns](https://docs.python.org/3/library/glob.html) to match for stage
names. For example: `train-*` (certain stage names) or
`models/dvc.yaml:train-*` (stages in specific `dvc.yaml` file). Note that it
Vonski marked this conversation as resolved.
Show resolved Hide resolved
Expand Down