simple-lazy 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1f1bf156abca48a25effef7bf5ec2d6bab5e61cdbf6ebeb33844fdf06be05539
+  data.tar.gz: 7f1982b3a37fb5b2a2c0352c7dae1c3744f9d30209bd518739066767753530ec
+SHA512:
+  metadata.gz: 9571b50538dad79b871db6dc08026db758d732047f203358a1e6175305c1e689f54add0ee800657f9e9639fd5a6327cee9d6703252e3f9d75128a8db8efd8ddf
+  data.tar.gz: be241db829ca6c92efab15753a7c9259dbb6c013db24e7820f73ae84f210a7d44b01e955559e29a6b2141c0f0f34b8a1cf1a4c62b5b067b0d9fedd4160ba116a

data/.gitignore

@@ -0,0 +1 @@
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gemspec

data/LICENSE

@@ -0,0 +1,2 @@
+this work is licensed under the terms of the MIT license,
+see https://opensource.org/licenses/MIT

data/README.md

@@ -0,0 +1,29 @@
+# Simple::Lazy
+
+lazily load objects
+
+## installation
+
+    $ gem install simple-lazy
+
+**or**
+
+```ruby
+gem 'simple-lazy'
+```
+
+    $ bundle
+
+## usage
+
+```ruby
+user = Simple::Lazy.new(1) { |id| User.find(id) } # #<Lazy @value=1 cached?=false>
+user.value # => 1
+user.cached? # => false
+user.username # => "elonmusk"
+user.tweets.count # => 7419
+user.value # => 1
+user.cached? # => true
+user.inspect # => #<Lazy @value=1 cached?=false>
+user.to_s # => "@elonmusk"
+```

data/Rakefile

@@ -0,0 +1,3 @@
+require "bundler/gem_tasks"
+
+task default: :spec

data/bin/console

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "simple/lazy"
+
+require "irb"
+
+IRB.start(__FILE__)

data/lib/simple/lazy.rb

@@ -0,0 +1,51 @@
+module Simple
+  class Lazy
+    VERSION = "1.0.0"
+
+    attr_reader :value
+
+    def initialize(value, &block)
+      @block = block
+      @value = value
+      @cached = nil
+      @is_cached = false
+    end
+
+    def hash
+      value.hash
+    end
+
+    def eql?(other)
+      other.is_a?(Simple::Lazy) ? value == other.value : value == other
+    end
+
+    def <=>(other)
+      other.is_a?(Simple::Lazy) ? value <=> other.value : value <=> other
+    end
+
+    def method_missing(method, *args, &block)
+      cached.public_send(method, *args, &block)
+    end
+
+    def cached
+      unless @cached
+        @cached = @block.call(value)
+        @is_cached = true
+      end
+
+      @cached
+    end
+
+    def cached?
+      @is_cached
+    end
+
+    def to_s
+      cached.to_s
+    end
+
+    def inspect
+      "#<Simple::Lazy @value=#{@value.inspect} cached?=#{cached?.inspect}>"
+    end
+  end
+end

data/simple-lazy.gemspec

@@ -0,0 +1,13 @@
+require_relative "lib/simple/lazy"
+
+Gem::Specification.new do |spec|
+  spec.name = "simple-lazy"
+  spec.version = Simple::Lazy::VERSION
+  spec.authors = ["localhostdotdev"]
+  spec.email = ["localhostdotdev@protonmail.com"]
+  spec.summary = "lazy loading, e.g. Simple::Lazy.new(1) { |id| User.find(id) }"
+  spec.homepage = "https://github.com/simple-updates/simple-lazy"
+  spec.license = "MIT"
+  spec.files = `git ls-files`.split("\n")
+  spec.require_paths = ["lib"]
+end

data/test/simple/lazy_test.rb

@@ -0,0 +1,40 @@
+require "minitest/autorun"
+
+class TestSimpleLazy < Minitest::Test
+  def test_1
+    assert_equal(1, Simple::Lazy.new(1) { }.value)
+    assert_equal(false, Simple::Lazy.new(1) { }.cached?)
+  end
+
+  def test_2
+    user = Simple::Lazy.new(1) { |id| Struct.new(:name).new("a#{id}") }
+
+    assert_equal(1, user.value)
+    assert_equal(false, user.cached?)
+    assert_equal("a1", user.name)
+    assert_equal(true, user.cached?)
+  end
+
+  def test_3
+    error = nil
+
+    begin
+      lazy = Simple::Lazy.new(1) { |id| raise 'oops' }
+      lazy.inspect
+      lazy.value
+      lazy.cached?
+      lazy == lazy
+      [lazy, lazy].sort
+      lazy.hash
+    rescue => e
+      error = e
+    end
+
+    assert_nil(error)
+  end
+
+  def test_4
+    lazy = Simple::Lazy.new(1) { |id| "oh" }
+    assert_equal("oh", lazy.to_s)
+  end
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: simple-lazy
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- localhostdotdev
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-04-24 00:00:00.000000000 Z
+dependencies: []
+description: 
+email:
+- localhostdotdev@protonmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- lib/simple/lazy.rb
+- simple-lazy.gemspec
+- test/simple/lazy_test.rb
+homepage: https://github.com/simple-updates/simple-lazy
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+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: lazy loading, e.g. Simple::Lazy.new(1) { |id| User.find(id) }
+test_files: []