normally 0.0.0

data/License.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Ben Christel
+
+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,52 @@
+# Normally
+
+## Prioritizing the Happy Path
+
+Much of the time when talking about conditional expressions, the concepts of a _happy path_ and a _sad path_ are useful. The happy path is the branch of the conditional that executes during the normal operation of your program. The sad path is there only to deal with errors or invalid input. When test-driving code, I normally focus on the happy path first. When reading code, I like to see the happy path first because the happy path tells me what the code is supposed to do, while the sad path just tells me how the code avoids doing things it's not supposed to do.
+
+Despite the importance of the happy path, the sad path is often the most visible in code with conditionals. Consider the following:
+
+```ruby
+def response_data(response)
+  if response.success?
+    JSON.parse(response.body)
+  else
+    nil
+  end
+end
+```
+
+The first thing we see when we look at this method is not the happy path, but the conditional that separates the normal case from the unexpected case. You have to read and understand this conditional before you can even tell which of its branches is the normal case.
+
+What we'd really like is something like this:
+
+```ruby
+def response_data(response)
+  normally { JSON.parse(response.body) }
+    .but_if (response.error?) { nil }
+end
+```
+
+Now the happy path is front and center. As you may have guessed, the `normally` gem makes this code actually work.
+
+## Installation
+
+You know the drill. If you're using [bundler](https://rubygems.org/gems/bundler), add this to your `Gemfile`:
+
+```ruby
+gem 'normally'
+```
+
+To install globally, do `gem install normally`
+
+The `normally` method is part of the `Normally` module, which must be included either in the global namespace or in the class where you want to use the `normally` syntax. For example:
+
+```ruby
+class Foo
+  include Normally
+
+  def do_something
+    normally { 'foo' }.but_if(error?) { 'fubar' }
+  end
+end
+```

data/lib/normally.rb

@@ -0,0 +1,15 @@
+class HappyPath
+  def initialize(happy_proc)
+    @happy_proc = happy_proc
+  end
+
+  def but_if(condition)
+    condition ? yield : @happy_proc.call
+  end
+end
+
+module Normally
+  def normally(&block)
+    HappyPath.new(block)
+  end
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: normally
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Ben Christel
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-13 00:00:00.000000000 Z
+dependencies: []
+description: Prioritize the happy path.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- lib/normally.rb
+- License.txt
+- README.md
+homepage: http://github.com/benchristel/normally
+licenses:
+- MIT
+post_install_message: 
+rdoc_options:
+- --charset=UTF-8
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: normally-0.0.0
+test_files: []