Swiftner API Ruby Client

This is a Ruby client for interacting with the Swiftner API. It allows you to work with videos, transcriptions, errors, and perform various actions such as uploading, deleting, updating, and fetching information. This client make it easier to deal with HTTP requests by providing a Ruby-oriented interface with built-in error handling.

• Ruby version: 3.0.0 or later

Install the gem and add to the application's Gemfile by executing:

$ bundle add swiftner

If bundler is not being used to manage dependencies, install the gem by executing:

$ gem install swiftner

This section includes syntax examples of some of the key features of the Swiftner API Ruby client.

api_key = "swiftner_api_key"

Swiftner.configure do |config|
  config.client = Swiftner::Client.new(api_key)
end

@video_content_service = Swiftner::API::VideoContent

# Find video contents
video_contents = @video_content_service.find_video_contents

# Find specific video content by ID
video_content = @video_content_service.find(1)

# Update the title of a video content
video_content.update(title: "New title")

@upload_service = Swiftner::API::Upload

# Find uploads
uploads = @upload_service.find_uploads

# Create an upload
upload = @upload_service.create(sample_attributes)

# Delete an upload
upload.delete

# Transcribe an upload
upload.transcribe("no")

@linked_content_service = Swiftner::API::LinkedContent

# Find linked contents
linked_contents = @linked_content_service.find_linked_contents

# Find linked content
linked_content = @linked_content_service.find(1)

# Create an upload
linked_content = @linked_content_service.create(sample_attributes)

# Find linked content transcriptions
transcriptions = linked_content.transcriptions

# Batch create linked content
linked_contents = @linked_content_service.batch_create([sample_attributes, sample_attributes])

# Restart transcription process
linked_content.transcribe

# Delete linked content
linked_content.delete

The Swiftner API Ruby Client includes custom exceptions for handling API errors. These inherit from either the base Swiftner::Error class or the standard Ruby StandardError class.

begin
  # some code that might raise an exception
rescue Swiftner::Forbidden => e
  puts "Handle forbidden error here"
rescue Swiftner::Unauthorized => e
  puts "Handle unauthorized error here"
end

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.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/swiftner/swiftner_ruby. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

Everyone interacting in the Swiftner project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.