dry-core 0.4.7

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 74e2816087ba373bcfd55f8e216ef6708e1e70b0930020d71518385190460537
+  data.tar.gz: 19eb04ff0972c2b928e455ff7345c93caed587af56ea8089a5433eb471a624b3
+SHA512:
+  metadata.gz: c1949faf46146ee0bb734aec09350b864ba414105ad7ceef4dad476b3667f4d14c0474c84da28fdf293e651da9a7a26119501548d6512eeed42e5e1296270d12
+  data.tar.gz: ffa845da4bf5da3f5b370f6093721d4c7689bde90da3b4a58f17954807fc9fe0f7065997b7bebee46e6eed2525bd181c042fe550ffa1b4557fa9cf95ee6eae47

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+spec/examples.txt

data/.inch.yml

@@ -0,0 +1,4 @@
+files:
+  excluded:
+    - lib/dry/core.rb
+    - lib/dry/core/version.rb

data/.rspec

@@ -0,0 +1,3 @@
+--format progress
+--color
+--require ./spec/spec_helper.rb

data/.rubocop.yml

@@ -0,0 +1,31 @@
+AllCops:
+  TargetRubyVersion: 2.1
+  Exclude:
+    - 'dry-core.gemspec'
+    - 'spec/spec_helper.rb'
+
+Style/SignalException:
+  Exclude:
+    - 'spec/**/*'
+
+Style/RedundantSelf:
+  Exclude:
+    - 'lib/dry/core/deprecations.rb'
+
+Metrics/LineLength:
+  Max: 110
+
+Metrics/MethodLength:
+  Enabled: false
+
+Style/FileName:
+  Exclude:
+    - 'lib/dry-core.rb'
+
+Lint/AmbiguousRegexpLiteral:
+  Exclude:
+    - 'spec/**/*'
+
+Style/BlockDelimiters:
+  Exclude:
+    - 'spec/**/*'

data/.travis.yml

@@ -0,0 +1,31 @@
+language: ruby
+dist: trusty
+sudo: required
+cache: bundler
+bundler_args: --without benchmarks tools
+after_success:
+  - '[ -d coverage ] && bundle exec codeclimate-test-reporter'
+script:
+  - bundle exec rake
+before_install:
+  - gem update --system
+after_success:
+  - '[ -d coverage ] && bundle exec codeclimate-test-reporter'
+rvm:
+  - 2.2.9
+  - 2.3.6
+  - 2.4.3
+  - 2.5.0
+  - jruby-9.1.15.0
+env:
+  global:
+    - COVERAGE=true
+    - JRUBY_OPTS='--dev -J-Xmx1024M'
+notifications:
+  email: false
+  webhooks:
+    urls:
+      - https://webhooks.gitter.im/e/19098b4253a72c9796db
+    on_success: change  # options: [always|never|change] default: always
+    on_failure: always  # options: [always|never|change] default: always
+    on_start: false     # default: false

data/CHANGELOG.md

