eg 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 474897a20982cd13215fb44ad94ef33f1b707c946b7c980b019ecba5ac35ce5d
+  data.tar.gz: d2da974a757adde708cfdd71883ee4b601826017051f6356fad2731781aead49
+SHA512:
+  metadata.gz: ed4bd7fa4c2a37a42a8096a54191a702b560084be91f4f56165cf4b372eb0d86993bc43109e3cc0a2e80a25d0af6861ea197b4d20d542a0ec22ee04e3220b444
+  data.tar.gz: acb74c22ace39c14888c56b7ca8ee20e364053f26555f6f028c7f6759911562b6474b284cfcc69957312af49cc4680540a6ec0e4f410b14ccb727ee65a70bcc7

data/.gitignore

@@ -0,0 +1,50 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+1.0 2019-06-15
+--------------
+
+* First working version

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 digital-fabric
+
+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,101 @@
+# EG - Prototype based objects for Ruby
+
+[INSTALL](#installing-eg) |
+[USAGE](#using-eg)
+
+## What is EG
+
+EG is a small gem that lets you create objects based on a prototype instead of a
+class definition. Eg is useful for creating singletons, mockups, service or
+factory objects, or simply for writing simple scripts without resorting to the
+`class MyClass; ...; end; my_object = MyClass.new` dance.
+
+```ruby
+require 'eg'
+
+greeter = EG.(
+  greet: -> (name) { puts "Hello, #{name}!" }
+)
+
+greeter.greet('world')
+```
+
+## Installing EG
+
+```bash
+$ gem install eg
+```
+
+Or add it to your Gemfile, you know the drill.
+
+## Using EG
+
+The EG module is a callable that accepts a single hash argument containing
+method prototypes and constant definitions. You can define methods, constants
+and instance variables:
+
+```ruby
+o = EG.(
+  foo:    -> { @bar },
+  '@bar': :baz,
+  VALUE:  42
+)
+
+o.foo    #=> :baz
+o::VALUE #=> 42
+```
+
+### defining methods
+
+Any prototype key that does not begin with an upper-case letter or `@` is
+considered a method. If the value is a proc or responds to `#to_proc`, it will
+be used as the method body. Otherwise, EG will wrap the value in a proc that
+returns it:
+
+```ruby
+o = EG.(
+  foo: -> { :bar },
+  bar: :baz
+)
+
+o.foo #=> :bar
+o.bar #=> :baz
+```
+
+### defining constants
+
+Constants are defined using keys that begin with an upper-case letter:
+
+```ruby
+o = EG.(
+  AnswerToEverything: 42
+)
+
+o::AnswerToEverything #=> 42
+```
+
+Care should be taken to always qualify constants when accessing them from
+prototype methods by prefixing them with `self::`:
+
+```ruby
+o = EG.(
+  A: 1,
+  a: ->(x) { self::A + x }
+)
+
+o.a(2) #=> 3
+```
+
+### defining instance variables
+
+Instance variables are defined using keys that begin with an `@`:
+
+```ruby
+o = EG.(
+  '@count': 0,
+  incr: -> { @count += 1 }
+)
+
+o.incr #=> 1
+o.incr #=> 2
+```

data/TODO.md

@@ -0,0 +1 @@
+- Rename gem to eg

data/eg.gemspec

@@ -0,0 +1,18 @@
+require_relative('lib/eg/version')
+
+Gem::Specification.new do |s|
+  s.name        = 'eg'
+  s.version     = EG::VERSION
+  s.licenses    = ['MIT']
+  s.summary     = 'EG: Prototype-based objects for Ruby'
+  s.author        = 'Sharon Rosner'
+  s.email         = 'ciconia@gmail.com'
+  s.files         = `git ls-files`.split
+  s.homepage      = 'http://github.com/digital-fabric/eg'
+  s.metadata      = { "source_code_uri" => "https://github.com/digital-fabric/eg" }
+  s.rdoc_options  = ["--title", "EG", "--main", "README.md"]
+  s.extra_rdoc_files = ["README.md", "CHANGELOG.md"]
+
+  s.add_runtime_dependency      'modulation', '~> 0.20'
+  s.add_development_dependency  'minitest',   '5.11.3'
+end

data/lib/eg.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'modulation/gem'
+
+export_default :EG
+
+# EG object creation functionality
+module EG
+  RE_CONST  = /^[A-Z]/.freeze
+  RE_ATTR   = /^@(.+)$/.freeze
+
+  # Creates an object from its prototype hash
+  # @param hash [Hash] prototype hash
+  # @return [Module] created object
+  def self.call(hash)
+    Module.new.tap do |m|
+      s = m.singleton_class
+      hash.each do |k, v|
+        if k =~ RE_CONST
+          m.const_set(k, v)
+        elsif k =~ RE_ATTR
+          m.instance_variable_set(k, v)
+        elsif v.respond_to?(:to_proc)
+          s.define_method(k) { |*args| instance_exec(*args, &v) }
+        else
+          s.define_method(k) { v }
+        end
+      end
+    end
+  end
+
+  def self.to_proc
+    ->(hash) { EG.call(hash) }
+  end
+end

data/lib/eg/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module EG
+  VERSION = '1.0'
+end

data/test/test_eg.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require 'modulation'
+require 'minitest/autorun'
+
+EG = import '../lib/eg'
+
+class EGTest < MiniTest::Test
+  def test_that_eg_can_define_methods
+    m = EG.(a: ->(x) { x + 1 }, b: ->(x) { x * 2})
+    assert_equal(4, m.a(3))
+    assert_equal(6, m.b(3))
+  end
+
+  def test_that_eg_can_define_constants
+    m = EG.(A: 1, B: 2)
+    assert_equal(1, m::A)
+    assert_equal(2, m::B)
+  end
+
+  def test_that_eg_constants_are_accessible_from_methods
+    m = EG.(A: 1, a: ->(x) { x + self::A })
+    assert_equal(4, m.a(3))
+  end
+
+  def test_that_eg_accepts_attributes
+    m = EG.("@foo": 'bar', getattr: -> { @foo })
+    
+    assert_equal('bar', m.getattr)
+  end
+
+  def test_the_works
+    effect = ->(f) {
+      EG.(
+        map:          ->(g)  { effect.(->(*x) {g.(f.(*x))}) },
+        run_effects:  ->(*x) { f.(*x) },
+        join:         ->(*x) { f.(*x) },
+        chain:        ->(g)  { effect.(f).map(g).join() }
+      )
+    }
+
+    msgs = []
+    f_zero = ->() {
+      msgs << 'Starting with nothing'
+      0
+    }
+    zero = effect.(f_zero)
+    increment = ->(x) { x + 1 }
+    one = zero.map(increment)
+
+    assert_equal([], msgs)
+    assert_equal(1, one.run_effects)
+    assert_equal(['Starting with nothing'], msgs)
+
+    msgs.clear
+    double  = ->(x) { x * 2 }
+    cube    = ->(x) { x**3 }
+    eight = zero.map(increment).map(double).map(cube)
+    
+    assert_equal([], msgs)
+    assert_equal(8, eight.run_effects)
+    assert_equal(['Starting with nothing'], msgs)
+  end
+
+  def test_use_as_proc
+    Kernel.define_method(:eg, &EG)
+    o = eg(
+      foo: -> { :bar }
+    )
+    assert_equal(:bar, o.foo)
+  end
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: eg
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Sharon Rosner
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-06-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: modulation
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.20'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.20'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 5.11.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 5.11.3
+description: 
+email: ciconia@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+- CHANGELOG.md
+files:
+- ".gitignore"
+- CHANGELOG.md
+- LICENSE
+- README.md
+- TODO.md
+- eg.gemspec
+- lib/eg.rb
+- lib/eg/version.rb
+- test/test_eg.rb
+homepage: http://github.com/digital-fabric/eg
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/digital-fabric/eg
+post_install_message: 
+rdoc_options:
+- "--title"
+- EG
+- "--main"
+- README.md
+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: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: 'EG: Prototype-based objects for Ruby'
+test_files: []