The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.


Net::HTTP::Spore - SPORE client


version 0.09


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

    # from JSON specification string
    my $client = Net::HTTP::Spore->new_from_string($json);

    # for identica
    my $client = Net::HTTP::Spore->new_from_spec('twitter.json', base_url => '');


    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');


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

Some specifications for well-known services are available


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 the appropriate methods to interact with the API.


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.


or only on some path

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

For very simple middlewares, you can simply pass in an anonymous function

    $client->enable( sub { my $request = shift; ... } );


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 a JSON specification string.


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:



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


  • Franck Cuny <>

  • Ash Berlin <>

  • Ahmad Fatoum <>


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.