act_as_api_client 1.0.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2879b607f0a39fdba8f0b5c92097320aacafd5e98a23e8082f051e9b95340765
-  data.tar.gz: c694503be26586f6c184f64b1df4084d261c1dae82aede31951fe7aa023d2c10
+  metadata.gz: 54f1e0502d9d834fafe3dcd401882b7948d7240d49784d8601bb6312d3982518
+  data.tar.gz: d6099660de91fe0317dd9e55db6343a0e599c299f889ca129ed94e57efe7162d
 SHA512:
-  metadata.gz: 8d94a6752470991a895526ed0a371e34c44a5db3cc7c1f6d9a81a3e38c4d1ba7a3b39ab0a2406277aa407037744b60f2bbe0408197eaf6cccd625b9f80ef767d
-  data.tar.gz: fc1abaa4b3ae8541dd3a67de89d0a74035ebc8d909aab2d1d48f1d2d34b609bd8406aa28a5a864eff3402aa5a922abcfecf6169b022c9408d6eebc8620d9b65d
+  metadata.gz: 6feb43b2e5f850c53770ea912187e514efa9c2986ad9a117ee7e260a8a4813e28c9c2a0054531ececc35821247d60f1670cd1f8e7b8db877e25a75cc697af930
+  data.tar.gz: b99cb6cee4fff9e10f86d367564283cbd19565ced49aee598a943c8e4a9aa706fd09fe3d06d57a5d1865944f0a630cd4e0d6aa916239592cdb614fe453b5310d

data/.github/workflows/main.yml

@@ -23,7 +23,7 @@ jobs:
       matrix:
         ruby-version: ["3.0"]
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Ruby
         uses: ruby/setup-ruby@2b019609e2b0f1ea1a2bc8ca11cb82ab46ada124
         with:
@@ -36,9 +36,9 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest]
-        ruby-version: ["2.6", "2.7", "3.0", "3.1", "3.2"]
+        ruby-version: ["2.6", "2.7", "3.0", "3.1", "3.2", "3.3"]
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:

data/.github/workflows/update_docs.yml

@@ -0,0 +1,51 @@
+name: Deploy Jekyll with GitHub Pages dependencies preinstalled
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches:
+      - main
+
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./docs
+          destination: ./_site
+          baseurl: act_as_api_client
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

data/.gitignore

@@ -12,6 +12,9 @@
 
 .idea
 .byebug_history
-spec/credentials.yml
 
-*.gem
+*.gem
+
+.DS_Store
+
+vendor

data/.rubocop.yml

@@ -20,3 +20,8 @@ AllCops:
 
 Style/Documentation:
   Enabled: false
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - 'act_as_api_client.gemspec'

data/.rubocop_todo.yml

@@ -12,17 +12,6 @@ Metrics/AbcSize:
   Exclude:
     - "lib/act_as_api_client/clients/github_repositories_client.rb"
 
-# Offense count: 5
-# Configuration parameters: CountComments, Max, CountAsOne, ExcludedMethods.
-# ExcludedMethods: refine
-Metrics/BlockLength:
-  Exclude:
-    - "**/*.gemspec"
-    - "spec/act_as_api_client/clients/authorize_net/authorize_net_notifications_client_spec.rb"
-    - "spec/act_as_api_client/clients/github_client/find_by_spec.rb"
-    - "spec/act_as_api_client/clients/github_client/find_spec.rb"
-    - "spec/act_as_api_client/clients/github_client/where_spec.rb"
-
 # Offense count: 1
 # Configuration parameters: IgnoredMethods, Max.
 Metrics/CyclomaticComplexity:
@@ -63,12 +52,6 @@ RSpec/NestedGroups:
   Exclude:
     - "spec/act_as_api_client/clients/github_client/find_by_spec.rb"
 
-# Offense count: 1
-# Configuration parameters: MinBodyLength.
-Style/GuardClause:
-  Exclude:
-    - "lib/act_as_api_client/clients/authorize_net_webhooks_client.rb"
-
 # Offense count: 4
 # Cop supports --auto-correct.
 # Configuration parameters: AutoCorrect, Max, AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.

data/Gemfile.lock

@@ -1,7 +1,8 @@
 PATH
   remote: .
   specs:
-    act_as_api_client (1.0.0)
+    act_as_api_client (1.3.0)
+      event_stream_parser
 
 GEM
   remote: https://rubygems.org/
