https://github.com/lokalise/ruby-lokalise-api

Lokalise API v2 Ruby interface.
https://github.com/lokalise/ruby-lokalise-api

api-client lokalise-api ruby-interface rubygem translation-files translation-providers

Last synced: about 2 months ago
JSON representation

Lokalise API v2 Ruby interface.

• Host: GitHub
• URL: https://github.com/lokalise/ruby-lokalise-api
• Owner: lokalise
• License: other
• Created: 2018-10-15T15:45:46.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2024-06-13T17:00:04.000Z (4 months ago)
• Last Synced: 2024-07-18T20:46:22.013Z (3 months ago)
• Topics: api-client, lokalise-api, ruby-interface, rubygem, translation-files, translation-providers
• Language: Ruby
• Homepage: https://lokalise.github.io/ruby-lokalise-api
• Size: 738 KB
• Stars: 19
• Watchers: 13
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# Lokalise API v2 official Ruby interface

![Gem](https://img.shields.io/gem/v/ruby-lokalise-api)

![CI](https://github.com/lokalise/ruby-lokalise-api/actions/workflows/ci.yml/badge.svg)

[![Coverage Status](https://coveralls.io/repos/github/lokalise/ruby-lokalise-api/badge.svg?branch=master)](https://coveralls.io/github/lokalise/ruby-lokalise-api?branch=master)

![Downloads total](https://img.shields.io/gem/dt/ruby-lokalise-api)

Official opinionated Ruby interface for the [Lokalise API](https://developers.lokalise.com/reference/lokalise-rest-api) that represents returned data as Ruby objects.

Looking for a Rails integration? Try the [lokalise_rails gem](https://github.com/bodrovis/lokalise_rails). Also you can use a [lokalise_manager gem](https://github.com/bodrovis/lokalise_manager) which allows to exchange translation files between Lokalise and *any* Ruby script.

## Quickstart

Install the gem by running:

```bash

$ gem install ruby-lokalise-api

```

Obtain an API token in your [personal profile](https://lokalise.com/profile#apitokens) (*API tokens* section) and initialize the client:

```ruby

require 'ruby_lokalise_api'

@client = RubyLokaliseApi.client 'YOUR_TOKEN_HERE'

```

Now the `@client` can be used to perform API requests:

```ruby

project = @client.project '123.abc'

project.name

process = @client.upload_file project_id,

                              data: 'Base-64 encoded data... ZnI6DQogI...',

                              filename: 'my_file.yml',

                              lang_iso: 'en'

process.status

```

Alternatively instantiate your client with an [OAuth2 token](http://docs.lokalise.com/en/articles/5574713-oauth-2):

```ruby

@client = RubyLokaliseApi.oauth2_client 'YOUR_OAUTH2_TOKEN_HERE'

```

Learn how to generate an OAuth2 token [in the docs](https://lokalise.github.io/ruby-lokalise-api/additional_info/oauth2).

## Usage

Detailed documentation can be found at [lokalise.github.io/ruby-lokalise-api](https://lokalise.github.io/ruby-lokalise-api/).

You can also check [this repo containing some usage examples](https://github.com/bodrovis-learning/Lokalise-APIv2-Samples) and [this blog post with explanations](https://lokalise.com/blog/lokalise-apiv2-in-practice).

## License

This gem is licensed under the [BSD 3 Clause license](https://github.com/lokalise/ruby-lokalise-api/blob/master/LICENSE). Prior to version 4 the license type was MIT.

Copyright (c) [Lokalise team](http://lokalise.co) and [Ilya Krukowski](http://bodrovis.tech)