kick_the_tires 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3cb8898b70655df647e6740ea327787223b78189
+  data.tar.gz: 746c8ce5fa4e07751a7346f0d7f5f97c01570c7d
+SHA512:
+  metadata.gz: d9b655a60edde655c7028b2b0576ed2594cf5d09e6949432230e9331057391cfa9d57486bef9cb20a07e02d2abcc981ebbf32f915864d37d9d8da78e21806b1b
+  data.tar.gz: 29bcadf9a3684ff7ceafb04a30ac6b31829618060afcb517a6fb109c487efd0f272a034fe30c9c2318ef1a6b9adaec18f02cd7c90b4dfc3ccd3643ef3cc0698c

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.2.0

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http:contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in kick_the_tires.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Dewayne VanHoozer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,65 @@
+# KickTheTires
+
+Provides some basic methods/assertions that are handy for exploring a new ruby library.
+
+Sometimes when you hear about a new library/gem you just wat to kick the
+kick_the_tires to see what it can do.  Sometimes you start with some REPL
+example from the authors or some sample code or tests that the author has
+provided.  This little gem allowed_push_host you to load up a few basic
+asserts/refutes/shows to explore the library's objects and method results.
+When you have finished kicking the tires you may want to take the library out
+for a spin with some functional, application-line code and you don't want
+any of the tire kicking out to STDOUT.
+
+It would be a good idea to reuse someone's general purpose assertations library.
+I did a quick look and didn't find any that were not tightly coupled with a
+testing framework.  Its an API exploration tool to learn the methods and
+objects introduced by a new gem that you have never seen before.
+
+You would never buy a used car without first kicking the tires and taking it
+for a spin.  Why would you start using a new gem without playing with it for
+a while?
+
+## Installation
+
+Install it yourself as:
+
+    $ gem install kick_the_tires
+
+## Usage
+
+```ruby
+require 'kick_the_tires'
+include KickTheTires
+
+require 'some_new_gem_to_explore'
+
+sngte = SomeNewGemToExplore.new
+
+refute sngte.nil?
+assert_equal SomeNewGemToExplore, sngte.class
+assert sngte.return_true
+show sngte
+
+take_it_for_a_spin # disables all asserts/refutes/shows
+
+assert sngte.nil? # does nothing but return
+
+# some application-like code that uses the new gem
+sngte.each do |s|
+  # do something
+end
+
+give_the_keys_back  # enables the asserts/regutes/shows
+
+assert sngte.nil? # active again, will display error stuff if object is not nil
+
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/kick_the_tires/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "kick_the_tires"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/kick_the_tires.gemspec

@@ -0,0 +1,37 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name          = "kick_the_tires"
+  spec.version       = '0.0.1'
+  spec.authors       = ["Dewayne VanHoozer"]
+  spec.email         = ["dvanhoozer@gmail.com"]
+
+  spec.summary       = %q{Provides some basic methods/assertions that are handy for exploring a new ruby library.}
+  spec.description   = %q{
+    Sometimes when you hear about a new library/gem you just wat to kick the kick_the_tires
+    to see what it can do.  Sometimes you start with some REPL example from the authors
+      or some sample code or tests that the author has provided.  This little gem allowed_push_host
+      you to load up a few basic asserts/refutes/shows to explore the library's objects
+      and method results.  When you have finished kicking the tires you may want to take
+      the library out for a spin with some functional, application-line code and you
+      don't want any of the tire kicking out to STDOUT.
+  }
+  spec.homepage      = "http://github.com/MadBomber/kick_the_tires"
+  spec.license       = "You want it?  It's yours."
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "bin"
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = "https://rubygems.org"
+  end
+
+  spec.add_dependency "awesome_print"
+
+  spec.add_development_dependency "bundler", "~> 1.9"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/kick_the_tires.rb

@@ -0,0 +1,86 @@
+# encoding: utf-8
+#########################################################
+###
+##  File: kick_the_tires.rb
+##  Desc: Poke around; check things out; see if you want it
+##  By:   Dewayne VanHoozer (dvanhoozer@gmail.com)
+
+require 'awesome_print'
+require 'pathname'
+
+module KickTheTires
+
+  @ktt_disabled = false
+
+  if caller.empty?
+    required_by_filename = __FILE__
+  else
+    required_by_filename = caller.last.split(':').first
+  end
+
+  SOURCE = Pathname.new(required_by_filename).readlines.map{|a_line| a_line.chomp.strip}
+
+  def show_source
+    return if @ktt_disabled
+    puts
+    puts "-"*75
+    a_string    = caller.last
+    source_line = a_string.split(' ').first.split(':')[1].to_i
+    puts "Source #=> #{SOURCE[source_line-1]}" # MAGIC: zero-based index
+  end
+
+  def show(a_thing)
+    return if @ktt_disabled
+    show_source
+    puts "Showing #{a_thing.class} #=>"
+    ap a_thing, {indent: 2, raw: true}
+  end
+
+  def assert(a_thing)
+    return if @ktt_disabled
+    assert_equal true, a_thing
+  end
+
+  def refute(a_thing)
+    return if @ktt_disabled
+    assert_equal false, a_thing
+  end
+
+  def assert_equal(expected_this, got_that)
+    return if @ktt_disabled
+    unless expected_this.to_s == got_that.to_s
+      show_source
+      puts 'Result #=>'
+      puts "Expected This: #{expected_this}"
+      puts "But Got That:  #{got_that}"
+      puts
+    end
+  end
+
+  # disable the asserts and shows
+  def take_it_for_a_spin
+    @ktt_disabled = true
+  end
+
+  def give_the_keys_back
+    @ktt_disabled = false
+  end
+
+  def out_for_a_drive?
+    @ktt_disabled
+  end
+
+
+  # TODO: Need a little more thinking about this
+  #       pry currently uses and older version of pry
+  #       than cli_helper
+=begin
+  def hands_on
+    show_source
+    puts "Entering pry.  Type 'help' for available commands."
+    puts "Enter the command 'up' to kick the tires on the new ride."
+    binding.pry
+  end
+=end
+
+end # module KickTheTires

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification
+name: kick_the_tires
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Dewayne VanHoozer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-03-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: "\n    Sometimes when you hear about a new library/gem you just wat to
+  kick the kick_the_tires\n    to see what it can do.  Sometimes you start with some
+  REPL example from the authors\n      or some sample code or tests that the author
+  has provided.  This little gem allowed_push_host\n      you to load up a few basic
+  asserts/refutes/shows to explore the library's objects\n      and method results.
+  \ When you have finished kicking the tires you may want to take\n      the library
+  out for a spin with some functional, application-line code and you\n      don't
+  want any of the tire kicking out to STDOUT.\n  "
+email:
+- dvanhoozer@gmail.com
+executables:
+- console
+- setup
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- kick_the_tires.gemspec
+- lib/kick_the_tires.rb
+homepage: http://github.com/MadBomber/kick_the_tires
+licenses:
+- You want it?  It's yours.
+metadata:
+  allowed_push_host: https://rubygems.org
+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.4.6
+signing_key: 
+specification_version: 4
+summary: Provides some basic methods/assertions that are handy for exploring a new
+  ruby library.
+test_files: []
+has_rdoc: