explain_shell 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 54c60e41d3c44ab082ff294249f2af6701c7919f
+  data.tar.gz: ff2947ce5b102b7d57a1b9919d0f48411089b1f0
+SHA512:
+  metadata.gz: 9553c723ef8ec5a17a91ee488f04d672cdf45b580542bd6a34f9d840cd5a485892de817a08d0a3ce35416b54bc9ada9d010e5dc43ca9ffdcfa8b5202bd48b599
+  data.tar.gz: 34e69f497d7f8f49f44f3bb2f05772c59fe31d151b5704361bf2c113ea2147f0236c449e78328cf84b37f249e16f58112b2042a05622a6791b860dec8353cf0e

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/bin/explain

@@ -0,0 +1,17 @@
+#!/usr/bin/env sh
+
+# base url with first command already injected
+# $ explain tar
+#   => http://explainshel.com/explain/tar?args=
+URL="http://explainshell.com/explain/$1?args="
+
+# removes $1 (tar) from arguments ($@)
+shift;
+
+# iterates over remaining args and adds builds the rest of the url
+for i in "$@"; do
+  URL=$URL"$i""+"
+done
+
+# opens url in browser
+open $URL

data/explain_shell.gemspec

@@ -0,0 +1,17 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |gem|
+  gem.name          = "explain_shell"
+  gem.version       = "1.0.0"
+  gem.authors       = ["Richard Schneeman"]
+  gem.email         = ["richard.schneeman+rubygems@gmail.com"]
+  gem.description   = %q{ Bash interface to http://explainshell.com/ }
+  gem.summary       = %q{ explain your bash commands with ease }
+  gem.homepage      = "https://github.com/schneems/explain_shell"
+  gem.license       = "MIT"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  # gem.require_paths = ["lib"]
+end

data/readme.md

@@ -0,0 +1,61 @@
+# Explain Shell
+
+An awesometastic way to open http://explainshell.com/ from your command line
+
+## Install
+
+```sh
+$ gem install explain_shell
+```
+
+## Use
+
+The explain_shell gem gives you an `explain` function in bash.
+
+```sh
+$ explain tar xzvf archive.tar.gz
+```
+
+Will open up http://explainshell.com/explain/tar?args=xzvf+archive.tar.gz in your browser!
+
+Use it with any unix command!
+
+```sh
+$ explain find . -type f -print0
+$ explain ssh -i keyfile -f -N -L 1234:www.google.com:80 host
+$ explain lsof -c python -u user
+$ explain mysql -u root -p -h 192.168.1.2
+$ explain iptables -A INPUT -i eth0 -s ip-to-block -j DROP
+$ explain git log --graph --abbrev-commit --pretty=oneline origin..mybranch
+```
+
+It's super annoying that it's a slightly different name ah-la bundle/bundler, but the [explain](http://rubygems.org/gems/explain) gem name was already taken.
+
+## Without Rubygems
+
+If you don't have Rubygems on your system (`$ which gem` returns nothing). You can add a simple script to your startup enviornment instead:
+
+```sh
+function explain {
+  # base url with first command already injected
+  # $ explain tar
+  #   => http://explainshel.com/explain/tar?args=
+  URL="http://explainshell.com/explain/$1?args="
+
+  # removes $1 (tar) from arguments ($@)
+  shift;
+
+  # iterates over remaining args and adds builds the rest of the url
+  for i in "$@"; do
+    URL=$URL"$i""+"
+  done
+
+  # opens url in browser
+  open $URL
+}
+```
+
+## License
+
+MIT
+

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: explain_shell
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Richard Schneeman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-17 00:00:00.000000000 Z
+dependencies: []
+description: ' Bash interface to http://explainshell.com/ '
+email:
+- richard.schneeman+rubygems@gmail.com
+executables:
+- explain
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- bin/explain
+- explain_shell.gemspec
+- readme.md
+homepage: https://github.com/schneems/explain_shell
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: explain your bash commands with ease
+test_files: []