File Coverage

blib/lib/Mojo/Autobox/String.pm

Criterion	Covered	Total	%
statement	14	14	100.0
branch	4	4	100.0
condition			n/a
subroutine	5	5	100.0
pod	4	4	100.0
total	27	27	100.0

package Mojo::Autobox::String;

use Mojo::Base -strict;

sub byte_stream {
  require Mojo::ByteStream;
  Mojo::ByteStream->new(shift);
}

*b = \&byte_stream;

sub dom {
  require Mojo::DOM;
  my $dom = Mojo::DOM->new(shift);
  return @_ ? $dom->find(@_) : $dom;
}

sub json {
  require Mojo::JSON;
  require Mojo::JSON::Pointer;
  my $data = Mojo::JSON::decode_json(shift);
  return @_ ? Mojo::JSON::Pointer->new($data)->get(shift) : $data;
}

*j = \&json;

sub url {
  require Mojo::URL;
  Mojo::URL->new(shift);
}

1;

=head1 NAME

Mojo::Autobox::String - Autobox string methods for Mojo::Autobox

=head1 SYNOPSIS

 use Mojo::Autobox;

 # "Trimmed"
 '  Trimmed  '->byte_stream->trim;

 # "Text"
 'Text'->dom->at('p')->text;

 # "world"
 '{"hello": "world"}'->json->{hello};

 # "anchor"
 'http://mysite.com/path#anchor'->url->fragment;

=head1 DESCRIPTION

String methods for L.

=head1 METHODS

=head2 byte_stream

Returns an instance of L, constructed from the invocant string.

=head2 b

An alias for L.

=head2 dom

Returns an instance of L, constructed from the invocant string.
Optionally takes a CSS3 selector which is passed to the L instance's L method.

=head2 json

Parses the invocant string as JSON using L and returns the result.
Optionally takes a JSON pointer used to delve into the resulting structure using L.

=head2 j

An alias for L.

=head2 url

Returns an instance of L, constructed from the invocant string.