Project

hammer_cli

0.15
A long-lived project that still receives updates
Hammer cli provides universal extendable CLI interface for ruby apps
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

Hammer - the CLI tool (not only) for Foreman

Hammer is a generic clamp-based CLI framework. Hammer-cli provides just the core functionality. The core is extensible using plugins that contain application-specific commands.

This architecture allows for easy customization according to your application. Nearly any Ruby script can be turned into a Hammer command, so the possibilities are endless. You also can easily add custom commands for your specific use, such as bulk actions or admin tasks.

Available plugins are listed on the Foreman's wiki.

Check out the release notes to see what's new in the latest version.

Installation

We build rpms, debs and gems. Alternatively you can install hammer from a git checkout. See our installation and configuration instuctions.

Having issues?

If one of hammer commands doesn't work as you would expect, you can run hammer -d ... to get full debug output from the loggers. It should give you an idea what went wrong.

If you have questions, don't hesitate to contact us on foreman-users@googlegroups.com or the Freenode#theforeman IRC channel.

Further reading

If you're interested in hammer and want to develop some plugins for Foreman or use it as a base for your own CLI, read the developer docs.

License

This project is licensed under the GPLv3+.

Acknowledgements

Thanks to Brian Gupta for the initial work and a great name.