V2 api (#31)

* Add guard file

* file rename and removed ks structs

* rename to transfer spec

* Rename file item to file, and remove duplicate tests

* replaced ks structs with attr_accesors

* Added descriptions per tests

* Added board feature and made methods private

* disabled remote items

* Removed ks structs

* added classes for handling boards

* Added specs for remote board

* Removed items, and renamed web_items to links

* rename items to links

* Cleanup of if case

* add upload_file and get_board method

* Handle future links uploads, remove not used parts and update put_io method with use of classes

* Class attributes instea of hashes

* take default arguments

* Added request board method

* raise errors with the file name and remove true return

* Transform items from remote board to classes

* Set keyword arguments for classes and make them accessible with attr_reader

* Do one full test of all methods for boards

* Bump version

* skip transfer Tests for now

* Type + spacing

* single quotes

* Skip transfer tests for now

* add items to remote boards

* Added board builder spec

* add helper methods for transfers

* Adding transfer functionality

* wip

* edited upload_file to also handle transfer files

* Send empty hash instead of string for get requests

* rubocop

* complete_file accepts boards and transfers and transfers work now

* Rescue when no block is given

* change method name

* Remove unsupported method

* changed variable into let

* Check for items on future board

* Tests for future transfers

* refactor of the transfer builder tests

* Added tests for wetransfer_client class

* bumped wetransfer_style style

* Refactor nested meta-hash away.

Shortened some tests while in the process

* Consitency

* Implement guard (#34)

* Added guard and rubocop to project

* added guard description to readme

* remove pry calls

* fixed conflicts

* Extracted boards and transfers from the client

* return remote board or add files to board

* Version to module

* change to module class wetransfer

* Removed transfer/board depended methods

* removed all the object related methods into the object classes

* Removed private methods from client and placed them into the right classes, still some refactoring could be done.

* these gems needs to be added

* Restructuring the code

* removed gualrdfile from gitignore

* Moved transfers and boards into WT_client folder en renaming

* Integration tests for boards (#35)

* let’s pass down the whole object instead of the id

* Before doing the request, make sure we have a auth token.

* added feature tests

* Pass down the board object

* remove module from spec describe

* moved constant more upward

* added part size constant

* Change to fixnum for old ruby support (2.1)

* change Test for Integer to support older rubies(2.1)

* Remove specific target ruby version form rubocop rules

* make size output integer

* Test for kind integer

* no need for class

* Add rubocop to guard

* run guard inside group to halt if test fail

* wip Add upload and create method for boards (#38)

* Create a transfer and upload files with one method
* add a duplicate file checker
* Removed code smell and naming things/items
* Spec our generic status code check
* Use non-deprecated Rubies

* Resolve multiple minor issues

* Mark parts of our boards API experimental

Author: davidenko87

.rspec

@@ -1,3 +1,2 @@
---format progress
 --order rand
---color
+--color

.rubocop.yml

@@ -1,2 +1,2 @@
 inherit_gem:
-  wetransfer_style: ruby/default.yml
+  wetransfer_style: ruby/default.yml

.travis.yml

@@ -1,8 +1,9 @@
 sudo: false
 language: ruby
 rvm:
-- 2.1.0
-- 2.5.1
+- 2.3
+- 2.4
+- 2.5
 - jruby-9.0
 before_install: gem install bundler -v 1.16.1
 cache: bundler

Guardfile

@@ -0,0 +1,11 @@
+group :red_green_refactor, halt_on_fail: true do
+  guard :rspec, cmd: 'bundle exec rspec' do
+    watch(%r{^spec/.+_spec\.rb$})
+    watch(%r{^lib/(.+)\.rb$}) { |m| "spec/#{m[1]}_spec.rb" }
+  end
+
+  guard :rubocop, cmd: 'bundle exec rubocop' do
+    watch(%r{^lib/(.+)\.rb$})
+    watch(%r{^spec/(.+)\.rb$})
+  end
+end

README.md

@@ -1,6 +1,8 @@
 # WeTransfer Ruby SDK
 
-An open source Ruby SDK for the WeTransfer Public API
+The Ruby SDK that makes interacting with WeTransfer's Public API a breeze
+
+This gem can be used to create transfers (as seen on WeTransfer.com) and boards (as seen in our [iOS app](https://itunes.apple.com/app/apple-store/id765359021?pt=10422800&ct=wetransfer-developer-portal&mt=8) and [Android app](https://play.google.com/store/apps/details?id=com.wetransfer.app.live&referrer=utm_source%3Dwetransfer%26utm_medium%3Ddeveloper-portal) ) alike.
 
 For your API key and additional info please visit our [developer portal](https://developers.wetransfer.com).
 
@@ -9,12 +11,13 @@ For your API key and additional info please visit our [developer portal](https:/
 ## Table of Contents
 
 1. [Installation](#installation)
-2. [Usage](#usage)
-3. [Super simple transfers](#super-simple-transfers)
-4. [Development](#development)
-5. [Contributing](#contributing)
-6. [License](#license)
-7. [Code of Conduct](#code-of-conduct)
+1. [Getting started](#getting-started)
+1. [Transfers](#transfers)
+1. [Boards](#boards)
+1. [Development](#development)
+1. [Contributing](#contributing)
+1. [License](#license)
+1. [Code of Conduct](#code-of-conduct)
 
 ## Installation
 
@@ -26,82 +29,122 @@ gem 'wetransfer'
 
 And then execute:
 
-    $ bundle
+    bundle install
 
 Or install it yourself as:
 
-    $ gem install wetransfer
-
-## Usage
+    gem install wetransfer
 
-### Minimalist transfers
+## Getting started
 
 You'll need to retrieve an API key from [our developer portal](https://developers.wetransfer.com).
 
-Be sure to not commit this key to Github! If you do though, no worries, you can always revoke & create a new key from within the portal.
+Be sure to not commit this key to Github! If you do though, you can always revoke it and create a new key from within the portal.
 
-For configuring and storing secrets - like this API key - there are a variety of solutions. The smoothest here is creating a .env file:
+For configuring and storing secrets - like this API key - there are a variety of solutions. The smoothest here is creating a `.env` file, and use a gem like [dotenv](https://github.com/bkeepers/dotenv).
 
 Now that you've got a wonderful WeTransfer API key, create a .env file in your project folder:
 
-    $ touch .env
+    touch .env
+
+You don't want the contents of this file to leave your system. Ever.
+
+If the `.env` file is new, make sure to add it to your `.gitignore`, using the following command:
+
+    echo .env >> .gitignore
 
-Check your `.gitignore` file and make sure it has `.env` listed!
+Open the file in your text editor and add this line:
 
-Now, open the file in your text editor and add this line:
+    WT_API_KEY=<your api key>
 
-`WT_API_KEY=<your api key>` (without the <> brackets!)
+Make sure to replace `<your api key>` by your actual api key. Don't include the pointy brackets!
 
-Great! Now you can go to your project file and create the client:
+Great! Now you can go to your project file and use the client.
+
+## Transfers
+
+A transfer is a collection of files that can be created once, and downloaded until it expires. Once a transfer is ready for sharing, it is closed for modifications.
 
 ```ruby
 # In your project file:
 require 'we_transfer_client'
 
-@client = WeTransferClient.new(api_key: ENV.fetch('WT_API_KEY'))
+client = WeTransfer::Client.new(api_key: ENV.fetch('WT_API_KEY'))
 ```
 
-Now that you've got the client set up you can use  `create_transfer` to, well, create a transfer!
+Now that you've got the client set up you can use  `create_transfer_and_upload_files` to, well, create a transfer, and upload all files!
 
 ```ruby
-transfer = @client.create_transfer(name: "My wonderful transfer", description: "I'm so excited to share this") do |upload|
+transfer = client.create_transfer_and_upload_files(message: 'All the Things') do |upload|
   upload.add_file_at(path: '/path/to/local/file.jpg')
   upload.add_file_at(path: '/path/to/another/local/file.jpg')
-  upload.add_file(name: 'README.txt', io: StringIO.new("This is the contents of the file"))
-  upload.add_web_url(url: "https://www.the.url.you.want.to.share.com", title: "title of the url"))
+  upload.add_file(name: 'README.txt', io: StringIO.new("You should read All the Things!"))
 end
 
-transfer.shortened_url => "https://we.tl/SSBsb3ZlIHJ1Ynk="
+# To get a link to your transfer, call `url` on your transfer object:
+transfer.url => "https://we.tl/t-123234="
 ```
 
-The upload will be performed at the end of the block.
+The upload will be performed at the end of the block. Depending on your file sizes and network connection speed, this might take some time.
+
+What are you waiting for? Open that link in your browser! Chop chop.
+
+## Boards
+
+A board is a collection of files and links, but it is open for modifications. Like your portfolio: While working, you can make adjustments to it. A board is a fantastic place for showcasing your work in progress.
+
+Boards need a WeTransfer Client to be present, just like transfers.
+
+```ruby
+# In your project file:
+require 'we_transfer_client'
+
+client = WeTransfer::Client.new(api_key: ENV.fetch('WT_API_KEY'))
+```
+
+After you create your client, you can
+
+### Create a board and upload items
+
+
+```ruby
+board = client.create_board(name: 'Meow', description: 'On Cats') do |items|
+  items.add_file(name: 'big file.jpg', io: File.open('/path/to/huge_file.jpg', 'rb')items.add_file_at(path: '/path/to/another/file.txt')
+  items.add_web_url(url: 'http://wepresent.wetransfer.com', title: 'Time well spent')
+end
+
+puts board.url # => "https://we.tl/b-923478"
+```
+
+You've just created a board. It is visible on the internet, to share it with anyone.
 
 ## Development
+
 You'll need to retrieve an API key from [our developer portal](https://developers.wetransfer.com), and as described above, store it in a local `.env` file. As always, do not commit this file to github! :)
 
 After forking and cloning down the repo, run `bundle install` to install dependencies. Then, run `bundle exec rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-```
-$ git clone <your fork>
-$ cd wetransfer_ruby_sdk
-$ bundle install
-```
+    git clone <your fork> ./wetransfer_ruby_sdk
+    cd wetransfer_ruby_sdk
+    bundle install
 
 To install this gem onto your local machine, run `bundle exec rake install`.
 
 To execute to ruby specs, run:
 
-```
-$ bundle exec rspec
-```
+    bundle exec rspec
 
 Please note that we use rubocop to lint this gem -- be sure to run it prior to submitting a PR for maximum mergeability.
 
-    $ bundle exec rubocop
+    bundle exec rubocop
+
+If any violations can be handled by rubocop, you can run auto-fix and it'll handle them for you, though do run the tests again and make sure it hasn't done something... unexpected.
+
+    bundle exec rubocop -a
 
-If any violations can be handled by rubocop, you can run auto-fix and it'll handle them for you, though do run the tests again and make sure it hasn't done something ... unexpected.
+For more convenience you also can run Guard, this checks all the tests and runs rubocop every time you save your files.
 
-    $ bundle exec rubocop -a
+    bundle exec guard
 
 Hooray!
 
@@ -115,4 +158,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the WeTransfer Ruby SDK project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/WeTransfer/wetransfer_ruby_sdk/blob/master/.github/CODE_OF_CONDUCT.md).
+Everyone interacting in the WeTransfer Ruby SDK project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/WeTransfer/wetransfer_ruby_sdk/blob/master/.github/CODE_OF_CONDUCT.md).

V2_README.md

@@ -0,0 +1,53 @@
+The process
+
+In the v2 version of the Ruby SDK we have added a new feature, mutable transfers called boards.
+
+Boards excists next to the transfers and will be mutable, so you can add new files or web_links to your board.
+
+
+To use the ruby sdk you have to Initailize a new client with your API-Key:
+
+```
+client = WeTransfer::Client.new(api_key: 'your-special-api-key')
+```
+
+### Initailize a Board
+
+Once you created that new client you can call methods to create a new board, empty or as a block:
+
+```
+board = client.create_board(name: 'File Collection', description: 'A collection of files')
+```
+or:
+```
+board = client.create_board(name: 'Dog Collection', description: 'A collection of dogs') do |item|
+  item.add_file(name: 'dalmatian.jpg', io: File.open('path/to/dalmatian.jpg', 'r'))
+  item.add_file(name: 'beagle.jpg', io: File.open('path/to/beagle.jpg', 'r'))
+  item.add_file(name: 'great_dane.jpg', io: File.open('path/to/great_dane.jpg', 'r'))
+  item.add_web_url(url: 'http://www.wetransfer.com', title: 'WeTransfer Website')
+end
+```
+
+### Initialize a Transfer
+
+For initializing a transfer the process is like this:
+
+```ruby
+transfer = @client.create_transfer(name: "Dog transfer", description: "Have a look at my dogs") do |upload|
+  upload.add_file(name: 'chihuahua.jpg', io: File.open('path/to/chihuahua.jpg', 'r'))
+  upload.add_file(name: 'chow_chow.jpg', io: File.open('path/to/chow_chow.jpg', 'r'))
+end
+
+transfer.shortened_url => "https://we.tl/SSBsb3ZlIHJ1Ynk="
+```
+
+Note: For initializing a transfer you have to pass all the files directly so the backend knows what you are uploading.
+
+
+
+### uploading the files
+
+For both the transfer and board, the files are not in you transfer or collection, yet.
+
+The files need to be uploaded and finalized
+

examples/create_collection.rb

@@ -0,0 +1,13 @@
+require_relative 'we_transfer_client'
+require 'dotenv'
+Dotenv.load
+
+client = WeTransfer::Client.new(api_key: ENV.fetch('WT_API_KEY'))
+transfer = client.create_transfer(name: 'My amazing transfer', description: 'Hi there!') do |builder|
+  builder.add_file(name: File.basename(__FILE__), io: File.open(__FILE__, 'rb'))
+  builder.add_file(name: 'amazing.txt', io: StringIO.new('This is unbelievable'))
+  builder.add_file(name: 'huge.bin', io: File.open('/path/to/local/file.jpg', 'rb'))
+  builder.add_file_at(path: __FILE__)
+end
+
+puts transfer.shortened_url

examples/create_transfer.rb

@@ -2,7 +2,7 @@
 require 'dotenv'
 Dotenv.load
 
-client = WeTransferClient.new(api_key: ENV.fetch('WT_API_KEY')) # , logger: Logger.new($stderr))
+client = WeTransfer::Client.new(api_key: ENV.fetch('WT_API_KEY'))
 transfer = client.create_transfer(name: 'My amazing transfer', description: 'Hi there!') do |builder|
   builder.add_file(name: File.basename(__FILE__), io: File.open(__FILE__, 'rb'))
   builder.add_file(name: 'amazing.txt', io: StringIO.new('This is unbelievable'))