lib/Frey/CouchAPI.pm

package Frey::CouchAPI;

=head1 DESCRIPTION

This is REST wrapper using following L<Mojo> implement Apache's CouchDB API

You can access it using normal C</_utils/> URI, just like on real CouchDB and
it will bring up partially functional Futon interface against this module.

L<Mojo::URL>

L<Mojo::Transaction>


=head1 Supported HTTP API

=cut

use warnings;
use strict;

use JSON;
use Data::Dump qw/dump/;
use URI::Escape;
use File::Path;
use Storable;

our $VERSION = '0.3';
$VERSION .= " (Frey $Frey::VERSION)" if $Frey::VERSION;

our $debug = $Frey::debug || 0;

sub rewrite_urls {
        my ( $self, $tx ) = @_;
        if ( $tx->req->url->path =~ m{/_utils/} ) {
                my $path = $tx->req->url->path;
                $path =~ s{(/_utils)/?$}{$1/index.html}; # poor man's DirectoryIndex
                $path =~  s{/_utils}{/static/futon};
                $tx->req->url->path( $path );
                my $url = $tx->req->url->to_string;
                my $old = $url;
                $url = $tx->req->url->to_string;
                warn "# rewrite $old -> $url\n";
        }
}

our $config = {
        database => {
                path => '/data/webpac2/var/row',
                name_glob => '/*/*',
        }
};

my $regex_dbs = '[a-z][a-z0-9_\$\(\)\+\-/]+';

our $json = {};
our $status;

sub ok {
        $json = { ok => JSON::true };
        $status = 200;
        warn "ok from ",join(' ',caller),$/;
}

sub file_rev { (stat($_[0]))[9] } # mtime

sub data_from_tx {
        my $tx = shift;
        my $data = $tx->req->content->file->slurp;
        $data = JSON->new->allow_nonref->decode( $data );
        warn "## data ",dump( $data );
        return $data;
}

