kinetic_sdk 0.1.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 1e8eb050d18a73811319295d6d60794a3683ae95
-  data.tar.gz: 51ce513d4a3e2d38fe12d356e3d70f528db8dac4
+SHA256:
+  metadata.gz: 2d9d1454174a1ad6358bfa3c1dd12d52cd24eef89c5a1464bca51c7a96829152
+  data.tar.gz: 4b0ef0d1c31e02566d8f00cc6aee0b796046e90284a5fef271280f4f9b587230
 SHA512:
-  metadata.gz: febab2779f3d476d60b287770512635813bf7b8f9a45ffbf1f9c2d24ece8c2526ebf79218f4341c20d4e966579f9003d9097774751e2ab35d9b0eafaadeb7336
-  data.tar.gz: 9b368596ac22f72c2a175ce7fe36033cc46918ab371f76c49a230c7d4fd582e3aa72516e5f6be7c313cc5823bbcf340b40e604ca7dbd1215fb3468bad7b049f2
+  metadata.gz: a4a0b0aef4fd8f4be9897d083b93c4370cfaeb82c6e8c39d7a98af40ecbe60b883fc5ac9699f8b4eba0d8df18306663445079a6073d8f2fe4d1243a1b9b93744
+  data.tar.gz: 8f4fa17ba3124ed7d2d6386670d4bf695f07a3babd4284d831436067baba2b90811e86ef5b294b5d9991eaf509d3d326bc28ec699e122697ced2547521fe4f9d

data/.yardoc-includes/yard-helpers.rb

@@ -0,0 +1,14 @@
+require 'yard'
+
+# Template helper to modify processing of links in HTML generated from our
+# markdown files.
+module LocalLinkHelper
+  # Rewrites links to (assumed local) markdown files so they're processed as
+  # {file: } directives.
+  def resolve_links(text)
+    text = text.gsub(%r{<a href="([^"]*.md)">([^<]*)</a>}, '{file:\1 \2}')
+    super text
+  end
+end
+
+YARD::Templates::Template.extra_includes << LocalLinkHelper

data/.yardopts

@@ -0,0 +1,7 @@
+--title Kinetic SDK
+--charset utf-8
+--markup markdown
+--output-dir doc
+--readme README.md
+--load .yardoc-includes/yard-helpers.rb
+'lib/**/*.rb' - '*.md'

data/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Change Log
+
+## [1.0.0](https://github.com/kineticdata/kinetic-sdk-rb/tree/1.0.0) (2019-06-13)
+
+** 0.x to 1.x Upgrade Warning **
+
+Export methods have been updated to reflect the folder structure
+of their respective API routes.
+
+For Example: in the 0.x versions of the SDK, the `export_trees` method would
+place the exported trees inside export_directory/trees. Starting in version 1.0.0, trees are exported to export_directory/sources/:source-name/trees
+
+The logger was changed from the `KineticSdk::Utils::Logger` module to the `KineticSdk::Utils::KLogger` class. This shouldn't have any effect on external scripts unless referencing the kinetic logger directly, which is unlikely. If that is the case however, you will need to update your scripts to reference the `logger` SDK variable instead of the static `KineticSDK::Utils::Logger` module.
+
+```ruby
+# 0.x example of logging in a script:
+sdk = KineticSdk::Core.new({
+  app_server_url: "http://localhost:8080/kinetic",
+  space_slug: "foo",
+  username: "space-user-1",
+  password: "password"
+})
+KineticSdk::Utils::Logger.info("foo")
+
+
+# 1.0 example of logging in a script
+sdk = KineticSdk::Core.new({
+  app_server_url: "http://localhost:8080/kinetic",
+  space_slug: "foo",
+  username: "space-user-1",
+  password: "password"
+})
+sdk.logger.info("foo")
+```
+
+**Implemented enhancements:**
+
+- Ability to export a space in one step using the `export_space` method.
+- Gateway errors (HTTP codes [502](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502), [503](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/503), and [504](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/504)) will automatically be retried, and may be controlled by the following options:
+  - :gateway_retry_limit (default 5), set to -1 to disable retrying gateway errors
+  - :gateway_retry_delay (default 1.0)

data/GettingStarted.md

@@ -18,32 +18,27 @@ If you do not have git and don't want to install it, you can download a zip file
 
 Prepare your Ruby program/script to use the Kinetic SDK.
 
-```bash
+```sh
 # create the project directory
-
 mkdir my_project
 
 # clone the kinetic-sdk-rb repository from GitHub
 # see above to download the zip file if you don't have the git client
