pray-cli 1.23.0 → 1.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9fa10db14b7b45fdd5152a06e02fdf4312ca40fa575529ecd7448722caea437c
-  data.tar.gz: f53a2e0ca8b6d8a5d97a8a45903953a9b20c900864a354b8ea494e986eb9d815
+  metadata.gz: ba8c54da1cf4639ba4a0016efde7e912bbf02cfe144c661d477fd90426851614
+  data.tar.gz: 3070148557ba6c79498db6d518d499fea8ea441faaa8f88d1b576dd4d7bc78e9
 SHA512:
-  metadata.gz: 21c44b12b0e8bf97d429491f4c32969a6700857c28b2b4b0981312dab4032279f7e52b4a4bd050984578469287554497e0ccff96a36ff6a3f99e69b97bbe1790
-  data.tar.gz: 11b795d9454a35f763cab755f82747c4470303912ef4269dd399d0b89266ad6833cf2246462b39113acfaccc494b904eba026d0e3813709a5e62735fcb74617e
+  metadata.gz: 9f92760d168fa68c8fbc6e587d679419fc0f3bcdd9176ce4c975bb80f61d00aee27d924b1fae84c8a5b09faba600b41d2ddd51a36abc889ab55a5f4662440b17
+  data.tar.gz: 5b9d61817650e3dd24b2d214eabf6b473cd84813544c656c48163bcbb83bda17c266f3cd28306e639b7cad3b10a6523df7b6a3436626baa379c849e98827b983

data/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+## 1.24.0 (2026-10-26)
+
+- Document `require "pray"` (library, no `Pray::CLI`) versus `require "pray-cli"` (library plus CLI).
+
 ## 1.23.0 (2026-10-26)
 
 - Leave package catalog JSON bytes alone when publish reports a version unchanged. A load and rewrite round trip no longer strips trailing newlines or reorders keys such as `artifact_hash` relative to `yanked`.

data/README.md

@@ -28,6 +28,19 @@ bundle install
 bundle exec pray version
 ```
 
+## Library vs CLI
+
+`require "pray"` loads the core library and does not define `Pray::CLI`.
+
+`require "pray-cli"` (or the `pray` executable) loads the library plus CLI dispatch.
+
+```ruby
+require "pray"
+
+manifest = Pray.parse_manifest(File.read("Prayfile"))
+project = Pray.resolve_project
+```
+
 ## Commands
 
 Core workflow:

data/lib/pray/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Pray
-  VERSION = "1.23.0"
-  GENERATED_BY = "pray 1.23.0"
+  VERSION = "1.24.0"
+  GENERATED_BY = "pray 1.24.0"
 end

data/lib/pray-cli.rb

@@ -1,4 +1,7 @@
 # frozen_string_literal: true
 
+# CLI entry. Loads the core library plus Pray::CLI.
+# Embed consumers that do not need the CLI should require "pray" instead.
+
 require_relative "pray"
 require_relative "pray/cli"

data/lib/pray.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+# Core library entry. Does not load Pray::CLI.
+# CLI consumers use require "pray-cli" or the pray executable.
+
 require_relative "pray/version"
 require_relative "pray/error"
 require_relative "pray/literal"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pray-cli
 version: !ruby/object:Gem::Version
-  version: 1.23.0
+  version: 1.24.0
 platform: ruby
 authors:
 - Andrei Makarov