mux_ruby 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 071d7be8b7ea6111c37e3252ddfde75ac1fb5023
+  data.tar.gz: 875bdcd5f51c8691cf37f8bfa614b05ad4712be6
+SHA512:
+  metadata.gz: 81204bff2d0b39af4df872ecbc45e3024bcc7ba48c74a8be90269e0ab51400336948c6bb80740ab2463ec52acdf448d9d008fde70fa95f3ef9665320328947c2
+  data.tar.gz: '00895ba9e6abcd30d6825efeea7b2b58785a8a5fd5714d6cfcf394eb99559964de51176e4218786d1aa893a550413b5da4c1e7b3a7f4aded3216cb32036f5c65'

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :development, :test do
+  gem 'rake', '~> 12.0.0'
+  gem 'pry-byebug'
+end

data/Gemfile.lock

@@ -0,0 +1,79 @@
+PATH
+  remote: .
+  specs:
+    mux_ruby (1.0.0)
+      json (~> 2.1, >= 2.1.0)
+      typhoeus (~> 1.0, >= 1.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ZenTest (4.11.1)
+    addressable (2.5.2)
+      public_suffix (>= 2.0.2, < 4.0)
+    autotest (4.4.6)
+      ZenTest (>= 4.4.1)
+    autotest-fsevent (0.2.14)
+      sys-uname
+    autotest-growl (0.2.16)
+    autotest-rails-pure (4.1.2)
+    byebug (10.0.2)
+    coderay (1.1.2)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.3)
+    ethon (0.11.0)
+      ffi (>= 1.3.0)
+    ffi (1.9.25)
+    hashdiff (0.3.7)
+    json (2.1.0)
+    method_source (0.9.0)
+    pry (0.11.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    pry-byebug (3.6.0)
+      byebug (~> 10.0)
+      pry (~> 0.10)
+    public_suffix (3.0.3)
+    rake (12.0.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+    safe_yaml (1.0.4)
+    sys-uname (1.0.3)
+      ffi (>= 1.0.0)
+    typhoeus (1.3.0)
+      ethon (>= 0.9.0)
+    vcr (3.0.3)
+    webmock (1.24.6)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  autotest (~> 4.4, >= 4.4.6)
+  autotest-fsevent (~> 0.2, >= 0.2.12)
+  autotest-growl (~> 0.2, >= 0.2.16)
+  autotest-rails-pure (~> 4.1, >= 4.1.2)
+  mux_ruby!
+  pry-byebug
+  rake (~> 12.0.0)
+  rspec (~> 3.6, >= 3.6.0)
+  vcr (~> 3.0, >= 3.0.1)
+  webmock (~> 1.24, >= 1.24.3)
+
+BUNDLED WITH
+   1.16.1

data/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2019 Mux, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,121 @@
+![Mux Ruby Banner](github-ruby-sdk.png)
+
+# Mux Ruby
+
+Official Mux API wrapper for ruby projects, supporting both Mux Data and Mux Video.
+
+[Mux Video](https://mux.com/video) is an API-first platform, powered by data and designed by video experts to make beautiful video possible for every development team.
+
+[Mux Data](https://mux.com/data) is a platform for monitoring your video streaming performance with just a few lines of code. Get in-depth quality of service analytics on web, mobile, and OTT devices.
+
+Not familiar with Mux? Check out https://mux.com/ for more information.
+
+## Requirements
+
+Ruby 1.9.
+
+Use `bundle install` to install dependencies if you're developing locally.
+
+## Installation
+
+### Adding to your Gemfile
+```
+gem 'mux_ruby', :git => 'git://github.com/muxinc/mux-ruby.git'
+```
+
+### Clone and install locally
+```
+git clone https://github.com/muxinc/mux-ruby.git && cd mux-ruby
+gem build mux_ruby.gemspec
+gem install mux_ruby.gem
+```
+
+## Getting Started
+
+### Overview
+
+Mux Ruby is a code generated lightweight wrapper around the Mux REST API and reflects them accurately. This has a few consequences you should watch out for:
+
+1) For almost all API responses, the object you're looking for will be in the `data` field on the API response object, as in the example below. This is because we designed our APIs with similar concepts to the [JSON:API](https://jsonapi.org/) standard. This means we'll be able to return more metadata from our API calls (such as related entities) without the need to make breaking changes to our APIs. We've decided not to hide that in this library.
+
+2) We don't use a lot of object orientation. For example API calls that happen on a single asset don't exist in the asset class, but are API calls in the AssetsApi which require an asset ID.
+
+### Authentication
+To use the Mux API, you'll need an access token and a secret. [Details on obtaining these can be found here in the Mux documentation.](https://docs.mux.com/docs#section-1-get-an-api-access-token)
+
+Its up to you to manage your token and secret. In our examples, we read them from `MUX_TOKEN_ID` and `MUX_TOKEN_SECRET` in your environment.
+
+### Example Usage
+Below is a quick example of using Mux Ruby to list the Video assets stored in your Mux account.
+
+Be sure to also checkout the [exmples directory](examples/):
+* [List Assets, Live Streams, Signing Keys, and Uploads.](examples/video/list-everything.rb)
+* [Create an Asset, wait for it to become availiable, and print its playback URL](examples/video/ingest.rb)
+* [Create a new Live Stream and retrieve its Stream key.](examples/video/create-live-stream.rb)
+
+There's also example usage of every API call (also used for testing):
+* [Video](examples/video/)
+  * [Assets](examples/video/exercise-assets.rb)
+  * [Live Streams](examples/video/exercise-live-streams.rb)
+  * [Signing Keys](examples/video/exercise-signing-keys.rb)
+  * [Uploads](examples/video/exercise-uploads.rb)
+* [Data](examples/data/)
+  * [Errors](examples/data/exercise-errors.rb)
+  * [Exports](examples/data/exercise-exports.rb)
+  * [Filters](examples/data/exercise-filters.rb)
+  * [Metrics](examples/data/exercise-metrics.rb)
+  * [Video Views](examples/data/exercise-video-views.rb)
+
+```ruby
+#!/usr/bin/env ruby
+
+require 'mux_ruby'
+
+# Auth Setup
+openapi = MuxRuby.configure do |config|
+  config.username = ENV['MUX_TOKEN_ID']
+  config.password = ENV['MUX_TOKEN_SECRET']
+end
+
+# API Client Init
+assets_api = MuxRuby::AssetsApi.new
+
+# List Assets
+puts "Listing Assets in account:\n\n"
+
+assets = assets_api.list_assets()
+assets.data.each do | asset |
+  puts "Asset ID: #{asset.id}"
+  puts "Status: #{asset.status}"
+  puts "Duration: #{asset.duration.to_s}\n\n"
+end
+```
+
+## Exceptions & Error Handling
+
+All errors inherit from `ApiError`, you can catch it or you can catch one of the more specific Errors below.
+
+### NotFoundError
+
+`NotFoundError` is thrown when a resource is not found. This is useful when trying to get an entity by its ID, for example `get_asset("some-id-here")` in the AssetsApi.
+
+### UnauthorizedError
+
+`UnauthorizedError` is thrown when Mux cannot authenticate your request. [You should check you have configured your credentials correctly.](#authentication)
+
+### ServiceError
+
+`ServiceError` is thrown when Mux returns a HTTP 5XX Status Code. If you encounter this reproducibly, please get in touch with [support@mux.com](mailto:support@mux.com).
+
+## Documentation
+
+[Be sure to check out the documentation in the `docs` directory.](docs/)
+
+## Issues
+If you run into problems, [please raise a GitHub issue,](https://github.com/muxinc/mux-ruby/issues) filling in the issue template. We'll take a look as soon as possible.
+
+## Contributing
+Please do not submit PRs against this package. It is generated from our OpenAPI definitions - [Please open an issue instead!](https://github.com/muxinc/mux-ruby/issues)
+
+## License
+[MIT License.](LICENSE) Copyright 2019 Mux, Inc.

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+
+begin
+  require 'rspec/core/rake_task'
+
+  RSpec::Core::RakeTask.new(:spec)
+  task default: :spec
+rescue LoadError
+  # no rspec available
+end

data/docs/AbridgedVideoView.md

@@ -0,0 +1,18 @@
+# MuxRuby::AbridgedVideoView
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **String** |  | [optional] 
+**viewer_os_family** | **String** |  | [optional] 
+**viewer_application_name** | **String** |  | [optional] 
+**video_title** | **String** |  | [optional] 
+**total_row_count** | **Integer** |  | [optional] 
+**player_error_message** | **String** |  | [optional] 
+**player_error_code** | **String** |  | [optional] 
+**error_type_id** | **Integer** |  | [optional] 
+**country_code** | **String** |  | [optional] 
+**view_start** | **String** |  | [optional] 
+**view_end** | **String** |  | [optional] 
+
+

data/docs/Asset.md

@@ -0,0 +1,27 @@
+# MuxRuby::Asset
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **String** |  | [optional] 
+**created_at** | **String** |  | [optional] 
+**deleted_at** | **String** |  | [optional] 
+**status** | **String** |  | [optional] 
+**duration** | **Float** |  | [optional] 
+**max_stored_resolution** | **String** |  | [optional] 
+**max_stored_frame_rate** | **Float** |  | [optional] 
+**aspect_ratio** | **String** |  | [optional] 
+**playback_ids** | [**Array<PlaybackID>**](PlaybackID.md) |  | [optional] 
+**tracks** | [**Array<Track>**](Track.md) |  | [optional] 
+**demo** | **BOOLEAN** |  | [optional] 
+**errors** | [**AssetErrors**](AssetErrors.md) |  | [optional] 
+**per_title_encode** | **BOOLEAN** |  | [optional] 
+**is_live** | **BOOLEAN** |  | [optional] 
+**passthrough** | **String** |  | [optional] 
+**live_stream_id** | **String** |  | [optional] 
+**master** | [**AssetMaster**](AssetMaster.md) |  | [optional] 
+**master_access** | **String** |  | [optional] [default to 'none']
+**mp4_support** | **String** |  | [optional] [default to 'none']
+**static_renditions** | [**AssetStaticRenditions**](AssetStaticRenditions.md) |  | [optional] 
+
+

data/docs/AssetErrors.md

@@ -0,0 +1,9 @@
+# MuxRuby::AssetErrors
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**type** | **String** |  | [optional] 
+**messages** | **Array<String>** |  | [optional] 
+
+

data/docs/AssetMaster.md

@@ -0,0 +1,9 @@
+# MuxRuby::AssetMaster
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**status** | **String** |  | [optional] 
+**url** | **String** |  | [optional] 
+
+

data/docs/AssetResponse.md

@@ -0,0 +1,8 @@
+# MuxRuby::AssetResponse
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**data** | [**Asset**](.md) |  | [optional] 
+
+

data/docs/AssetStaticRenditions.md

@@ -0,0 +1,9 @@
+# MuxRuby::AssetStaticRenditions
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**status** | **String** | * `ready`: All MP4s are downloadable * `preparing`: We are preparing the MP4s * `disabled`: MP4 support was not requested or has been removed * `errored`: There was a Mux internal error that prevented the MP4s from being created  | [optional] [default to 'disabled']
+**files** | [**Array<AssetStaticRenditionsFiles>**](AssetStaticRenditionsFiles.md) |  | [optional] 
+
+

data/docs/AssetStaticRenditionsFiles.md

@@ -0,0 +1,13 @@
+# MuxRuby::AssetStaticRenditionsFiles
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**name** | **String** |  | [optional] 
+**ext** | **String** | Extension of the static rendition file | [optional] 
+**height** | **Integer** | The height of the static rendition's file in pixels | [optional] 
+**width** | **Integer** | The width of the static rendition's file in pixels | [optional] 
+**bitrate** | **Integer** | The bitrate in bits per second | [optional] 
+**filesize** | **String** |  | [optional] 
+
+