lolcommits takes a snapshot with your webcam every time you git commit code, and archives a lolcat style image with it. Git blame has never been so much fun!
This plugin uploads each lolcommit to a remote server after capturing. You configure the plugin by setting a remote endpoint to handle the HTTP post request. The following params will be sent:
file
- captured lolcommit filemessage
- the commit messagerepo
- repository name e.g. lolcommits/lolcommitssha
- commit SHAauthor_name
- the commit author nameauthor_email
- the commit author email addresskey
- optional key (string) from plugin config
You can also set an optional HTTP Basic Auth header (username and/or password).
- Ruby >= 3.1
- A webcam
- ImageMagick
- ffmpeg (optional) for animated gif capturing
After installing the lolcommits gem, install this plugin with:
$ gem install lolcommits-uploldz
Then configure to enable and set the remote endpoint:
$ lolcommits --config -p uploldz
# set enabled to `true`
# set the remote endpoint (must begin with http(s)://)
# optionally set a key (sent in params) and/or HTTP Basic Auth credentials
That's it! Provided the endpoint responds correctly, your next lolcommit will be uploaded to it. To disable use:
$ lolcommits --config -p uploldz
# and set enabled to `false`
Check out this repo and run bin/setup
, this will install all dependencies and
generate docs. Use bundle exec rake
to run all tests.
You can also run bin/console
for an interactive prompt that will allow you to
experiment with the gem code.
MiniTest is used for testing. Run the test suite with:
$ rake test
Generate docs for this gem with:
$ rake rdoc
If you think something is broken or missing, please raise a new issue. Take a moment to check it hasn't been raised in the past (and possibly closed).
Bug reports and pull requests are welcome on GitHub.
When submitting pull requests, remember to add tests covering any new behaviour, and ensure all tests are passing. Read the contributing guidelines for more details.
This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct. See here for more details.
The gem is available as open source under the terms of LGPL-3.