@@ -13,6 +14,7 @@ GEM
     crack (0.4.5)
       rexml
     diff-lcs (1.5.0)
+    event_stream_parser (1.0.0)
     hashdiff (1.0.1)
     parallel (1.22.1)
     parser (3.1.2.0)
@@ -69,6 +71,3 @@ DEPENDENCIES
   rubocop-rspec
   vcr (~> 6.1)
   webmock (~> 3.14)
-
-BUNDLED WITH
-   1.17.2

data/act_as_api_client.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name          = "act_as_api_client"
-  spec.version       = "1.0.0"
+  spec.version       = "1.3.1"
   spec.authors       = ["Max Rukomoynikov"]
   spec.email         = ["rukomoynikov@gmail.com"]
 
@@ -15,7 +15,7 @@ Gem::Specification.new do |spec|
   spec.metadata = {
     "source_code_uri" => "https://github.com/Rukomoynikov/act_as_api_client",
     "homepage_uri" => spec.homepage,
-    "documentation_uri" => "https://rubydoc.info/github/Rukomoynikov/act_as_api_client/main",
+    "documentation_uri" => "https://rukomoynikov.github.io/act_as_api_client/",
     "bug_tracker_uri" => "https://github.com/Rukomoynikov/act_as_api_client/issues"
   }
 
@@ -26,6 +26,8 @@ Gem::Specification.new do |spec|
   end
   spec.require_paths = ["lib"]
 
+  spec.add_dependency "event_stream_parser"
+
   # Uncomment to register a new dependency of your gem
   spec.add_development_dependency "byebug", "~> 11.1"
   spec.add_development_dependency "rake", "~> 13.0"

data/docs/.gitignore

@@ -0,0 +1,5 @@
+_site
+.sass-cache
+.jekyll-cache
+.jekyll-metadata
+vendor

data/docs/404.html

