Adding More Jobs

{"header":{"message":"doc: Write \"Adding More Jobs\".","description":null,"timestamp":"2011-10-12T14:54:20Z","authors":[{"email":"ludo@gnu.org","name":"Ludovic Courtès"}]},"hash":"LW755CJKCIPO7NR7D5TP5WZNGCP5UWLBMA7KJXMHJEB6XIJJGO3QC","authors":[],"deps":{"hashes":[["LW755CJKCIPO7NR7D5TP5WZNGCP5UWLBMA7KJXMHJEB6XIJJGO3QC","doc: Write \"Adding More Jobs\"."],["AA",null],["EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC","doc: Write \"Building from the Command Line\"."],["PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC","doc: Import the \"Creating Projects\" chapter by Visser & Dolstra."]],"deps":["EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC"],"known":[]},"hunks":[{"Edit":{"inode":{"change":4,"pos":114},"path":"doc/manual/projects.xml","line":416,"atom":{"NewVertex":{"up_context":[{"change":2,"pos":2121}],"down_context":[{"change":4,"pos":5239}],"flag":"BLOCK","start":0,"end":2246,"inode":{"change":4,"pos":114}}},"contents":[{"Add":" "},{"Add":""},{"Add":"

"},{"Add":" Adding More Jobs"},{"Add":""},{"Add":" "},{"Add":" illustrates how to write the most"},{"Add":" basic jobs, tarball and"},{"Add":" build. In practice, much more can be done by"},{"Add":" using features readily provided by Nixpkgs or by creating new jobs"},{"Add":" as customizations of existing jobs."},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" For instance, test coverage report for projects compiled with GCC"},{"Add":" can be automatically generated using the"},{"Add":" coverageAnalysis function provided by Nixpkgs"},{"Add":" instead of nixBuild. Back to our GNU Hello"},{"Add":" example, we can define a coverage job that"},{"Add":" produces an HTML code coverage report directly readable from the"},{"Add":" corresponding Hydra build page:"},{"Add":""},{"Add":" "},{"Add":" coverage ="},{"Add":" { tarball ? jobs.tarball {}"},{"Add":" , system ? builtins.currentSystem"},{"Add":" }:"},{"Add":""},{"Add":" let pkgs = import nixpkgs { inherit system; }; in"},{"Add":" pkgs.releaseTools.coverageAnalysis {"},{"Add":" name = \"hello\" ;"},{"Add":" src = tarball;"},{"Add":" configureFlags = [ \"--disable-silent-rules\" ];"},{"Add":" }; "},{"Add":""},{"Add":" As can be seen, the only difference compared to"},{"Add":" build is the use of"},{"Add":" coverageAnalysis."},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" Nixpkgs provides many more build tools, including the ability to"},{"Add":" run build in virtual machines, which can themselves run another"},{"Add":" GNU/Linux distribution, which allows for the creation of packages"},{"Add":" for these distributions. Please see the"},{"Add":" pkgs/build-support/release directory"},{"Add":" of Nixpkgs for more. The NixOS manual also contains information"},{"Add":" about whole-system testing in virtual machine."},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" Now, assume we want to build Hello with an old version of GCC, and"},{"Add":" with different configure flags. A new"},{"Add":" build_exotic job can be written that simply"},{"Add":" overrides the relevant arguments passed to"},{"Add":" nixBuild:"}]}},{"Edit":{"inode":{"change":4,"pos":114},"path":"doc/manual/projects.xml","line":474,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":5240}],"down_context":[{"change":4,"pos":5240}],"flag":"BLOCK","start":2247,"end":3340,"inode":{"change":4,"pos":114}}},"contents":[{"Add":" "},{"Add":" build_exotic ="},{"Add":" { tarball ? jobs.tarball {}"},{"Add":" , system ? builtins.currentSystem"},{"Add":" }:"},{"Add":""},{"Add":" let"},{"Add":" pkgs = import nixpkgs { inherit system; };"},{"Add":" build = jobs.build { inherit tarball system; };"},{"Add":" in"},{"Add":" pkgs.lib.overrideDerivation build (attrs: {"},{"Add":" buildInputs = [ pkgs.gcc33 ];"},{"Add":"\t preConfigure = \"gcc --version\";"},{"Add":"\t configureFlags ="},{"Add":"\t attrs.configureFlags ++ [ \"--disable-nls\" ];"},{"Add":" }); "},{"Add":""},{"Add":" The build_exotic job reuses"},{"Add":" build and overrides some of its arguments: it"},{"Add":" adds a dependency on GCC 3.3, a pre-configure phase that runs"},{"Add":" gcc --version, and adds the"},{"Add":" --disable-nls configure flags."},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" This customization mechanism is very powerful. For instance, it"},{"Add":" can be used to change the way Hello and all"},{"Add":" its dependencies–including the C library and compiler used to"},{"Add":" build it–are built. See the Nixpkgs manual for more."},{"Add":" "},{"Add":""}]}},{"Edit":{"inode":{"change":4,"pos":114},"path":"doc/manual/projects.xml","line":506,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":5253}],"down_context":[{"change":4,"pos":5253}],"flag":"BLOCK","start":3341,"end":3343,"inode":{"change":4,"pos":114}}},"contents":[{"Add":""},{"Add":""}]}}],"owner":"grahamc","repo":"hydra2","token":"j9uCV7S0AqYFF4E0bNQT7meKc0wXmT9xXdgO2B5fLN4=","login":null}

…

Dependencies

Change contents