Minha idéia é ir postando os conteúdos na medida que eu vou evoluindo nos estudo do Rails. Assim quem quizer aprender é só seguir os posts. Bom vamos ver se isso vai dar certo.

Mas vamos ao que interessa!

Bom, digitamos no Terminal o comando: rails NomeDoProjeto, e o resultado é

README
Rakefile
app/
config/
db/
doc/
lib/
log/
public/
script/
test/
tmp/
vendor/

É sobre essa organização de pastas que vamos falar hoje.

README – arquivo com instruções de uso;
Rakefile – script de construção;
app/ – Dentro dessa pasta estão os arquivos da estrutura MVC – (Model, View e Controller);
components/ – componentes reutilizáveis;
config/ – parâmetros de configurações tanto do projeto quanto do banco de dados;
db/ – Informações sobre o esquema e as migrations geradas para modificar o banco de dados;
doc/ – Documentação auto gerada, utilizando o Rdoc,
lib/ – Código compartilhado códigos que não podemos adicionar a uma um modelo, view ou controller, algo como um gerador de arquivos pdf.
log/ – documentos de log produzidos pelo seu aplicativo;
public/ – Diretório acessível pela Web. É a pasta onde o HTTP server utiliza pra rodar o seu aplicativo;
script/ – Scripts utilitários, onde estão os programas utilizados pelos desenvolvedores Rails, para entede-los você pode executalos sem nenhum argumento, você obterá informações sobre de uso;
test/ – Utilitários de testes, onde escrevemos os teste funcionais, testes de integração, fixtures e simulações;
tmp/ – Arquivos temporários utilizados e gerados em tempo de execução do seu aplicativo;
vendor/ – Código importado onde você irá por os seus plugins utilizados pela aplicação, código de terceiros.

As pastas app/ e test/ é onde fica quase toda a nossa aplicação, é onde mais iremos trabalhar!

Bom hoje é isso. Acho que com isso conseguimos ver com outros olhos toda a estrutura de pastas criada automaticamente pelo Rails. Nos próximos posts vou detalhar mais cada uma destas pastas falando dos seus arquivos internos.

Fiz a instalação em vários Mac`s diferentes até chegar nesse tutorial, pra validar refiz em outro Mac no trabalho. Ao todo foram 4 instalações em 4 Mac`s diferentes, em ambientes totalmente diferentes, com proxy, sem proxy, mini Mac, iMac e Macbook. Espero que você não tenha problemas, se tiver é só comentar o post que retorno.

Caso você já instalou o MySQL e o Xcode então vamos ao que interessa.

Primeiro é atualizar o Gem, que é o gerenciados de pacotes do Ruby. Pra ilustrar abaixo estão as versões que acompanham o Leopard.

Você deve ter notado, a instalação do Ruby on Rails é feita no Terminal.
Para iniciar a instalação precisamos ter permissões root, o comando sudo sh resolve essa questão:

sudo sh

Ele vai pedir a senha, dai você se pergunta: que senha? É a mesma senha do seu usuário, mas não pode ser em branco, caso sua senha esteja em branco, defina uma em System Preferences -> Accounts. Não esqueça que o seu usuário tem que pertencer ao grupo Admin, caso não pertença é preciso acessar o Mac com um ususário que pertença.

Agora sim, com a senha definida, vamos ao Terminal e digitamos: sudo sh

 sudo sh

Vamos atualizar o gem utilizando o comando gem update –system

 gem update --system

Quando fiz esses printscreen eu estava no trabalho, lá para acessar a Internet precisamos autenticar no proxy a primeira linha do print abaixo faz isso, diz pro sistema pra quando acessar algum conteúdo utilizando o protocolo HTTP efetue essa requisição utilizando o proxy, esse comando eu utilizo no Linux toda a vez que preciso atualizar algum pacote ao baixar algum arquivo utilizando o wget, como o Leopard é irmão do Linux não custa garantir.

Se você não estiver em uma rede que precise se autenticar no proxy pra acessar a Internet esqueça isso, caso esse seja o seu caso não custa ter 100% de certeza configurando as opções de Proxy em System Preferences -> Network -> Sua Conexão -> Advanced -> Proxies.

Vai apararecer na sua tela algo parecido com o print abaixo.

Digitando gem -v e rails -v validamos se foi atualizado com sucesso.

gem -v
ruby -v

Agora é a vez do Rails, para instalar o Rails pedimos para o Gem agora atualizado instalar utilizando o comando

 gem install rails --include-dependencies