@@ -0,0 +1,25 @@
+---
+permalink: /404.html
+layout: default
+---
+
+<style type="text/css" media="screen">
+  .container {
+    margin: 10px auto;
+    max-width: 600px;
+    text-align: center;
+  }
+  h1 {
+    margin: 30px 0;
+    font-size: 4em;
+    line-height: 1;
+    letter-spacing: -1px;
+  }
+</style>
+
+<div class="container">
+  <h1>404</h1>
+
+  <p><strong>Page not found :(</strong></p>
+  <p>The requested page could not be found.</p>
+</div>

data/docs/Gemfile

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+# Hello! This is where you manage which Jekyll version is used to run.
+# When you want to use a different version, change it below, save the
+# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
+#
+#     bundle exec jekyll serve
+#
+# This will help ensure the proper Jekyll version is running.
+# Happy Jekylling!
+gem "jekyll", "~> 4.3.4"
+# This is the default theme for new Jekyll sites. You may change this to anything you like.
+gem "minima", "~> 2.5"
+# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
+# uncomment the line below. To upgrade, run `bundle update github-pages`.
+# gem "github-pages", group: :jekyll_plugins
+# If you have any plugins, put them here!
+group :jekyll_plugins do
+  gem "jekyll-feed", "~> 0.12"
+end
+
+# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
+# and associated library.
+platforms :mingw, :x64_mingw, :mswin, :jruby do
+  gem "tzinfo", ">= 1", "< 3"
+  gem "tzinfo-data"
+end
+
+# Performance-booster for watching directories on Windows
+gem "wdm", "~> 0.1", platforms: %i[mingw x64_mingw mswin]
+
+# Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem
+# do not have a Java counterpart.
+gem "http_parser.rb", "~> 0.6.0", platforms: [:jruby]

data/docs/Gemfile.lock

@@ -0,0 +1,181 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
+    bigdecimal (3.1.8)
+    colorator (1.1.0)
+    concurrent-ruby (1.3.4)
+    em-websocket (0.5.3)
+      eventmachine (>= 0.12.9)
+      http_parser.rb (~> 0)
+    eventmachine (1.2.7)
+    ffi (1.17.0)
+    ffi (1.17.0-aarch64-linux-gnu)
+    ffi (1.17.0-aarch64-linux-musl)
+    ffi (1.17.0-arm-linux-gnu)
+    ffi (1.17.0-arm-linux-musl)
+    ffi (1.17.0-arm64-darwin)
+    ffi (1.17.0-x86-linux-gnu)
+    ffi (1.17.0-x86-linux-musl)
+    ffi (1.17.0-x86_64-darwin)
+    ffi (1.17.0-x86_64-linux-gnu)
+    ffi (1.17.0-x86_64-linux-musl)
+    forwardable-extended (2.6.0)
+    google-protobuf (4.28.3)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.28.3-aarch64-linux)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.28.3-arm64-darwin)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.28.3-x86-linux)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.28.3-x86_64-darwin)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.28.3-x86_64-linux)
+      bigdecimal
+      rake (>= 13)
+    http_parser.rb (0.8.0)
+    i18n (1.14.6)
+      concurrent-ruby (~> 1.0)
+    jekyll (4.3.4)
+      addressable (~> 2.4)
+      colorator (~> 1.0)
+      em-websocket (~> 0.5)
+      i18n (~> 1.0)
+      jekyll-sass-converter (>= 2.0, < 4.0)
+      jekyll-watch (~> 2.0)
+      kramdown (~> 2.3, >= 2.3.1)
+      kramdown-parser-gfm (~> 1.0)
+      liquid (~> 4.0)
+      mercenary (>= 0.3.6, < 0.5)
+      pathutil (~> 0.9)
+      rouge (>= 3.0, < 5.0)
+      safe_yaml (~> 1.0)
+      terminal-table (>= 1.8, < 4.0)
+      webrick (~> 1.7)
+    jekyll-feed (0.17.0)
+      jekyll (>= 3.7, < 5.0)
+    jekyll-sass-converter (3.0.0)
+      sass-embedded (~> 1.54)
+    jekyll-seo-tag (2.8.0)
+      jekyll (>= 3.8, < 5.0)
+    jekyll-watch (2.2.1)
+      listen (~> 3.0)
+    kramdown (2.5.1)
+      rexml (>= 3.3.9)
+    kramdown-parser-gfm (1.1.0)
+      kramdown (~> 2.0)
+    liquid (4.0.4)
+    listen (3.9.0)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    mercenary (0.4.0)
+    minima (2.5.2)
+      jekyll (>= 3.5, < 5.0)
+      jekyll-feed (~> 0.9)
+      jekyll-seo-tag (~> 2.1)
+    pathutil (0.16.2)
+      forwardable-extended (~> 2.6)
+    public_suffix (6.0.1)
+    rake (13.2.1)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.11.1)
+      ffi (~> 1.0)
+    rexml (3.3.9)
+    rouge (4.5.1)
+    safe_yaml (1.0.5)
+    sass-embedded (1.81.0)
+      google-protobuf (~> 4.28)
+      rake (>= 13)
+    sass-embedded (1.81.0-aarch64-linux-android)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-aarch64-linux-gnu)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-aarch64-linux-musl)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-aarch64-mingw-ucrt)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-arm-linux-androideabi)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-arm-linux-gnueabihf)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-arm-linux-musleabihf)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-arm64-darwin)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-riscv64-linux-android)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-riscv64-linux-gnu)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-riscv64-linux-musl)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-x86-cygwin)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-x86-linux-android)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-x86-linux-gnu)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-x86-linux-musl)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-x86-mingw-ucrt)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-x86_64-cygwin)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-x86_64-darwin)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-x86_64-linux-android)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-x86_64-linux-gnu)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.81.0-x86_64-linux-musl)
+      google-protobuf (~> 4.28)
+    terminal-table (3.0.2)
+      unicode-display_width (>= 1.1.1, < 3)
+    unicode-display_width (2.6.0)
+    webrick (1.9.0)
+
+PLATFORMS
+  aarch64-linux-android
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  aarch64-mingw-ucrt
+  arm-linux-androideabi
+  arm-linux-gnu
+  arm-linux-gnueabihf
+  arm-linux-musl
+  arm-linux-musleabihf
+  arm64-darwin
+  riscv64-linux-android
+  riscv64-linux-gnu
+  riscv64-linux-musl
+  ruby
+  x86-cygwin
+  x86-linux
+  x86-linux-android
+  x86-linux-gnu
+  x86-linux-musl
+  x86-mingw-ucrt
+  x86_64-cygwin
+  x86_64-darwin
+  x86_64-linux
+  x86_64-linux-android
+  x86_64-linux-gnu
+  x86_64-linux-musl
+
+DEPENDENCIES
+  http_parser.rb (~> 0.6.0)
+  jekyll (~> 4.3.4)
+  jekyll-feed (~> 0.12)
+  minima (~> 2.5)
+  tzinfo (>= 1, < 3)
+  tzinfo-data
+  wdm (~> 0.1)
+
+BUNDLED WITH
+   2.5.11

