dry-core 0.4.2 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 1bb0fe21e198b946d0363a8a082f3c860605eb38
-  data.tar.gz: d08019514eabec7e537e2a01138378295a62a75e
+SHA256:
+  metadata.gz: 3a392bbea0fdae74dcaa2a99035e2b4d326d68a733ad8cbed5803c31cae028e5
+  data.tar.gz: 320c2059c1424a20eefd901c1f8f48da399ce3579441d546bab8b9dac7457f24
 SHA512:
-  metadata.gz: 68b16b0ce816c94c9187d3721933aad533d5d8450c742b5e3659cdfc5dc77d6a63d3ae56f67c2278a3403382bace6af3396aefcb77f5f2a06053d3c16efb1d94
-  data.tar.gz: 5d97a6f64702926e66aba7bf4d1727f143997cce3054d4c58f35890a4e344265e4f37492f6cc56aec80685bdefce9a4fd6a1bc8e3c802fbec6feaad76e99d90a
+  metadata.gz: 883649ce8aa3ed20709191569110e0f4969c614fd4baf72dc2fc80a47847f20493ffbda1d795da21e15289383eb55f3c77f4a8f367832b90f22021ffab7914d2
+  data.tar.gz: c7dee84cedde914a6a800ed6822c957d099c90ded80b558f9b1625ab6706cf85b273af73f6e5404320b1e46e7b58a3111ff7af9613c5b457e61dc00978ff9e28

data/.travis.yml

@@ -7,12 +7,16 @@ 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.1.10
-  - 2.2.7
-  - 2.3.4
-  - 2.4.1
-  - jruby-9.1.9.0
+  - 2.2.9
+  - 2.3.6
+  - 2.4.3
+  - 2.5.0
+  - jruby-9.1.15.0
 env:
   global:
     - COVERAGE=true

data/CHANGELOG.md

@@ -1,3 +1,20 @@
+# 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 `Undefiend`; 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

data/README.md

@@ -8,8 +8,8 @@
 
 [![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://img.shields.io/codeclimate/github/dry-rb/dry-core.svg)][code_climate]
-[![Test Coverage](https://img.shields.io/codeclimate/coverage/github/dry-rb/dry-core.svg)][code_climate]
+[![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)
 

data/lib/dry/core/constants.rb

@@ -43,6 +43,26 @@ module Dry
         def undefined.inspect
           'Undefined'
         end
+
+        # Pick a value, if the first argument is not Undefined, return it back,
+        # otherwise return the second arg or yield the block.
+        #
+        # @example
+        #  def method(val = Undefined)
+        #    1 + Undefined.default(val, 2)
+        #  end
+        #
+        def undefined.default(x, y = self)
+          if x.equal?(self)
+            if y.equal?(self)
+              yield
+            else
+              y
+            end
+          else
+            x
+          end
+        end
       end.freeze
 
       def self.included(base)

data/lib/dry/core/deprecations.rb

@@ -53,7 +53,7 @@ module Dry
         end
 
         # @api private
-        def deprecated_method_message(old, new = nil, msg = nil)
+        def deprecated_name_message(old, new = nil, msg = nil)
           if new
             deprecation_message(old, <<-MSG)
               Please use #{new} instead.
@@ -142,7 +142,7 @@ module Dry
         # @param [Symbol] new_name replacement (not required)
         # @option [String] message optional deprecation message
         def deprecate(old_name, new_name = nil, message: nil)
-          full_msg = Deprecations.deprecated_method_message(
+          full_msg = Deprecations.deprecated_name_message(
             "#{self.name}##{old_name}",
             new_name ? "#{self.name}##{new_name}" : nil,
             message
@@ -175,7 +175,7 @@ module Dry
         # @param [Symbol] new_name replacement (not required)
         # @option [String] message optional deprecation message
         def deprecate_class_method(old_name, new_name = nil, message: nil)
-          full_msg = Deprecations.deprecated_method_message(
+          full_msg = Deprecations.deprecated_name_message(
             "#{self.name}.#{old_name}",
             new_name ? "#{self.name}.#{new_name}" : nil,
             message
@@ -192,6 +192,32 @@ module Dry
             end
           end
         end
+
+        # Mark a constant as deprecated
+        # @param [Symbol] constant_name constant name to be deprecated
+        # @option [String] message optional deprecation message
+        def deprecate_constant(constant_name, message: nil)
+          value = const_get(constant_name)
+          remove_const(constant_name)
+
+          full_msg = Deprecations.deprecated_name_message(
+            "#{self.name}::#{constant_name}",
+            message
+          )
+
+          mod = Module.new do
+            define_method(:const_missing) do |missing|
+              if missing == constant_name
+                warn("#{ full_msg }\n#{ STACK.() }")
+                value
+              else
+                super(missing)
+              end
+            end
+          end
+
+          extend(mod)
+        end
       end
     end
   end

data/lib/dry/core/descendants_tracker.rb

@@ -0,0 +1,76 @@
+require 'concurrent/array'
+
+module Dry
+  module Core
+    # An implementation of descendants tracker, heavily inspired
+    # by the descendants_tracker gem.
+    #
+    # @example
+    #
+    #   class Base
+    #     extend Dry::Core::DescendantsTracker
+    #   end
+    #
+    #   class A < Base
+    #   end
+    #
+    #   class B < Base
+    #   end
+    #
+    #   class C < A
+    #   end
+    #
+    #   Base.descendants # => [C, B, A]
+    #   A.descendants # => [C]
+    #   B.descendants # => []
+    #
+    module DescendantsTracker
+      class << self
+        # @api private
+        def setup(target)
+          target.instance_variable_set(:@descendants, Concurrent::Array.new)
+        end
+
+        private
+
+        # @api private
+        def extended(base)
+          super
+
+          DescendantsTracker.setup(base)
+        end
+      end
+
+      # Return the descendants of this class
+      #
+      # @example
+      #   descendants = Parent.descendants
+      #
+      # @return [Array<Class>]
+      #
+      # @api public
+      attr_reader :descendants
+
+      protected
+
+      # @api private
+      def add_descendant(descendant)
+        ancestor = superclass
+        if ancestor.respond_to?(:add_descendant, true)
+          ancestor.add_descendant(descendant)
+        end
+        descendants.unshift(descendant)
+      end
+
+      private
+
+      # @api private
+      def inherited(descendant)
+        super
+
+        DescendantsTracker.setup(descendant)
+        add_descendant(descendant)
+      end
+    end
+  end
+end

data/lib/dry/core/version.rb

@@ -1,5 +1,5 @@
 module Dry
   module Core
-    VERSION = '0.4.2'.freeze
+    VERSION = '0.4.4'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dry-core
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.4.4
 platform: ruby
 authors:
 - Nikita Shilnikov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-12-16 00:00:00.000000000 Z
+date: 2018-02-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -92,6 +92,7 @@ files:
 - lib/dry/core/class_builder.rb
 - lib/dry/core/constants.rb
 - lib/dry/core/deprecations.rb
+- lib/dry/core/descendants_tracker.rb
 - lib/dry/core/errors.rb
 - lib/dry/core/extensions.rb
 - lib/dry/core/inflector.rb
@@ -117,7 +118,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.14
+rubygems_version: 2.7.3
 signing_key: 
 specification_version: 4
 summary: A toolset of small support modules used throughout the dry-rb ecosystem.