enotype 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 49b45ee141f7108c88785143cbae350f76dee9dbb6d5dd1acbce7972bc3bbfe6
+  data.tar.gz: 5e3f2de9a97da96a79757a56d2c3be830b3f3ccec01c7392fd437a4bf26fdad6
+SHA512:
+  metadata.gz: 8cc784fcf21d0d73ade3cd036288b953d40f32fe4a8394cbfb92f10610c052b10fa9ce2997d4237b97e9fec9cf09751bf0ace0464851dab3cd0a634bda24d362
+  data.tar.gz: 57d00f2f5c740134ccfbea7b125ab0ea335795bb0d0b2f9b9e200f2bb60d34494abc11feda7c0caeedf9b23ba4dd37f47faf4e5487d11dd4ffa7ea54e6a2da08

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Simon Repp
+
+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,14 @@
+# enotype
+
+**A cross-language standard library for types.**
+
+```ruby
+require 'enotype'
+
+Enotype::color('#fff') # returns '#fff'
+Enotype::color('#xyz') # raises 'A color is required, for instance '#B6D918', '#fff' or '#01b'.'
+```
+
+enotype is a collection of minimalist pure functions that validate and convert type-unsafe `string` representations into type-safe, native types.
+
+It is the standard type library for the [eno notation language](https://eno-lang.org) but can be utilized in a multitude of other contexts as well.

data/lib/enotype.rb

@@ -0,0 +1 @@
+require 'enotype/en'

data/lib/enotype/de.rb

@@ -0,0 +1,103 @@
+require 'json'
+
+COLOR_REGEXP = /^\s*#[0-9a-f]{3}([0-9a-f]{3})?\s*$/i
+DATE_REGEXP = /^\s*(\d{4})-(\d\d)-(\d\d)\s*$/
+DATETIME_REGEXP = /^\s*(\d{4})(?:-(\d\d)(?:-(\d\d)(?:T(\d\d):(\d\d)(?::(\d\d)(?:\.(\d+))?)?(?:(Z)|([+\-])(\d\d):(\d\d)))?)?)?\s*$/
+EMAIL_REGEXP = /^\s*[^@\s]+@[^@\s]+\.[^@\s]+\s*$/
+FLOAT_REGEXP = /^\s*-?\d+(\.\d+)?\s*$/
+INTEGER_REGEXP = /^\s*-?\d+\s*$/
+LAT_LNG_REGEXP = /^\s*(-?\d{1,3}(?:\.\d+)?)\s*,\s*(-?\d{1,3}(?:\.\d+)?)\s*$/
+URL_REGEXP = /^\s*https?:\/\/[^\s.]+\.\S+\s*$/
+
+module Enotype
+  def self.boolean(value)
+    lower = value.strip.downcase
+  
+    return true if lower == 'true'
+    return false if lower == 'false'
+    return true if lower == 'yes'
+    return false if lower == 'no'
+  
+    raise 'Ein boolescher Wert ist erforderlich - erlaubte Werte sind \'true\', \'false\', \'yes\' und \'no\'.'
+  end
+  
+  def self.color(value)
+    raise 'Eine Farbe ist erforderlich, zum Beispiel \'#B6D918\', \'#fff\' oder \'#01b\'.' unless value.match(COLOR_REGEXP)
+  
+    value
+  end
+  
+  def self.comma_separated(value)
+    value.split(',', -1).map { |item| item.strip  }
+  end
+  
+  def self.date(value)
+    match = value.match(DATE_REGEXP)
+  
+    raise 'Ein valides Datum ist erforderlich, zum Beispiel \'1993-11-18\'.' unless match
+  
+    year = match[1].to_i
+    month = match[2].to_i
+    day = match[3].to_i
+  
+    Time.utc(year, month, day)
+  end
+  
+  def self.datetime(value)
+    match = value.match(DATETIME_REGEXP)
+  
+    raise 'Ein valides Datum oder Datum und Zeit sind erforderlich, zum Beispiel \'1961-01-22\' oder \'1989-11-09T19:17Z\' (siehe https://www.w3.org/TR/NOTE-datetime).' unless match
+  
+    year = match[1].to_i
+    month = match[2] ? match[2].to_i : 1
+    day = match[3] ? match[3].to_i : 1
+    hour = match[4] ? match[4].to_i : 0
+    minute = match[5] ? match[5].to_i : 0
+    second = match[6] ? match[6].to_i : 0
+    fraction = match[7] ? "0.#{match[7]}".to_f : 0
+    zulu = match[8]
+    offset = zulu ? '+00:00' : "#{match[9] || '+'}#{match[10] || '00'}:#{match[11] || '00'}"
+  
+    Time.new(year, month, day, hour, minute, second + fraction, offset)
+  end
+  
+  def self.email(value)
+    raise 'Eine valide Email Adresse ist erforderlich, zum Beispiel \'jane.doe@eno-lang.org\'.' unless value.match(EMAIL_REGEXP)
+  
+    value
+  end
+  
+  def self.float(value)
+    raise 'Eine Dezimalzahl ist erforderlich, zum Beispiel \'13.0\', \'-9.159\' oder \'42\'.' unless value.match(FLOAT_REGEXP)
+    
+    value.to_f
+  end
+  
+  def self.integer(value)
+    raise 'Eine Ganzzahl ist erforderlich, zum Beispiel \'42\' oder \'-21\'.' unless value.match(INTEGER_REGEXP)
+  
+    value.to_i
+  end
+  
+  def self.json(value)
+    begin
+      JSON.parse(value)
+    rescue => err
+      raise "Valides JSON ist erforderlich - die Meldung des Parsers war:\n#{err.message}"
+    end
+  end
+  
+  def self.lat_lng(value)
+    match = LAT_LNG_REGEXP.match(value)
+  
+    raise 'Ein valides Breiten-/Längengrad Koordinatenpaar ist erforderlich, zum Beispiel \'48.2093723, 16.356099\'.' unless match
+  
+    { lat: match[1].to_f, lng: match[2].to_f }
+  end
+  
+  def self.url(value)
+    raise 'Eine valide URL ist erforderlich, zum Beispiel \'https://eno-lang.org\'.' unless value.match(URL_REGEXP)
+  
+    value
+  end
+end

data/lib/enotype/en.rb

@@ -0,0 +1,103 @@
+require 'json'
+
+COLOR_REGEXP = /^\s*#[0-9a-f]{3}([0-9a-f]{3})?\s*$/i
+DATE_REGEXP = /^\s*(\d{4})-(\d\d)-(\d\d)\s*$/
+DATETIME_REGEXP = /^\s*(\d{4})(?:-(\d\d)(?:-(\d\d)(?:T(\d\d):(\d\d)(?::(\d\d)(?:\.(\d+))?)?(?:(Z)|([+\-])(\d\d):(\d\d)))?)?)?\s*$/
+EMAIL_REGEXP = /^\s*[^@\s]+@[^@\s]+\.[^@\s]+\s*$/
+FLOAT_REGEXP = /^\s*-?\d+(\.\d+)?\s*$/
+INTEGER_REGEXP = /^\s*-?\d+\s*$/
+LAT_LNG_REGEXP = /^\s*(-?\d{1,3}(?:\.\d+)?)\s*,\s*(-?\d{1,3}(?:\.\d+)?)\s*$/
+URL_REGEXP = /^\s*https?:\/\/[^\s.]+\.\S+\s*$/
+
+module Enotype
+  def self.boolean(value)
+    lower = value.strip.downcase
+  
+    return true if lower == 'true'
+    return false if lower == 'false'
+    return true if lower == 'yes'
+    return false if lower == 'no'
+  
+    raise 'A boolean is required - allowed values are \'true\', \'false\', \'yes\' and \'no\'.'
+  end
+  
+  def self.color(value)
+    raise 'A color is required, for instance \'#B6D918\', \'#fff\' or \'#01b\'.' unless value.match(COLOR_REGEXP)
+  
+    value
+  end
+  
+  def self.comma_separated(value)
+    value.split(',', -1).map { |item| item.strip  }
+  end
+  
+  def self.date(value)
+    match = value.match(DATE_REGEXP)
+  
+    raise 'A valid date is required, for instance \'1993-11-18\'.' unless match
+  
+    year = match[1].to_i
+    month = match[2].to_i
+    day = match[3].to_i
+  
+    Time.utc(year, month, day)
+  end
+  
+  def self.datetime(value)
+    match = value.match(DATETIME_REGEXP)
+  
+    raise 'A valid date or date and time are required, for instance \'1961-01-22\' or \'1989-11-09T19:17Z\' (see https://www.w3.org/TR/NOTE-datetime).' unless match
+  
+    year = match[1].to_i
+    month = match[2] ? match[2].to_i : 1
+    day = match[3] ? match[3].to_i : 1
+    hour = match[4] ? match[4].to_i : 0
+    minute = match[5] ? match[5].to_i : 0
+    second = match[6] ? match[6].to_i : 0
+    fraction = match[7] ? "0.#{match[7]}".to_f : 0
+    zulu = match[8]
+    offset = zulu ? '+00:00' : "#{match[9] || '+'}#{match[10] || '00'}:#{match[11] || '00'}"
+  
+    Time.new(year, month, day, hour, minute, second + fraction, offset)
+  end
+  
+  def self.email(value)
+    raise 'A valid email address is required, for instance \'jane.doe@eno-lang.org\'.' unless value.match(EMAIL_REGEXP)
+  
+    value
+  end
+  
+  def self.float(value)
+    raise 'A decimal number is required, for instance \'13.0\', \'-9.159\' or \'42\'.' unless value.match(FLOAT_REGEXP)
+    
+    value.to_f
+  end
+  
+  def self.integer(value)
+    raise 'An integer is required, for instance \'42\' or \'-21\'.' unless value.match(INTEGER_REGEXP)
+  
+    value.to_i
+  end
+  
+  def self.json(value)
+    begin
+      JSON.parse(value)
+    rescue => err
+      raise "Valid JSON is required - the parser returned:\n#{err.message}"
+    end
+  end
+  
+  def self.lat_lng(value)
+    match = LAT_LNG_REGEXP.match(value)
+  
+    raise 'A valid latitude/longitude coordinate pair is required, for instance \'48.2093723, 16.356099\'.' unless match
+  
+    { lat: match[1].to_f, lng: match[2].to_f }
+  end
+  
+  def self.url(value)
+    raise 'A valid URL is required, for instance \'https://eno-lang.org\'.' unless value.match(URL_REGEXP)
+  
+    value
+  end
+end

data/lib/enotype/es.rb

@@ -0,0 +1,103 @@
+require 'json'
+
+COLOR_REGEXP = /^\s*#[0-9a-f]{3}([0-9a-f]{3})?\s*$/i
+DATE_REGEXP = /^\s*(\d{4})-(\d\d)-(\d\d)\s*$/
+DATETIME_REGEXP = /^\s*(\d{4})(?:-(\d\d)(?:-(\d\d)(?:T(\d\d):(\d\d)(?::(\d\d)(?:\.(\d+))?)?(?:(Z)|([+\-])(\d\d):(\d\d)))?)?)?\s*$/
+EMAIL_REGEXP = /^\s*[^@\s]+@[^@\s]+\.[^@\s]+\s*$/
+FLOAT_REGEXP = /^\s*-?\d+(\.\d+)?\s*$/
+INTEGER_REGEXP = /^\s*-?\d+\s*$/
+LAT_LNG_REGEXP = /^\s*(-?\d{1,3}(?:\.\d+)?)\s*,\s*(-?\d{1,3}(?:\.\d+)?)\s*$/
+URL_REGEXP = /^\s*https?:\/\/[^\s.]+\.\S+\s*$/
+
+module Enotype
+  def self.boolean(value)
+    lower = value.strip.downcase
+  
+    return true if lower == 'true'
+    return false if lower == 'false'
+    return true if lower == 'yes'
+    return false if lower == 'no'
+  
+    raise 'Se requiere un valor booleano - valores permitidos son \'true\', \'false\', \'yes\' y \'no\'.'
+  end
+  
+  def self.color(value)
+    raise 'Se requiere un color, por ejemplo \'#B6D918\', \'#fff\' o \'#01b\'.' unless value.match(COLOR_REGEXP)
+  
+    value
+  end
+  
+  def self.comma_separated(value)
+    value.split(',', -1).map { |item| item.strip  }
+  end
+  
+  def self.date(value)
+    match = value.match(DATE_REGEXP)
+  
+    raise 'Se requiere una fecha valida, por ejemplo \'1993-11-18\'' unless match
+  
+    year = match[1].to_i
+    month = match[2].to_i
+    day = match[3].to_i
+  
+    Time.utc(year, month, day)
+  end
+  
+  def self.datetime(value)
+    match = value.match(DATETIME_REGEXP)
+  
+    raise 'Se requiere una valida fecha o fecha y hora, por ejemplo \'1961-01-22\' o \'1989-11-09T19:17Z\' (vea https://www.w3.org/TR/NOTE-datetime).' unless match
+  
+    year = match[1].to_i
+    month = match[2] ? match[2].to_i : 1
+    day = match[3] ? match[3].to_i : 1
+    hour = match[4] ? match[4].to_i : 0
+    minute = match[5] ? match[5].to_i : 0
+    second = match[6] ? match[6].to_i : 0
+    fraction = match[7] ? "0.#{match[7]}".to_f : 0
+    zulu = match[8]
+    offset = zulu ? '+00:00' : "#{match[9] || '+'}#{match[10] || '00'}:#{match[11] || '00'}"
+  
+    Time.new(year, month, day, hour, minute, second + fraction, offset)
+  end
+  
+  def self.email(value)
+    raise 'Se requiere una dirección electrónica valida, por ejemplo \'jane.doe@eno-lang.org\'.' unless value.match(EMAIL_REGEXP)
+  
+    value
+  end
+  
+  def self.float(value)
+    raise 'Se requiere un número decimal, por ejemplo \'13.0\', \'-9.159\' o \'42\'.' unless value.match(FLOAT_REGEXP)
+    
+    value.to_f
+  end
+  
+  def self.integer(value)
+    raise 'Se requiere un número entero, por ejemplo \'42\' o \'-21\'.' unless value.match(INTEGER_REGEXP)
+  
+    value.to_i
+  end
+  
+  def self.json(value)
+    begin
+      JSON.parse(value)
+    rescue => err
+      raise "Se requiere JSON valido - el mensaje del parser fue:\n#{err.message}"
+    end
+  end
+  
+  def self.lat_lng(value)
+    match = LAT_LNG_REGEXP.match(value)
+  
+    raise 'Se requiere una pareja de coordenadas latitud/longitud valida, por ejemplo \'48.2093723, 16.356099\'' unless match
+  
+    { lat: match[1].to_f, lng: match[2].to_f }
+  end
+  
+  def self.url(value)
+    raise 'Se requiere un URL valido, por ejemplo \'https://eno-lang.org\'.' unless value.match(URL_REGEXP)
+  
+    value
+  end
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: enotype
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Simon Repp
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-02-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+description: enotype is a collection of minimalist pure functions that validate and
+  convert type-unsafe string representations into type-safe, native types.
+email: simon@fdpl.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/enotype.rb
+- lib/enotype/de.rb
+- lib/enotype/en.rb
+- lib/enotype/es.rb
+homepage: https://eno-lang.org/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.8
+signing_key: 
+specification_version: 4
+summary: A cross-language standard library for types
+test_files: []