rb_core_extensions 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff651ca46ca4e51a477160b362fdd434c6fa95d248d27a5022b0ee8f0c9b5b41
-  data.tar.gz: 819bafb17f44354587c741c2ede51e3bf7f002f7020bdb32a718d82016401519
+  metadata.gz: eaab7679a1e5cedcdfd17b5abaed34ac040d6d5f0bc7ab91e8e3d52695d78720
+  data.tar.gz: e61962df11083b76b1198b1762854142dd9e160d8e127fbdc6f11021d27f1d13
 SHA512:
-  metadata.gz: e05845abd3afc84fcee0fd1ee16d05f2b9904b5e9abe082cf261bddc2681e3637122786a3ddb792a6ba08273313ea766b8b4defcdbcf627de1ba747b333d10d2
-  data.tar.gz: 572c3a81cc8c4fe82b821220d3528c4497d4246b02061422ce7f1155af4427c70666db8b28f2a64a63e2f96a1523a3e57db8a46867e686ec0372a04444d57987
+  metadata.gz: 889d4bb5b68918c8feaf3bf3ac4cac823f78b2899af9a0f3a7afe5f9d63fbef3c357e1da85c31bf07e893172ccaf540d70f9594ec756b0c82361a7c504f17b43
+  data.tar.gz: 3712ca130c9031070b2ec4d01edea3f88e8e991db450e6c3d229e39eeab21df2f34363b9a7464d66ee88970752f2ecfca4352d0d9a645954640f610b7e3ebd17

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [0.1.3](https://github.com/shivam091/core_extensions/compare/v0.1.2...v0.1.3) - 2023-07-07
+
+### What's new
+
+- Added core extension methods `hierarchy`, `lineage`, and `leaf_subclasses` in `Class`
+- Added extensions `to_i` and `to_b` in `TrueClass` and `FalseClass`
+- Added `to_b` core ext. in `NilClass`
+
 ## [0.1.2](https://github.com/shivam091/core_extensions/compare/v0.1.1...v0.1.2) - 2023-07-06
 
 ### What's new

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rb_core_extensions (0.1.2)
+    rb_core_extensions (0.1.3)
       activesupport (~> 7.0)
 
 GEM

data/README.md

@@ -47,7 +47,7 @@ require "core_extensions/date"
 
 ## Extensions Provided
 
-Below are the extension methods which are provided by `rb_core_extensions`. Please refer [documentation](https://shivam091.github.io/core_extensions) or rspec for examples of how to use these methods.
+Below are the extension methods provided by `rb_core_extensions`. Please refer [documentation](https://shivam091.github.io/core_extensions) for examples of how to use these methods.
 
 ### [Array](https://shivam091.github.io/core_extensions/Array.html)
 
@@ -78,10 +78,23 @@ Below are the extension methods which are provided by `rb_core_extensions`. Plea
 #### ***core_extensions/hash/delete.rb***
 1. **[`#slice!`](https://shivam091.github.io/core_extensions/Hash.html#method-i-slice-21)** - Alters the hash by keeping only specified `keys` and returns it.
 
+### [TrueClass](https://shivam091.github.io/core_extensions/TrueClass.html)
+
+#### ***core_extensions/true_class.rb***
+1. **[`#to_i`](https://shivam091.github.io/core_extensions/TrueClass.html#method-i-to_i)** - Returns `1` if invoked on `TrueClass` instance.
+2. **[`#to_b`](https://shivam091.github.io/core_extensions/TrueClass.html#method-i-to_b)** - Returns `true` if invoked on `TrueClass` instance.
+
+### [FalseClass](https://shivam091.github.io/core_extensions/FalseClass.html)
+
+#### ***core_extensions/false_class.rb***
+1. **[`#to_i`](https://shivam091.github.io/core_extensions/FalseClass.html#method-i-to_i)** - Returns `0` if invoked on `FalseClass` instance.
+2. **[`#to_b`](https://shivam091.github.io/core_extensions/FalseClass.html#method-i-to_b)** - Returns `false` if invoked on `FalseClass` instance.
+
 ### [NilClass](https://shivam091.github.io/core_extensions/NilClass.html)
 
-### ***core_extensions/nil_class***
-1. **[`#blank?`](https://shivam091.github.io/core_extensions/NilClass.html#method-i-blank-3F)** - Returns `true` when invoked on `nil`.
+#### ***core_extensions/nil_class.rb***
+1. **[`#blank?`](https://shivam091.github.io/core_extensions/NilClass.html#method-i-blank-3F)** - Returns `true` if invoked on `NilClass` instance.
+2. **[`#to_b`](https://shivam091.github.io/core_extensions/NilClass.html#method-i-to_b)** - Returns `false` if invoked on `NilClass` instance.
 
 ### [Object](https://shivam091.github.io/core_extensions/Object.html)
 
@@ -95,6 +108,13 @@ Below are the extension methods which are provided by `rb_core_extensions`. Plea
 #### ***core_extensions/module.rb***
 1. **[`#namespaces`](https://shivam091.github.io/core_extensions/Module.html#method-i-namespaces)** - Returns an `Array` with the namespaces to the current `Module`.
 
+### [Class](https://shivam091.github.io/core_extensions/Class.html)
+
+#### ***core_extensions/class.rb***
+1. **[`#hierarchy`](https://shivam091.github.io/core_extensions/Class.html#method-i-hierarchy)** - Returns a tree-like `Hash` structure of all descendants.
+2. **[`#lineage`](https://shivam091.github.io/core_extensions/Class.html#method-i-lineage)** - Returns an `Array` of all superclasses.
+3. **[`#leaf_subclasses`](https://shivam091.github.io/core_extensions/Class.html#method-i-leaf_subclasses)** - Returns an `Array` of all descendants which have no subclasses.
+
 ## Contributing
 
 1. Fork it

data/lib/core_extensions/all.rb

@@ -4,7 +4,10 @@
 
 require "core_extensions/array"
 require "core_extensions/hash"
+require "core_extensions/true_class"
+require "core_extensions/false_class"
 require "core_extensions/nil_class"
 
-require "core_extensions/object"
+require "core_extensions/class"
 require "core_extensions/module"
+require "core_extensions/object"

data/lib/core_extensions/class.rb

@@ -0,0 +1,40 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+require "active_support/core_ext/class/subclasses"
+
+class Class
+  # Returns a tree-like +Hash+ structure of all descendants.
+  #
+  # ==== Examples
+  #
+  #   require 'socket'
+  #   IO.hierarchy
+  #   #=> {BasicSocket=>{UNIXSocket=>{UNIXServer=>{}}, IPSocket=>{UDPSocket=>{}, TCPSocket=>{TCPServer=>{}}}, Socket=>{}}, File=>{}}
+  def hierarchy
+    subclasses.each_with_object({}) { |k, h| h[k] = k.hierarchy }
+  end
+
+  # Returns an +Array+ of all superclasses.
+  #
+  # ==== Examples
+  #
+  #   require 'socket'
+  #   TCPServer.lineage
+  #   #=> [TCPSocket, IPSocket, BasicSocket, IO, Object, BasicObject]
+  def lineage
+    superclass.nil? ? [] : superclass.lineage.unshift(superclass)
+  end
+
+  # Returns an +Array+ of all descendants which have no subclasses.
+  #
+  # ==== Examples
+  #
+  #   require 'socket'
+  #   BasicSocket.leaf_subclasses
+  #   #=> [Socket, UNIXServer, UDPSocket, TCPServer]
+  def leaf_subclasses
+    descendants.select { |d| d.subclasses.empty? }
+  end
+end

data/lib/core_extensions/false_class.rb

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+class FalseClass
+  # Returns +0+ if invoked on +FalseClass+ instance.
+  #
+  # ==== Examples
+  #
+  #   false.to_i #=> 0
+  def to_i
+    0
+  end
+
+  # Returns +false+ if invoked on +FalseClass+ instance.
+  #
+  # ==== Examples
+  #
+  #   false.to_b #=> false
+  def to_b
+    false
+  end
+end

data/lib/core_extensions/nil_class.rb

@@ -3,7 +3,7 @@
 # -*- warn_indent: true -*-
 
 class NilClass
-  # Returns +true+ when invoked on `nil`.
+  # Returns +true+ if invoked on `NilClass` instance.
   #
   # ==== Examples
   #
@@ -11,4 +11,13 @@ class NilClass
   def blank?
     true
   end
+
+  # Returns +false+ if invoked on +NilClass+ instance.
+  #
+  # ==== Examples
+  #
+  #   nil.to_b #=> false
+  def to_b
+    false
+  end
 end

data/lib/core_extensions/true_class.rb

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+class TrueClass
+  # Returns +1+ if invoked on +TrueClass+ instance.
+  #
+  # ==== Examples
+  #
+  #   true.to_i #=> 1
+  def to_i
+    1
+  end
+
+  # Returns +true+ if invoked on +TrueClass+ instance.
+  #
+  # ==== Examples
+  #
+  #   true.to_b #=> true
+  def to_b
+    true
+  end
+end

data/lib/core_extensions/version.rb

@@ -3,5 +3,5 @@
 # -*- warn_indent: true -*-
 
 module CoreExtensions #:nodoc:
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rb_core_extensions
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Harshal LADHE
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-07-06 00:00:00.000000000 Z
+date: 2023-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -70,6 +70,8 @@ files:
 - lib/core_extensions/array/duplicates.rb
 - lib/core_extensions/array/inclusion.rb
 - lib/core_extensions/array/math.rb
+- lib/core_extensions/class.rb
+- lib/core_extensions/false_class.rb
 - lib/core_extensions/hash.rb
 - lib/core_extensions/hash/access.rb
 - lib/core_extensions/hash/delete.rb
@@ -77,6 +79,7 @@ files:
 - lib/core_extensions/module.rb
 - lib/core_extensions/nil_class.rb
 - lib/core_extensions/object.rb
+- lib/core_extensions/true_class.rb
 - lib/core_extensions/version.rb
 - rb_core_extensions.gemspec
 homepage: https://github.com/shivam091/core_extensions