buildr

Un outil de buildr moderne, puissant et efficace

Montre-moi ton build, je te dirai comment se porte ton projet.

• Jean-Philippe Caruana
• Orange - Multimedia Business Services
• http://buildr.barreverte.fr/

Aujourd'hui

• on va parler de build
• on va voir du code (un peu)
• j'espère vous donner envie d'essayer buildr
• ... et de l'adopter

Les outils de build

Maven

• les apports positifs :-)
  • standardisation (sources, repos, goals)
  • très répandu
• le côté sombre :-(
  • lent
  • XML
  • boîte noire
  • difficile à étendre
  • build non incrémental
  • en fait un peu trop (archetypes, site)

Comparatif objectif : quelques commandes

maven	buildr
mvn eclipse:eclipse	buildr eclipse
mvn package -Dmaven.test.skip=true	buildr package test=no
mvn test -Dtest=MonTest	buildr test=MonTest
maven test:match -Dmaven.test.match="*MonTest*"

Comparatif objectif : quelques chiffres

	maven 1	buildr
Projet Condor : SLOC	1053	750
Projet Condor : nombre de fichiers	43	1
Projet Condor : temps de build total	12 min	2 min 30
Projet AVSP : SLOC	19183	878
Projet AVSP : nombre fichiers	188	2
Projet AVSP : temps de build total	difficile à estimer, mais aux environs de la 1/2h	7 min
Projet AVSP : temps pour faire une release	un binome pendant 1/2 journée (avec erreurs)	5 min (safe)

Témoignages sur Internet : nombre de lignes de code

maven2 ou ant	buildr
4652	698
768	28

VERSION_NUMBER = "1.0.0-SNAPSHOT"
GROUP = 'barreverte.fr'
COPYRIGHT = 'Barre Verte !'

repositories.remote << 'http://www.ibiblio.org/maven2/'

desc 'présentation buildr'
define 'exemple' do
  project.version = VERSION_NUMBER
  project.group = GROUP

  compile.using :target=>'1.5', :other=>['-encoding', 'ISO8859_1'], :deprecation=>false, :debug=>true

  desc 'la lib A'
  define 'A' do
    package :jar
  end

  desc 'la lib B'
  define 'B' do
    compile.with project('A')
    package :jar
  end

  desc 'la lib D'
  define 'D' do
    package :jar
  end

  desc 'mon livrable final'
  define 'C' do
    compile.with projects('A', 'B', 'D')
    package :war
  end
end 

exemples

• ajouter des dépendances :

  desc 'infrastructure commune'
  define 'commons' do
    compile.with LOG4J, MYSQL, SERVLET_API, COMMONS_LANG, XSTREAM
    test.with JDOM, 'jspapi:jsp-api:jar:2.0', MOCKRUNNER, SPRING, SPRING_MOCK, MOCKITO, FEST
    package :jar
  end 

• grouper des dépendances :

  SPRING_DAO = Buildr::group('spring-beans', 'spring-core', 'spring-dao', 'spring-jdbc',
    :under=>'org.springframework', :version=>'1.2.6') 

• sortir du standard maven2/buildr :

  test.resources.from _(:src, :test, :data) 

• archive dans un format spécifique :

  lib_generee = package :jar
  livrable = package :tgz
  livrable.include _('src/main/batch'), :as=>'batch' 
  livrable.path('batch/lib').include lib_generee, compile.dependencies 

• faire des asserts sur les binaires :

  check livrable, "doit embarquer le jar scala-library. Merci de verifier si votre 
  $SCALA_HOME pointe bien vers un répertoire valide" do
    it.should contain('batch/lib/scala-library.jar')
  end 

• des droits de fichiers spécifiques :

  chmod 0755, Dir[_('src/main/avsp-batch/bin/*')]
  chmod 0644, FileList[_('src/main/avsp-batch/etc/**/*.properties')] 

• dépendances entre taches rake

  task :fitnesse => [:prerequis_fitnesse, :fitnesse_wiki_seul] 

• intégration transparente avec les taches Ant :

  task :fitnesse_wiki_seul do |t|
    ant(t.name) do |ant|
      ant.taskdef :name=>'start_fitnesse', :classname=>'fitnesse.ant.StartFitnesseTask',
  :classpath=>FITNESSE_JAR
      ant.start_fitnesse :wikidirectoryrootpath=>_('src/main'), :fitnesseport=>8082 
    end
  end 

• plusieurs jars en un seul :

  bouchons = package :jar, :file=>_('target/bouchons.jar')
  bouchons.merge artifacts(COMMONS_HTTPCLIENT, COMMONS_LANG, LOG4J, project('commons-test')) 

• ajouter des taches ant avant une commande buildr :

  compile.enhance ['ma_jolie_tache_ant'] 

• setup de tests :

  test.setup { Rake::Task['une_belle_tache_rake'].execute } 

• personaliser le fichier manifest :

  manifest['Implementation-Version'] = project.version
  manifest['Copyright']              = COPYRIGHT
  manifest['Mon-Champ-Personalise']  = TOUTE_AUTRE_VALEUR 

• paramétrer les repositories maven2 :

  repositories.remote << 'http://www.ibiblio.org/maven2/'
  repositories.remote << 'http://mirrors.ibiblio.org/pub/mirrors/maven2'
  repositories.remote << 'http://maven01b.serveur:8081/nexus/content/groups/public'
  repositories.release_to = { :url=>'sftp://maven01b.serveur:/var/maven-projets/maven',
    :username=>'robert.johnson', :password=>'Xroads' } 

Les défauts de buildr

• installation difficile (gems)
• très réactif / moins stable
• nécessité de traduire les artifacts maven
• peu adopté

Les voisins

buildr, build like you code

• Gradle : a better way to build (http://www.gradle.org/)
• sbt : a simple build tool for Scala projects (http://code.google.com/p/simple-build-tool/)

Références

• le site officiel : buildr.apache.org
• Martin Fowler "DSL for builds"
• Why I don't like maven
• Why I don't use maven
• cette présentation : buildr.barreverte.fr et sur github