Pronto, pra validar é só digitar o comando rails -v

 rails -v

Agora precisamos instalar o suporte do Ruby ao MySQL, esse comando é um pouco mais extenso:

 env ARCHFLAGS="-arch i386" gem install mysql -- --with-mysql-config=/usr/local/mysql/bin/mysql_config

Pronto, Gem e Ruby atualizados e Rails e suporte do Ruby pro MySQL instalados, para testes vamos criar nossa primeiro projeto:

 rails FirstRailsApp --database=mysql

Vai aparecer na tela o seguinte

Vamos entrar na pasta do projeto cd FirstRailsApp e iniciar o servidor Web para ver se está funcionando.

cd FirstRailsApp
script/server

Que tal ver se funcionou? Abra o seu navegador e acesse http://localhost:3000 irá aparecer o seguinte conteúdo

Se quizer testar se a conexão com o banco está ok, precisamos antes configurar o arquivo database.yml que está dentro da pasta config do seu projeto (config/database.yml).

development:
  adapter: mysql
  encoding: utf8
  database: FirstRailsApp_development
  pool: 5
  username: root
  password:
  socket: /tmp/mysql.sock

# Warning: The database defined as "test" will be erased and
# re-generated from your development database when you run "rake".
# Do not set this db to the same as development or production.
test:
  adapter: mysql
  encoding: utf8
  database: FirstRailsApp_test
  pool: 5
  username: root
  password:
  socket: /tmp/mysql.sock

production:
  adapter: mysql
  encoding: utf8
  database: FirstRailsApp_production
  pool: 5
  username: root
  password:
  socket: /tmp/mysql.sock

Após configurado crie o database no MySQL utilizando por exemplo o MySQL Query Browser ou a sua ferramenta favorita.
Para testar o acesso ao banco digite rake db:migrate, ele irá tentar conectar com o banco e verificar se existe a base definida no arquivo de configuração.

rake db:migrate

Pronto, ambiente praparado.

Agora vamos revisar o nosso trabalho.

• Atualizar o gerenciador de pacotes nativo do Leopard e com ele o Ruby
• Instalar o Rails
• Instalar o suporte do Ruby pro MySQL direcionando o arquivo de configuração do MySQL
• Testar montando um projeto Rails

Resumo dos comandos – Indo direto ao ponto

Versões instaladas.

gem -v
ruby -v

Atualizando versões e instalando o Rails e suporte ao MySQL do Ruby

sudo sh
gem update --system
gem install rails --include-dependencies
env ARCHFLAGS="-arch i386" gem install mysql -- --with-mysql-config=/usr/local/mysql/bin/mysql_config

Versões finais

gem -v
ruby -v
rails -v

Testando

rails FirstRailsApp --database-mysql
cd FirstRailsApp
rake db:migrate
script/server

Ver conteúdo no endereço: http://localhost:3000

Você deve estar se perguntando por que instalar o MySQL sozinho se existem combinações do tipo MySQL + Apache e PHP. Vou explicar o porquê. Você lembra daqueles modelos de televisores que vinham com o vídeocassete junto, conhecidos como duetos, existem hoje uns que vem com o DVD acoplado. Quando acontece alguma coisa com o seu televisor e você precisa levar pra alguma assistência técnica pra arrumar, você fica sem o videocassete, caso dê problema no seu videocassete e você precise fazer a mesma coisa, você fica sem o televisor, sendo mais claro, a combinação é muito útil quando pensamos em praticidade e facilidade de uso, mas quando paramos pra pensar em manutenção, configurações e personalizações ficamos muitos amarrados. Outro motivo seria, o Mac já possui por padrão o Apache, porque instalar outro se já possuímos um? Dois Apaches na maquina? Por esses motivos prefiro trabalha com meus serviços não agrupados, em troca de um maior nível de flexibilidade e personalização.

Mas isso não o impede de ignorar esse tutorial e baixar o MAMP, mas se o caso não for esse vamos iniciar a instalação do MySQL?

Para instalar o MySQL precisamos fazer o download da última versão estável disponível no site. http://dev.mysql.com/downloads/mysql/5.1.html#macosx-dmg

Baixar a opção Packager Formated – Mac OSX 10.5 (Leopard)
se você utiliza o Tiger baixar a opção Packager Formated – Mac OSX 10.4

Escolher o Mirror para download.

Montar o dmg e executar o arquivo X.X.X-osx10.X-x86.dmg
no meu caso mysql-5.1.30-osx10.5-x86.dmg
(este é o arquivo de instalação do MySQL).