-
 git clone https://github.com/kineticdata/kinetic-sdk-rb.git my_project/vendor/kinetic-sdk-rb
 
 # copy the sample driver to your project's root directory
-
 cp my_project/vendor/kinetic-sdk-rb/samples/driver/driver.rb my_project/driver.rb
 ```
 
 ### Try the driver
 
-Modify the sample driver program with your Kinetic Request CE (or other Kinetic Application) information, and try it out.
+Modify the sample driver program with your Kinetic Core (or other Kinetic Application) information, and try it out.
 
-```bash
+```sh
 # make sure to change back to the project root directory
-
 cd my_project
 
 # run the driver file
-
 ruby driver.rb
 ```
 
@@ -51,14 +46,13 @@ ruby driver.rb
 
 If you would like to generate the inline documentation for this SDK, perform the following steps.
 
-```bash
+```sh
 # install the bundler gem, and then then necessary documentation gems
 cd my_project/vendor/kinetic-sdk-rb
 gem install bundler
 bundle install
 
 # generate and open the inline Ruby documentation for the SDK
-
-bundle exec rake doc
-open rdoc/index.html
+bundle exec rake rdoc
+open doc/index.html
 ```

data/README.md

@@ -10,11 +10,12 @@ The Kinetic Ruby SDK is a library that consists of and SDK for each supported Ki
 
 The following Kinetic Data applications are supported in this SDK library:
 
-* Kinetic Request CE 1.0.4+
-* Kinetic Task 4.0+
+* Kinetic Core 1.0.4+
+* Kinetic Agent 1.0.0+
 * Kinetic Bridgehub 1.0+
-* Kinetic Filehub 1.0+
 * Kinetic Discussions 1.0+
+* Kinetic Filehub 1.0+
+* Kinetic Task 4.0+
 
 ## Getting Started
 
@@ -28,7 +29,7 @@ The following are a list of requirements to use this SDK:
 
 The Kinetic Ruby SDK requires Ruby 2.2+, which includes JRuby 9.0+. You can determine the version of Ruby you are using with the following command:
 
-```bash
+```sh
 ruby -v
 ```
 
@@ -44,17 +45,21 @@ All of the HTTP methods return a {KineticSdk::Utils::KineticHttpResponse} object
 
 If you are using Bundler, add this line to your application's Gemfile:
 
-```ruby
+```sh
 gem 'kinetic_sdk'
 ```
 
 And then execute:
 
-    $ bundle
+```sh
+bundle
+```
 
 Or install it yourself as:
 
-    $ gem install kinetic_sdk
+```sh
+gem install kinetic_sdk
+```
 
 Then in your application, include the SDK with the following code:
 
@@ -70,6 +75,27 @@ the SDK with the following code.
 require File.join(File.expand_path(File.dirname(__FILE__)), 'vendor', 'kinetic-sdk-rb', 'kinetic-sdk')
 ```
 
+### Kinetic Agent SDK example
+
+```ruby
+agent_sdk = KineticSdk::Agent.new({
+  app_server_url: "http://localhost:8080/kinetic-agent",
+  username: "configuration-user",
+  password: "password",
+  options: {
+    log_level: "info",
+    max_redirects: 3
+  }
+})
+response = agent_sdk.find_all_bridges()
+bridges = response.content['bridges']
+
+puts response.code            # String value of HTTP response code ("200", "400", "500", etc...)
+puts response.status          # Ruby Fixnum value of response.code (200, 400, 500, etc...)
+puts response.content         # Ruby Hash
+puts response.content_string  # JSON formatted response body
+```
+
 ### Kinetic BridgeHub SDK example
 
 ```ruby
@@ -112,10 +138,10 @@ puts response.content         # Ruby Hash
 puts response.content_string  # JSON formatted response body
 ```
 
-### Kinetic Request CE SDK example of a Space User
+### Kinetic Core SDK example of a Space User
 
 ```ruby
-space_sdk = KineticSdk::RequestCe.new({
+space_sdk = KineticSdk::Core.new({
   app_server_url: "http://localhost:8080/kinetic",
   space_slug: "foo",
   username: "space-user-1",
@@ -134,10 +160,10 @@ puts response.content         # Ruby Hash
 puts response.content_string  # JSON formatted response body
 ```
 
-### Kinetic Request CE SDK example of a System User
+### Kinetic Core SDK example of a System User
 
 ```ruby
-system_sdk = KineticSdk::RequestCe.new({
+system_sdk = KineticSdk::Core.new({
   app_server_url: "http://localhost:8080/kinetic",
   username: "configuration-user",
   password: "password",
@@ -154,12 +180,12 @@ puts response.content         # Ruby Hash
 puts response.content_string  # JSON formatted response body
 ```
 
