NAME

CPAN::Testers::Reports::Query::JSON - Find out about a distributions cpantesters results

SYNOPSIS

  my $dist_query = CPAN::Testers::Reports::Query::JSON->new(
      {   distribution => 'Data::Pageset',
          version => '1.01',    # optional, will default to latest version
      }
  );

  print "Processing version: " . $dist_query->version() . "\n";
  print "Other versions are: " . join(" ", @{$dist_query->versions()}) . "\n";

  my $all = $dist_query->all();
  printf "There were %s tests, %s passed, %s failed - e.g. %s percent",
      $all->total_tests(),
      $all->number_passed(),
      $all->number_failed(),
      $all->percent_passed();

  my $win32_only = $dist_query->win32_only();
  printf "There were %s windows tests, %s passed, %s failed - e.g. %s percent",
      $win32_only->total_tests(),
      $win32_only->number_passed(),
      $win32_only->number_failed(),
      $win32_only->percent_passed();

  my $non_win32 = $dist_query->non_win32();
  printf "There were %s windows tests, %s passed, %s failed - e.g. %s percent",
      $non_win32->total_tests(),
      $non_win32->number_passed(),
      $non_win32->number_failed(),
      $non_win32->percent_passed();
      
  # Get results for a specific OS
  my $specific_os = $dist_query->for_os('linux');

DESCRIPTION

This module queries the cpantesters website (via the JSON interface) and gets the test results back, it then parses these to answer a few simple questions.

This module only reports on versions of Perl which are unpatched.

all()

Get stats on all tests, returns a CPAN::Testers::Reports::Query::JSON::Set object.

win32_only()

Returns a CPAN::Testers::Reports::Query::JSON::Set object for win32 only test results. 'MSWin32' and 'cygwin' are osnames.

non_win32()

Non windows, returns a CPAN::Testers::Reports::Query::JSON::Set object.

for_os()

my $report = $dist_query->for_os('linux');

Returns a CPAN::Testers::Reports::Query::JSON::Set object for the specified OS.

current_version()

my $current_version = $query->current_version();

Returns the latest version available

AUTHOR

Leo Lapworth, LLAP@cuckoo.org

BUGS

None that I'm aware of - export may not encode correctly.

Repository (git)

http://github.com/ranguard/cpan-testers-reports-query-json, git://github.com/ranguard/cpan-testers-reports-query-json.git

COPYRIGHT

Copyright (c) Leo Lapworth. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.