eriksundin / ricotta-gem

A ruby gem for interacting with the Ricotta translation management tool

Ricotta is a web based translation management tool, with complimentary build tools, to efficiently manage localized resources in your software project.

• http://ricotta-open.appspot.com
• https://github.com/sosandstrom/ricotta

About

The ricotta gem integrates with the Ricotta translation tool to make it easier to keep translations up to date in your software projects, all from the command line.

Installation

gem install ricotta

Usage

$ ricotta

Download translations from Ricotta

Commands:
dump                 Dump translations from Ricotta into local files.
help                 Display global or [command] help documentation.
install:xcode        Fetch translations from Ricotta and install them into an Xcode project

Global Options:
-h, --help           Display help documentation 
-v, --version        Display version information 
-t, --trace          Display backtrace when an error occurs 

Install into an Xcode project

$ cd projects/MyXcodeProject
$ ricotta install:xcode -u http://ricotta-open.appspot.com \
                        -p MyRicottaProject \
                        -l en

Or by recommendation, create a .ricottarc file (see below) and execute.

$ ricotta install:xcode

Configuration

You can configure ricotta by using a ricotta configuration file. The recommended name is .ricottarc but a custom file can be passed by using the -c option.

# My Ricotta configuration
url: http://ricotta-open.appspot.com
project: MyProject
language: en,es,pt
branch: staging
template: my_translation_template

Ricotta automatically searches for .ricottarc in the current working directory and in the users home directory. Multiple configurations are automatically merged.

Multiple configurations example:

# Global config in ~/.ricottarc
url: http://ricotta.mycompany.com
subset: ios

App configurations

# /Users/es/dev/projects/MyiOSApp
project: MyApp
language: en,es
name_token: appName

And

# /Users/es/dev/projects/MyOtheriOSApp
project: MyOtherApp
language: en,pt,ru
name_token: applicationName
subset: iphone  #override global config

Contact

Erik Sundin

• [email protected]

License

Ricotta gem is available under the MIT license. See the LICENSE file for more info.

ricotta-gem's Issues

I can't download ricotta strings after updating ruby gem to 1.8.7

I have updated my ruby gem to version 1.8.7 (2012-10-12 patchlevel 371) [i686-darwin12] and then I tried to download my localised strings from Ricotta by executing the command 'ricotta install:xcode', but it always failed with following error:

Faraday: you may want to install system_timer for reliable timeouts
invalid command. Use --help for more information
/opt/local/lib/ruby/site_ruby/1.8/rubygems/custom_require.rb:36:in gem_original_require': /o ...n?", *dir_options, none_option) ^ from /opt/local/lib/ruby/site_ruby/1.8/rubygems/custom_require.rb:36:inrequire'
from /opt/local/lib/ruby/gems/1.8/gems/ricotta-0.0.2/lib/ricotta/commands.rb:4
from /opt/local/lib/ruby/site_ruby/1.8/rubygems/custom_require.rb:36:in gem_original from /opt/local/lib/ruby/site_ruby/1.8/rubygems/custom_require.rb:36:inrequire'
from /opt/local/lib/ruby/gems/1.8/gems/ricotta-0.0.2/bin/ricotta:19
from /opt/local/bin/ricotta:23:in `load'
from /opt/local/bin/ricotta:23

Failed to download translations for en: 500

I am using your ricotta gem in my project. Every time when I use command
“ricotta install:xcode -u http://ricotta-open.appspot.com -p myproject -l en”
I am getting following error:
processing en
Failed to download translations for en: 500

<title>500 Server Error</title>

Error: Server Error

The server encountered an error and could not complete your request.

Please try again in 30 seconds.

Please suggest if I am missing something.