transifex-interface-ruby 0.0.1 → 0.0.2

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    ZDI5MmRmMmZhMjVlYzU1NWI0NDZkNTVlYmYzODYyNmJiODAwYzlkMQ==
-  data.tar.gz: !binary |-
-    YjJmYjhlOGFmMmE2ZWQxMzZiOThmYzM0NTAwY2ExMjJmNjI5ZjlkNw==
-!binary "U0hBNTEy":
-  metadata.gz: !binary |-
-    Mjk2ZmY2ZjM3NmE0Y2MyOTA4OGE5Y2FkZmMzMDVhZTk5N2RiNDcyYzhmNDll
-    ZThlODlhMDU2MGZlOGQwMTgxODA3NzdhNjVhOTIxYzU0ZGUzYzFhYWRkOTJk
-    MTAwNTAxOTQ0YTVlYTIyMzliNDAwOGM2NTczYTI2ZmFmZDlhNjE=
-  data.tar.gz: !binary |-
-    YjBlYWE2ZTI0NjJkMjc5MjM5NmYzNmMyZTg1MmY5NzIwNTJlMTBlMGIyZDY5
-    ODMyNDdmNTBjYjQ0Nzc0OTM3YWQyOGY5NjdkZGQwNTI1Yzk0MzliY2YxMmQy
-    NDRjZjNiMzc5YWI4Y2IwYTI1NjgwMGY1YjRmZDE0YWYxOTUxMWI=
+SHA1:
+  metadata.gz: 54b9106f9ec2eb907afe6d31b83220b71a029bda
+  data.tar.gz: a9dc02d1e3fb33f07a78f9257b093d1708354f4a
+SHA512:
+  metadata.gz: f0bfbb7d12edea0056a45646b347a34b6fef917d2e92cc7f5a56ced642a9a1ad4a0aed5e5b29b4cb657832252855f3a1a5ca844348eb20800bc6f2280211996a
+  data.tar.gz: 6e2e44980dd82c9258d709ca105351570a32227da83c5143fa0634d6e24ab02774759cc6e3b37c9dc3b81be064372f75065688b25248ee480e5bc94b5fd5eb73

data/.gitignore

@@ -1,17 +1,17 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
-Gemfile.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--order rand

data/Gemfile

@@ -1,4 +1,4 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in transifex-interface-ruby.gemspec
-gemspec
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in transifex-interface-ruby.gemspec
+gemspec

data/LICENSE.txt

