# GCloudex Storage

 This is a fork from sashaafm/gcloudex with a few dependencies upgrades
 Google Cloud Storage for Elixir.
 Friendly set of wrappers for Google Cloud Storage Platform services' API's. 

## Features
- Minimal configuration and dependencies
- Friendly way to use Google Cloud services' API's
- Function names and signatures closely mimic their REST counterparts
- HTTP requests sent using the popular HTTPoison app providing familiar HTTP responses
- Easy to extend
  
## Installation and Configuration

GCloudex uses HTTPoison for the HTTP requests, Poison for JSON encoding/decoding and Friendly for XML parsing. The Google Authorization Tokens are retrieved using Goth. The JSON API's for the various Google Cloud services are used whenever possible or available. 

  1. Add gcloudex to your list of dependencies in `mix.exs`:

        def deps do
          [{:gcloudex, git: "git@github.com:mgiacomini/gcloudex_storage.git"}]
        end

  2. Ensure gcloudex is started before your application:

        def application do
          [applications: [:gcloudex_storage]]
        end

Then go to the Google Cloud's website and download the credentials file for your Google Project. 

Put that file in your application's config folder and rename the file to 
`creds.json` (or whatever name you prefer). This file will be used to authenticate the requests. **Be sure to add it to your .gitignore file in case you're uploading to a public repository.**

Finally put inside the config file you want (like `dev.exs`) the following line:

    config :goth, 
      json: "config/<filename>.json" |> Path.expand |> File.read!

That's all you need to use GCloudex Storage.

## Usages Examples

### Cloud Storage:
> GCloudex.CloudStorage.Client.list_buckets # => {:ok, %HTTPoison.Response{body: ..., status_code: 200}}
> GCloudex.CloudStorage.CLient.put_object "bucket_name", "this_file.txt" # => {:ok, %HTTPoison.Response{body: ..., status_code: 200}}