# Net::Twitter::Role::InflateObjects - phpMan

## NAME
    [Net::Twitter::Role::InflateObjects] - Inflate Twitter API return values
    to Moose objects

## VERSION
    version 4.01043

## SYNOPSIS
      use [Net::Twitter];
      my $nt = [Net::Twitter]->new(traits => [qw/InflateObjects [API::Rest]/]);

      $nt->credentials($username, $password);

      $r = $nt->friends_timeline;

      $r->[0]->user->name; # return values are objects with read accessors
      $r->[0]->created_at; # dates are inflated to DateTime objects
      $r->[0]->relative_created_at; # "6 minutes ago"

## DESCRIPTION
    This role provides inflation of HASH refs, returned by the Twitter API,
    into Moose objects. URLs are inflated to URI objects. Dates are inflated
    to DateTime objects. Objects that have a "created_at" attribute also
    have a "relative_created_at" method that prints times in the same style
    as the Twitter web interface.

    All HASH members have read accessors, so

      $r->[0]->{user}{screen_name}

    Can be accessed as

      $r->[0]->user->screen_name

## CAVEATS
    An accessor is created for each HASH key returned by Twitter. As Twitter
    adds new attributes, InflateObjects will create accessors for them.
    However, InflateObjects will also drop accessors if Twitter drops the
    corresponding HASH element. So, code that relies on HASH element will
    fail loudly if Twitter drops support for it. (This may be a feature!)

## AUTHOR
    Marc Mims <<marc@questright.com>>

## LICENSE
    Copyright (c) 2016 Marc Mims

    The Twitter API itself, and the description text used in this module is:

    Copyright (c) 2009 Twitter

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