data/docs/_config.yml

@@ -0,0 +1,50 @@
+# Welcome to Jekyll!
+#
+# This config file is meant for settings that affect your whole blog, values
+# which you are expected to set up once and rarely edit after that. If you find
+# yourself editing this file very often, consider using Jekyll's data files
+# feature for the data you need to update frequently.
+#
+# For technical reasons, this file is *NOT* reloaded automatically when you use
+# 'bundle exec jekyll serve'. If you change this file, please restart the server process.
+#
+# If you need help with YAML syntax, here are some quick references for you:
+# https://learn-the-web.algonquindesign.ca/topics/markdown-yaml-cheat-sheet/#yaml
+# https://learnxinyminutes.com/docs/yaml/
+#
+# Site settings
+# These are used to personalize your new site. If you look in the HTML files,
+# you will see them accessed via {{ site.title }}, {{ site.email }}, and so on.
+# You can create any custom variable you would like, and they will be accessible
+# in the templates via {{ site.myvariable }}.
+
+title: Act as API client
+description: >- # this means to ignore newlines until "baseurl:"
+  Simple gem to cover all your API needs.
+baseurl: "/act_as_api_client"
+url: "https://rukomoynikov.github.io"
+# twitter_username: rukomoynikov
+# github_username: rukomoynikov
+
+# Build settings
+theme: minima
+# plugins:
+# Exclude from processing.
+# The following items will not be processed, by default.
+# Any item listed under the `exclude:` key here will be automatically added to
+# the internal "default list".
+#
+# Excluded items can be processed by explicitly listing the directories or
+# their entries' file path in the `include:` list.
+#
+# exclude:
+#   - .sass-cache/
+#   - .jekyll-cache/
+#   - gemfiles/
+#   - Gemfile
+#   - Gemfile.lock
+#   - node_modules/
+#   - vendor/bundle/
+#   - vendor/cache/
+#   - vendor/gems/
+#   - vendor/ruby/

data/docs/_config_development.yml

@@ -0,0 +1 @@
+baseurl: ""

data/docs/clients/anthropic.markdown