@@ -1,22 +1,22 @@
-Copyright (c) 2014 Fred-grais
-
-MIT License
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+Copyright (c) 2014 Fred-grais
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -1,513 +1,517 @@
-# Transifex::Interface::Ruby
-
-This gem is designed to interact easily with the Transifex API. You can perform all the actions allowed by the API. Documentation located here : http://docs.transifex.com/developer/api/
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-    gem 'transifex-interface-ruby'
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install transifex-interface-ruby
-
-## Usage
-
-### Initialization
-
-To initialize the gem, you will have to create an initializer like follow:
-
-```ruby
-Transifex.configure do |c|
-  c.client_login = 'your_client_login'
-  c.client_secret = 'your_secret'    
-end
-```
-Then restart the server.
-
-If you don't do this you will end up with the following error:
-
-```ruby
-#<Transifex::TransifexError: Authorization Required>
-```
-
-### Formats
-
-It represents all the formats available on Transifex:
-
-```ruby
-Transifex::Formats.fetch
-```
-
-### Languages
-
-It represents all the languages available on Transifex:
-
-#### Fetch
-
-You can fetch all the languages:
-
-```ruby
-Transifex::Languages.fetch
-```
-
-Or specify a language:
-
-```ruby
-Transifex::Languages.fetch('en')
-```
-
-### Projects (to fetch all projects and create a new one)
-
-#### Fetch
-
-To fetch all the projects owned by the account specified in the initializer:
-
-```ruby
-Transifex::Projects.fetch
-```
-
-#### Create
-
-To create a new project, you can proceed as following:
-
-For a private project:
-
-```ruby
-private_project_params = {:slug => "private_project", :name => "Private Project", :description => "description", :source_language_code => "en", :private => true}
-
-Transifex::Projects.create(private_project_params)
-```
-For a public project:
-
-```ruby
-public_project_params = {:slug => "public_project", :name => "Public Project", :description => "description", :source_language_code => "en", :repository_url => "http://example.com"}
-
-Transifex::Projects.create(public_project_params)
-```
-
-The complete list of the allowed parameters is located in the Transifex documentation.
-
-### Project (symbolize an existing project)
-
-#### Instantiation 
-
-```ruby
-transifex_project = Transifex::Project.new('project_slug')
-```
-or 
-
-```ruby
-transifex_project = Transifex::Projects.create(params) 
-```
-#### Fetch
-
-You can fetch the project informations from transifex:
-
-```ruby
-transifex_project_informations = transifex_project.fetch
-```
-
-with more details:
-
-```ruby
-transifex_project_informations = transifex_project.fetch_with_details
-```
-
-#### Update
-
-You can update the project: (see documentation for available fields)
-
-```ruby
-transifex_project.update({:description => "new description"})
-```
-#### Destroy
-
-You can destroy a project:
-
-```ruby
-transifex_project.delete
-```
-
-### Project Languages ( to fetch all languages of a project and create a new one)
-
-
-#### Instantiation
-
-```ruby
-project_languages = transifex_project.languages
-```
-
-#### Fetch
-
-You can retrieve informations about all the languages of a project:
-
-```ruby
-project_languages.fetch
-```
-
-#### Create
-
-You can create a new language for a project:
-
-```ruby
-params = {:language_code => "el", :coordinators => ['username']}
-project_languages.create(params)
-```
-
-### Project Language (Symbolize a single language of a project)
-
-#### Instantiation
-
-```ruby
-project_language = transifex_project.language('en')
-```
-
-#### Fetch
-
-You can retrieve informations for a project's specified language:
-
-```ruby
-project_language.fetch
-```
-
-with details:
-
-```ruby
-project_language.fetch_with_details
-```
-
-#### Update
-
-You can update the information of a project's specified language:
-
-```ruby
-params = {:coordinators => ['username1', 'username2'], :translators => ['username'], :reviewers => ['username']}
-project_language.update(params)
-```
-
-#### Delete
-
-You can delete a project's specified language:
-
-```ruby
-project_language.delete
-```
-
-### Project language management
-
-You have access to the differents teams of a language: coordinators, reviewers and translators.
-
-#### Instantiation:
-
-```ruby
-project_language_coordinators_team = project_language.coordinators
-project_language_reviewers_team = project_language.reviewers
-project_language_translators_team = project_language.translators
-```
-
-#### Fetch
-
-```ruby
-project_language_xxx_team.fetch
-```
-
-#### Update
-
-```ruby
-project_language_xxx_team.update(['username1', 'username2'])
-```
-
-### Resources ( to fetch all resources of a project and create a new one)
-
-First, instantiate a project (see Project/instantiation)
-
-#### Fetch
-
-You can fetch all the resources of projects:
-
-```ruby
-transifex_project.resources
-```
-
-#### Create
-
-You can create a new resource for the specified project:
-
-Without a file (you have to send the content as a string) :
-
-```ruby
-transifex_project.resources.create({:slug => "p", :name => "without_file", :i18n_type => "TXT", :content => "test"})
-```
-
-With a file: (YAML currently supported)
-
-```ruby
-options = {:trad_from_file => true}
-transifex_project.resources.create({:slug => "q", :name => "with_file", :i18n_type => "YAML", :content => 'path/to/your/file.yml'}
-```
-
-### Resource (Symbolize a single resource of a project)
-
-#### Instantiation
-
-You can instantiate a resource as follow:
-
-```ruby
-project_resource = transifex_project.resource("resource_slug")
-```
-
-#### Fetch
-
-You can retrieve informations of the specified resource:
-
-```ruby
-project_resource.fetch
-```
-with more details:
-
-```ruby
-project_resource.fetch_with_details
-```
-
-#### Update
-
-You can update a resource: (see documentation for allowed fields)
-
-```ruby
-project_resource.update({name: "new_name", categories: ["cat1", "cat2"]})
-```
-
-#### Delete
-
-You can delete the specified resource:
-
-```ruby
-project_resource.delete
-```
-
-### Resource Content ( Source language content)
-
-You can manage the resource's source language 
-
-#### Fetch
-
-You can retrieve the source language content:
-
-As a hash: (content is encoded as a string)
-
-```ruby
-project_resource.content.fetch
-```
-
-Or as a file
-Here for a YAML file:
-
-```ruby
-project_resource.content.fetch_with_file("path/where/file/will/be/saved.yml")
-```
-The source language content will be copied in the specified file.
-
-#### Update
-
-You can update the source language content (add new traductions for example):
-Attention: the source language content will be overrided.
-
-You must update the source language content with the same method used to create the resource.
-
-So if you used a YAML file, you must provide a new YAML file.
-
-With the content as a string:
-
-```ruby
-project_resource.content.update({:i18n_type => "TXT", :content => 'new_content'})
-```
-
-With a file:
-
-```ruby
-project_resource.content.update({:i18n_type => "YAML", :content => 'path/to/your/file.yml'})
-```
-
-### Resource Translations
-
-The following will explain how you can fetch the different translations of a resource and update them.
-
-You have to specify the language you want to work on.
-For example to work on the english translation:
-
-```ruby
-resource_translation = project_resource.translation('en')
-```
-
-#### Fetch
-
-You can fetch the translation content of a resource:
-
-As a Hash: (content encoded as a string)
-
-```ruby
-resource_translation.fetch
-```
-
-As a file: (file saved to the specified location)
-
-```ruby
-options = {:path_to_file => path_to_file}
-resource_translation.fetch_with_file(options)
-```
-
-You can use some options (as defined in the transifex documentations)
-
-For example to retrieve only reviewed translations:
-
-```ruby
-options = {:path_to_file => path_to_file, :mode => "reviewed"}
-resource_translation.fetch_with_file(options)
-```
-
-#### Update
-
-You can update the translation content:
-
-```ruby
-options = {:i18n_type => "YAML", :content => "/path/to/the/file/to/upload.yml"}
-resource_translation.update(options)
-```
-
-### Resource Translations Strings
-
-Resource translations strings allow you to retrieve meta-informations about translations strings (translation key, context, content, and so on)
-
-#### Instantiation
-
-```ruby
-resource_translation_strings = resource_translation.strings
-```
-
-#### Fetch
-
-You can fetch informations of all the strings of a translation:
-
-```ruby
-resource_translation_strings.fetch
-```
-
-With details:
-
-```ruby
-resource_translation_strings.fetch_with_details
-```
-
-You can specify a key and/or a context to search a particular string
-
-```ruby
-options = {:key => "welcome", :context => "context"}
-resource_translation_strings.fetch_with_details(options)
-```
-
-#### Update
-
-You can update some informations of a translation string (see documentation for available fields):
-
-You must specify at least the key of the translation, and can add a context(by default empty).
-
-```ruby
-options = {:key => "welcome", :context => "context"}
-resource_translation_strings.update({:key => "welcome", :context => "", :translation => "new_translation"})
-```
-### Resource Translations String (Symbolize a single string)
-
-#### Instantiation
-
-Context is empty by default.
-
-```ruby
-resource_translation_string = resource_translation.string(key, context)
-```
-
-#### Fetch
-
-You can fetch the informations about the specified string:
-
-```ruby
-resource_translation_string.fetch
-```
-
-#### Update
-
-You can update the informations of the specified string: (available fields in the documentation)
-
-```ruby
-params = {:reviewed => true, :translation => "new translation"}
-resource_translation_string.update(params)
-```
-
-### Resource Source String 
-
-It allow you to retrieve meta-data on a source language string and update them.
-
-#### Instantiation
-
-Context is empty by default.
-
-```ruby
-resource_source_string = project_resource.source(key, context)
-```
-
-#### Fetch
-
-You can fetch meta-data about the specified source string:
-
-```ruby
-resource_source_string.fetch
-```
-
-#### Update
-
-You can update the meta-data of the specified source string
-
-```ruby
-params = {:comment => "my comment", :character_limit => 140, :tags => ["tag1", "tag2"]}
-resource_source_string.update(params)
-```
-
-### Resource Statistics
-
-It allow you to retrieve some transifex stats about a resource.
-
-#### Instantiation
-
-```ruby
-resource_stats = project_resource.statistics
-```
-
-#### Fetch
-
-You can fetch the statistics:
-
-Of all the the resource languages:
-
-```ruby
-resource_stats.fetch
-```
-
-Of a specified language:
-
-```ruby
-resource_stats.fetch('en')
-```
-
-
-## Contributing
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+# Transifex::Interface::Ruby
+
+This gem is designed to interact easily with the Transifex API. You can perform all the actions allowed by the API. Documentation located here : http://docs.transifex.com/developer/api/
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'transifex-interface-ruby'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install transifex-interface-ruby
+
+## Usage
+
+### Initialization
+
+To initialize the gem, you will have to create an initializer like follow:
+
+```ruby
+Transifex.configure do |c|
+  c.client_login = 'your_client_login'
+  c.client_secret = 'your_secret'    
+end
+```
+Then restart the server.
+
+If you don't do this you will end up with the following error:
+
+```ruby
+#<Transifex::TransifexError: Authorization Required>
+```
+
+### Formats
+
+It represents all the formats available on Transifex:
+
+```ruby
+Transifex::Formats.fetch
+```
+
+### Languages
+
+It represents all the languages available on Transifex:
+
+#### Fetch
+
+You can fetch all the languages:
+
+```ruby
+Transifex::Languages.fetch
+```
+
+Or specify a language:
+
+```ruby
+Transifex::Languages.fetch('en')
+```
+
+### Projects (to fetch all projects and create a new one)
+
+#### Fetch
+
+To fetch all the projects owned by the account specified in the initializer:
+
+```ruby
+Transifex::Projects.fetch
+```
+
+#### Create
+
+To create a new project, you can proceed as following:
+
+For a private project:
+
+```ruby
+private_project_params = {:slug => "private_project", :name => "Private Project", :description => "description", :source_language_code => "en", :private => true}
+
+Transifex::Projects.create(private_project_params)
+```
+For a public project:
+
+```ruby
+public_project_params = {:slug => "public_project", :name => "Public Project", :description => "description", :source_language_code => "en", :repository_url => "http://example.com"}
+
+Transifex::Projects.create(public_project_params)
+```
+
+The complete list of the allowed parameters is located in the Transifex documentation.
+
+### Project (symbolize an existing project)
+
+#### Instantiation 
+
+```ruby
+transifex_project = Transifex::Project.new('project_slug')
+```
+or 
+
+```ruby
+transifex_project = Transifex::Projects.create(params) 
+```
+#### Fetch
+
+You can fetch the project informations from transifex:
+
+```ruby
+transifex_project_informations = transifex_project.fetch
+```
+
+with more details:
+
+```ruby
+transifex_project_informations = transifex_project.fetch_with_details
+```
+
+#### Update
+
+You can update the project: (see documentation for available fields)
+
+```ruby
+transifex_project.update({:description => "new description"})
+```
+#### Destroy
+
+You can destroy a project:
+
+```ruby
+transifex_project.delete
+```
+
+### Project Languages ( to fetch all languages of a project and create a new one)
+
+
+#### Instantiation
+
+```ruby
+project_languages = transifex_project.languages
+```
+
+#### Fetch
+
+You can retrieve informations about all the languages of a project:
+
+```ruby
+project_languages.fetch
+```
+
+#### Create
+
+You can create a new language for a project:
+
+```ruby
+params = {:language_code => "el", :coordinators => ['username']}
+project_languages.create(params)
+```
+
+### Project Language (Symbolize a single language of a project)
+
+#### Instantiation
+
+```ruby
+project_language = transifex_project.language('en')
+```
+
+#### Fetch
+
+You can retrieve informations for a project's specified language:
+
+```ruby
+project_language.fetch
+```
+
+with details:
+
+```ruby
+project_language.fetch_with_details
+```
+
+#### Update
+
+You can update the information of a project's specified language:
+
+```ruby
+params = {:coordinators => ['username1', 'username2'], :translators => ['username'], :reviewers => ['username']}
+project_language.update(params)
+```
+
+#### Delete
+
+You can delete a project's specified language:
+
+```ruby
+project_language.delete
+```
+
+### Project language management
+
+You have access to the differents teams of a language: coordinators, reviewers and translators.
+
+#### Instantiation:
+
+```ruby
+project_language_coordinators_team = project_language.coordinators
+project_language_reviewers_team = project_language.reviewers
+project_language_translators_team = project_language.translators
+```
+
+#### Fetch
+
+```ruby
+project_language_xxx_team.fetch
+```
+
+#### Update
+
+```ruby
+project_language_xxx_team.update(['username1', 'username2'])
+```
+
+### Resources ( to fetch all resources of a project and create a new one)
+
+First, instantiate a project (see Project/instantiation)
+
+#### Fetch
+
+You can fetch all the resources of projects:
+
+```ruby
+transifex_project.resources.fetch
+```
+
+#### Create
+
+You can create a new resource for the specified project:
+
+Without a file (you have to send the content as a string) :
+
+```ruby
+params = {:slug => "resource_slug", :name => "Resource created with content as a string", :i18n_type => "TXT", :content => "test"}
+transifex_project.resources.create(params)
+```
+
+With a file: (YAML currently supported)
+
+```ruby
+params = {:slug => "resource_slug", :name => "Resource created with a file", :i18n_type => "YAML", :content => 'path/to/your/file.yml'}
+options = {:trad_from_file => true}
+transifex_project.resources.create(params, options)
+```
+
+### Resource (Symbolize a single resource of a project)
+
+#### Instantiation
+
+You can instantiate a resource as follow:
+
+```ruby
+project_resource = transifex_project.resource("resource_slug")
+```
+
+#### Fetch
+
+You can retrieve informations of the specified resource:
+
+```ruby
+project_resource.fetch
+```
+with more details:
+
+```ruby
+project_resource.fetch_with_details
+```
+
+#### Update
+
+You can update a resource: (see documentation for allowed fields)
+
+```ruby
+project_resource.update({name: "new_name", categories: ["cat1", "cat2"]})
+```
+
+#### Delete
+
+You can delete the specified resource:
+
+```ruby
+project_resource.delete
+```
+
+### Resource Content ( Source language content)
+
+You can manage the resource's source language 
+
+#### Fetch
+
+You can retrieve the source language content:
+
+As a hash: (content is encoded as a string)
+
+```ruby
+project_resource.content.fetch
+```
+
+Or as a file
+Here for a YAML file:
+
+```ruby
+project_resource.content.fetch_with_file("path/where/file/will/be/saved.yml")
+```
+The source language content will be copied in the specified file.
+
+#### Update
+
+You can update the source language content (add new traductions for example):
+Attention: the source language content will be overrided.
+
+You must update the source language content with the same method used to create the resource.
+
+So if you used a YAML file, you must provide a new YAML file.
+
+With the content as a string:
+
+```ruby
+project_resource.content.update({:i18n_type => "TXT", :content => 'new_content'})
+```
+
+With a file:
+
+```ruby
+params = {:i18n_type => "YAML", :content => 'path/to/your/file.yml'}
+options = {:trad_from_file => true}
+project_resource.content.update(params, options)
+```
+
+### Resource Translations
+
+The following will explain how you can fetch the different translations of a resource and update them.
+
+You have to specify the language you want to work on.
+For example to work on the english translation:
+
+```ruby
+resource_translation = project_resource.translation('en')
+```
+
+#### Fetch
+
+You can fetch the translation content of a resource:
+
+As a Hash: (content encoded as a string)
+
+```ruby
+resource_translation.fetch
+```
+
+As a file: (file saved to the specified location)
+
+```ruby
+options = {:path_to_file => path_to_file}
+resource_translation.fetch_with_file(options)
+```
+
+You can use some options (as defined in the transifex documentations)
+
+For example to retrieve only reviewed translations:
+
+```ruby
+options = {:path_to_file => path_to_file, :mode => "reviewed"}
+resource_translation.fetch_with_file(options)
+```
+
+#### Update
+
+You can update the translation content:
+
+```ruby
+options = {:i18n_type => "YAML", :content => "/path/to/the/file/to/upload.yml"}
+resource_translation.update(options)
+```
+
+### Resource Translations Strings
+
+Resource translations strings allow you to retrieve meta-informations about translations strings (translation key, context, content, and so on)
+
+#### Instantiation
+
+```ruby
+resource_translation_strings = resource_translation.strings
+```
+
+#### Fetch
+
+You can fetch informations of all the strings of a translation:
+
+```ruby
+resource_translation_strings.fetch
+```
+
+With details:
+
+```ruby
+resource_translation_strings.fetch_with_details
+```
+
+You can specify a key and/or a context to search a particular string
+
+```ruby
+options = {:key => "welcome", :context => "context"}
+resource_translation_strings.fetch_with_details(options)
+```
+
+#### Update
+
+You can update some informations of a translation string (see documentation for available fields):
+
+You must specify at least the key of the translation, and can add a context(by default empty).
+
+```ruby
+params = {:key => "welcome", :context => "", :translation => "new_translation"}
+resource_translation_strings.update(params)
+```
+### Resource Translations String (Symbolize a single string)
+
+#### Instantiation
+
+Context is empty by default.
+
+```ruby
+resource_translation_string = resource_translation.string(key, context)
+```
+
+#### Fetch
+
+You can fetch the informations about the specified string:
+
+```ruby
+resource_translation_string.fetch
+```
+
+#### Update
+
+You can update the informations of the specified string: (available fields in the documentation)
+
+```ruby
+params = {:reviewed => true, :translation => "new translation"}
+resource_translation_string.update(params)
+```
+
+### Resource Source String 
+
+It allow you to retrieve meta-data on a source language string and update them.
+
+#### Instantiation
+
+Context is empty by default.
+
+```ruby
+resource_source_string = project_resource.source('key', 'context')
+```
+
+#### Fetch
+
+You can fetch meta-data about the specified source string:
+
+```ruby
+resource_source_string.fetch
+```
+
+#### Update
+
+You can update the meta-data of the specified source string
+
+```ruby
+params = {:comment => "my comment", :character_limit => 140, :tags => ["tag1", "tag2"]}
+resource_source_string.update(params)
+```
+
+### Resource Statistics
+
+It allow you to retrieve some transifex stats about a resource.
+
+#### Instantiation
+
+```ruby
+resource_stats = project_resource.statistics
+```
+
+#### Fetch
+
+You can fetch the statistics:
+
+Of all the the resource languages:
+
+```ruby
+resource_stats.fetch
+```
+
+Of a specified language:
+
+```ruby
+resource_stats.fetch('en')
+```
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request