NAME

Test::Smoke::Fact::SmokeID - The run environment for a Test::Smoke report

SYNOPSIS

  my $fact = Test::Smoke::Fact::SmokeID->new (
      resource => "http://perl5.git.perl.org/perl.git/8c576062",
      content  => {
          git_id       => "8c57606294f48eb065dff03f7ffefc1e4e2cdce4",
	  perl_id      => "5.12.2-RC4",
	  hostname     => "smokebox",
	  architecture => "PA-RISC2.0/64/2 cpu",
	  osname       => "HP-UX",
	  osversion    => "11.31",
	  cc           => "cc",
	  ccversion    => "B3910B",
	  parallel     => 1,
	  user         => "tux",
	  smoke_date   => "2010-05-28 12:13:14 +01",
	  },
      );

DESCRIPTION

These facts identify a smoke. With this ID, one should be able to find all other facts that belong to a single smoke run.

git_id

This item describes the long form of the git SHA1 hash id of the perl checkout that is being smoked.

e.g. "8c57606294f48eb065dff03f7ffefc1e4e2cdce4"
perl_id

This item describes the perl version (or tag) of the perl checkout that is being smoked.

e.g. "5.12.2-RC4"
hostname

This item describes the host name of the machine on which the smoke runs.

e.g. "smokebox"
architecture

This item describes, as completely as possible, the architecture of the system on which the smoke runs.

e.g. "PA-RISC2.0/64/2 cpu"

This information is an aggregation of what Test::Smoke was able to gather, in above example, a PA-RISC 2.0 64bit architecture with 2 CPU's. The format of this information in not normalized across architectures, it just joins all information found.

osname

This item describes the Operating system name, which is not guaranteed to be the same as $^O.

e.g. "HP-UX"
osversion

This item describes the operating system version.

e.g. "11.31"
cc

This item describes the name of the C-compiler used for this smoke. It does not tell anything about the identity of the compiler.

e.g. "cc"
ccversion

This item describes the version of the C-compiler

e.g. "B3910B"
parallel

This item (a boolean) indicates that the core tests are run in parallel. This was done by passing some -j# option to Test::Harness.

user

This item describes the name of the user who ran the smoke.

e.g. "tux"
smoke_date

This item describes the date (and time), preferably in ISO norm.

e.g. "2010-05-28T12:13:14+01"
smoke_id

This item should be a MD5 hash of the above items, but it is possible to pass one. Unless one is passed, it is automatically generated.

SEE ALSO

Test::Smoke, Test::Smoke::Metabase, Metabase::Fact. Metabase::Fact::Hash.

AUTHOR

H.Merijn Brand

COPYRIGHT AND LICENSE

Copyright (c) 2010 by H.Merijn Brand

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.