Obs: Caso você utilize algum programa
com a famosa combinação AMP (Apache + MySQL e PHP)
como por exemplo o MAMP,
não esqueça de parar os servidores.

Seguir os seguintes passos no estilo NNF (Next-Next-Finish)

Instalar o MySQL Preference Pane.
É um utilitário que fica no System Preferences
que inicia e para o MySQL e configura a inicialização automática.
O nome do arquivo é MySQL.prefPane.

Deseja disponibilizar o Preference Pane
para todos os usuários?

Feito isso é só clicar em “Start MySQL Server”.

O usuário default é root sem senha.

O MySQL é bem intuitivo, não tem segredo, coloquei os prints das janelas pois não tem muito o que comentar, a instalação é simples e direta. Alguma dúvida comente o post que eu retorno.

Para ajudar o seu trabalho podemos baixar o PhpMyAdmin, ou bem mais fácil podemos baixar o MySQL Admin no link http://dev.mysql.com/downloads/gui-tools/5.0.html

O propósito do Rails é tornar mais fácil desenvolver, instalar e mantes aplicativos Web, utilizam a arquitetura MVC, alé disso, quando se cria um projeto Rails, ele automaticamente cria todo o “esqueleto”, relacionei essa estrutura, quando utilizamos um framework tipo Code Igniter pro PHP, após “deszipar” o arquivo do Code Igniter, surge toda uma estrutura, a única diferença é que no Rails essa estrutura é criada em tempo real. O Rails cria automaticamente programas temporários de testes “stubs”para as novas funcionalidades que vão sendo adicionadas.

Rails utiliza também alguns outros conceitos: DRY – Don’t Repeat Yourself – Não se Repita – que emprega que todo conhecimento de um sistema deve ser escrito em um único determinado local, ORM – Object-Relational Mapping, que utiliza as tabelas do banco de dados para definir os models, não há a necessidade de escrever um model, eles automaticamente são mapeados para as classes, suas linhas para objetos e suas colunas para atributos, portanto quando modificamos um banco automaticamente isso é refletido para a aplicação, Convention over configuration – essa convenção diz basicamente que deve-se assumir valores padrão onde existe uma convenção.

Uma coisa que achei bem interessante são os migrations, todas as modificações no banco de dados são documentadas pelo Rails, na verdade as modificações são escritas no Rails e ele mesmo as executa no banco de dados, há um controle sobre as modificações no banco, podendo ser aplicadas em outro banco com por exemplo a deploy da aplicação ou até mesmo desfazer uma modificação.
Suporte integrado ao AJAX e RESTful.

Tudo isso e muito mais é resultado da combinação de 5 componentes:

• Active Record – mapeamento objeto-relacional (Model do MVC);
• Action Pack – compreende o Action-view e o Action-Controller (Visão e Controller do MVC);
• Action Mailer – suporte a envio de recebimento de e-mails;
• Active Support – coleção de classes e extensões;
• Action Webservices – implementa WSDL e SOAP;

O discurso dos evangelistas do Rails me lembra muito os designers da Apple, a história do “Estado da Arte”, que é a busca constante pela simplicidade, praticidade, design, perfeição, facilidade. Até onde estão os meus estudos o Rails está suprindo muito bem essas espectativas, é claro que como qualquer outra linguagem de programação é possível escrever um código sujo, mas garanto que ela facilita muito as boas práticas, ela dá suporte a diversos gems que automatizam determinados processos e diversos plugins que expandem as funcionalidades da sua aplicação sem muito esforço.

Caso esteja interessado em iniciar seus estudo também segue algumas dicas:

Livro: Desenvolvimento Web Ágil com Rails – Link Saraiva – foi o livro que comprei.

Podcast: Podcast Ruby on Rails Brasil com Fábio Akita e Carlos Eduardo Brando – só não espere escutar somente coisas sobre Rails, os caras são sinistros, os assuntos vão de Cloud Computing a Compiladores, de Jruby a Rails! Muuuito bom mesmo (Open Your Mind). Estou fazendo uma sessão Rails Podcast Brasil, escutando todos desde o início.

Blogs em pt-BR: http://akitaonrails.com do Fábio Akita e http://www.nomedojogo.com Carlos Brando – estão sendo as minhas referências de Ruby on Rails.

Bom sobre Rails hoje é só, vou postar mais coisas com o desenrolar dos estudos.

Com relação ao Streaming, estamos finalizando outra etapa do projeto, estou preparando um Screencast junto com o pessoal que está participando do projeto comigo.