NAME

Mojo::Transaction::HTTP::Role::Mechanize - Mechanize Mojo a little

SYNOPSIS

  use Mojo::UserAgent;
  use Mojo::Transaction::HTTP::Role::Mechanize;

  my $ua = Mojo::UserAgent->new;
  my $tx = $ua->get('/')->with_roles('+Mechanize');

  # call submit immediately
  my $submit_tx = $tx->submit('#submit-id', username => 'fry');
  $ua->start($submit_tx);

  # first extract form values
  my $values = $tx->extract_forms->first->val;
  $submit_tx = $tx->submit('#submit-id', counter => $values->{counter} + 3);
  $ua->start($submit_tx);

DESCRIPTION

Role::Tiny based role to compose a form submission "trait" into Mojo::Transaction::HTTP.

METHODS

Mojo::Transaction::HTTP::Role::Mechanize implements the following method.

extract_forms

  $collection = $tx->extract_forms;

Returns a Mojo::Collection of Mojo::DOM elements with activated Mojo::DOM::Role::Form that contains all the forms of the page.

submit

  # result using selector
  $submit_tx = $tx->submit('#id', username => 'fry');

  # result without selector using default submission
  $submit_tx = $tx->submit(username => 'fry');

  # passing hash, rather than list, of values
  $submit_tx = $tx->submit({username => 'fry'});

  # passing hash, rather than list, of values and a selector
  $submit_tx = $tx->submit('#id', {username => 'fry'});

Build a new Mojo::Transaction::HTTP object with "tx" in Mojo::UserAgent::Transactor and the contents of the form with the $id and merged values. If no selector is given, the first non-disabled button or appropriate input element (of type button, submit, or image) will be used for the submission.

AUTHOR

kiwiroy - Roy Storey kiwiroy@cpan.org

tekki - Rolf Stöckli tekki@cpan.org

lindleyw - William Lindley wlindley+remove+this@wlindley.com

LICENSE

This library is free software and may be distributed under the same terms as perl itself.

SEE ALSO

Mojo::DOM::Role::Form, Mojolicious.