Net::Jifty - interface to online Jifty applications
Version 0.05 released 21 Dec 08
use Net::Jifty; my $j = Net::Jifty->new(site => 'http://mushroom.mu/', cookie_name => 'MUSHROOM_KINGDOM_SID', appname => 'MushroomKingdom', email => 'god@mushroom.mu', password => 'melange'); # the story begins $j->create(Hero => name => 'Mario', job => 'Plumber'); # find the hero whose job is Plumber and change his name to Luigi and color # to green $j->update(Hero => job => 'Plumber', name => 'Luigi', color => 'Green'); # win! $j->delete(Enemy => name => 'Bowser');
Jifty is a full-stack web framework. It provides an optional REST interface for applications. Using this module, you can interact with that REST interface to write client-side utilities.
You can use this module directly, but you'll be better off subclassing it, such as what we've done for Net::Hiveminder.
This module also provides a number of convenient methods for writing short scripts. For example, passing use_config => 1 to new will look at the config file for the username and password (or SID) of the user. If neither is available, it will prompt the user for them.
use_config => 1
new
Each Net::Jifty object will do the following upon creation:
..but only if you use_config is set to true.
use_config
..unless a sid is available, in which case we're already logged in.
This assumes your site is using Jifty::Plugin::Authentication::Password. If that's not the case, override this in your subclass.
This is called automatically when each Net::Jifty object is constructed (unless a session ID is passed in).
This uses the Jifty "web services" API to perform ACTION. This is not the REST interface, though it resembles it to some degree.
ACTION
This module currently only uses this to log in.
This will take a hash containing arguments and convert those arguments into URL encoded form. I.e., (x => 1, y => 2, z => 3) becomes:
x=1&y=2&z=3
These are then ready to be appened to the URL on a GET or placed into the content of a PUT.
This will perform a GET, POST, PUT, DELETE, etc using the internal LWP::UserAgent object.
URL may be a string or an array reference (which will have its parts properly escaped and joined with /). URL already has http://your.site/=/ prepended to it, and .yml appended to it, so you only need to pass something like model/YourApp.Model.Foo/name, or [qw/model YourApp.Model.Foo name].
URL
/
http://your.site/=/
.yml
model/YourApp.Model.Foo/name
[qw/model YourApp.Model.Foo name]
This will return the data structure returned by the Jifty application, or throw an error.
This will post ARGS to URL. See the documentation for method about the format of URL.
ARGS
method
This will get the specified URL with ARGS as query parameters. See the documentation for method about the format of URL.
Perform ACTION, using ARGS. This does use the REST interface.
Create a new object of type MODEL with the FIELDS set.
MODEL
FIELDS
Find some MODEL where KEY is VALUE and delete it.
KEY
VALUE
Find some MODEL where KEY is VALUE and set FIELDS on it.
Find some MODEL where KEY is VALUE and return it.
Searches for all objects of type MODEL that satisfy FIELDS. The optional OUTCOLUMN defines the output column, in case you don't want the entire records.
OUTCOLUMN
Retrieves the sid from the LWP::UserAgent object.
Encodes FRAGMENTS and joins them with /.
FRAGMENTS
Returns STRINGS, properly URI-escaped.
STRINGS
Loads DATE (which must be of the form YYYY-MM-DD) into a DateTime object.
DATE
YYYY-MM-DD
Compares the two email addresses. Returns true if they're equal, false if they're not.
Returns true if EMAIL looks like it is the same as the current user's.
EMAIL
This will return a hash reference of the user's preferences. Because this method is designed for use in small standalone scripts, it has a few peculiarities.
It will warn if the permissions are too liberal on the config file, and fix them.
warn
It will prompt the user for an email and password if necessary. Given the email and password, it will attempt to log in using them. If that fails, then it will try again.
Upon successful login, it will write a new config consisting of the options already in the config plus session ID, email, and password.
This will warn about (and fix) config files being readable by group or others.
This transforms the config file into a hashref. It also does any postprocessing needed, such as transforming localhost to 127.0.0.1 (due to an obscure bug, probably in HTTP::Cookies).
This will write the config to disk. This is usually only done when a sid is discovered, but may happen any time.
This will ask the user for her email and password. It may do so repeatedly until login is successful.
Retrieve user ID's email address.
ID
Jifty, Net::Hiveminder
Shawn M Moore, <sartak at bestpractical.com>
<sartak at bestpractical.com>
Andrew Sterling Hanenkamp, <hanenkamp@gmail.com>
<hanenkamp@gmail.com>
Please report any bugs or feature requests to bug-net-jifty at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-Jifty.
bug-net-jifty at rt.cpan.org
Copyright 2007 Best Practical Solutions.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Net::Jifty, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Net::Jifty
CPAN shell
perl -MCPAN -e shell install Net::Jifty
For more information on module installation, please visit the detailed CPAN module installation guide.