# freefeed-client

Ruby wrapper for [Freefeed API](https://fetsh.github.io/freefeed-api).

[![Gem Version](https://badge.fury.io/rb/feefeed-client.svg)](http://badge.fury.io/rb/freefeed-client)

## Installation

Add following line to your Gemfile:

```ruby
gem 'freefeed-client'
```

And then execute:

```shell
$ bundle
```

Or install it system-wide:

```shell
$ gem install freefeed-client
```

## Usage

First things first, you need to [obtain a token](https://fetsh.github.io/freefeed-api/#authentication) for your user. Then create your api client like this:

```ruby
require 'freefeed'

client = Freefeed::Client.new('yourFreefeedAPIToken')

post = Freefeed::Types::PostCreate.new(
  {
    post: { 
      body: 'Hello World!'
    },
    meta: {
      feeds: ['yourusername']
    }
  }
)

post_resource = Freefeed::Post.new(client: client)

post_resource.create(post)
```

You can skip instantiating resource, but I'm not sure if this is a good practice:

```ruby
require 'freefeed'

client = Freefeed::Client.new('yourFreefeedAPIToken')

post = Freefeed::Types::PostCreate.new(
  {
    post: { 
      body: 'Hello World!'
    },
    meta: {
      feeds: ['yourusername']
    }
  }
)

client.posts.create(post)
```

You can even skip instantiating post type, but you will lose some validation:


```ruby
require 'freefeed'

client = Freefeed::Client.new('yourFreefeedAPIToken')

client.posts.create({post: {body: 'Hello World!'}, meta: {feeds: ['yourusername']}})
```

## Logging

By default, `freefeed-client` logs everything to STDOUT. You can change this behavior and provide your own logger class with someo ptions. See example below:

```ruby
client = Freefeed::Client.new(
  'yourFreefeedAPIToken',
  logger: Logger.new('log.txt'),
  logger_options: {bodies: false, headers: false}
)
```