Sha256: 4d69aef47acd7b8a667606019b5d0eb66255b69c5ac0300722e2f83c96fc57e7

Contents?: true

Size: 1.69 KB

Versions: 56

Compression:

Stored size: 1.69 KB

Contents

Hammer - the CLI tool (not only) for Foreman
============================================

Hammer is a generic [clamp-based](https://github.com/mdub/clamp) 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](http://projects.theforeman.org/projects/hammer-cli/wiki/List_of_Plugins).

Check out the [release notes](doc/release_notes.md#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](doc/installation.md#installation).


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](doc/developer_docs.md#hammer-development-docs).


License
-------
This project is licensed under the GPLv3+.


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

Version data entries

56 entries across 56 versions & 1 rubygems

Version Path
hammer_cli-3.14.0 README.md
hammer_cli-3.13.0 README.md
hammer_cli-3.12.0 README.md
hammer_cli-3.10.0 README.md
hammer_cli-3.9.0 README.md
hammer_cli-3.8.0 README.md
hammer_cli-3.7.0 README.md
hammer_cli-3.5.1 README.md
hammer_cli-3.6.0 README.md
hammer_cli-3.5.0 README.md
hammer_cli-3.4.0 README.md
hammer_cli-3.3.0 README.md
hammer_cli-3.2.0 README.md
hammer_cli-3.1.1 README.md
hammer_cli-3.0.2 README.md
hammer_cli-3.1.0 README.md
hammer_cli-3.0.1 README.md
hammer_cli-3.0.0 README.md
hammer_cli-2.5.1 README.md
hammer_cli-2.5.0 README.md