validator_fn 0.1.7 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f3c19ca1d1f502bed0157cfafa1f2a1b895ada518a58770f22f7ea3eeb159fb8
-  data.tar.gz: e7d7cb6dd656953bded2541458316019a1578913907b473499520f86b59fda8a
+  metadata.gz: dbf0665436aeda62b487528bb8f8f85777c45a357c4cf34884600a14273f289d
+  data.tar.gz: 0ba29a6cf3b5d453f3561f8e9c3f205c060d088226c83f494ff7a269dc672734
 SHA512:
-  metadata.gz: c03edea5b8e2fecf7fb892ca22a4157ebfbe0dd8e717578cc5d38e3280c99ada72e72a18b6ee7c661e1d533261560037c47ff6c18065c28af7eb5478fc5c9f4e
-  data.tar.gz: 382a11b7ea12ebda356c03039b3e5b2228d1dcc0d7e38ac95da7419f36b69ab932f14054fb44029cf6dfed670a6257f6bb270d2cd5abae98be54e004badc6af7
+  metadata.gz: de5d94c98746fd64ecb55f05e658ec434f57c8e518d16bb817ef39e4c56b53cd7130c52ab3ee69dddd5d8b853830dd271374d29c4ac6573576b9cdaf9287c80b
+  data.tar.gz: cfd9b2aab1a51bae15f335fc74e0970bf406d16f0e522ce3eb239176e0814a59bf0be37f13c4753bb0e2193c828634c7e6de7aeda7f323eb92eede177c3ad8ce

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    validator_fn (0.1.6)
+    validator_fn (0.1.8)
       fn_reader
 
 GEM
@@ -9,7 +9,7 @@ GEM
   specs:
     coderay (1.1.3)
     diff-lcs (1.4.4)
-    fn_reader (0.1.0)
+    fn_reader (0.2.0)
     method_source (0.9.2)
     pry (0.12.2)
       coderay (~> 1.1.0)

data/README.md

@@ -1,9 +1,11 @@
 # ValidatorFn
 
