NAME
   Net::HTTP::Spore - SPORE client

VERSION
   version 0.05

SYNOPSIS
       my $client = Net::HTTP::Spore->new_from_spec('twitter.json');

       # for identica
       my $client = Net::HTTP::Spore->new_from_spec('twitter.json', base_url => 'http://identi.ca/com/api');

       $client->enable('Format::JSON');

       my $timeline = $client->public_timeline(format => 'json');
       my $tweets = $timeline->body;

       foreach my $tweet (@$tweets) {
           print $tweet->{user}->{screen_name}. " says ".$tweet->{text}."\n";
       }

       my $friends_timeline = $client->friends_timeline(format => 'json');

DESCRIPTION
   This module is an implementation of the SPORE specification.

   To use this client, you need to use or to write a SPORE specification of
   an API. A description of the SPORE specification format is available at
   <http://github.com/SPORE/specifications/blob/master/spore_description.po
   d>

   Some specifications for well-known services are available
   <http://github.com/SPORE/api-description>.

 CLIENT CREATION
   First you need to create a client. This can be done using two methods,
   new_from_spec and new_from_string. The client will read the
   specification file to create a appropriate methods to interact with the
   API.

 MIDDLEWARES
   It's possible to activate some middlewares to extend the usage of the
   client. If you're using an API that discuss in JSON, you can enable the
   middleware Net::HTTP::Spore::Middleware::JSON.

       $client->enable('Format::JSON');

   or only on some path

       $client->enable_if(sub{$_->[0]->path =~ m!/path/to/json/stuff!}, 'Format::JSON');

 METHODS
   new_from_spec($specification_file, %args)
       Create and return a Net::HTTP::Spore::Core object, with methods
       generated from the specification file. The specification file can
       either be a file on disk or a remote URL.

   new_from_string($specification_string, %args)
       Create and return a Net::HTTP::Spore::Core object, with methods
       generated from the specification string.

 TRACING
   Net::HTTP::Spore provides a way to trace what's going on when doing a
   request.

  Enabling Trace
   You can enable tracing using the environment variable SPORE_TRACE. You
   can also enable tracing at construct time by adding trace => 1 when
   calling new_from_spec.

  Trace Output
   By default output will be directed to STDERR. You can specify another
   default output:

       SPORE_TRACE=1=log.txt

   or

       ->new_from_spec('spec.json', trace => '1=log.txt');

AUTHOR
   franck cuny <[email protected]>

COPYRIGHT AND LICENSE
   This software is copyright (c) 2012 by linkfluence.

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

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.