./pants filter [args]
Filter the input targets based on various criteria.
Config section: [filter]
Basic options
--filter-output-file=<path>PANTS_FILTER_OUTPUT_FILEoutput_file
default:
Output to this file. If unspecified, outputs to stdout.
None
Output to this file. If unspecified, outputs to stdout.
--filter-sep=<separator>PANTS_FILTER_SEPsep
default:
String to use to separate lines in line-oriented output.
\n
String to use to separate lines in line-oriented output.
--filter-target-type="[[+-]type1,type2,..., [+-]type1,type2,..., ...]"PANTS_FILTER_TARGET_TYPEtarget_type
default:
Filter on these target types, e.g. `resources` or `python_library`.
[]
Filter on these target types, e.g. `resources` or `python_library`.
--filter-address-regex="[[+-]regex1,regex2,..., [+-]regex1,regex2,..., ...]"PANTS_FILTER_ADDRESS_REGEXaddress_regex
default:
Filter on target addresses matching these regexes.
[]
Filter on target addresses matching these regexes.
--filter-tag-regex="[[+-]regex1,regex2,..., [+-]regex1,regex2,..., ...]"PANTS_FILTER_TAG_REGEXtag_regex
default:
Filter on targets with tags matching these regexes.
[]
Filter on targets with tags matching these regexes.
Advanced options
None
Deprecated options
--filter-type="[[+-]type1,type2,..., [+-]type1,type2,..., ...]"PANTS_FILTER_TYPEtype
default:
Deprecated, will be removed in version: 2.1.0.dev0.
Use `--target-type` instead of `--type`.
Filter on these target types, e.g. `resources` or `python_library`.
[]
Deprecated, will be removed in version: 2.1.0.dev0.
Use `--target-type` instead of `--type`.
Filter on these target types, e.g. `resources` or `python_library`.
--filter-regex="[[+-]regex1,regex2,..., [+-]regex1,regex2,..., ...]"PANTS_FILTER_REGEXregex
default:
Deprecated, will be removed in version: 2.1.0.dev0.
Use `--address-regex` instead of `--regex`.
Filter on target addresses matching these regexes.
[]
Deprecated, will be removed in version: 2.1.0.dev0.
Use `--address-regex` instead of `--regex`.
Filter on target addresses matching these regexes.
--filter-target="[[+-]spec1,spec2,..., [+-]spec1,spec2,..., ...]"PANTS_FILTER_TARGETtarget
default:
Deprecated, will be removed in version: 2.1.0.dev0.
`--filter-target` was removed because it is similar to `--filter-address-regex`. If you still need this feature, please message us on Slack (https://www.pantsbuild.org/docs/community).
Filter on these target addresses.
[]
Deprecated, will be removed in version: 2.1.0.dev0.
`--filter-target` was removed because it is similar to `--filter-address-regex`. If you still need this feature, please message us on Slack (https://www.pantsbuild.org/docs/community).
Filter on these target addresses.
--filter-ancestor="[[+-]spec1,spec2,..., [+-]spec1,spec2,..., ...]"PANTS_FILTER_ANCESTORancestor
default:
Deprecated, will be removed in version: 2.1.0.dev0.
`--filter-ancestor` was removed because it is not trivial to implement. If you still need this feature, please message us on Slack (https://www.pantsbuild.org/docs/community).
Filter on targets that these targets depend on.
[]
Deprecated, will be removed in version: 2.1.0.dev0.
`--filter-ancestor` was removed because it is not trivial to implement. If you still need this feature, please message us on Slack (https://www.pantsbuild.org/docs/community).
Filter on targets that these targets depend on.
Related subsystems
Updated about a month ago