@@ -0,0 +1,153 @@
+# v0.4.7 2018-06-25
+
+### Fixed
+
+* Fix default logger for deprecations, it now uses `$stderr` by default, as it should (flash-gordon)
+
+[Compare v0.4.6...v0.4.7](https://github.com/dry-rb/dry-core/compare/v0.4.6...v0.4.7)
+
+# v0.4.6 2018-05-15
+
+### Changed
+
+* Trigger constant autoloading in the class builder (radar)
+
+[Compare v0.4.5...v0.4.6](https://github.com/dry-rb/dry-core/compare/v0.4.5...v0.4.6)
+
+# v0.4.5 2018-03-14
+
+### Added
+
+* `Dry::Core::Memoizable`, which provides a `memoize` macro for memoizing results of instance methods (timriley)
+
+[Compare v0.4.4...v0.4.5](https://github.com/dry-rb/dry-core/compare/v0.4.4...v0.4.5)
+
+# v0.4.4 2018-02-10
+
+### Added
+
+* `deprecate_constant` overrides `Module#deprecate_constant` and issues a labeled message on accessing a deprecated constant (flash-gordon)
+* `Undefined.default` which accepts two arguments and returns the first if it's not `Undefined`; otherwise, returns the second one or yields a block (flash-gordon)
+
+[Compare v0.4.3...v0.4.4](https://github.com/dry-rb/dry-core/compare/v0.4.3...v0.4.4)
+
+# v0.4.3 2018-02-03
+
+### Added
+
+* `Dry::Core::DescendantsTracker` which is a maintained version of the [`descendants_tracker`](https://github.com/dkubb/descendants_tracker) gem (flash-gordon)
+
+[Compare v0.4.2...v0.4.3](https://github.com/dry-rb/dry-core/compare/v0.4.2...0.4.3)
+
+# v0.4.2 2017-12-16
+
+### Fixed
+
+* Class attributes now support private setters/getters (flash-gordon)
+
+[Compare v0.4.1...v0.4.2](https://github.com/dry-rb/dry-core/compare/v0.4.1...v0.4.2)
+
+# v0.4.1 2017-11-04
+
+### Changed
+
+* Improved error message on invalid attribute value (GustavoCaso)
+
+[Compare v0.4.0...v0.4.1](https://github.com/dry-rb/dry-core/compare/v0.4.0...v0.4.1)
+
+# v0.4.0 2017-11-02
+
+### Added
+
+* Added the `:type` option to class attributes, you can now restrict attribute values with a type. You can either use plain ruby types (`Integer`, `String`, etc) or `dry-types` (GustavoCaso)
+
+  ```ruby
+    class Foo
+      extend Dry::Core::ClassAttributes
+
+      defines :ruby_attr, type: Integer
+      defines :dry_attr, type: Dry::Types['strict.int']
+    end
+  ```
+
+[Compare v0.3.4...v0.4.0](https://github.com/dry-rb/dry-core/compare/v0.3.4...v0.4.0)
+
+# v0.3.4 2017-09-29
+
+### Fixed
+
+* `Deprecations` output is set to `$stderr` by default now (solnic)
+
+[Compare v0.3.3...v0.3.4](https://github.com/dry-rb/dry-core/compare/v0.3.3...v0.3.4)
+
+# v0.3.3 2017-08-31
+
+### Fixed
+
+* The Deprecations module now shows the right caller line (flash-gordon)
+
+[Compare v0.3.2...v0.3.3](https://github.com/dry-rb/dry-core/compare/v0.3.2...v0.3.3)
+
+# v0.3.2 2017-08-31
+
+### Added
+
+* Accept an existing logger object in `Dry::Core::Deprecations.set_logger!` (flash-gordon)
+
+[Compare v0.3.1...v0.3.2](https://github.com/dry-rb/dry-core/compare/v0.3.1...v0.3.2)
+
+# v0.3.1 2017-05-27
+
+### Added
+
+* Support for building classes within an existing namespace (flash-gordon)
+
+[Compare v0.3.0...v0.3.1](https://github.com/dry-rb/dry-core/compare/v0.3.0...v0.3.1)
+
+# v0.3.0 2017-05-05
+
+### Changed
+
+* Class attributes are initialized _before_ running the `inherited` hook. It's slightly more convenient behavior and it's very unlikely anyone will be affected by this, but technically this is a breaking change (flash-gordon)
+
+[Compare v0.2.4...v0.3.0](https://github.com/dry-rb/dry-core/compare/v0.2.4...v0.3.0)
+
+# v0.2.4 2017-01-26
+
+### Fixed
+
+* Do not require deprecated method to be defined (flash-gordon)
+
+[Compare v0.2.3...v0.2.4](https://github.com/dry-rb/dry-core/compare/v0.2.3...v0.2.4)
+
+# v0.2.3 2016-12-30
+
+### Fixed
+
+* Fix warnings on using uninitialized class attributes (flash-gordon)
+
+[Compare v0.2.2...v0.2.3](https://github.com/dry-rb/dry-core/compare/v0.2.2...v0.2.3)
+
+# v0.2.2 2016-12-30
+
+### Added
+
+* `ClassAttributes` which provides `defines` method for defining get-or-set methods (flash-gordon)
+
+[Compare v0.2.1...v0.2.2](https://github.com/dry-rb/dry-core/compare/v0.2.1...v0.2.2)
+
+# v0.2.1 2016-11-18
+
+### Added
+
+* `Constants` are now available in nested scopes (flash-gordon)
+
+[Compare v0.2.0...v0.2.1](https://github.com/dry-rb/dry-core/compare/v0.2.0...v0.2.1)
+
+# v0.2.0 2016-11-01
+
+[Compare v0.1.0...v0.2.0](https://github.com/dry-rb/dry-core/compare/v0.1.0...v0.2.0)
+
+# v0.1.0 2016-09-17
+
+Initial release

data/CONTRIBUTING.md

@@ -0,0 +1,29 @@
+# Issue Guidelines
+
+## Reporting bugs
+
+If you found a bug, report an issue and describe what's the expected behavior versus what actually happens. If the bug causes a crash, attach a full backtrace. If possible, a reproduction script showing the problem is highly appreciated.
+
+## Reporting feature requests
+
+Report a feature request **only after discourseing it first on [discourse.dry-rb.org](https://discourse.dry-rb.org)** where it was accepted. Please provide a concise description of the feature, don't link to a discourseion thread, and instead summarize what was discourseed.
+
+## Reporting questions, support requests, ideas, concerns etc.
+
+**PLEASE DON'T** - use [discourse.dry-rb.org](https://discourse.dry-rb.org) instead.
+
+# Pull Request Guidelines
+
+A Pull Request will only be accepted if it addresses a specific issue that was reported previously, or fixes typos, mistakes in documentation etc.
+
+Other requirements:
+
+1) Do not open a pull request if you can't provide tests along with it. If you have problems writing tests, ask for help in the related issue.
+2) Follow the style conventions of the surrounding code. In most cases, this is standard ruby style.
+3) Add API documentation if it's a new feature
+4) Update API documentation if it changes an existing feature
+5) Bonus points for sending a PR to [github.com/dry-rb/dry-rb.org](github.com/dry-rb/dry-rb.org) which updates user documentation and guides
+
+# Asking for help
+
+If these guidelines aren't helpful, and you're stuck, please post a message on [discourse.dry-rb.org](https://discourse.dry-rb.org).

data/Gemfile

@@ -0,0 +1,22 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :test do
+  if RUBY_VERSION >= '2.4'
+    gem 'activesupport'
+  else
+    gem 'activesupport', '~> 4.2'
+  end
+  gem 'inflecto', '~> 0.0', '>= 0.0.2'
+  gem 'codeclimate-test-reporter', require: false
+  gem 'simplecov', require: false
+  gem 'dry-types'
+  gem 'dry-inflector', git: 'https://github.com/dry-rb/dry-inflector', branch: 'master'
+end
+
+group :tools do
+  gem 'pry-byebug', platform: :mri
+  gem 'pry', platform: :jruby
+  gem 'rubocop'
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Nikita Shilnikov
+
+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,47 @@
+[gitter]: https://gitter.im/dry-rb/chat
+[gem]: https://rubygems.org/gems/dry-core
+[travis]: https://travis-ci.org/dry-rb/dry-core
+[code_climate]: https://codeclimate.com/github/dry-rb/dry-core
+[inch]: http://inch-ci.org/github/dry-rb/dry-core
+
+# dry-core
+
+[![Gem Version](https://img.shields.io/gem/v/dry-core.svg)][gem]
+[![Build Status](https://img.shields.io/travis/dry-rb/dry-core.svg)][travis]
+[![Code Climate](https://api.codeclimate.com/v1/badges/eebb0e969814744231e4/maintainability)][code_climate]
+[![Test Coverage](https://api.codeclimate.com/v1/badges/eebb0e969814744231e4/test_coverage)][code_climate]
+[![API Documentation Coverage](http://inch-ci.org/github/dry-rb/dry-core.svg)][inch]
+![No monkey-patches](https://img.shields.io/badge/monkey--patches-0-brightgreen.svg)
+
+A collection of small modules used in the dry-rb ecosystem.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'dry-core'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install dry-core
+
+## 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.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/dry-rb/dry-core.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/dry-core.gemspec

@@ -0,0 +1,34 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'dry/core/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'dry-core'
+  spec.version       = Dry::Core::VERSION
+  spec.authors       = ['Nikita Shilnikov']
+  spec.email         = ['fg@flashgordon.ru']
+
+  spec.summary       = 'A toolset of small support modules used throughout the dry-rb ecosystem.'
+  spec.description   = spec.summary
+  spec.homepage      = 'https://github.com/dry-rb/dry-core'
+  spec.license       = 'MIT'
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  else
+    raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.'
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|bin)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+  spec.required_ruby_version = '>= 2.1.0'
+  spec.add_runtime_dependency 'concurrent-ruby', '~> 1.0'
+
+  spec.add_development_dependency 'bundler', '~> 1.12'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end

data/lib/dry-core.rb

@@ -0,0 +1 @@
+require 'dry/core'

data/lib/dry/core.rb

@@ -0,0 +1,8 @@
+require 'dry/core/version'
+
+# :nodoc:
+module Dry
+  # :nodoc:
+  module Core
+  end
+end

data/lib/dry/core/cache.rb

@@ -0,0 +1,66 @@
+require 'concurrent/map'
+
+module Dry
+  module Core
+    # Allows you to cache call results that are solely determined by arguments.
+    #
+    # @example
+    #   require 'dry/core/cache'
+    #
+    #   class Foo
+    #     extend Dry::Core::Cache
+    #
+    #     def heavy_computation(arg1, arg2)
+    #       fetch_or_store(arg1, arg2) { arg1 ^ arg2 }
+    #     end
+    #   end
+    #
+    # @api public
+    module Cache
+      # @api private
+      def self.extended(klass)
+        super
+        klass.include(Methods)
+        klass.instance_variable_set(:@__cache__, Concurrent::Map.new)
+      end
+
+      # @api private
+      def inherited(klass)
+        super
+        klass.instance_variable_set(:@__cache__, cache)
+      end
+
+      # @api private
+      def cache
+        @__cache__
+      end
+
+      # Caches a result of the block evaluation
+      #
+      # @param [Array<Object>] args List of hashable objects
+      # @yield An arbitrary block
+      #
+      # @note beware Proc instance hashes are not equal, i.e. -> { 1 }.hash != -> { 1 }.hash,
+      #       this means you shouldn't pass Procs in args unless you're sure
+      #       they are always the same instances, otherwise you introduce a memory leak
+      #
+      # @return [Object] block's return value (cached for subsequent calls with the same argument values)
+      def fetch_or_store(*args, &block)
+        cache.fetch_or_store(args.hash, &block)
+      end
+
+      # Instance methods
+      module Methods
+        # Delegates call to the class-level method
+        #
+        # @param [Array<Object>] args List of hashable objects
+        # @yield An arbitrary block
+        #
+        # @return [Object] block's return value
+        def fetch_or_store(*args, &block)
+          self.class.fetch_or_store(*args, &block)
+        end
+      end
+    end
+  end
+end