# Gemfile
gem 'ponominalu', '~> 0.1.0'

# вызываем методы API, как методы модуля Ponominalu в нотации snake_case

artists = Pn.get_artists

# если ponominalu.ru ожидает получить параметр в виде списка,
# разделенного запятыми, то его можно передать массивом
venue = Pn.get_venue(id: 77, exclude: [:description, :eng_title, :address])

# большинство методов возвращает структуры Hashie::Mash
# и массивы из них
venue.title                 # => "Гостиный двор"
venue.alias                 # => "gostiniy-dvor"
venue.stations.first.title  # => "Китай-город"

# если метод, возвращающий массив, вызывается с блоком,
# то блок будет выполнен для каждого элемента,
# и метод вернет обработанный массив

venue = Pn.get_venues(limit: 5) do |venue|
  "#{venue.alias}"
end
# => ["royal-beach-club",
# "klub-kubrik",
# "dk-rossiya",
# "jazz-club-igorya-butmana-na-taganke",
# "centr-razvitiya-biznesa-sberbanka"]

Pn # => Ponominalu

Pn.unregister_alias
Pn # => NameError: uninitialized constant Pn

Pn.get_artist
# Ponominalu::Error: Ponominalu returned an error -200: 'alias Required' after calling method 'get_artist' without parameters. App session is '123'.

Ponominalu.configure do |config|
  config.session       = '123abc123'

  # faraday-адаптер для запросов
  config.adapter = :net_http
  # HTTP-метод для вызова методов API (:get или :post)
  config.http_verb = :post
  # параметры для faraday-соединения
  config.faraday_options = {
    ssl: {
      ca_path:  '/usr/lib/ssl/certs'
    },
    proxy: {
      uri:      'http://proxy.example.com',
      user:     'foo',
      password: 'bar'
    }
  }
  # максимальное количество повторов запроса при ошибках
  config.max_retries = 2

  # получить ответ JSON-ом в виде строки
  config.raw_json = false

  # выбрасывать исключение, если в результате запроса ничего не было найдено
  config.empty_strict = false

  # результат возвращается в соответствии с форматом указанном в документации,
  # вместе с ключами "code", "ts" а также параметрами запроса, которые могут
  # пригодиться в дальнейшем, в ходе выполнения программы.
  # По умолчанию возвращается непосредственно ответ (ключ "message").
  config.wrap_response = false

  # логгер
  config.logger        = Rails.logger
  config.log_requests  = true  # параметры запросов
  config.log_errors    = true  # параметры запросов
  config.log_responses = false # удачные ответы
end

Ponominalu.configure({
  adapter: :net_http,
  session: '123abc123',
  max_retries: 2,
  empty_strict: false,
  raw_json: false
  ...
})

Ponominalu.adapter = :net_http
Ponominalu.session = '123abc123'
Ponominalu.max_retries = 2
...