llm.rb 0.1.0

data/spec/readme_spec.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "setup"
+require "test/cmd"
+
+RSpec.describe "The README examples" do
+  before { ENV["key"] = key }
+  after { ENV["key"] = nil }
+  let(:key) { "" }
+
+  context "when given the lazy conversation example" do
+    subject(:command) do
+      cmd RbConfig.ruby,
+        "-Ilib",
+        "-r", webmock("lazy_conversation.rb"),
+        readme_example("lazy_conversation.rb")
+    end
+
+    let(:actual_conversation) do
+      command.stdout.each_line.map(&:strip)
+    end
+
+    let(:expected_conversation) do
+      [
+        "[system] You are a friendly chatbot. Sometimes, you like to tell a joke.",
+        "But the joke must be based on the given inputs.",
+        "I will provide you a set of messages. Reply to all of them.",
+        "A message is considered unanswered if there is no corresponding assistant response.",
+
+        "[user] What color is the sky?",
+        "[user] What color is an orange?",
+        "[user] I like Ruby",
+
+        "[assistant] The sky is typically blue during the day, but it can have beautiful",
+        "hues of pink, orange, and purple during sunset! As for an orange,",
+        "it's typically orange in color - funny how that works, right?",
+        "I love Ruby too! Did you know that a Ruby is not only a beautiful",
+        "gemstone, but it's also a programming language that's both elegant",
+        "and powerful! Speaking of colors, why did the orange stop?",
+        "Because it ran out of juice!"
+      ].map(&:strip)
+    end
+
+    it "is successful" do
+      is_expected.to be_success
+    end
+
+    it "emits output" do
+      expect(join(actual_conversation)).to eq(join(expected_conversation))
+    end
+  end
+
+  def webmock(example)
+    File.join(Dir.getwd, "share", "llm", "webmocks", example)
+  end
+
+  def readme_example(example)
+    File.join(Dir.getwd, "share", "llm", "examples", example)
+  end
+
+  def join(lines)
+    lines.reject(&:empty?).join("\n")
+  end
+end

data/spec/setup.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "llm"
+require "webmock/rspec"
+
+RSpec.configure do |config|
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+
+  config.include Module.new {
+    def request_fixture(file)
+      path = File.join(fixtures, "requests", file)
+      File.read(path).chomp
+    end
+
+    def response_fixture(file)
+      path = File.join(fixtures, "responses", file)
+      File.read(path).chomp
+    end
+    alias_method :fixture, :response_fixture
+
+    def fixtures
+      File.join(__dir__, "fixtures")
+    end
+  }
+end

metadata

@@ -0,0 +1,194 @@
+--- !ruby/object:Gem::Specification
+name: llm.rb
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Antar Azri
+- '0x1eef'
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-03-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: net-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.24.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.24.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.37
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.37
+- !ruby/object:Gem::Dependency
+  name: kramdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: test-cmd.rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+description: llm.rb is a lightweight Ruby library that provides a common interface
+  and set of functionality for multple Large Language Models (LLMs). It is designed
+  to be simple, flexible, and easy to use.
+email:
+- azantar@proton.me
+- 0x1eef@proton.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/llm.rb
+- lib/llm/conversation.rb
+- lib/llm/core_ext/ostruct.rb
+- lib/llm/error.rb
+- lib/llm/file.rb
+- lib/llm/http_client.rb
+- lib/llm/lazy_conversation.rb
+- lib/llm/message.rb
+- lib/llm/message_queue.rb
+- lib/llm/provider.rb
+- lib/llm/providers/anthropic.rb
+- lib/llm/providers/anthropic/error_handler.rb
+- lib/llm/providers/anthropic/format.rb
+- lib/llm/providers/anthropic/response_parser.rb
+- lib/llm/providers/gemini.rb
+- lib/llm/providers/gemini/error_handler.rb
+- lib/llm/providers/gemini/format.rb
+- lib/llm/providers/gemini/response_parser.rb
+- lib/llm/providers/ollama.rb
+- lib/llm/providers/ollama/error_handler.rb
+- lib/llm/providers/ollama/format.rb
+- lib/llm/providers/ollama/response_parser.rb
+- lib/llm/providers/openai.rb
+- lib/llm/providers/openai/error_handler.rb
+- lib/llm/providers/openai/format.rb
+- lib/llm/providers/openai/response_parser.rb
+- lib/llm/response.rb
+- lib/llm/response/completion.rb
+- lib/llm/response/embedding.rb
+- lib/llm/version.rb
+- llm.gemspec
+- spec/anthropic/completion_spec.rb
+- spec/gemini/completion_spec.rb
+- spec/gemini/embedding_spec.rb
+- spec/llm/conversation_spec.rb
+- spec/llm/lazy_conversation_spec.rb
+- spec/ollama/completion_spec.rb
+- spec/ollama/embedding_spec.rb
+- spec/openai/completion_spec.rb
+- spec/openai/embedding_spec.rb
+- spec/readme_spec.rb
+- spec/setup.rb
+homepage: https://github.com/llmrb/llm
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/llmrb/llm
+  source_code_uri: https://github.com/llmrb/llm
+  changelog_uri: https://github.com/llmrb/llm/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.23
+signing_key:
+specification_version: 4
+summary: llm.rb is a lightweight Ruby library that provides a common interface and
+  set of functionality for multple Large Language Models (LLMs). It is designed to
+  be simple, flexible, and easy to use.
+test_files: []