sub dispatch {
        my ($self,$tx) = @_;

        $status = 500; # Internal Error

        my $url = $tx->req->url->to_string;
        $url = uri_unescape( $url );
        my $method = $tx->req->method;
        my $path = $config->{database}->{path};
        
        if ( $url eq '/' ) {
                $json = {
                        couchdb => "Welcome",
                        version => "CouchAPI $VERSION",
                };
                $status = 200;
        } elsif ( $url eq '/_all_dbs' ) {
                $json = [
                        map {
                                s{^\Q$path\E/*}{};
                                $_;
                        } glob $path . $config->{database}->{name_glob}
                ];
                $status = 200;
        } elsif ( $url =~ m{^/_config/?(.+)} ) {

                $json = $config;

                if ( $method eq 'PUT' ) {

                        my $part = $1;
                        my $data = data_from_tx( $tx );
                        warn "## part $part = $data\n";

                        $part =~ s!/!'}->{'!;

                        # poor man's transaction :-)
                        my $code = "\$config->{'$part'} = \$data;";
                        eval $code;
                        if ( $@ ) {
                                warn "ERROR: $code -> $@";
                                $status = 500;
                        } else {
                                $status = 200;
                        }

                        warn "# config after $code is ",dump( $config ),$/;

                } elsif ( $method eq 'GET' ) {
                        $status = 200;
                } else {
                        $status = 501;
                }

=head2 Database

L<http://wiki.apache.org/couchdb/HTTP_database_API> except compaction

=cut

        } elsif (
                   $url =~ m{($regex_dbs)/$}
                # DELETE doesn't have trailing slash
                || $method eq 'DELETE' && $url =~ m{($regex_dbs)$}
        ) {

                my $database = $1;

                my $dir = "$path/$database";

                if ( $method eq 'GET' ) {
                        $json = database_get( $database );
                } elsif ( $method eq 'DELETE' ) {
                        if ( ! -e $dir ) {
                                $status = 404;
                        } else {
                                rmtree($dir);
                                if ( ! -d $dir ) {
                                        ok;
                                } else {
                                        $status = 500;
                                }
                        }
                } elsif ( $method eq 'PUT' ) {
                        if ( -e $dir ) {
                                $status = 412;
                        } else {
                                mkpath($dir);
                                if ( -e $path ) {
                                        ok;
                                        $status = 201;
                                } else {
                                        $status = 500;
                                }
                        }
                }

                warn "## database $database $status ",dump( $json );

        } elsif ( $url =~ m{($regex_dbs)/([^?]+)\??(.+)?$} ) {
                my ($database,$id,$args) = ($1,$2,$3);

=head2 Document

L<http://wiki.apache.org/couchdb/HTTP_Document_API>

=cut

                my $arg;
                if ( $args ) {
                        foreach my $a ( split(/[&;]/,$args) ) {
                                my ($n,$v) = split(/=/,$a);
                                $v =~ s{(["'])(.+)\1}{$2};
                                $arg->{$n} = $v;
                        }
                }

                warn "ERROR: path $path doesn't exist\n" unless -e $path;

                my $p = "$path/$database/$id";
                warn "## database: $database id: $id -> $p ", dump( $arg ),"\n";


                if ( $id =~ m{_all_docs(\w*)$} ) {

                        my $by = $1;
                        my $offset = 0;
                        my $startkey = delete $arg->{startkey};
                           $startkey ||= delete $arg->{startkey_docid}; # XXX key == id
                        my $endkey   = delete $arg->{endkey};
                        my $limit    = delete $arg->{limit};
                        my $skip     = delete $arg->{skip};
                        my $total_rows = 0;
                        my $collected_rows = 0;

                        my @docs = grep { length $_ } map {

                                $total_rows++;
        
                                if ( $limit > 0 && $collected_rows == $limit ) {
                                        '';
                                } else {
        
                                        s{^$path/$database/}{};

                                        if ( defined $endkey && $_ gt $endkey ) {
                                                '';
                                        } elsif ( $startkey ) {
                                                if ( $_ ge $startkey ) {
                                                        $collected_rows++;
                                                        $_;
                                                } else {
                                                        $offset++;
                                                        '';
                                                }
                                        } else {
                                                $collected_rows++;
                                                $_;
                                        }
                                }

                        } glob( "$path/$database/*" );

                        $offset += $skip if $skip;

                        warn "## docs $startkey -> $endkey limit $limit ", dump( @docs ); # if $debug;

                        $json = {
                                total_rows =>  $total_rows,
                                offset => $offset,
                                rows => [],
                        };

                        my $rows;
                        my @ids;

                        foreach my $id ( @docs ) {
                                warn "++ $id\n" if $debug;
                                my $p = "$path/$database/$id";
                                my $data = eval { Storable::retrieve( $p ) };
                                if ( $@ ) {
                                        warn "ERROR: $p | $@\n";
                                        next;
                                }
                                push @ids, $id;
                                $rows->{$id} = {
                                        id => $id,
                                        key => $id,
                                        value => {
                                                rev => file_rev $p,
                                        }
                                };
                        }

                        my $descending = delete $arg->{descending};
                        my @sorted = sort @ids;

                        warn "creating rows in ", $descending ? "descending" : "", " order\n";

                        foreach my $id ( $descending ? reverse @sorted : @sorted ) {
                                warn ">> $id ", $descending ? 'desc' : 'asc', "\n" if $debug;
                                push @{ $json->{rows} }, $rows->{$id};
                        }

                        $status = 200;

                } elsif ( $method eq 'PUT' ) {
        
                        warn "## ",dump( $tx->req ) if $debug;

                        my $data = $tx->req->content->file->slurp;

                        my $db_path = "$path/$database";
                        make_path $db_path unless -e $db_path;

                        Storable::store( from_json($data), $p );
                        my $rev = file_rev $p;
                        warn "store $p $rev size ", -s $p, " bytes | $data\n";

                        $status = 201; # Created
                        $json = {
                                id => $id,
                                ok => JSON::true,
                                rev => $rev,
                        };

                } elsif ( $method eq 'GET' ) {
                        if ( ! -e $p ) {
                                $status = 404;
                        } else {
                                warn "retrive $p ", -s $p, " bytes\n";
                                $json = Storable::retrieve( $p );
                                if ( delete $arg->{revs_info} ) {
                                        my $rev = file_rev $p;
                                        $json->{_rev} = $rev;
                                        $json->{_revs_info} = [
                                                { rev => $rev, status => 'available' }
                                        ];
                                }
                                $status = 200;

                        }
                } elsif ( $method eq 'DELETE' ) {
                        if ( -e $p ) {
                                unlink $p && ok || { $status = 500 };
                        } else {
                                $status = 404;
                        }
                } elsif ( $method eq 'POST' ) {
                        my $data = data_from_tx( $tx );

                        # FIXME implement real view server and return 200
                        $json = { total_rows => 0, offset => 0 };
                        $status = 202;

                } else {
                        $status = 501;
                }

                if ( keys %$arg ) {
                        warn "WARNING: arg left from $url = ",dump( $arg ),$/;
                        $status = 501;
                }

        }

        $json = { error => 'not_found', reason => 'Missing' } if $status == 404;

        if ( $method =~ m{(DELETE|PUT)} ) {
                $tx->res->headers->add_line( 'Location' => $tx->req->url->to_abs );
        }

        $tx->res->code( $status );
        $tx->res->headers->content_type( 'text/plain;charset=utf-8' );
        my $body = to_json $json;
        $tx->res->body( $body );
        $tx->res->headers->add_line( 'Cache-Control' => 'must-revalidate' );
        $tx->res->headers->add_line( 'Server' => "Frey::CouchAPI/$VERSION" );

        print "$method $url $status\n$body\n";

        warn "## headers ", $tx->res->headers->to_string;

        return $tx;

}

sub database_get {
        my ($db_name) = @_;
        my $path = $config->{database}->{path} || die;
        warn "# collecting docs from $path/$db_name/*\n";
        my @docs = glob "$path/$db_name/*";
        my $json = {
                db_name => $db_name,
                doc_count => $#docs + 1,
                doc_del_count => 0,
                update_seq => 0,
                purge_seq => 0,
                capacity_running => JSON::false,
                disk_size => 0,
                instance_start_time => time(),
        };

        warn "## calculating disk_size\n";
        $json->{disk_size} += -s $_ foreach @docs;
        $status = 200;
        return $json;
}

1;
__END__

=head1 SEE ALSO

L<http://wiki.apache.org/couchdb/Reference>

1	dpavlin	1046	package Frey::CouchAPI;
2
3	dpavlin	1051	=head1 DESCRIPTION
4
5	dpavlin	1052	This is REST wrapper using following L<Mojo> implement Apache's CouchDB API
6	dpavlin	1051
7	dpavlin	1071	You can access it using normal C</_utils/> URI, just like on real CouchDB and
8			it will bring up partially functional Futon interface against this module.
9	dpavlin	1052
10			L<Mojo::URL>
11
12			L<Mojo::Transaction>
13
14
15	dpavlin	1051	=head1 Supported HTTP API
16
17			=cut
18
19	dpavlin	1049	use warnings;
20			use strict;
21
22	dpavlin	1046	use JSON;
23			use Data::Dump qw/dump/;
24			use URI::Escape;
25	dpavlin	1075	use File::Path;
26	dpavlin	1047	use Storable;
27	dpavlin	1046
28	dpavlin	1061	our $VERSION = '0.3';
29	dpavlin	1053	$VERSION .= " (Frey $Frey::VERSION)" if $Frey::VERSION;
30	dpavlin	1049
31			our $debug = $Frey::debug \|\| 0;
32
33	dpavlin	1046	sub rewrite_urls {
34			my ( $self, $tx ) = @_;
35			if ( $tx->req->url->path =~ m{/_utils/} ) {
36			my $path = $tx->req->url->path;
37			$path =~ s{(/_utils)/?$}{$1/index.html}; # poor man's DirectoryIndex
38			$path =~ s{/_utils}{/static/futon};
39			$tx->req->url->path( $path );
40			my $url = $tx->req->url->to_string;
41			my $old = $url;
42			$url = $tx->req->url->to_string;
43			warn "# rewrite $old -> $url\n";
44			}
45			}
46
47	dpavlin	1050	our $config = {
48	dpavlin	1061	database => {
49			path => '/data/webpac2/var/row',
50			name_glob => '//',
51			}
52	dpavlin	1050	};
53
54	dpavlin	1047	my $regex_dbs = '[a-z][a-z0-9_\$\(\)\+\-/]+';
55	dpavlin	1046
56	dpavlin	1047	our $json = {};
57	dpavlin	1052	our $status;
58	dpavlin	1047
59			sub ok {
60			$json = { ok => JSON::true };
61			$status = 200;
62	dpavlin	1054	warn "ok from ",join(' ',caller),$/;
63	dpavlin	1047	}
64
65	dpavlin	1054	sub file_rev { (stat($_[0]))[9] } # mtime
66	dpavlin	1050
67	dpavlin	1060	sub data_from_tx {
68			my $tx = shift;
69			my $data = $tx->req->content->file->slurp;
70			$data = JSON->new->allow_nonref->decode( $data );
71			warn "## data ",dump( $data );
72			return $data;
73			}
74
75	dpavlin	1046	sub dispatch {
76			my ($self,$tx) = @_;
77
78	dpavlin	1052	$status = 500; # Internal Error
79
80	dpavlin	1046	my $url = $tx->req->url->to_string;
81			$url = uri_unescape( $url );
82	dpavlin	1047	my $method = $tx->req->method;
83	dpavlin	1061	my $path = $config->{database}->{path};
84	dpavlin	1050
85	dpavlin	1046	if ( $url eq '/' ) {
86			$json = {
87	dpavlin	1047	couchdb => "Welcome",
88	dpavlin	1050	version => "CouchAPI $VERSION",
89	dpavlin	1052	};
90			$status = 200;
91	dpavlin	1046	} elsif ( $url eq '/_all_dbs' ) {
92	dpavlin	1061	$json = [
93			map {
94			s{^\Q$path\E/*}{};
95			$_;
96			} glob $path . $config->{database}->{name_glob}
97			];
98	dpavlin	1047	$status = 200;
99	dpavlin	1050	} elsif ( $url =~ m{^/_config/?(.+)} ) {
100
101	dpavlin	1061	$json = $config;
102	dpavlin	1050
103			if ( $method eq 'PUT' ) {
104
105			my $part = $1;
106	dpavlin	1061	my $data = data_from_tx( $tx );
107			warn "## part $part = $data\n";
108	dpavlin	1050
109			$part =~ s!/!'}->{'!;
110
111			# poor man's transaction :-)
112	dpavlin	1061	my $code = "\$config->{'$part'} = \$data;";
113	dpavlin	1050	eval $code;
114			if ( $@ ) {
115			warn "ERROR: $code -> $@";
116			$status = 500;
117			} else {
118			$status = 200;
119	dpavlin	1049	}
120	dpavlin	1050
121	dpavlin	1061	warn "# config after $code is ",dump( $config ),$/;
122	dpavlin	1050
123			} elsif ( $method eq 'GET' ) {
124			$status = 200;
125			} else {
126			$status = 501;
127			}
128
129	dpavlin	1051	=head2 Database
130
131			L<http://wiki.apache.org/couchdb/HTTP_database_API> except compaction
132
133			=cut
134
135	dpavlin	1059	} elsif (
136			$url =~ m{($regex_dbs)/$}
137			# DELETE doesn't have trailing slash
138			\|\| $method eq 'DELETE' && $url =~ m{($regex_dbs)$}
139			) {
140
141	dpavlin	1047	my $database = $1;
142
143	dpavlin	1054	my $dir = "$path/$database";
144
145	dpavlin	1047	if ( $method eq 'GET' ) {
146			$json = database_get( $database );
147			} elsif ( $method eq 'DELETE' ) {
148			if ( ! -e $dir ) {
149			$status = 404;
150			} else {
151	dpavlin	1075	rmtree($dir);
152	dpavlin	1054	if ( ! -d $dir ) {
153			ok;
154			} else {
155			$status = 500;
156			}
157	dpavlin	1047	}
158			} elsif ( $method eq 'PUT' ) {
159	dpavlin	1054	if ( -e $dir ) {
160			$status = 412;
161	dpavlin	1047	} else {
162	dpavlin	1075	mkpath($dir);
163	dpavlin	1054	if ( -e $path ) {
164			ok;
165			$status = 201;
166			} else {
167			$status = 500;
168			}
169	dpavlin	1047	}
170			}
171
172	dpavlin	1059	warn "## database $database $status ",dump( $json );
173
174	dpavlin	1049	} elsif ( $url =~ m{($regex_dbs)/([^?]+)\??(.+)?$} ) {
175			my ($database,$id,$args) = ($1,$2,$3);
176
177	dpavlin	1051	=head2 Document
178
179			L<http://wiki.apache.org/couchdb/HTTP_Document_API>
180
181			=cut
182
183	dpavlin	1049	my $arg;
184			if ( $args ) {
185			foreach my $a ( split(/[&;]/,$args) ) {
186			my ($n,$v) = split(/=/,$a);
187			$v =~ s{(["'])(.+)\1}{$2};
188			$arg->{$n} = $v;
189			}
190			}
191	dpavlin	1050
192			warn "ERROR: path $path doesn't exist\n" unless -e $path;
193
194	dpavlin	1047	my $p = "$path/$database/$id";
195	dpavlin	1051	warn "## database: $database id: $id -> $p ", dump( $arg ),"\n";
196	dpavlin	1047
197
198	dpavlin	1057	if ( $id =~ m{_all_docs(\w*)$} ) {
199	dpavlin	1049
200			my $by = $1;
201			my $offset = 0;
202			my $startkey = delete $arg->{startkey};
203	dpavlin	1062	$startkey \|\|= delete $arg->{startkey_docid}; # XXX key == id
204	dpavlin	1051	my $endkey = delete $arg->{endkey};
205			my $limit = delete $arg->{limit};
206	dpavlin	1060	my $skip = delete $arg->{skip};
207	dpavlin	1049	my $total_rows = 0;
208	dpavlin	1062	my $collected_rows = 0;
209	dpavlin	1049
210			my @docs = grep { length $_ } map {
211	dpavlin	1057
212	dpavlin	1062	$total_rows++;
213
214			if ( $limit > 0 && $collected_rows == $limit ) {
215	dpavlin	1057	'';
216			} else {
217	dpavlin	1051
218	dpavlin	1057	s{^$path/$database/}{};
219	dpavlin	1051
220	dpavlin	1057	if ( defined $endkey && $_ gt $endkey ) {
221			'';
222			} elsif ( $startkey ) {
223			if ( $_ ge $startkey ) {
224	dpavlin	1062	$collected_rows++;
225	dpavlin	1057	$_;
226			} else {
227			$offset++;
228			'';
229			}
230			} else {
231	dpavlin	1062	$collected_rows++;
232	dpavlin	1049	$_;
233			}
234			}
235	dpavlin	1051
236	dpavlin	1047	} glob( "$path/$database/*" );
237
238	dpavlin	1060	$offset += $skip if $skip;
239	dpavlin	1057
240	dpavlin	1051	warn "## docs $startkey -> $endkey limit $limit ", dump( @docs ); # if $debug;
241	dpavlin	1047
242			$json = {
243	dpavlin	1049	total_rows => $total_rows,
244			offset => $offset,
245	dpavlin	1047	rows => [],
246			};
247
248	dpavlin	1049	my $rows;
249			my @ids;
250
251	dpavlin	1047	foreach my $id ( @docs ) {
252	dpavlin	1049	warn "++ $id\n" if $debug;
253	dpavlin	1047	my $p = "$path/$database/$id";
254	dpavlin	1049	my $data = eval { Storable::retrieve( $p ) };
255			if ( $@ ) {
256			warn "ERROR: $p \| $@\n";
257			next;
258			}
259			push @ids, $id;
260			$rows->{$id} = {
261	dpavlin	1047	id => $id,
262			key => $id,
263			value => {
264	dpavlin	1054	rev => file_rev $p,
265	dpavlin	1047	}
266			};
267			}
268
269	dpavlin	1049	my $descending = delete $arg->{descending};
270			my @sorted = sort @ids;
271
272	dpavlin	1050	warn "creating rows in ", $descending ? "descending" : "", " order\n";
273
274	dpavlin	1049	foreach my $id ( $descending ? reverse @sorted : @sorted ) {
275	dpavlin	1050	warn ">> $id ", $descending ? 'desc' : 'asc', "\n" if $debug;
276	dpavlin	1049	push @{ $json->{rows} }, $rows->{$id};
277			}
278
279	dpavlin	1057	$status = 200;
280
281	dpavlin	1047	} elsif ( $method eq 'PUT' ) {
282
283	dpavlin	1059	warn "## ",dump( $tx->req ) if $debug;
284	dpavlin	1047
285			my $data = $tx->req->content->file->slurp;
286
287	dpavlin	1059	my $db_path = "$path/$database";
288			make_path $db_path unless -e $db_path;
289
290	dpavlin	1047	Storable::store( from_json($data), $p );
291	dpavlin	1054	my $rev = file_rev $p;
292			warn "store $p $rev size ", -s $p, " bytes \| $data\n";
293
294	dpavlin	1052	$status = 201; # Created
295	dpavlin	1054	$json = {
296			id => $id,
297			ok => JSON::true,
298			rev => $rev,
299			};
300
301	dpavlin	1047	} elsif ( $method eq 'GET' ) {
302	dpavlin	1049	if ( ! -e $p ) {
303			$status = 404;
304			} else {
305			warn "retrive $p ", -s $p, " bytes\n";
306			$json = Storable::retrieve( $p );
307	dpavlin	1055	if ( delete $arg->{revs_info} ) {
308			my $rev = file_rev $p;
309			$json->{_rev} = $rev;
310			$json->{_revs_info} = [
311			{ rev => $rev, status => 'available' }
312			];
313			}
314			$status = 200;
315
316	dpavlin	1049	}
317			} elsif ( $method eq 'DELETE' ) {
318			if ( -e $p ) {
319	dpavlin	1054	unlink $p && ok \|\| { $status = 500 };
320	dpavlin	1049	} else {
321			$status = 404;
322			}
323	dpavlin	1056	} elsif ( $method eq 'POST' ) {
324	dpavlin	1060	my $data = data_from_tx( $tx );
325
326			# FIXME implement real view server and return 200
327	dpavlin	1056	$json = { total_rows => 0, offset => 0 };
328	dpavlin	1060	$status = 202;
329
330	dpavlin	1047	} else {
331			$status = 501;
332			}
333
334	dpavlin	1059	if ( keys %$arg ) {
335			warn "WARNING: arg left from $url = ",dump( $arg ),$/;
336			$status = 501;
337			}
338	dpavlin	1049
339	dpavlin	1046	}
340
341	dpavlin	1052	$json = { error => 'not_found', reason => 'Missing' } if $status == 404;
342
343			if ( $method =~ m{(DELETE\|PUT)} ) {
344			$tx->res->headers->add_line( 'Location' => $tx->req->url->to_abs );
345	dpavlin	1047	}
346
347			$tx->res->code( $status );
348	dpavlin	1053	$tx->res->headers->content_type( 'text/plain;charset=utf-8' );
349	dpavlin	1047	my $body = to_json $json;
350			$tx->res->body( $body );
351	dpavlin	1053	$tx->res->headers->add_line( 'Cache-Control' => 'must-revalidate' );
352			$tx->res->headers->add_line( 'Server' => "Frey::CouchAPI/$VERSION" );
353	dpavlin	1052
354	dpavlin	1054	print "$method $url $status\n$body\n";
355	dpavlin	1053
356	dpavlin	1052	warn "## headers ", $tx->res->headers->to_string;
357
358	dpavlin	1046	return $tx;
359
360			}
361
362	dpavlin	1047	sub database_get {
363			my ($db_name) = @_;
364	dpavlin	1061	my $path = $config->{database}->{path} \|\| die;
365	dpavlin	1047	warn "# collecting docs from $path/$db_name/*\n";
366			my @docs = glob "$path/$db_name/*";
367			my $json = {
368			db_name => $db_name,
369			doc_count => $#docs + 1,
370			doc_del_count => 0,
371			update_seq => 0,
372			purge_seq => 0,
373			capacity_running => JSON::false,
374			disk_size => 0,
375			instance_start_time => time(),
376			};
377
378			warn "## calculating disk_size\n";
379	dpavlin	1049	$json->{disk_size} += -s $_ foreach @docs;
380	dpavlin	1047	$status = 200;
381			return $json;
382			}
383
384	dpavlin	1046	1;
385	dpavlin	1051	__END__
386
387			=head1 SEE ALSO
388
389			L<http://wiki.apache.org/couchdb/Reference>
390