En aquest tema, aprendrem a configurar un projecte de Ruby des de zero. Aquesta configuració és essencial per assegurar-nos que el nostre entorn de desenvolupament estigui preparat per a la implementació de funcionalitats, proves i desplegament. Seguint aquests passos, podrem establir una base sòlida per al nostre projecte final.

  1. Creació de l'Estructura del Projecte

Pas 1: Crear el Directori del Projecte

Primer, necessitem crear un directori per al nostre projecte. Això es pot fer des de la línia de comandes:

mkdir projecte_final
cd projecte_final

Pas 2: Inicialitzar un Repositori Git

És una bona pràctica utilitzar un sistema de control de versions com Git per gestionar el nostre codi. Inicialitzem un repositori Git dins del nostre directori del projecte:

git init

Pas 3: Crear l'Estructura de Carpetes

Creem les carpetes necessàries per organitzar el nostre projecte. Una estructura típica podria ser:

mkdir lib spec bin
  • lib: Contindrà els fitxers de codi font.
  • spec: Contindrà els fitxers de proves.
  • bin: Contindrà els scripts executables.

  1. Configuració del Fitxer Gemfile

El Gemfile és un fitxer que especifica les gemmes (llibreries) que el nostre projecte necessita. Creem un fitxer Gemfile a l'arrel del nostre projecte amb el següent contingut:

source 'https://rubygems.org'

gem 'rspec'
gem 'pry'
  • rspec: Per a les proves.
  • pry: Per a la depuració.

Pas 4: Instal·lar les Gemmes

Després de crear el Gemfile, instal·lem les gemmes especificades:

bundle install

  1. Configuració de RSpec

RSpec és una eina popular per a les proves en Ruby. Configurarem RSpec per al nostre projecte.

Pas 5: Inicialitzar RSpec

Inicialitzem RSpec dins del nostre projecte:

rspec --init

Això crearà dos fitxers:

  • .rspec: Configuració d'RSpec.
  • spec/spec_helper.rb: Fitxer de configuració per a les proves.

  1. Configuració de l'Entorn de Desenvolupament

Pas 6: Crear un Fitxer de Configuració

Podem crear un fitxer config/environment.rb per carregar totes les dependències i configurar l'entorn del nostre projecte:

# config/environment.rb

require 'bundler/setup'
Bundler.require(:default)

# Carregar tots els fitxers de la carpeta lib
Dir[File.join(__dir__, '../lib/**/*.rb')].each { |file| require file }

Pas 7: Crear un Fitxer Executable

Creem un fitxer executable a la carpeta bin per iniciar el nostre projecte:

# bin/start

#!/usr/bin/env ruby

require_relative '../config/environment'

puts "El projecte està configurat correctament!"

No oblidem donar permisos d'execució al fitxer:

chmod +x bin/start

  1. Prova de la Configuració

Pas 8: Executar el Fitxer Executable

Finalment, executem el fitxer start per assegurar-nos que tot està configurat correctament:

bin/start

Si tot està configurat correctament, hauríem de veure el missatge "El projecte està configurat correctament!".

Resum

En aquesta secció, hem après a configurar un projecte de Ruby des de zero. Hem creat l'estructura de carpetes, inicialitzat un repositori Git, configurat el Gemfile i instal·lat les gemmes necessàries. També hem configurat RSpec per a les proves i creat un fitxer executable per iniciar el projecte. Amb aquesta configuració, estem preparats per començar a implementar funcionalitats i desenvolupar el nostre projecte final.

© Copyright 2024. Tots els drets reservats