elevenlabs-ruby 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1ac9c2ee9225938c2f79819099697b8b56cd660396d3f61e4fdd731f10362d3
-  data.tar.gz: 3857319b7947d80d2d8abc275d8b05ae9725b26d4670910b9464e2a080d10ac1
+  metadata.gz: f09441bd076023311ab4c534b879e7d15863cf3f3d8592aff670912142e9f990
+  data.tar.gz: d11560b31848bfbd4ecfd95204ef611d8bedcb984c075a5f05791027b933a93f
 SHA512:
-  metadata.gz: a11e27bb12a99872a6eac9a805827f888ba74dffba9ca100257ec603b6ff5d841daeac6569e0e7d7534d076c3c228d71bf18d0d134e0574bc55e16409e84b61e
-  data.tar.gz: ed4ca2da916b9c80971f9d0327acaffab7763c629dedefdaf762028f36527e1c1da8a706a331bee6aab0b82c683a7785ded301b2dbbd9648605e0bb47bbf7b3f
+  metadata.gz: 2db2ab4a2d79872f997f96ec6ba130e4304d41879302ba39b22364fa021ecb8264ca89081817432f36eaccf98376abc87c8f0472c6bc366ef5281715010f39dc
+  data.tar.gz: ebd6cf20635c4c3bd0b1eb4f7292c2ead619589136984eb4990fe0e83b41bb12db364219cdbaabf861ddd60c1c72bc7db050d0d24ca1696cd96fa0ec0141be70

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in replicate-ruby.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+
+gem "minitest", "~> 5.0"
+
+gem "rubocop", "~> 1.21"

data/Gemfile.lock

