In order to install Statue, simply run:
pip install statue
You can validate statue has been installed successfully by running:
statue --version
Which will print:
statue, version {{ version() }}
In order for Statue to work correctly, you need to initialize Statue's configuration file. This is simply done by going to your project's root directory and using the command:
statue config init -i
This command will create statue.toml file with the relevant configurations. Just follow the instructions, and your Statue configuration file will be ready!
!!! note
The flag `-i` flag is important. It will make *Statue* install all commands added in the configuration.
You can see which commands have been set in your configuration using the command:
statue config show-tree
If you want to look at your configuration file as plain text, you can alternatively use:
statue config show
!!! note
When using `statue config init`, *Statue* will ask you to specify for each source which [contexts](contexts.md),
allowed commands and denied commands to apply to that source. If you are not sure how to respond, skip by pressing
enter. You'll always be able to edit your configuration later.
Now that your configuration file is ready, simply run:
statue run
And all the commands defined in the configuration will run on your codebase.
!!! note
When running `statue run`, *Statue* creates a cache directory named *.statue* which is saved in your project's
root directory. If you're using *git* as your VCS tool we highly recommend that you add *.statue* to your
*.gitignore* file.
We highly recommend fixing your commands versions in the configuration. This will make sure every developer working on your project uses the same command versions. You can do so by running:
statue config fix-versions
If you want to fix the versions of your commands to their latest available version, simply run:
statue config fix-versions --latest
- Learn how to use
statue run
in various ways to improve efficiency - Learn how to use contexts in order to specify the way you want your formatters and linters to run
- Learn how to edit your configuration file via command line