Resets git repo to a clean state by discarding uncommitted changes
This action will reset your git repo to a clean state, discarding any uncommitted and untracked changes. Useful in case you need to revert the repo back to a clean state, e.g. after running fastlane.
Untracked files like
.envwill also be deleted, unless
It's a pretty drastic action so it comes with a sort of safety latch. It will only proceed with the reset if this condition is met:
- You have called the
ensure_git_status_cleanaction prior to calling this action. This ensures that your repo started off in a clean state, so the only things that will get destroyed by this action are files that are created as a byproduct of the fastlane run.
|Supported platforms||ios, android, mac|
reset_git_repo(force: true) # If you don't care about warnings and are absolutely sure that you want to discard all changes. This will reset the repo even if you have valuable uncommitted changes, so use with care!
reset_git_repo(skip_clean: true) # If you want "git clean" to be skipped, thus NOT deleting untracked files like ".env". Optional, defaults to false.
reset_git_repo( force: true, files: [ "./file.txt" ] )
||Array of files the changes should be discarded. If not given, all files will be discarded|
||Skip verifying of previously clean state of repo. Only recommended in combination with
||Skip 'git clean' to avoid removing untracked files like
||Setting this to true will clean the whole repository, ignoring anything in your local .gitignore. Set this to true if you want the equivalent of a fresh clone, and for all untracked and ignore files to also be removed||
||You can pass a string, or array of, file pattern(s) here which you want to have survive the cleaning process, and remain on disk, e.g. to leave the
* = default value is dependent on the user's system
To show the documentation in your terminal, run
fastlane action reset_git_repo
It is recommended to add the above action into your
Fastfile, however sometimes you might want to run one-offs. To do so, you can run the following command from your terminal
fastlane run reset_git_repo
To pass parameters, make use of the
: symbol, for example
fastlane run reset_git_repo parameter1:"value1" parameter2:"value2"
It's important to note that the CLI supports primative types like integers, floats, booleans, and strings. Arrays can be passed as a comma delimited string (e.g.
param:"1,2,3"). Hashes are not currently supported.
It is recommended to add all fastlane actions you use to your
This action, just like the rest of fastlane, is fully open source, view the source code on GitHub