files.com 1.0.90

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ebf4d4605addae148b16bbe121b65c0e49c1d15c6ea46a2b1f056a0bfd3cd8d2
+  data.tar.gz: a8880dab867bbbc0ebb640cc39cf3aa2e7898efa9ac81fd39bcf30a060d898bf
+SHA512:
+  metadata.gz: f1bf9ea0d78910f4c41926f971113527b199392dfa2739ac1f389f87b5947023906b7a622e9e2961b503c3b95b833435806892d74bab5a023634badd850e6acb
+  data.tar.gz: e6b8a6b3b6e012c9b9d01f70d5835f39622dc3cf9656701f29c54c774af987a7f0605d540aa1c5f20115ecef1cfa65f7f47bbb8e59eb4e67c3d9a32219dee824

data/CONTRIBUTORS

@@ -0,0 +1,4 @@
+Kevin Bombino <kevin.bombino@files.com>
+Martyn Garcia <martyn.garcia@files.com>
+Dustin Zeisler <dustin.zeisler@files.com>
+Rommel Santor <rommel.santor@files.com>

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,82 @@
+PATH
+  remote: .
+  specs:
+    files.com (1.0)
+      addressable (>= 2.7.0)
+      concurrent-ruby (>= 1.1.3)
+      faraday (>= 1.0.1)
+      net-http-persistent
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.7.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    ast (2.4.1)
+    byebug (11.1.3)
+    coderay (1.1.2)
+    concurrent-ruby (1.1.6)
+    connection_pool (2.2.3)
+    diff-lcs (1.3)
+    faraday (1.0.1)
+      multipart-post (>= 1.2, < 3)
+    memory_profiler (0.9.14)
+    method_source (1.0.0)
+    multipart-post (2.1.1)
+    net-http-persistent (4.0.0)
+      connection_pool (~> 2.2)
+    parallel (1.19.2)
+    parser (2.7.1.4)
+      ast (~> 2.4.1)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry-byebug (3.9.0)
+      byebug (~> 11.0)
+      pry (~> 0.13.0)
+    public_suffix (4.0.5)
+    rainbow (3.0.0)
+    rake (12.0.0)
+    regexp_parser (1.7.1)
+    rexml (3.2.4)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.1)
+      rspec-support (~> 3.9.1)
+    rspec-expectations (3.9.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.3)
+    rubocop (0.85.1)
+      parallel (~> 1.10)
+      parser (>= 2.7.0.1)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.7)
+      rexml
+      rubocop-ast (>= 0.0.3)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (0.0.3)
+      parser (>= 2.7.0.1)
+    ruby-progressbar (1.10.1)
+    unicode-display_width (1.7.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  files.com!
+  memory_profiler
+  pry
+  pry-byebug
+  rake (~> 12.0.0)
+  rspec (~> 3.9.0)
+  rubocop
+
+BUNDLED WITH
+   2.1.4

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2019- Action Verb, LLC (https://www.files.com)
+
+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,119 @@
+# Files.com Ruby Client
+
+The Files.com Ruby client library provides convenient access to the Files.com API from applications written in the Ruby language.
+
+
+## Installation
+
+To install the package:
+
+    gem install files.com
+
+Or add this to your app's Gemfile:
+
+    gem 'files.com', '~> 1.0'
+
+
+### Requirements
+
+* Ruby 2.3+
+
+
+## Usage
+
+### Authentication
+
+There are multiple ways to authenticate to the API.
+
+#### Global API Key
+
+You can set an API key globally, like this:
+
+    Files.api_key = "my-key"
+
+
+#### Per-Request API Key
+
+Or, you can pass an API key per-request, in the Options hash at the end
+of every method.  Like this:
+
+    Files::Group.list({}, api_key: "my-key")
+
+That key will automatically be used for any followup actions that occur
+on models returned from the API.
+
+
+#### User Session
+
+Or, you can open a user session by calling `Files::Session.create`
+
+    session = Files::Session.create(username: "username", password: "password")
+
+Then use it as follows:
+
+    Files::Group.list({}, session: session)
+
+Or use if for all subsequent API calls globally like this:
+
+    Files.session = Files::Session.create(username: "username", password: "password")
+
+
+### Setting Global Options
+
+You can set the following global options directly on the `Files` module:
+
+ * `Files.log_level` - set to `nil`, `info`, or `debug`
+ * `Files.open_timeout` - open timeout in seconds (default: 30)
+ * `Files.read_timeout` - read timeout in seconds (default: 80)
+ * `Files.initial_network_retry_delay` - initial retry delay in seconds (default: 0.5)
+ * `Files.max_network_retries` - max retries (default: 3)
+ * `Files.max_network_retry_delay` - max retry delay in seconds (default: 2)
+ * `Files.base_url` - to point this client at an on-premise
+   installation of Files.com, set its URL here.
+ * `Files.proxy` - proxy configuration (uses Faraday format)
+
+
+### File Operations
+
+The Files::File and Files::Dir models implement the standard Ruby API
+for File and Dir, respectively.  (Note that the Files.com API uses the
+word Folder, not Dir, and Files::Dir is simply an alias for
+Files::Folder).
+
+
+#### List root folder
+
+    Files::Folder.list_for("/").each do |file|
+      puts file.path
+    end
+    
+
+#### Writing a file example
+
+    Files::File.open("foo.txt", 'w') do |f|
+      f.write("contents")
+    end
+
+
+#### Reading a file example
+
+    Files::File.find("foo.txt").read
+
+
+### Additional Object Documentation
+
+Additional docs are available at https://developers.files.com/ and also
+in the `docs/` subdirectory of this directory.
+
+
+### RDoc (YARD) Generated Documentation coming in the future
+
+We hope to add RDoc/Yard documentation to a future release.
+
+
+## Getting Support
+
+The Files.com team is happy to help with any SDK Integration challenges you
+may face.
+
+Just email support@files.com and we'll get the process started.

data/Rakefile

@@ -0,0 +1,12 @@
+require "bundler/gem_tasks"
+
+Dir.glob('lib/tasks/*.rake').each { |r| import r }
+
+begin
+  require 'rspec/core/rake_task'
+
+  RSpec::Core::RakeTask.new(:spec)
+  task default: :spec
+rescue LoadError
+  # no rspec available
+end

data/SECURITY.md

@@ -0,0 +1,24 @@
+# Security Policy
+
+Thank you for your interest in Files.com security.  We recognize that your data is very personal and sensitive and we work hard to keep it protected.
+
+
+## Supported Versions
+
+Only the latest version will be supported with security updates.
+
+
+## Reporting a Vulnerability
+
+Here at Files.com, we celebrate security and we encourage independent security researchers to help us keep our products secure.
+
+We offer a Security Bug Bounty Program to create an incentive and reward structure so that researchers are able to devote resources to working on Files.com.
+
+We offer our Bug Bounty Program on HackerOne at https://hackerone.com/files
+
+We prefer to receive reports of vulnerabilities there.
+
+If you do not wish to use HackerOne, alternate submission instructions are available at:
+https://www.files.com/legal/security-bounty/
+
+Thank you for helping keep the Files.com community secure!

data/_VERSION

@@ -0,0 +1 @@
+1.0.90

data/bin/files

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+require "#{::File.dirname(__FILE__)}/../lib/files.com"
+require "#{::File.dirname(__FILE__)}/../lib/files.com/cli"
+
+Files::Cli.new.run

data/bin/files-console

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+require "irb"
+require "irb/completion"
+
+require "#{::File.dirname(__FILE__)}/../lib/files.com"
+
+# Config IRB to enable --simple-prompt and auto indent
+IRB.conf[:PROMPT_MODE] = :SIMPLE
+IRB.conf[:AUTO_INDENT] = true
+
+puts "Loaded Files.com Console."
+
+IRB.start

data/docs/account_line_item.md

@@ -0,0 +1,41 @@
+# AccountLineItem
+
+## Example AccountLineItem Object
+
+```
+{
+  "id": 1,
+  "amount": "",
+  "balance": "",
+  "created_at": "2000-01-01T01:00:00Z",
+  "currency": "USD",
+  "download_uri": "https://url...",
+  "invoice_line_items": [
+
+  ],
+  "method": "paypal",
+  "payment_line_items": [
+
+  ],
+  "payment_reversed_at": "2000-01-01T01:00:00Z",
+  "payment_type": "",
+  "site_name": "My Site",
+  "type": "invoice",
+  "updated_at": "2000-01-01T01:00:00Z"
+}
+```
+
+* `id` (int64): Line item Id
+* `amount` (double): Line item amount
+* `balance` (double): Line item balance
+* `created_at` (date-time): Line item created at
+* `currency` (string): Line item currency
+* `download_uri` (string): Line item download uri
+* `invoice_line_items` (array): Associated invoice line items
+* `method` (string): Line item payment method
+* `payment_line_items` (array): Associated payment line items
+* `payment_reversed_at` (date-time): Date/time payment was reversed if applicable
+* `payment_type` (string): Type of payment if applicable
+* `site_name` (string): Site name this line item is for
+* `type` (string): Type of line item, either payment or invoice
+* `updated_at` (date-time): Line item updated at

data/docs/action.md

@@ -0,0 +1,37 @@
+# Action
+
+## Example Action Object
+
+```
+{
+  "id": 1,
+  "path": "path",
+  "when": "2000-01-01T01:00:00Z",
+  "destination": "/to_path",
+  "display": "Actual text of the action here.",
+  "ip": "192.283.128.182",
+  "source": "/from_path",
+  "targets": [
+
+  ],
+  "user_id": 1,
+  "username": "user",
+  "action": "create",
+  "failure_type": "none",
+  "interface": "web"
+}
+```
+
+* `id` (int64): Action ID
+* `path` (string): Path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+* `when` (date-time): Action occurrence date/time
+* `destination` (string): The destination path for this action, if applicable
+* `display` (string): Friendly displayed output
+* `ip` (string): IP Address that performed this action
+* `source` (string): The source path for this action, if applicable
+* `targets` (array): Targets
+* `user_id` (int64): User ID
+* `username` (string): Username
+* `action` (string): Type of action
+* `failure_type` (string): Failure type.  If action was a user login or session failure, why did it fail?
+* `interface` (string): Interface on which this action occurred.

data/docs/api_key.md

@@ -0,0 +1,202 @@
+# ApiKey
+
+## Example ApiKey Object
+
+```
+{
+  "id": 1,
+  "descriptive_label": "Site-wide API key for https://site.files.com/ (key ID #1)",
+  "created_at": "2000-01-01T01:00:00Z",
+  "expires_at": "2000-01-01T01:00:00Z",
+  "key": "[key]",
+  "last_use_at": "2000-01-01T01:00:00Z",
+  "name": "My Main API Key",
+  "path": "shared/docs",
+  "permission_set": "full",
+  "platform": "win32",
+  "user_id": 1
+}
+```
+
+* `id` (int64): API Key ID
+* `descriptive_label` (string): Unique label that describes this API key.  Useful for external systems where you may have API keys from multiple accounts and want a human-readable label for each key.
+* `created_at` (date-time): Time which API Key was created
+* `expires_at` (date-time): API Key expiration date
+* `key` (string): API Key actual key string
+* `last_use_at` (date-time): API Key last used - note this value is only updated once per 3 hour period, so the 'actual' time of last use may be up to 3 hours later than this timestamp.
+* `name` (string): Internal name for the API Key.  For your use.
+* `path` (string): Folder path restriction for this api key. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+* `permission_set` (string): Permissions for this API Key.  Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations).  Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
+* `platform` (string): If this API key represents a Desktop app, what platform was it created on?
+* `user_id` (int64): User ID for the owner of this API Key.  May be blank for Site-wide API Keys.
+
+
+---
+
+## List Api Keys
+
+```
+Files::ApiKey.list(
+  user_id: 1, 
+  page: 1, 
+  per_page: 1
+)
+```
+
+### Parameters
+
+* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
+* `page` (int64): Current page number.
+* `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
+* `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `deleted_at` and `expires_at`.
+* `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `expires_at`.
+* `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `expires_at`.
+* `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `expires_at`.
+* `filter_like` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `expires_at`.
+* `filter_lt` (object): If set, return records where the specifiied field is less than the supplied value. Valid fields are `expires_at`.
+* `filter_lteq` (object): If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are `expires_at`.
+
+
+---
+
+## Show information about current API key.  (Requires current API connection to be using an API key.)
+
+```
+Files::ApiKey.find_current
+```
+
+
+---
+
+## Show Api Key
+
+```
+Files::ApiKey.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Api Key ID.
+
+
+---
+
+## Create Api Key
+
+```
+Files::ApiKey.create(
+  user_id: 1, 
+  name: "My Main API Key", 
+  expires_at: "2000-01-01T01:00:00Z", 
+  permission_set: "full", 
+  path: "shared/docs"
+)
+```
+
+### Parameters
+
+* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
+* `name` (string): Internal name for the API Key.  For your use.
+* `expires_at` (string): API Key expiration date
+* `permission_set` (string): Permissions for this API Key.  Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations).  Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
+* `path` (string): Folder path restriction for this api key.
+
+
+---
+
+## Update current API key.  (Requires current API connection to be using an API key.)
+
+```
+Files::ApiKey.update_current(
+  expires_at: "2000-01-01T01:00:00Z", 
+  name: "My Main API Key", 
+  permission_set: "full"
+)
+```
+
+### Parameters
+
+* `expires_at` (string): API Key expiration date
+* `name` (string): Internal name for the API Key.  For your use.
+* `permission_set` (string): Permissions for this API Key.  Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations).  Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
+
+
+---
+
+## Update Api Key
+
+```
+Files::ApiKey.update(id, 
+  name: "My Main API Key", 
+  expires_at: "2000-01-01T01:00:00Z", 
+  permission_set: "full"
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Api Key ID.
+* `name` (string): Internal name for the API Key.  For your use.
+* `expires_at` (string): API Key expiration date
+* `permission_set` (string): Permissions for this API Key.  Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations).  Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
+
+
+---
+
+## Delete current API key.  (Requires current API connection to be using an API key.)
+
+```
+Files::ApiKey.delete_current
+```
+
+
+---
+
+## Delete Api Key
+
+```
+Files::ApiKey.delete(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Api Key ID.
+
+
+---
+
+## Update Api Key
+
+```
+api_key = Files::ApiKey.list_for(path).first
+
+api_key.update(
+  name: "My Main API Key",
+  expires_at: "2000-01-01T01:00:00Z",
+  permission_set: "full"
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Api Key ID.
+* `name` (string): Internal name for the API Key.  For your use.
+* `expires_at` (string): API Key expiration date
+* `permission_set` (string): Permissions for this API Key.  Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations).  Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
+
+
+---
+
+## Delete Api Key
+
+```
+api_key = Files::ApiKey.list_for(path).first
+
+api_key.delete
+```
+
+### Parameters
+
+* `id` (int64): Required - Api Key ID.