-### Kinetic Request CE SDK example of a Subdomain
+### Kinetic Core SDK example of a Subdomain
 
-This example requires a proxy server configured to rewrite the space slug subdomain to the expected Request CE API route.
+This example requires a proxy server configured to rewrite the space slug subdomain to the expected Core API route.
 
 ```ruby
-space_sdk = KineticSdk::RequestCe.new({
+space_sdk = KineticSdk::Core.new({
   space_server_url: "https://foo.myapp.io",
   space_slug: "foo",
   username: "space-user-1",
@@ -262,19 +288,19 @@ Beginning with version 0.0.2, there are now two additional options that can be p
 
 May be used with all application SDKs.
 
-**Example 1 using Kinetic Request CE without server certificate validation:**
+**Example 1 using Kinetic Core without server certificate validation:**
 
 ```ruby
-space_sdk = KineticSdk::RequestCe.new({
+space_sdk = KineticSdk::Core.new({
   ...
   options: {}
 })
 ```
 
-**Example 2 using Kinetic Request CE without server certificate validation:**
+**Example 2 using Kinetic Core without server certificate validation:**
 
 ```ruby
-space_sdk = KineticSdk::RequestCe.new({
+space_sdk = KineticSdk::Core.new({
   ...
   options: {
     ssl_verify_mode: "none"
@@ -282,10 +308,10 @@ space_sdk = KineticSdk::RequestCe.new({
 })
 ```
 
-**Example using Kinetic Request CE with server certificate validation and known CAs:**
+**Example using Kinetic Core with server certificate validation and known CAs:**
 
 ```ruby
-space_sdk = KineticSdk::RequestCe.new({
+space_sdk = KineticSdk::Core.new({
   ...
   options: {
     ssl_verify_mode: "peer"
@@ -293,10 +319,10 @@ space_sdk = KineticSdk::RequestCe.new({
 })
 ```
 
-**Example using Kinetic Request CE with server certificate validation and a self-signing CA:**
+**Example using Kinetic Core with server certificate validation and a self-signing CA:**
 
 ```ruby
-space_sdk = KineticSdk::RequestCe.new({
+space_sdk = KineticSdk::Core.new({
   ...
   options: {
     ssl_verify_mode: "peer",
@@ -309,14 +335,32 @@ space_sdk = KineticSdk::RequestCe.new({
 
 If you need to make a custom HTTP call for some reason, there is a class that allows you to do that. Simply make sure the KineticSdk is required in your program. See the [Getting Started Guide](GettingStarted.md) for details.
 
-Then you need to instantiate a new instance of the {KineticSdk::Utils::KineticHttp} class, and call the desired HTTP method with the appropriate information. Each response will be returned as a {KineticSdk::Utils::KineticHttpResponse} object.
+Then you need to instantiate a new instance of the {KineticSdk::CustomHttp} class, and call the desired HTTP method with the appropriate information. Each response will be returned as a {KineticSdk::Utils::KineticHttpResponse} object.
 
 ```ruby
-# instantiate the KineticHttp class without authentication
-http = KineticSdk::Utils::KineticHttp.new
+# instantiate the CustomHttp class without authentication
+http = KineticSdk::CustomHttp.new
 
-# instantiate the KineticHttp class with Basic authentication
-http = KineticSdk::Utils::KineticHttp.new("john.doe@company.com", "s3cretP@ssw0rd")
+# instantiate the CustomHttp class with Basic authentication
+http = KineticSdk::CustomHttp.new({
+  username: "john.doe@company.com",
+  password: "s3cretP@ssw0rd"
+})
+
+# instantiate the CustomHttp class with Basic authentication, and custom options
+http = KineticSdk::CustomHttp.new({
+  username: "john.doe@company.com",
+  password: "s3cretP@ssw0rd",
+  options: {
+    log_level: "debug",
+    log_output: "stderr",
+    max_redirects: 3,
+    gateway_retry_delay: 1.0,
+    gateway_retry_limit: 5,
+    ssl_verify_mode: "peer",
+    ssl_ca_file: "/path/to/self-signing-ca.pem"
+  }
+})
 
 # call the appropriate method
 
@@ -356,28 +400,32 @@ response = http.put(
 
 ## Additional Documentation
 
-The RDoc documentation for the SDK can be generated by running a rake command. This will provide detailed information for each module, class, and method. The output can be found in the generated `rdoc` directory.
+The RDoc documentation for the SDK can be generated by running a rake command. This will provide detailed information for each module, class, and method. The output can be found in the generated `doc` directory.
 
 In order to do this however, the `yard` gem is required and must first be installed.
 
-This SDK includes a [Gemfile](./Gemfile) that can be used with the `bundler` gem to ensure the proper version is installed.
+This SDK includes a Gemfile that can be used with the `bundler` gem to ensure the proper version is installed.
 
 Install the Bundler gem:
 
-    gem install bundler
+```sh
+gem install bundler
+```
 
 _IMPORTANT NOTE_: If using [rbenv](https://github.com/rbenv/rbenv) to manage Ruby versions, run the following command.
 
-    rbenv rehash
+```sh
+rbenv rehash
+```
 
 Finally, install the dependency gems:
 
-    bundle install
+```sh
+bundle install
+```
 
-Now that the required documentation generation gem is installed, a simple Rake command can be run to generate the inline documentation. For this SDK, the following commands are all equivalent:
+Now that the required documentation generation gem is installed, a simple Rake command can be run to generate the inline documentation.
 
-```ruby
-bundle exec rake
-bundle exec rake doc
-bundle exec rake yard
+```sh
+bundle exec rake rdoc
 ```

data/Rakefile

@@ -0,0 +1,13 @@
+require "bundler/gem_tasks"
+require 'yard'
+
+desc "Generate Documentation"
+YARD::Rake::YardocTask.new do |t|
+  # see .yardopts
+  t.stats_options = %w( --list-undoc )
+end
+
+# Generate Yard documentation
+task :doc => [:yard]
+task :rdoc => [:yard]
+task :default => [:doc]

data/kinetic_sdk.gemspec

@@ -0,0 +1,33 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "kinetic_sdk/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "kinetic_sdk"
+  spec.version       = KineticSdk::VERSION
+  spec.authors       = ["Kinetic Data"]
+  spec.email         = ["support@kineticdata.com"]
+
+  spec.summary       = %q{Ruby SDK for Kinetic Data application APIs}
+  spec.homepage      = "https://github.com/kineticdata/kinetic-sdk-rb"
+
+  spec.files         = Dir.glob("{bin,lib,gems,.yardoc-includes}/**/*") + %w(kinetic_sdk.gemspec .yardopts CHANGELOG.md GettingStarted.md README.md Rakefile)
+  spec.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+
+  spec.add_dependency "slugify", "1.0.7"
+  spec.add_dependency "multipart-post", "2.0.0"
+  spec.add_dependency "mime-types", "3.1"
+  spec.add_dependency "parallel", "1.12.1"
+  spec.add_dependency "ruby-progressbar", "1.9.0"
+
+  spec.add_development_dependency "kontena-websocket-client", "0.1.1"
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 12.3.0"
+  spec.add_development_dependency "yard", "~> 0.9.20"
+
+  spec.metadata["yard.run"] = "yri"
+end

data/lib/kinetic_sdk/agent/agent-sdk.rb

@@ -0,0 +1,90 @@
+Dir[File.join(File.dirname(File.expand_path(__FILE__)), "lib", "**", "*.rb")].each {|file| require file }
+
+module KineticSdk
+
+  # Agent is a Ruby class that acts as a wrapper for the Kinetic Agent System 
+  # REST API without having to make explicit HTTP requests. This is not to be
+  # confused with the Kinetic Agent Space REST API, which must go through the
+  # Kinetic Core Proxy API.
+  #
+  class Agent
+
+    # Include the KineticHttpUtils module
+    include KineticSdk::Utils::KineticHttpUtils
+
+    attr_reader :api_url, :username, :options, :password, :server, :version, :logger
+
+    # Initalize the Agent SDK with the web server URL and configuration user
+    # credentials, along with any custom option values.
+    #
+    # @param opts [Hash] Kinetic Agent properties
+    # @option opts [String] :config_file optional - path to the YAML configuration file
+    #
+    #   * Ex: /opt/config/agent-configuration1.yaml
+    #
+    # @option opts [String] :app_server_url the URL to the Kinetic Agent web application.
+    #
+    #   * Ex: <http://192.168.0.1:8080/kinetic-agent>
+    #
+    # @option opts [String] :username the username for the user
+    # @option opts [String] :password the password for the user
+    # @option opts [Hash<Symbol, Object>] :options ({}) optional settings
+    #
+    #   * :gateway_retry_limit (FixNum) (_defaults to: 5_) max number of times to retry a bad gateway
+    #   * :gateway_retry_delay (Float) (_defaults to: 1.0_) number of seconds to delay before retrying a bad gateway
+    #   * :log_level (String) (_defaults to: off_) level of logging - off | error | warn | info | debug
+    #   * :log_output (String) (_defaults to: STDOUT_) where to send output - STDOUT | STDERR
+    #   * :max_redirects (Fixnum) (_defaults to: 5_) maximum number of redirects to follow
+    #   * :ssl_ca_file (String) full path to PEM certificate used to verify the server
+    #   * :ssl_verify_mode (String) (_defaults to: none_) - none | peer
+    #
+    # Example: using a configuration file
+    #
+    #     KineticSdk::Agent.new({
+    #       config_file: "/opt/config1.yaml"
+    #     })
+    #
+    # Example: using a properties hash
+    #
+    #     KineticSdk::Agent.new({
+    #       app_server_url: "http://localhost:8080/kinetic-agent",
+    #       username: "admin",
+    #       password: "admin",
+    #       options: {
+    #         log_level: "debug",
+    #         ssl_verify_mode: "peer",
+    #         ssl_ca_file: "/usr/local/self_signing_ca.pem"
+    #       }
+    #     })
+    #
+    # If the +config_file+ option is present, it will be loaded first, and any additional
+    # options will overwrite any values in the config file
+    #
+    def initialize(opts)
+      # initialize any variables
+      options = {}
+
+      # process the configuration file if it was provided
+      unless opts[:config_file].nil?
+        options.merge!(YAML::load_file opts[:config_file])
+      end
+
+      # process the configuration hash if it was provided
+      options.merge!(opts)
+
+      # process any individual options
+      @options = options.delete(:options) || {}
+      # setup logging
+      log_level = @options[:log_level] || @options["log_level"]
+      log_output = @options[:log_output] || @options["log_output"]
+      @logger = KineticSdk::Utils::KLogger.new(log_level, log_output)
+
+      @username = options[:username]
+      @password = options[:password]
+      @server = options[:app_server_url].chomp('/')
+      @api_url = "#{@server}/app/api/v1"
+      @version = 1
+    end
+
+  end
+end

data/lib/kinetic_sdk/agent/lib/bridges.rb

@@ -0,0 +1,92 @@
+module KineticSdk
+  class Agent
+
+    # Add Bridge
+    #
+    # @param space [String] slug of the space
+    # @param body [Hash] properties associated to the Bridge
+    #   - +adapterClass+
+    #   - +name+
+    #   - +slug+
+    #   - +properties+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_bridge(space, body, headers=default_headers)
+      @logger.info("Adding the \"#{body['name']}\" bridge in the \"#{space}\" space.")
+      post("#{@api_url}/spaces/#{space}/bridges", body, headers)
+    end
+
+    # Delete a Bridge
+    #
+    # @param space [String] slug of the space
+    # @param slug [String] slug of the Bridge
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def delete_bridge(space, slug, headers=default_headers)
+      @logger.info("Deleting the \"#{slug}\" bridge in the \"#{space}\" space.")
+      delete("#{@api_url}/spaces/#{space}/bridges/#{slug}", headers)
+    end
+
+    # Find a bridge
+    #
+    # @param space [String] slug of the space
+    # @param slug [String] slug of the bridge
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_bridge(space, slug, params={}, headers=default_headers)
+      @logger.info("Finding the \"#{slug}\" bridge in the \"#{space}\" space.")
+      get("#{@api_url}/spaces/#{space}/bridges/#{slug}", params, headers)
+    end
+
+    # Update a bridge
+    #
+    # @param space [String] slug of the space
+    # @param slug [String] slug of the bridge
+    # @param body [Hash] properties of the bridge to update
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def update_bridge(space, slug, body={}, headers=default_headers)
+      @logger.info("Updating the \"#{slug}\" bridge in the \"#{space}\" space.")
+      put("#{@api_url}/spaces/#{space}/bridges/#{slug}", body, headers)
+    end
+
+    # Find all bridges in a space
+    #
+    # @param space [String] slug of the space
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_bridges(space, params={}, headers=default_headers)
+      @logger.info("Find all bridges in the \"#{space}\" space.")
+      get("#{@api_url}/spaces/#{space}/bridges", params, headers)
+    end
+
+    # Add Bridge to Space
+    #
+    # @param space [String] slug of the space
+    # @param body [Hash] properties associated to the Bridge
+    #   - +space+
+    #   - +adapterClass+
+    #   - +name+
+    #   - +slug+
+    #   - +properties+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_space_bridge(body, headers=default_headers)
+      @logger.info("Adding the \"#{body['name']}\" bridge in the \"#{body['space']}\" space.")
+      post("#{@api_url}/bridges", body, headers)
+    end
+
+    # Find all bridges in the system
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_all_bridges(params={}, headers=default_headers)
+      @logger.info("Find all bridges.")
+      get("#{@api_url}/bridges", params, headers)
+    end
+
+  end
+end