|
1 | | -# All settings are optional (with their default values provided below), and |
2 | | -# can also be set with an environment variable with the same name, capitalized |
3 | | -# and prefixed by `BASHLY_` - for example: BASHLY_SOURCE_DIR |
| 1 | +#------------------------------------------------------------------------------- |
| 2 | +# BASHLY SETTINGS |
| 3 | +#------------------------------------------------------------------------------- |
4 | 4 | #
|
5 | | -# When setting environment variables, you can use: |
6 | | -# - "0", "false" or "no" to represent false |
7 | | -# - "1", "true" or "yes" to represent true |
| 5 | +### Default Values |
| 6 | +# |
| 7 | +# All settings are optional, with their default values provided below |
| 8 | +# |
| 9 | +### Environment Variables |
| 10 | +# |
| 11 | +# Values can also be set using an environment variable with the same name, |
| 12 | +# capitalized and prefixed by `BASHLY_` - for example: `BASHLY_SOURCE_DIR` |
| 13 | +# |
| 14 | +# When setting environment variables, you can use: |
| 15 | +# - "0", "false" or "no" to represent false |
| 16 | +# - "1", "true" or "yes" to represent true |
| 17 | +# |
| 18 | +# Environment variables take precedence over values in the config file. |
| 19 | +# |
| 20 | +### File Location: |
| 21 | +# |
| 22 | +# Bashly looks for the settings file in these locations. |
| 23 | +# - The path defined in the `BASHLY_SETTINGS_PATH` environment variable. |
| 24 | +# - A file named `bashly-settings.yml` in the working directory. |
| 25 | +# - A file named `settings.yml` in the working directory. |
| 26 | +# |
| 27 | +### Environment Overrides: |
| 28 | +# |
| 29 | +# All options (except `env`) may be specified with an environment suffix in |
| 30 | +# order to override its value for a given environment. |
| 31 | +# |
| 32 | +# For example, when defining `formatter_production: shfmt --minify`, then |
| 33 | +# this will be the formatter used when generating the script with |
| 34 | +# `bashly generate --env production` |
| 35 | +# |
| 36 | +# Since these values take precedence over the standard values, you can define |
| 37 | +# both (i.e. `formatter: shfmt` and `formatter_production: shfmt --minify`). |
8 | 38 | #
|
9 | | -# If you wish to change the path to this file, set the environment variable |
10 | | -# BASHLY_SETTINGS_PATH. |
11 | | - |
12 | 39 |
|
13 | 40 | #-------------------------------------------------------------------------------
|
14 | 41 | # PATH OPTIONS
|
@@ -52,12 +79,12 @@ strict: false
|
52 | 79 | tab_indent: false
|
53 | 80 |
|
54 | 81 | # Choose a post-processor for the generated script:
|
55 | | -# formatter: internal # Use Bashly's internal formatter (compacts newlines) |
| 82 | +# formatter: internal # Use Bashly’s built-in formatter (removes extra newlines) |
56 | 83 | # formatter: external # Run the external command `shfmt --case-indent --indent 2`
|
57 | 84 | # formatter: none # Disable formatting entirely
|
58 | | -# formatter: <string> # Use a custom shell command to format the script. |
59 | | -# # The command will receive the script via stdin and |
60 | | -# # must output the result to stdout. |
| 85 | +# formatter: <string> # Provide a custom shell command to format the script. |
| 86 | +# # The command receives the script via stdin and must |
| 87 | +# # write the result to stdout. |
61 | 88 | # # Example: shfmt --minify
|
62 | 89 | formatter: internal
|
63 | 90 |
|
@@ -102,7 +129,7 @@ usage_colors:
|
102 | 129 | #-------------------------------------------------------------------------------
|
103 | 130 |
|
104 | 131 | # Set to 'production' or 'development'.
|
105 | | -# Determines which features are enabled in the rendered script. |
| 132 | +# Determines which features are enabled in the generated script. |
106 | 133 | # Use the `enable_*` options below to adjust settings for each environment.
|
107 | 134 | # It is recommended to leave this set to 'development' and run
|
108 | 135 | # `bashly generate --env production` when the production version is needed.
|
|
0 commit comments