@@ -0,0 +1,92 @@
+---
+layout: home
+image: "./assets/thumbnail.jpg"
+---
+
+The Messages API lets you send messages with text or images, and receive a response from the AI model. You can use it in two main ways:
+
+**Simple sync request:**
+{% highlight ruby %}
+require "act_as_api_client"
+
+class AnthropicClient < ApiClient
+  act_as_api_client for: %i[anthropic messages],
+                    with: { x_api_key: ENV["ANTHROPIC_API_KEY"] }
+end
+
+anthropic_client = AnthropicClient.new
+
+pp anthropic_client.create(
+  model: "claude-3-5-sonnet-20241022",
+  messages: [
+    { "role": "user", "content": "Hello there." },
+    { "role": "assistant", "content": "Hi, I'm Claude. How can I help you?" },
+    { "role": "user", "content": "Can you explain LLMs in plain English?" }
+  ],
+  max_tokens: 1024
+)
+{% endhighlight %}
+
+**Async (stream) request:**
+{% highlight ruby %}
+anthropic_client.create(
+  model: "claude-3-5-sonnet-20241022",
+  messages: [
+    { "role": "user", "content": "Hello there." },
+    { "role": "assistant", "content": "Hi, I'm Claude. How can I help you?" },
+    { "role": "user", "content": "Can you explain LLMs in plain English?" }
+  ],
+  max_tokens: 1024,
+  stream: true
+) do |event, data|
+  p event
+  p data
+end
+{% endhighlight %}
+
+**Response:**
+{% highlight ruby %}
+{"id"=>"msg_017gdUbYuH8Y51y5TngCNbnN",
+ "type"=>"message",
+ "role"=>"assistant",
+ "model"=>"claude-3-5-sonnet-20241022",
+ "content"=>
+  [{"type"=>"text",
+    "text"=>
+     "Sure! Let me explain Large Language Models (LLMs) in simple terms:\n" +
+     "\n" +
+     "LLMs are computer programs that have been trained on massive amounts of text from the internet, books, and other sources. Think of them like incredibly well-read students who have absorbed information from millions of documents.\n" +
+     "\n" +
+     "These models learn patterns in language - how words fit together, how sentences are structured, and how ideas connect. They can then use these patterns to:\n" +
+     "- Generate human-like text\n" +
+     "- Answer questions\n" +
+     "- Summarize information \n" +
+     "- Translate languages\n" +
+     "- Help with writing\n" +
+     "- And much more\n" +
+     "\n" +
+     "I'm an LLM myself. When you write something to me, I look at the patterns I learned during training to understand what you're saying and formulate relevant responses. However, I don't actually \"understand\" things the way humans do - I work by recognizing and generating patterns in text.\n" +
+     "\n" +
+     "The \"Large\" in LLM refers to both the massive amount of training data used and the number of parameters (connection points) in the model - often billions or trillions.\n" +
+     "\n" +
+     "Think of it like a very sophisticated autocomplete system, but one that can maintain context and generate much longer, more coherent responses.\n" +
+     "\n" +
+     "Would you like me to elaborate on any part of this explanation?"}],
+ "stop_reason"=>"end_turn",
+ "stop_sequence"=>nil,
+ "usage"=>{"input_tokens"=>38, "output_tokens"=>272}}
+{% endhighlight %}
+
+**Supported options:**
+- `model (string)` - [LLM model](https://docs.anthropic.com/en/docs/about-claude/models) to process your request
+- `messages (list)` - list of messages (see example above)
+- `max_tokens (number)` - the maximum number of tokens to generate before stopping
+- `metadata (hash)` - an object describing metadata about the request
+- `stop_sequences (list)` - custom text sequences that will cause the model to stop generating
+- `stream (boolean)` - whether to incrementally stream the response using server-sent events
+- `system (string)` - system prompt
+- `temperature (float)` - system prompt
+- `tool_choice (hash)` - how the model should use the provided tools
+- `tools (list)` - definitions of tools that the model may use
+- `top_k (number)` - only sample from the top K options for each subsequent token
+- `top_p (float)` - use nucleus sampling

data/docs/docker-compose.yml

@@ -0,0 +1,13 @@
+services:
+  app:
+    build:
+      dockerfile_inline: |
+        FROM ruby:bullseye
+        COPY Gemfile Gemfile.lock .
+        RUN bundle install
+    working_dir: /app
+    volumes:
+      - ./:/app
+    ports:
+      - 4000:4000
+    command: bundle exec jekyll serve -H 0.0.0.0 --watch --config _config.yml,_config_development.yml

data/docs/index.markdown

@@ -0,0 +1,39 @@
+---
+layout: home
+image: "./assets/thumbnail.jpg"
+---
+
+![Act as api logo](/assets/thumbnail.jpg)
+
+## Supported clients:
+
+- [Anthropic](clients/anthropic)
+
+## Example of usage:
+
+Any API client can be used with or withour Rails. All what you need to do is
+inherit from ApiClient and choose service through `act_as_api_client for:`. Also
+some clients may require some settings token etc.
+
+**Add to Gemfile:**
+{% highlight ruby %}
+gem 'act_as_api_client'
+{% endhighlight %}
+
+**Request service:**
+{% highlight ruby %}
+require "act_as_api_client"
+
+class AnthropicClient < ApiClient
+  act_as_api_client for: %i[anthropic messages],
+                    with: { x_api_key: ENV["ANTHROPIC_API_KEY"] }
+end
+
+anthropic_client = AnthropicClient.new
+
+anthropic_client.create(
+  model: "claude-3-5-sonnet-20241022",
+  messages: [{ "role": "user", "content": "Hello there." }],
+  max_tokens: 1024
+)
+{% endhighlight %}

data/examples/anthropic_playground.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# Run it with `ruby anthropic_playground.rb`
+# See Anthropic development API documentation on https://docs.anthropic.com/en/api/messages
+
+require "bundler/inline"
+
+gemfile(true) do
+  source "https://rubygems.org"
+
+  gem "act_as_api_client", path: "../"
+end
+
+require "act_as_api_client"
+
+class AnthropicClient < ApiClient
+  act_as_api_client for: %i[anthropic messages],
+                    with: { x_api_key: ENV["ANTHROPIC_API_KEY"] }
+end
+
+anthropic_client = AnthropicClient.new
+
+pp anthropic_client.create(
+  model: "claude-3-5-sonnet-20241022",
+  messages: [
+    { "role": "user", "content": "Hello there." },
+    { "role": "assistant", "content": "Hi, I'm Claude. How can I help you?" },
+    { "role": "user", "content": "Can you explain LLMs in plain English?" }
+  ],
+  max_tokens: 1024
+)