philiprehberger-bit_field 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f16348291b79d06cfaca4dd476c9035c08fb1d5fda2d533cd77640d510b3b1c
-  data.tar.gz: 813565b60c755c8acbc193771f9094863de462f20db0c53b692ae6a0b717619c
+  metadata.gz: 9177b0d13311c9ded1be36cd0b56b4d62c9fbad315c823f19437c9a8886a66c6
+  data.tar.gz: 2e2ed3c15bd4f7fa8e3426dd577e115d75825bc3dbbed2e624515ac0cc5bcc06
 SHA512:
-  metadata.gz: f34ce9c2b7e5c8e7d251669c68a0722131ec975289060503558427017fa9d680040aa3814fc0fd1fc9679a7551949b62722e9f2b96fa2128a7d1ce525c93ff2d
-  data.tar.gz: a6282f0def79db8cf56a17c986ea4f7ff122e827f96c3ece8263b2e6368a92fd52c13f4b153985e3b520186ce8831dfbebb4e7daba6b17f295a29337d8736d9d
+  metadata.gz: bfa1a00bbafef9ec7ad8bc658ea47ffd834e24456686b039efc478a88cf4cf3064a39fea76b583b7f3e52183cf06133c1ee1911a919e9aa23dab09e002664ad1
+  data.tar.gz: d409f6a964b1473b9dea05b3193e9ea5429dccd51c6c9944e8f9c51f819f148625e21d074204fc6fd1cc7cb46d1a157609dcffdff74103315729e680a91f3661

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-05-30
+
+### Added
+- `BitField#disjoint?(other)` predicate returning `true` when self and `other` share zero flags in common — pairs with `subset_of?` for permission-isolation checks
+- Card image to README per readme-template guide
+
 ## [0.7.0] - 2026-05-02
 
 ### Added

data/README.md

@@ -4,6 +4,8 @@
 [![Gem Version](https://badge.fury.io/rb/philiprehberger-bit_field.svg)](https://rubygems.org/gems/philiprehberger-bit_field)
 [![Last updated](https://img.shields.io/github/last-commit/philiprehberger/rb-bit-field)](https://github.com/philiprehberger/rb-bit-field/commits/main)
 
+![philiprehberger-bit_field](https://raw.githubusercontent.com/philiprehberger/rb-bit-field/main/package-card.webp)
+
 Named bit flags with symbolic access, set operations, and serialization
 
 ## Requirements
@@ -134,6 +136,20 @@ required.subset_of?(granted) # => true
 granted.subset_of?(required) # => false
 ```
 
+### Disjoint Check
+
+Test whether two bit fields share zero flags in common. The empty bit field is
+disjoint with every value (including itself).
+
+```ruby
+admin   = Permissions.new(:admin)
+viewer  = Permissions.new(:read)
+
+admin.disjoint?(viewer)   # => true  (no overlap)
+viewer.disjoint?(viewer)  # => false (read overlaps with itself)
+Permissions.new.disjoint?(admin) # => true (empty vs anything)
+```
+
 ### Strict Mode
 
 ```ruby
@@ -209,6 +225,7 @@ Permissions.from_i(0b101).to_binary_string # => "101"
 | `#added_flags(other)` | Return flags set in self but not in other |
 | `#removed_flags(other)` | Return flags set in other but not in self |
 | `#subset_of?(other)` | True if every flag set in self is also set in other |
+| `#disjoint?(other)` | True when self and other share no flags in common |
 | `#to_i` | Return the integer representation |
 | `#to_binary_string(width: nil)` | Return the field as a `"0"`/`"1"` string, MSB-first |
 | `#to_a` | Return an array of set flag names |

data/lib/philiprehberger/bit_field/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module BitField
-    VERSION = '0.7.0'
+    VERSION = '0.8.0'
   end
 end

data/lib/philiprehberger/bit_field.rb

@@ -422,6 +422,20 @@ module Philiprehberger
         other.to_i.allbits?(to_i)
       end
 
+      # Check whether self and `other` share no flags in common.
+      #
+      # Returns true when the bitwise AND of the two underlying values is zero.
+      # The empty bit field is disjoint with every bit field, including itself.
+      #
+      # @param other [Base] another instance of the same BitField subclass
+      # @return [Boolean]
+      # @raise [Error] when `other` is not the same BitField subclass
+      def disjoint?(other)
+        raise Error, 'cannot compare different bit field types' unless other.is_a?(self.class)
+
+        @value.nobits?(other.to_i)
+      end
+
       alias eql? ==
 
       private

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-bit_field
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-03 00:00:00.000000000 Z
+date: 2026-05-31 00:00:00.000000000 Z
 dependencies: []
 description: Named bit flags with a DSL for defining flags at bit positions, symbolic
   read/set/clear/toggle, flag groups, bulk operations, bitwise OR/AND/XOR, JSON/hash