philiprehberger-assert 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e39e8f2c580c51b62aee03496bca3941ac2efe839618a379e5a50721e2e2e0f1
-  data.tar.gz: 1dd5e255316ff40587c86a795a098ca8d40aba63c3e8ba8505458b9a9455e3b2
+  metadata.gz: 806a389a510c91f4c13f8b09ed2b4defbeea816d0d6d9d5f3a1a452add6f12de
+  data.tar.gz: 915ce84054018103c7c27618f54d99e0e9ecd3f257056a6e60653f54433b55d7
 SHA512:
-  metadata.gz: 25bdfe4360a3d1619e7c0aeb7f7235c47b8cdac18c047ed14c6bbb5baad2b36ad546444f8e7a8b2c0eab814f2d6e3a101fbbec5472c4ed78dcdbb12f1f0456d9
-  data.tar.gz: 02f70ca6912c4ac85b05d19ed44dcb4c53eb9e89c15752933c46fc2197884df3a74f3089c9ee714a596b30e8db7eeb77d23e35dd60008d1a020bb3b199cb7f9a
+  metadata.gz: d54316256352d71f704fe3988caf7f228661a1e86977f4acf3e9486bd2c9b57daf2c9bc70e9a23a927d4e7b206f6e814c16dbbb4798d71a103963c8fed229299
+  data.tar.gz: 6ee3a9ba4b4a5b78d2d39f72acf310cc2019391521978fd958d6006c76afa234db0efc203387bec98dc6574913daf92f4445db333a34cc570df8913574cf2fe0

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-04-29
+
+### Added
+- `Assert.postcondition(condition, message)` for Design by Contract postcondition checks, complementing the existing `precondition`
+
+## [0.4.0] - 2026-04-15
+
+### Added
+- `starts_with(prefix)` matcher for string prefix assertions
+- `ends_with(suffix)` matcher for string suffix assertions
+
 ## [0.3.0] - 2026-04-04
 
 ### Added

data/README.md

@@ -45,6 +45,13 @@ Philiprehberger::Assert.that(config).includes_key(:host)
 Philiprehberger::Assert.that(items).not_empty
 ```
 
+### String Prefix and Suffix
+
+```ruby
+Assert.that('hello world').starts_with('hello')
+Assert.that('hello world').ends_with('world')
+```
+
 ### Range and Membership
 
 ```ruby
@@ -85,19 +92,33 @@ end
 Philiprehberger::Assert.precondition(user.active?, 'user must be active')
 ```
 
+### Postconditions (Design by Contract)
+
+```ruby
+def withdraw(amount)
+  Philiprehberger::Assert.precondition(amount.positive?, 'amount must be positive')
+  result = perform_withdrawal(amount)
+  Philiprehberger::Assert.postcondition(result.balance >= 0, 'balance must not go negative')
+  result
+end
+```
+
 ## API
 
 | Method | Description |
 |--------|-------------|
 | `Assert.that(value, message = nil)` | Start a chainable assertion |
 | `Assert.soft { \|a\| ... }` | Collect failures, raise at end |
-| `Assert.precondition(condition, message)` | Design by Contract check |
+| `Assert.precondition(condition, message)` | Design by Contract precondition check |
+| `Assert.postcondition(condition, message)` | Design by Contract postcondition check |
 | `Assertion#is_a(type)` | Assert value is an instance of type |
 | `Assertion#gte(num)` | Assert value >= num |
 | `Assertion#lte(num)` | Assert value <= num |
 | `Assertion#gt(num)` | Assert value > num |
 | `Assertion#lt(num)` | Assert value < num |
 | `Assertion#matches(pattern)` | Assert value matches regex pattern |
+| `Assertion#starts_with(prefix)` | Assert string value starts with prefix |
+| `Assertion#ends_with(suffix)` | Assert string value ends with suffix |
 | `Assertion#not_blank` | Assert value is not nil or blank |
 | `Assertion#not_empty` | Assert value is not empty |
 | `Assertion#includes_key(key)` | Assert hash includes key |

data/lib/philiprehberger/assert/assertion.rb

@@ -34,6 +34,14 @@ module Philiprehberger
         check(pattern.match?(@value.to_s), "Expected #{@value.inspect} to match #{pattern.inspect}")
       end
 
+      def starts_with(prefix)
+        check(@value.start_with?(prefix), "expected to start with #{prefix.inspect}")
+      end
+
+      def ends_with(suffix)
+        check(@value.end_with?(suffix), "expected to end with #{suffix.inspect}")
+      end
+
       def not_blank
         check(!@value.nil? && !@value.to_s.strip.empty?, 'Expected value to not be blank')
       end

data/lib/philiprehberger/assert/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module Assert
-    VERSION = '0.3.0'
+    VERSION = '0.5.0'
   end
 end

data/lib/philiprehberger/assert.rb

@@ -33,5 +33,14 @@ module Philiprehberger
     def self.precondition(condition, message)
       raise AssertionError, message unless condition
     end
+
+    # Design by Contract postcondition check.
+    #
+    # @param condition [Boolean] the condition to verify
+    # @param message [String] failure message
+    # @raise [AssertionError] if condition is false
+    def self.postcondition(condition, message)
+      raise AssertionError, message unless condition
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-assert
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-05 00:00:00.000000000 Z
+date: 2026-04-29 00:00:00.000000000 Z
 dependencies: []
 description: A lightweight runtime assertion library for Ruby with chainable matchers,
   soft assertions, and Design by Contract preconditions.