NAME

Test::Auto::Plugin

ABSTRACT

Test-Auto Plugin Class

SYNOPSIS

  package Test::Auto::Plugin::Example;

  use Test::More;

  use parent 'Test::Auto::Plugin';

  sub tests {
    my ($self, @args) = @_;

    subtest "testing example plugin", sub {

      ok 1;
    };

    return $self;
  }

  1;

DESCRIPTION

This package provides an abstract base class for creating Test::Auto plugins.

LIBRARIES

This package uses type constraints from:

Test::Auto::Types

ATTRIBUTES

This package has the following attributes:

subtests

  subtests(Subtests)

This attribute is read-only, accepts "(Subtests)" values, and is required.

METHODS

This package implements the following methods:

tests

  tests(Any @args) : Object

This method is meant to be overridden by the superclass, and should perform specialized subtests. While not required, ideally this method should return its invocant.

tests example #1

  package main;

  use Test::Auto;
  use Test::Auto::Parser;
  use Test::Auto::Subtests;

  my $test = Test::Auto->new(
    't/Test_Auto_Plugin.t'
  );

  my $parser = Test::Auto::Parser->new(
    source => $test
  );

  my $subtests = Test::Auto::Subtests->new(
    parser => $parser
  );

  # Test::Auto::Plugin::ShortDescription
  my $example = $subtests->plugin('ShortDescription');

  $example->tests(length => 200);

AUTHOR

Al Newkirk, "awncorp@cpan.org"

LICENSE

This is free software; you can redistribute it and/or modify it under the terms of the The Apache License, Version 2.0, as elucidated in the "license file" <https://github.com/iamalnewkirk/test-auto/blob/master/LICENSE>.

PROJECT

Wiki <https://github.com/iamalnewkirk/test-auto/wiki>

Project <https://github.com/iamalnewkirk/test-auto>

Initiatives <https://github.com/iamalnewkirk/test-auto/projects>

Milestones <https://github.com/iamalnewkirk/test-auto/milestones>

Issues <https://github.com/iamalnewkirk/test-auto/issues>