A collection of commands and utilities that aim to make developer's lives a bit easier.
Run brew tap apainintheneck/dev-utils
.
Usage: brew api-readall-test [options]
Test API generation and loading of core formulae and casks.
Note: This requires the core tap(s) to be installed locally,
HOMEBREW_NO_INSTALL_FROM_API gets set automatically before running and this
command is slow because it generates and then loads everything.
--fail-fast Exit after the first failure.
--formula, --formulae Only test core formulae.
--cask, --casks Only test core casks.
-d, --debug Display any debugging information.
-q, --quiet Make some output more quiet.
-v, --verbose Make some output more verbose.
-h, --help Show this message.
Usage: brew branch-compare [options] -- command
Runs a brew command on both the current branch and the main branch and then
diffs the output of both commands. This helps with debugging and assurance
testing when making changes to important commands.
Example: brew branch-compare --quiet -- deps --installed
Warning: This command runs git commands on the main brew repo. To be safe avoid
running other brew commands simultaneously.
--ignore-errors Continue diff when a command returns a
non-zero exit code.
--with-stderr Combine stdout and stderr in diff output.
--word-diff Show word diff instead of default line diff.
--time Benchmark the command on both branches.
--local Only load formula/cask from local taps not
the API.
-d, --debug Display any debugging information.
-q, --quiet Make some output more quiet.
-v, --verbose Make some output more verbose.
-h, --help Show this message.
Usage: brew generate-api-diff [options]
Compare the API generation before and and after changes to brew. This helps with
debugging and assurance testing when making changes to the JSON API.
Note: One of the --cask or --formula options is required.
Warning: This command runs git commands on the main brew repo. To be safe avoid
running other brew commands simultaneously.
--cask Run the diff on only core casks.
--formula Run the diff on only core formulae.
--word-diff Show word diff instead of default line diff.
--stat Shows condensed output based on git
diff --stat
-d, --debug Display any debugging information.
-q, --quiet Make some output more quiet.
-v, --verbose Make some output more verbose.
-h, --help Show this message.
Usage: brew service-diff [options]
Compare the service file generation on macOS and Linux before and after changes
to brew. This helps with debugging and assurance testing when making changes to
the brew services DSL.
Warning: This command runs git commands on the main brew repo. To be safe avoid
running other brew commands simultaneously.
--formula Run the diff on only one formula.
--tap Run the diff on only one tap.
--word-diff Show word diff instead of default line diff.
--stat Shows condensed output based on git
diff --stat
-d, --debug Display any debugging information.
-q, --quiet Make some output more quiet.
-v, --verbose Make some output more verbose.
-h, --help Show this message.
Linting and readme checks are run on each pull request while integration tests are only run weekly.
- Linting
rake lint:check
rake lint:fix
- Readme
rake readme:outdated
rake readme:generate
- Integration Tests
rake missing-tests
rake test:all
rake test:api-readall-test
(SLOW)rake test:branch-compare
rake test:generate-api-diff
(SLOW)rake test:service-diff