-ValidatorFn is a collection of very simple lambdas that can be used for validating/transforming 
-data structures.  It makes use of currying in order to provide a very composable 
-DSL. To help you understand the concepts it is stongly advised to read [this blog post.](http://blog.martinosis.com/blog/simple-functional-strong-params-in-ruby/). 
+ValidatorFn is a collection of very simple lambdas that can be used for validating/transforming
+data structures. It makes use of currying in order to provide a very composable
+DSL. To help you understand the concepts it is stongly advised to read [this blog post.](http://blog.martinosis.com/blog/simple-functional-strong-params-in-ruby/).
 
+It can be very useful for validating structures that comes from input, such as configuration files,
+JSON apis, test result.
 
 ## Installation
 
@@ -28,7 +30,7 @@ require 'validator_fn'
 include ValidatorFn
 ```
 
-You can start validating type of an object. 
+You can start validating type of an object.
 
 ```
 is_a.(String).(3)
@@ -61,21 +63,88 @@ user = hash_of.({name: is_a.(String), age: to_int})
 user.({name: "", age: "234"})
 ```
 
-Since we are using curried lambdas, you can compose validators as you which. 
+Since we are using curried lambdas, you can compose validators as you which.
 
 ```
-postal_code = -> a { 
+postal_code = -> a {
   invalid.("Invalid postal code: #{a}")  unless a =~ /[a-z]\d[a-z]\s*\d[a-z]\d/i
   a
 }
-contact =  hash_of.(user: user, 
-                    address: hash_of.({ street_number: is_a.(Integer), 
+contact =  hash_of.(user: user,
+                    address: hash_of.({ street_number: is_a.(Integer),
                                         postal_code: postal_code}))
 ```
 
 This is a very simple library (100 lines of code) that can be extended as you which by
 creating your own lambdas.
 
+## Casting
+
+You can also apply converter functions to the structure.
+
+```ruby
+user = { name: "Joe", created_at: "2020-01-03" }
+to_date = ->str { Date.parse(str) }
+user_validator = hash_of.(name: is_a.(String),
+                          created_at: is_a.(String) >> to_date)
+
+user_validator.(user)
+# => {:name=>"Joe", :created_at=>#<Date: 2020-01-03 ((2458852j,0s,0n),+0s,2299161j)>}
+```
+
+This makes it very useful processing JSON payloads.
+
+## Code generation
+
+You can generate validator code from existing structure:
+
+```
+require 'openuri'
+require "json"
+struct = JSON.parse(URI.open("https://api.github.com/users/defunkt").read)
+
+require_relative "validator_fn"
+
+# Generate unformatted code
+code = ValidatorFn.generate_validator.(struct)
+
+# You can reformat it using a code formatter
+require "rufo"
+puts Rufo.format(code)
+hash_of.({ "login" => is_a.(String),
+           "id" => is_a.(Integer),
+           "node_id" => is_a.(String),
+           "avatar_url" => is_a.(String),
+           "gravatar_id" => is_a.(String),
+           "url" => is_a.(String),
+           "html_url" => is_a.(String),
+           "followers_url" => is_a.(String),
+           "following_url" => is_a.(String),
+           "gists_url" => is_a.(String),
+           "starred_url" => is_a.(String),
+           "subscriptions_url" => is_a.(String),
+           "organizations_url" => is_a.(String),
+           "repos_url" => is_a.(String),
+           "events_url" => is_a.(String),
+           "received_events_url" => is_a.(String),
+           "type" => is_a.(String),
+           "site_admin" => is_a_bool,
+           "name" => is_a.(String),
+           "company" => any,
+           "blog" => is_a.(String),
+           "location" => any,
+           "email" => any,
+           "hireable" => any,
+           "bio" => is_a.(String),
+           "twitter_username" => any,
+           "public_repos" => is_a.(Integer),
+           "public_gists" => is_a.(Integer),
+           "followers" => is_a.(Integer),
+           "following" => is_a.(Integer),
+           "created_at" => is_a.(String),
+           "updated_at" => is_a.(String) })
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -86,7 +155,6 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/validator_fn. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/validator_fn/blob/master/CODE_OF_CONDUCT.md).
 
-
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
@@ -95,5 +163,3 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 Everyone interacting in the ValidatorFn project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/validator_fn/blob/master/CODE_OF_CONDUCT.md).
 Everyone interacting in the ValidatorFn project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/validator_fn/blob/master/CODE_OF_CONDUCT.md).
-Everyone interacting in the ValidatorFn project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/validator_fn/blob/master/CODE_OF_CONDUCT.md).
-Everyone interacting in the ValidatorFn project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/validator_fn/blob/master/CODE_OF_CONDUCT.md).

data/lib/validator_fn/error.rb

@@ -0,0 +1,23 @@
+module ValidatorFn
+  class Error < StandardError
+    attr_reader :my_msg
+
+    def initialize(msg)
+      @my_msg = msg
+      super(msg)
+    end
+
+    def message(indent = 0)
+      if cause
+        cause_msg = if cause.kind_of?(Error)
+            cause.message(indent + 1)
+          else
+            cause.message
+          end
+        my_msg + "\n" + ("  " * (indent + 1)) + cause_msg
+      else
+        my_msg
+      end
+    end
+  end
+end

data/lib/validator_fn/version.rb

@@ -1,3 +1,3 @@
 module ValidatorFn
-  VERSION = "0.1.7"
+  VERSION = "0.1.8"
 end

data/lib/validator_fn.rb

@@ -1,33 +1,10 @@
 require "validator_fn/version"
+require "validator_fn/error"
 require "fn_reader"
 
 module ValidatorFn
-  class Error < StandardError; end
-
   fn_reader :something, :matches, :either, :array_of, :any, :is_nil,
-    :maybe, :present, :is_a, :int, :hash_of, :invalid, :generate_validator, :handle_error, :error_str, :apply
-
-  class Error < StandardError
-    attr_reader :my_msg
-
-    def initialize(msg)
-      @my_msg = msg
-      super(msg)
-    end
-
-    def message(indent = 0)
-      if cause
-        cause_msg = if cause.kind_of?(Error)
-            cause.message(indent + 1)
-          else
-            cause.message
-          end
-        my_msg + "\n" + ("  " * (indent + 1)) + cause_msg
-      else
-        my_msg
-      end
-    end
-  end
+    :maybe, :present, :is_a, :is_a_bool, :int, :hash_of, :invalid, :generate_validator, :handle_error, :error_str, :apply
 
   @@apply = ->fn, a {
     begin
@@ -59,6 +36,7 @@ module ValidatorFn
   @@is_nil = ->a { invalid.("Should be nil but was #{a}") unless a.nil?; a }
   @@maybe = either.(is_nil)
   @@is_a = ->klass, a { invalid.("Expected type #{klass}, got #{a.inspect}") unless a.is_a?(klass); a }.curry
+  @@is_a_bool = ->a { invalid.("Expected bool, got #{a.inspect}") unless a == true || a == false; a }.curry
   @@hash_of = ->fields, hash {
     hash ||= {}
     fields.reduce({}) do |memo, (key, fn)|
@@ -97,6 +75,10 @@ module ValidatorFn
       "hash_of.({ #{inner} })"
     when Array
       "array_of.( #{generate_validator.(a.first)} )"
+    when TrueClass
+      "is_a_bool"
+    when FalseClass
+      "is_a_bool"
     else
       "is_a.(#{a.class})"
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: validator_fn
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.8
 platform: ruby
 authors:
 - Martin Chabot
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-12-30 00:00:00.000000000 Z
+date: 2022-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fn_reader
@@ -43,6 +43,7 @@ files:
 - bin/console
 - bin/setup
 - lib/validator_fn.rb
+- lib/validator_fn/error.rb
 - lib/validator_fn/version.rb
 - validator_fn.gemspec
 homepage: https://github.com/martinos/validator_fn
@@ -66,7 +67,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.1.2
 signing_key:
 specification_version: 4
 summary: Series of lambdas for validating Ruby structures