HomeDocs
DocsCommunityTestimonialsUsersGitHubTwitterBlogJobsTermsPrivacyCookies
TermsPrivacyCookies
Hey! These docs are for version 2.8, which is no longer officially supported. Click here for the latest version, 2.18!




Format and fix safe deprecations in BUILD files.

This does not handle the full Pants upgrade. You must still manually change `pants_version` in `pants.toml` and you may need to manually address some deprecations. See [Upgrade tips](🔗) for upgrade tips.

This goal is run without arguments. It will run over all BUILD files in your project.

Config section: <span style="color: purple"><code>[update-build-files]</code></span>

## Basic options

<div style="color: purple"> <h3><code>check</code></h3> <code>--[no-]update-build-files-check</code><br> <code>PANTS_UPDATE_BUILD_FILES_CHECK</code><br> </div> <div style="padding-left: 2em;"> <span style="color: green">default: <code>False</code></span>

<br>

Do not write changes to disk, only write back what would change. Return code 0 means there would be no changes, and 1 means that there would be.

</div> <br>

<div style="color: purple"> <h3><code>fmt</code></h3> <code>--[no-]update-build-files-fmt</code><br> <code>PANTS_UPDATE_BUILD_FILES_FMT</code><br> </div> <div style="padding-left: 2em;"> <span style="color: green">default: <code>True</code></span>

<br>

Format BUILD files using Black.

Set `[black].args`, `[black].config`, and `[black].config_discovery` to change Black's behavior. Set `[black].interpreter_constraints` and `[python].interpreter_search_path` to change which interpreter is used to run Black.

</div> <br>

<div style="color: purple"> <h3><code>fix_safe_deprecations</code></h3> <code>--[no-]update-build-files-fix-safe-deprecations</code><br> <code>PANTS_UPDATE_BUILD_FILES_FIX_SAFE_DEPRECATIONS</code><br> </div> <div style="padding-left: 2em;"> <span style="color: green">default: <code>True</code></span>

<br>

Automatically fix deprecations, such as target type renames, that are safe because they do not change semantics.

</div> <br>

## Advanced options

None

## Deprecated options

None