ruby-spacy 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6185c586feb32fa51efcd4349398cd4ca9541280a5cc8a1b6a73eb93a987d4ac
-  data.tar.gz: a146a9c40e2d5293e2401cb16b8ac6866cbb577e11a10d9657c406f933e7a3aa
+  metadata.gz: 9bf4e97474302a2fffe019227e5afbb26c815036d13ec75bae6349f7186dff31
+  data.tar.gz: 2cd4012d9545d0a5ad9d2ebb03d07e40ae54acdfb18f0c9132c8848cce5cfd8e
 SHA512:
-  metadata.gz: bf558d4e9a7a6765fd7d088bbf8324a6ee0e4f4186962551d71e5a991e0aefd1e51a186f19c2824fabcc6afd0c83960771f082237febece52c2a522ccb39a5cf
-  data.tar.gz: 3a64559cf8c169d1ac1ecdef526d26e5776989b9cc203a8ed30e0dd5d87ff62a4d1b741aff30c8cb49e5ffb716c6068f9af3a12d50d0d4de8ad6f22ebe80ea0d
+  metadata.gz: 208f43e0efa0334ec159fb56e836f315bd5469a3768e77e0f6b7fa3ec936e722546e0323cc7bf5790393cc2fc52318e172355b821b6f3c83268de3cbf35ba139
+  data.tar.gz: 753515dcb7fb3e44ea2c4419e83baf9e0e8f9c6810a4f65cbfc3a631414b33019b5a0b4915c9a87edd8ac34fb8aac48673954c092c50e2e1cc152713bde48466

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Change Log
 
+## 0.4.1 - 2026-07-19
+### Fixed
+- Gem packaging: normalize file permissions at build time so packaged files
+  are world-readable (0644 / 0755). Version 0.4.0 shipped 11 owner-only
+  (0600) files, which made the gem unusable after `sudo gem install`
+
+## 0.4.0 - 2026-02-23
+### Added
+- `Language#with_openai` block API with `OpenAIHelper` for streamlined OpenAI integration
+- `Doc#linguistic_summary` for JSON-formatted spaCy analysis output
+- `Token#idx`, `Span#text`/`Span#to_s`, `Language#memory_zone` (spaCy 3.8+)
+
+### Fixed
+- `Doc#ents` returns proper `Span` objects instead of raw Python objects
+
+### Changed
+- Model name validation in `Language#initialize` for security
+- OpenAI client: temperature support for o-series models, 429 retry with
+  exponential backoff, client reuse, `dimensions`/`response_format` parameters,
+  tool call depth limit
+- Improved `respond_to_missing?` across all wrapper classes
+- Added `instance_variables_to_inspect` for Ruby 4.0+ compatibility
+- Added `base64` gem dependency (required for Ruby 3.4+)
+
 ## 0.3.0 - 2025-01-06
 ### Added
 - Ruby 4.0 support

data/README.md

@@ -13,11 +13,12 @@
 | ✅ | Access to pre-trained word vectors                 |
 | ✅ | OpenAI Chat/Completion/Embeddings API integration  |
 
-Current Version: `0.3.0`
+Current Version: `0.4.0`
 
 - Ruby 4.0 supported
 - spaCy 3.8 supported
 - OpenAI GPT-5 API integration
+- Block-based OpenAI API with linguistic analysis
 
 ## Installation of Prerequisites
 
@@ -843,6 +844,65 @@ Output:
 ...
 ```
 
+### Block-based OpenAI API
+
+The `Language#with_openai` block API provides a streamlined way to combine spaCy's linguistic analysis with OpenAI. The `Doc#linguistic_summary` method generates a JSON summary of spaCy's analysis (tokens, entities, noun chunks, etc.) that can be passed directly to the LLM as context.
+
+**Basic usage:**
+
+```ruby
+require "ruby-spacy"
+
+nlp = Spacy::Language.new("en_core_web_sm")
+doc = nlp.read("Apple Inc. was founded by Steve Jobs in California.")
+
+nlp.with_openai(model: "gpt-5-mini") do |ai|
+  result = ai.chat(
+    system: "You are a linguistic analyst. Analyze the given linguistic data.",
+    user: doc.linguistic_summary
+  )
+  puts result
+end
+```
+
+**Batch processing with `pipe`:**
+
+```ruby
+require "ruby-spacy"
+
+nlp = Spacy::Language.new("en_core_web_sm")
+texts = ["The bank approved the loan.", "I sat on the river bank."]
+
+nlp.with_openai(model: "gpt-5-mini") do |ai|
+  nlp.pipe(texts).each do |doc|
+    result = ai.chat(
+      system: "Identify the meaning of 'bank' in one word based on the linguistic context.",
+      user: doc.linguistic_summary
+    )
+    puts "#{doc.text} => #{result}"
+  end
+end
+```
+
+**Customizing linguistic summary:**
+
+```ruby
+# Include sentences and morphology, exclude noun chunks
+summary = doc.linguistic_summary(
+  sections: [:text, :tokens, :entities, :sentences],
+  token_attributes: [:text, :lemma, :pos, :dep, :head, :morphology]
+)
+```
+
+**Embeddings:**
+
+```ruby
+nlp.with_openai do |ai|
+  vector = ai.embeddings("Hello world")
+  puts vector.length  # => 1536
+end
+```
+
 ## Advanced Usage
 
 ### Setting a Timeout

data/Rakefile

@@ -10,3 +10,16 @@ Rake::TestTask.new(:test) do |t|
 end
 
 task default: :test
+
+# Gem packaging preserves on-disk file modes; owner-only permissions here
+# produce gems whose files are unreadable after a sudo install. Executable
+# status is determined by path alone because local (Dropbox-synced) modes
+# are unreliable.
+task :normalize_permissions do
+  `git ls-files -z`.split("\x0").each do |f|
+    executable = f.start_with?("bin/", "exe/")
+    File.chmod(executable ? 0o755 : 0o644, f)
+  end
+end
+
+Rake::Task["build"].enhance([:normalize_permissions])

data/lib/ruby-spacy/version.rb

@@ -2,5 +2,5 @@
 
 module Spacy
   # The version number of the module
-  VERSION = "0.4.0"
+  VERSION = "0.4.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-spacy
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Yoichiro Hasebe