OSMBtranstats é o nome deste projeto que organiza-se em volta do script get_stats.rb
e do arquivo de configurações config.yml. Quer significar "OpenStreetMap Brazil/Basic Translations's Statistics". São estatísticas básicas de traduções de software na comunidade OpenStreetMap Brasil.
O uso do script reduz o tempo de manutenção da página wiki de situação das traduções brasileiras a alguns segundos ou menos de dois minutos, dependendo da qualidade da conexão à Internet.
Intenções que estão colocadas de lado mas são facilmente realizáveis: internacionalionalizar o projeto, com algumas pequenas alterações no código (que hoje recebe/trata apenas pt-br, pt_BR ou pt), possibilitando que comunidades de outros países o reutilizem.
- Git, para baixar os arquivos com mais praticidade
- Ruby, a linguagem de programação
- Bundler, para empacotar alguma dependência
- Bibliotecas de software
- transifex-ruby, lib para autenticar e colher dados no Transifex
- nokogiri, lib para colher dados em páginas HTML
- yamldiff, lib que extendemos para contar diferenças entre arquivos YAML
Não é exatamente "instalação". Só das dependências, e colocar os arquivos num diretório.
No Ubuntu
$ sudo apt-get install git
$ sudo apt-get install ruby ruby-nokogiri
$ sudo apt-get install bundler
$ cd TEMP_DIR/
$ git clone https://github.com/tmaesaka/transifex-ruby.git
$ cd transifex-ruby
$ gem build transifex-ruby.gemspec
$ sudo gem install transifex-ruby-0.0.4.gem
$ cd TEMP_DIR/
$ git clone https://github.com/alexandre-mbm/yamldiff.git
$ cd yamldiff
$ bundle
$ gem build yamldiff.gemspec
$ sudo gem install yamldiff-0.0.10.gem
$ cd ~
$ https://github.com/OSMBrasil/OSMBtranstats.git
$ cd OSMBtranstats
Rotina pensada para Ubuntu 14.04 LTS mas não testada.
No Windows
- Instale Git para Windows: msysGit
- Instale Ruby no Windows: RubyInstaller
- Siga as dicas para a instalação dos gems necessários
- Este ambiente está validado, tendo sido o berço do projeto
-
Configure o config.yml com suas credenciais Transifex
-
Execute
$ ruby get_stats.rb > stats.txt
-
Copie o conteúdo de stats.txt para edição de WikiProject Brazil/Traduções/Situação
-
Revise as alterações e salve a página
Dedicamos esta ferramenta ao domínio público através de CCO 1.0 (arquivo LICENSE).
Nossas três dependências diretas são liberadas sob a Expat License, também conhecida ambiguamente como MIT License; existe mais de uma "licença do MIT".
Ruby 2.x está sob licença dupla: Ruby License / FreeBSD License (conhecida como 2-clause BSDL).
Bundler é ferramenta disponibilizada sob a Expat License.