@@ -0,0 +1,77 @@
+PATH
+  remote: .
+  specs:
+    elevenlabs-ruby (0.2.0)
+      addressable
+      faraday (>= 2.0)
+      faraday-multipart
+      faraday-retry
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.4)
+      public_suffix (>= 2.0.2, < 6.0)
+    ast (2.4.2)
+    byebug (11.1.3)
+    coderay (1.1.3)
+    crack (0.4.5)
+      rexml
+    faraday (2.7.4)
+      faraday-net_http (>= 2.0, < 3.1)
+      ruby2_keywords (>= 0.0.4)
+    faraday-multipart (1.0.4)
+      multipart-post (~> 2)
+    faraday-net_http (3.0.2)
+    faraday-retry (2.1.0)
+      faraday (~> 2.0)
+    hashdiff (1.0.1)
+    json (2.6.3)
+    method_source (1.0.0)
+    minitest (5.18.0)
+    multipart-post (2.3.0)
+    parallel (1.23.0)
+    parser (3.2.2.1)
+      ast (~> 2.4.1)
+    pry (0.14.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    public_suffix (5.0.1)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.8.0)
+    rexml (3.2.5)
+    rubocop (1.51.0)
+      json (~> 2.3)
+      parallel (~> 1.10)
+      parser (>= 3.2.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.28.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.28.1)
+      parser (>= 3.2.1.0)
+    ruby-progressbar (1.13.0)
+    ruby2_keywords (0.0.5)
+    unicode-display_width (2.4.2)
+    webmock (3.18.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  arm64-darwin-22
+
+DEPENDENCIES
+  byebug
+  elevenlabs-ruby!
+  minitest (~> 5.0)
+  pry
+  rake (~> 13.0)
+  rubocop (~> 1.21)
+  webmock
+
+BUNDLED WITH
+   2.4.10

data/README.md

@@ -0,0 +1,34 @@
+# ElevenLabs Ruby client
+
+This is a Ruby client for the [ElevenLabs](https://elevenlabs.io/) API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'elevenlabs-ruby'
+```
+
+## Usage
+
+Grab your token from your ElevenLabs account and authenticate by configuring `api_token`:
+
+```ruby
+ElevenLabs.configure do |config|
+  config.api_key = "your_api_token"
+end
+```
+
+Checkout their [API docs](https://api.elevenlabs.io/docs) for available endpoints.
+
+```ruby
+client = ElevenLabs::Client.new(api_key: 'xxxxxxxxxx')
+voices = client.get('voices')
+voice_id = voices['voices'].first['voice_id']
+speech = client.post("text-to-speech/#{voice_id}", { text: 'your text' }) # returns a binary string
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/eleven_labs/client.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "eleven_labs/configurable"
+require "eleven_labs/connection"
+
+module ElevenLabs
+  class Client
+    include ElevenLabs::Configurable
+    include ElevenLabs::Connection
+
+    def initialize(options = {})
+      # Use options passed in, but fall back to module defaults
+      ElevenLabs::Configurable.keys.each do |key|
+        value = options.key?(key) ? options[key] : ElevenLabs.instance_variable_get(:"@#{key}")
+        instance_variable_set(:"@#{key}", value)
+      end
+    end
+  end
+end

data/lib/eleven_labs/configurable.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module ElevenLabs
+  module Configurable
+    attr_accessor :api_key
+    attr_writer :api_endpoint
+
+    class << self
+      # List of configurable keys for {Datatrans::Client}
+      # @return [Array] of option keys
+      def keys
+        @keys ||= %i[api_key api_endpoint]
+      end
+    end
+
+    # Set configuration options using a block
+    def configure
+      yield self
+    end
+
+    # API endpoint methods
+    def api_endpoint
+      @api_endpoint ||= "https://api.elevenlabs.io/v1"
+    end
+
+    private
+
+    def options
+      Hash[ElevenLabs::Configurable.keys.map { |key| [key, send(key)] }]
+    end
+  end
+end

data/lib/eleven_labs/connection.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "faraday/net_http"
+require "faraday/retry"
+require "addressable/uri"
+
+module ElevenLabs
+  # Network layer for API clients.
+  module Connection
+    DEFAULT_MEDIA_TYPE = "application/json"
+    USER_AGENT = "ElevenLabs Ruby Gem"
+
+    # Header keys that can be passed in options hash to {#get},{#head}
+    CONVENIENCE_HEADERS = Set.new(%i[accept content_type])
+
+    # Make a HTTP GET request
+    #
+    # @param url [String] The path, relative to {#api_endpoint}
+    # @param options [Hash] Query and header params for request
+    # @return [Sawyer::Resource]
+    def get(url, options = {})
+      request :get, url, options
+    end
+
+    # Make a HTTP POST request
+    #
+    # @param url [String] The path, relative to {#api_endpoint}
+    # @param options [Hash] Body and header params for request
+    # @return [Sawyer::Resource]
+    def post(url, options = {})
+      request :post, url, options.to_json
+    end
+
+    # Make a HTTP PUT request
+    #
+    # @param url [String] The path, relative to {#api_endpoint}
+    # @param options [Hash] Body and header params for request
+    # @return [Sawyer::Resource]
+    def put(url, options = {})
+      request :put, url, options.to_json
+    end
+
+    # Make a HTTP PATCH request
+    #
+    # @param url [String] The path, relative to {#api_endpoint}
+    # @param options [Hash] Body and header params for request
+    # @return [Sawyer::Resource]
+    def patch(url, options = {})
+      request :patch, url, options.to_json
+    end
+
+    # Make a HTTP DELETE request
+    #
+    # @param url [String] The path, relative to {#api_endpoint}
+    # @param options [Hash] Query and header params for request
+    # @return [Sawyer::Resource]
+    def delete(url, options = {})
+      request :delete, url, options
+    end
+
+    # Make a HTTP HEAD request
+    #
+    # @param url [String] The path, relative to {#api_endpoint}
+    # @param options [Hash] Query and header params for request
+    # @return [Sawyer::Resource]
+    def head(url, options = {})
+      request :head, url, options
+    end
+
+    # Hypermedia agent for the datatrans API
+    #
+    # @return [Sawyer::Agent]
+    def agent
+      @agent ||= Faraday.new(url: endpoint) do |conn|
+        conn.request :retry
+        conn.headers['XI-API-KEY'] = api_key
+        conn.headers["Content-Type"] = DEFAULT_MEDIA_TYPE
+        conn.headers["Accept"] = DEFAULT_MEDIA_TYPE
+
+        conn.adapter :net_http
+      end
+    end
+
+    # Response for last HTTP request
+    #
+    # @return [Sawyer::Response]
+    def last_response
+      @last_response if defined? @last_response
+    end
+
+    protected
+
+    def endpoint
+      api_endpoint
+    end
+
+    private
+
+    def request(method, path, data)
+      @last_response = agent.send(method, Addressable::URI.parse(path.to_s).normalize.to_s, data)
+      case @last_response.status
+      when 400
+        raise Error, "#{@last_response.status} #{@last_response.reason_phrase}: #{JSON.parse(@last_response.body)}"
+      else
+        begin
+          JSON.parse(@last_response.body)
+        rescue JSON::ParserError, TypeError => _e
+          @last_response.body
+        end
+      end
+    end
+  end
+end

data/lib/eleven_labs/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ElevenLabs
+  VERSION = "0.2.0"
+end

data/lib/eleven_labs.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "eleven_labs/client"
+
+module ElevenLabs
+  class Error < StandardError; end
+
+  class << self
+    include ElevenLabs::Configurable
+
+    def client
+      return @client if defined?(@client)
+      @client = ElevenLabs::Client.new(options)
+    end
+  end
+end

data/lib/elevenlabs/ruby.rb

@@ -0,0 +1 @@
+require_relative "../eleven_labs"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: elevenlabs-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Dreaming Tulpa
@@ -114,7 +114,16 @@ email:
 executables: []
 extensions: []
 extra_rdoc_files: []
-files: []
+files:
+- Gemfile
+- Gemfile.lock
+- README.md
+- lib/eleven_labs.rb
+- lib/eleven_labs/client.rb
+- lib/eleven_labs/configurable.rb
+- lib/eleven_labs/connection.rb
+- lib/eleven_labs/version.rb
+- lib/elevenlabs/ruby.rb
 homepage: https://github.com/dreamingtulpa/elevenlabs-ruby
 licenses: []
 metadata: