mutations 0.5.0 → 0.5.1

data/.travis

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - jruby-19mode
+branches:
+  only:
+    - master

data/Gemfile

@@ -1,4 +1,5 @@
 source 'http://rubygems.org'
+gemspec
 
 gem 'minitest', '~> 4.0'
 gem 'activesupport'

data/Gemfile.lock

@@ -1,3 +1,9 @@
+PATH
+  remote: .
+  specs:
+    mutations (0.5.0)
+      activesupport
+
 GEM
   remote: http://rubygems.org/
   specs:
@@ -7,6 +13,7 @@ GEM
     i18n (0.6.1)
     minitest (4.1.0)
     multi_json (1.3.6)
+    rake (0.9.2.2)
 
 PLATFORMS
   ruby
@@ -14,3 +21,5 @@ PLATFORMS
 DEPENDENCIES
   activesupport
   minitest (~> 4.0)
+  mutations!
+  rake

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) Jonathan Novak
+
+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

@@ -1,5 +1,7 @@
 # Mutations
 
+[![Build Status](https://travis-ci.org/cypriss/mutations.png)](https://travis-ci.org/cypriss/mutations)
+
 Compose your business logic into commands that sanitize and validate input. Write safe, reusable, and maintainable code for Ruby and Rails apps.
 
 ## Installation
@@ -44,7 +46,7 @@ def create
   if outcome.success?
     render json: {message: "Great success, #{outcome.result.name}!"}
   else
-    render json: outcome.errors.symbolic
+    render json: outcome.errors.symbolic, status: 422
   end
 end
 ```
@@ -53,11 +55,11 @@ Some things to note about the example:
 
 * We don't need attr_accessible or strong_attributes to protect against mass assignment attacks
 * We're guaranteed that within execute, the inputs will be the correct data types, even if they needed some coercion (all strings are stripped by default, and strings like "1" / "0" are converted to true/false for newsletter_subscribe) 
-* We don't need ActiveRecord/ActiveModel validations
-* We don't need Callbacks on our models -- everything is in the execute method (helper methods are also encouraged).
-* We don't use accepts_nested_attributes_for, even though multiple AR models are created.
+* We don't need ActiveRecord validations
+* We don't need callbacks on our models -- everything is in the execute method (helper methods are also encouraged)
+* We don't use accepts_nested_attributes_for, even though multiple ActiveRecord models are created
 * This code is completely re-usable in other contexts (need an API?)
-* The inputs to this 'function' are documented by default -- the bare minimum to use it (name and email) are documented, as are 'extras' (newsletter_subscribe).
+* The inputs to this 'function' are documented by default -- the bare minimum to use it (name and email) are documented, as are 'extras' (newsletter_subscribe)
 
 ## Why is it called 'mutations'?
 
@@ -82,7 +84,7 @@ And inside, you had a library of business operations that you can do against you
 
 Each of these _mutations_ takes your application from one state to the next.
 
-That being said, you can easily use the input validation/specification capabilities for things that don't mutate your database.
+That being said, you can create commands for things that don't mutate your database.
 
 ## How do I call mutations?
 
@@ -267,5 +269,5 @@ Yes, but I don't think it's a very good idea. Better to compose.
 
 ### Can I use this with Rails forms helpers?
 
-Somewhat. This works great with any forms, but there's no built-in way to bake the errors into the HTML with Rails form tag helpers. Right now this is really designed to support a JSON API.  You'd probably have to write an adapter of some kind.
+Somewhat. Any form can submit to your server, and mutations will happily accept that input. However, if there are errors, there's no built-in way to bake the errors into the HTML with Rails form tag helpers. Right now this is really designed to support a JSON API.  You'd probably have to write an adapter of some kind.
 

data/lib/mutations.rb

@@ -20,5 +20,9 @@ module Mutations
     def error_message_creator
       @error_message_creator ||= DefaultErrorMessageCreator.new
     end
+    
+    def error_message_creator=(creator)
+      @error_message_creator = creator
+    end
   end
 end

data/lib/mutations/errors.rb

@@ -36,7 +36,10 @@ module Mutations
       )
     end
     
-    # Key is either a symbol or a fixnum
+    # key: the name of the field, eg, :email. Could be nil if it's an array element
+    # error_symbol: the validation symbol, eg, :matches or :required
+    # options:
+    #  :index -- index of error if it's in an array
     def message(key, error_symbol, options = {})
       if options[:index]
         "#{(key || 'array').to_s.titleize}[#{options[:index]}] #{MESSAGES[error_symbol]}"

data/lib/mutations/version.rb

@@ -1,3 +1,3 @@
 module Mutations
-  VERSION = "0.5.0"
+  VERSION = "0.5.1"
 end

data/mutations.gemspec

@@ -14,6 +14,7 @@ Gem::Specification.new do |s|
 
   s.add_dependency 'activesupport'
   s.add_development_dependency 'minitest', '~> 4'
+  s.add_development_dependency 'rake'
   
   s.required_ruby_version = '>= 1.9.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mutations
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-25 00:00:00.000000000 Z
+date: 2012-10-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -43,6 +43,22 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: '4'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Compose your business logic into commands that sanitize and validate
   input.
 email: jnovak@gmail.com
@@ -51,8 +67,10 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .travis
 - Gemfile
 - Gemfile.lock
+- MIT-LICENSE
 - README.md
 - Rakefile
 - lib/mutations.rb