X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2Fstemmaweb%2FController%2FRoot.pm;h=5ab5e922edda1fead54800a5b80eb3e2a4838a3d;hb=f761f9a7802815a5e3aa1068cd7aa17dd83ff8e5;hp=84288eaf1565e9a373249b2bf4bbe3fc61ea8946;hpb=14d81212f38cf1d6947a9a61b468669ff35da379;p=scpubgit%2Fstemmaweb.git

diff --git a/lib/stemmaweb/Controller/Root.pm b/lib/stemmaweb/Controller/Root.pm
index 84288ea..5ab5e92 100644
--- a/lib/stemmaweb/Controller/Root.pm
+++ b/lib/stemmaweb/Controller/Root.pm
@@ -2,6 +2,7 @@ package stemmaweb::Controller::Root;
 use Moose;
 use namespace::autoclean;
 use Text::Tradition::Analysis qw/ run_analysis /;
+use TryCatch;
 
 
 BEGIN { extends 'Catalyst::Controller' }
@@ -32,6 +33,10 @@ components will be loaded.
 sub index :Path :Args(0) {
     my ( $self, $c ) = @_;
 
+	# Are we being asked to load a text immediately? If so 
+	if( $c->req->param('withtradition') ) {
+		$c->stash->{'withtradition'} = $c->req->param('withtradition');
+	}
     $c->stash->{template} = 'index.tt';
 }
 
@@ -48,101 +53,378 @@ Serves a snippet of HTML that lists the available texts.  This returns texts bel
 sub directory :Local :Args(0) {
 	my( $self, $c ) = @_;
     my $m = $c->model('Directory');
-    my $user = $c->user_exists ? $c->user->get_object : 'public';
-    my @textlist = $m->traditionlist($user);
-    $c->stash->{texts} = \@textlist;
+    # Is someone logged in?
+    my %usertexts;
+    if( $c->user_exists ) {
+    	my $user = $c->user->get_object;
+    	my @list = $m->traditionlist( $user );
+    	map { $usertexts{$_->{id}} = 1 } @list;
+		$c->stash->{usertexts} = \@list;
+		$c->stash->{is_admin} = 1 if $user->is_admin;
+	}
+	# List public (i.e. readonly) texts separately from any user (i.e.
+	# full access) texts that exist. Admin users therefore have nothing
+	# in this list.
+	my @plist = grep { !$usertexts{$_->{id}} } $m->traditionlist('public');
+	$c->stash->{publictexts} = \@plist;
 	$c->stash->{template} = 'directory.tt';
 }
 
-=head2 variantgraph
+=head1 AJAX methods for traditions and their properties
 
- GET /variantgraph/$textid
- 
-Returns the variant graph for the text specified at $textid, in SVG form.
+=head2 newtradition
 
+ POST /newtradition,
+ 	{ name: <name>,
+ 	  language: <language>,
+ 	  public: <is_public>,
+ 	  file: <fileupload> }
+ 
+Creates a new tradition belonging to the logged-in user, with the given name
+and the collation given in the uploaded file. The file type is indicated via
+the filename extension (.csv, .txt, .xls, .xlsx, .xml). Returns the ID and 
+name of the new tradition.
+ 
 =cut
 
-sub variantgraph :Local :Args(1) {
-	my( $self, $c, $textid ) = @_;
+sub newtradition :Local :Args(0) {
+	my( $self, $c ) = @_;
+	return _json_error( $c, 403, 'Cannot save a tradition without being logged in' )
+		unless $c->user_exists;
+
+	my $user = $c->user->get_object;
+	# Grab the file upload, check its name/extension, and call the
+	# appropriate parser(s).
+	my $upload = $c->request->upload('file');
+	my $name = $c->request->param('name') || 'Uploaded tradition';
+	my $lang = $c->request->param( 'language' ) || 'Default';
+	my $public = $c->request->param( 'public' ) ? 1 : undef;
+	my( $ext ) = $upload->filename =~ /\.(\w+)$/;
+	my %newopts = (
+		'name' => $name,
+		'language' => $lang,
+		'public' => $public,
+		'file' => $upload->tempname
+		);
+
+	my $tradition;
+	my $errmsg;
+	if( $ext eq 'xml' ) {
+		# Try the different XML parsing options to see if one works.
+		foreach my $type ( qw/ CollateX CTE TEI / ) {
+			try {
+				$tradition = Text::Tradition->new( %newopts, 'input' => $type );
+			} catch ( Text::Tradition::Error $e ) {
+				$errmsg = $e->message;
+			} catch {
+				$errmsg = "Unexpected parsing error";
+			}
+			last if $tradition;
+		}
+	} elsif( $ext =~ /^(txt|csv|xls(x)?)$/ ) {
+		# If it's Excel we need to pass excel => $ext;
+		# otherwise we need to pass sep_char => [record separator].
+		if( $ext =~ /xls/ ) {
+			$newopts{'excel'} = $ext;
+		} else {
+			$newopts{'sep_char'} = $ext eq 'txt' ? "\t" : ',';
+		}
+		try {
+			$tradition = Text::Tradition->new( 
+				%newopts,
+				'input' => 'Tabular',
+				);
+		} catch ( Text::Tradition::Error $e ) {
+			$errmsg = $e->message;
+		} catch {
+			$errmsg = "Unexpected parsing error";
+		}
+	} else {
+		# Error unless we have a recognized filename extension
+		return _json_error( $c, 403, "Unrecognized file type extension $ext" );
+	}
+	
+	# Save the tradition if we have it, and return its data or else the
+	# error that occurred trying to make it.
+	if( $errmsg ) {
+		return _json_error( $c, 500, "Error parsing tradition .$ext file: $errmsg" );
+	} elsif( !$tradition ) {
+		return _json_error( $c, 500, "No error caught but tradition not created" );
+	}
+
 	my $m = $c->model('Directory');
-	my $tradition = $m->tradition( $textid );
-	my $collation = $tradition->collation;
-	$c->stash->{'result'} = $collation->as_svg;
-	$c->forward('View::SVG');
+	$user->add_tradition( $tradition );
+	my $id = $c->model('Directory')->store( $tradition );
+	$c->model('Directory')->store( $user );
+	$c->stash->{'result'} = { 'id' => $id, 'name' => $tradition->name };
+	$c->forward('View::JSON');
 }
-	
-=head2 alignment
 
- GET /alignment/$textid
+=head2 textinfo
 
-Returns an alignment table for the text specified at $textid.
+ GET /textinfo/$textid
+ POST /textinfo/$textid, 
+ 	{ name: $new_name, 
+ 	  language: $new_language,
+ 	  public: $is_public, 
+ 	  owner: $new_userid } # only admin users can update the owner
+ 
+Returns information about a particular text.
 
 =cut
 
-sub alignment :Local :Args(1) {
+sub textinfo :Local :Args(1) {
 	my( $self, $c, $textid ) = @_;
-	my $m = $c->model('Directory');
-	my $collation = $m->tradition( $textid )->collation;
-	my $alignment = $collation->alignment_table;
-	
-	# Turn the table, so that witnesses are by column and the rows
-	# are by rank.
-	my $wits = [ map { $_->{'witness'} } @{$alignment->{'alignment'}} ];
-	my $rows;
-	foreach my $i ( 0 .. $alignment->{'length'} - 1 ) {
-		my @rankrdgs = map { $_->{'tokens'}->[$i]->{'t'} } 
-			@{$alignment->{'alignment'}};
-		push( @$rows, { 'rank' => $i+1, 'readings' => \@rankrdgs } );
+	my $tradition = $c->model('Directory')->tradition( $textid );
+	unless( $tradition ) {
+		return _json_error( $c, 404, "No tradition with ID $textid" );
+	}	
+	my $ok = _check_permission( $c, $tradition );
+	return unless $ok;
+	if( $c->req->method eq 'POST' ) {
+		return _json_error( $c, 403, 
+			'You do not have permission to update this tradition' ) 
+			unless $ok eq 'full';
+		my $params = $c->request->parameters;
+		# Handle changes to owner-accessible parameters
+		my $m = $c->model('Directory');
+		my $changed;
+		# Handle name param - easy
+		if( exists $params->{name} ) {
+			my $newname = delete $params->{name};
+			unless( $tradition->name eq $newname ) {
+				try {
+					$tradition->name( $newname );
+					$changed = 1;
+				} catch {
+					return _json_error( $c, 500, "Error setting name to $newname" );
+				}
+			}
+		}
+		# Handle language param, making Default => null
+		my $langval = delete $params->{language} || 'Default';
+		unless( $tradition->language eq $langval ) {
+			try {
+				$tradition->language( $langval );
+				$changed = 1;
+			} catch {
+				return _json_error( $c, 500, "Error setting language to $langval" );
+			}
+		}
+
+		# Handle our boolean
+		my $ispublic = $tradition->public;
+		if( delete $params->{'public'} ) {  # if it's any true value...
+			$tradition->public( 1 );
+			$changed = 1 unless $ispublic;
+		} else {  # the checkbox was unchecked, ergo it should not be public
+			$tradition->public( 0 );
+			$changed = 1 if $ispublic;
+		}
+		
+		# Handle ownership change
+		my $newuser;
+		if( exists $params->{'owner'} ) {
+			# Only admins can update user / owner
+			my $newownerid = delete $params->{'owner'};
+			unless( !$newownerid || 
+				( $tradition->has_user && $tradition->user->id eq $newownerid ) ) {
+				unless( $c->user->get_object->is_admin ) {
+					return _json_error( $c, 403, 
+						"Only admin users can change tradition ownership" );
+				}
+				$newuser = $m->find_user({ username => $newownerid });
+				unless( $newuser ) {
+					return _json_error( $c, 500, "No such user " . $newownerid );
+				}
+				$newuser->add_tradition( $tradition );
+				$changed = 1;
+			}
+		}
+		# TODO check for rogue parameters
+		if( scalar keys %$params ) {
+			my $rogueparams = join( ', ', keys %$params );
+			return _json_error( $c, 403, "Request parameters $rogueparams not recognized" );
+		}
+		# If we safely got to the end, then write to the database.
+		$m->save( $tradition ) if $changed;
+		$m->save( $newuser ) if $newuser;		
 	}
-	$c->stash->{'witnesses'} = $wits;
-	$c->stash->{'table'} = $rows;
-	$c->stash->{'template'} = 'alignment.tt';
+
+	# Now return the current textinfo, whether GET or successful POST.
+	my $textinfo = {
+		textid => $textid,
+		name => $tradition->name,
+		language => $tradition->language,
+		public => $tradition->public,
+		owner => $tradition->user ? $tradition->user->id : undef,
+		witnesses => [ map { $_->sigil } $tradition->witnesses ],
+	};
+	my @stemmasvg = map { $_->as_svg({ size => [ 500, 375 ] }) } $tradition->stemmata;
+	map { $_ =~ s/\n/ /mg } @stemmasvg;
+	$textinfo->{stemmata} = \@stemmasvg;
+	$c->stash->{'result'} = $textinfo;
+	$c->forward('View::JSON');
 }
 
+=head2 variantgraph
+
+ GET /variantgraph/$textid
+ 
+Returns the variant graph for the text specified at $textid, in SVG form.
+
+=cut
+
+sub variantgraph :Local :Args(1) {
+	my( $self, $c, $textid ) = @_;
+	my $tradition = $c->model('Directory')->tradition( $textid );
+	unless( $tradition ) {
+		return _json_error( $c, 404, "No tradition with ID $textid" );
+	}	
+	my $ok = _check_permission( $c, $tradition );
+	return unless $ok;
+
+	my $collation = $tradition->collation;
+	$c->stash->{'result'} = $collation->as_svg;
+	$c->forward('View::SVG');
+}
+	
 =head2 stemma
 
- GET /stemma/$textid
- POST /stemma/$textid, { 'dot' => $dot_string }
+ GET /stemma/$textid/$stemmaseq
+ POST /stemma/$textid/$stemmaseq, { 'dot' => $dot_string }
 
-Returns an SVG representation of the stemma hypothesis for the text.  If 
-the URL is called with POST and a new dot string, updates the stemma and
-returns the SVG as with GET.
+Returns an SVG representation of the given stemma hypothesis for the text.  
+If the URL is called with POST, the stemma at $stemmaseq will be altered
+to reflect the definition in $dot_string. If $stemmaseq is 'n', a new
+stemma will be added.
 
 =cut
 
-sub stemma :Local :Args(1) {
-	my( $self, $c, $textid ) = @_;
+sub stemma :Local :Args(2) {
+	my( $self, $c, $textid, $stemmaid ) = @_;
 	my $m = $c->model('Directory');
 	my $tradition = $m->tradition( $textid );
-	
+	unless( $tradition ) {
+		return _json_error( $c, 404, "No tradition with ID $textid" );
+	}	
+	my $ok = _check_permission( $c, $tradition );
+	return unless $ok;
+
+	$c->stash->{'result'} = '';
+	my $stemma;
 	if( $c->req->method eq 'POST' ) {
-		# Update the stemma
-		my $dot = $c->request->body_params->{'dot'};
-		$tradition->add_stemma( $dot );
-		$m->store( $tradition );
+		if( $ok eq 'full' ) {
+			my $dot = $c->request->body_params->{'dot'};
+			try {
+				if( $stemmaid eq 'n' ) {
+					# We are adding a new stemma.
+					$stemmaid = $tradition->stemma_count;
+					$stemma = $tradition->add_stemma( 'dot' => $dot );
+				} elsif( $stemmaid !~ /^\d+$/ ) {
+					return _json_error( $c, 403, "Invalid stemma ID specification $stemmaid" );
+				} elsif( $stemmaid < $tradition->stemma_count ) {
+					# We are updating an existing stemma.
+					$stemma = $tradition->stemma( $stemmaid );
+					$stemma->alter_graph( $dot );
+				} else {
+					# Unrecognized stemma ID
+					return _json_error( $c, 404, "No stemma at index $stemmaid, cannot update" );
+				}
+			} catch ( Text::Tradition::Error $e ) {
+				return _json_error( $c, 500, $e->message );
+			}
+			$m->store( $tradition );
+		} else {
+			# No permissions to update the stemma
+			return _json_error( $c, 403, 
+				'You do not have permission to update stemmata for this tradition' );
+		}
 	}
 	
-	$c->stash->{'result'} = $tradition->stemma_count
-		? $tradition->stemma(0)->as_svg( { size => [ 500, 375 ] } )
-		: '';
-	$c->forward('View::SVG');
+	# For a GET or a successful POST request, return the SVG representation
+	# of the stemma in question, if any.
+	if( !$stemma && $tradition->stemma_count > $stemmaid ) {
+		$stemma = $tradition->stemma( $stemmaid );
+	}
+	my $stemma_xml = $stemma ? $stemma->as_svg( { size => [ 500, 375 ] } ) : '';
+	# What was requested, XML or JSON?
+	my $return_view = 'SVG';
+	if( my $accept_header = $c->req->header('Accept') ) {
+		$c->log->debug( "Received Accept header: $accept_header" );
+		foreach my $type ( split( /,\s*/, $accept_header ) ) {
+			# If we were first asked for XML, return SVG
+			last if $type =~ /^(application|text)\/xml$/;
+			# If we were first asked for JSON, return JSON
+			if( $type eq 'application/json' ) {
+				$return_view = 'JSON';
+				last;
+			}
+		}
+	}
+	if( $return_view eq 'SVG' ) {
+		$c->stash->{'result'} = $stemma_xml;
+		$c->forward('View::SVG');
+	} else { # JSON
+		$stemma_xml =~ s/\n/ /mg;
+		$c->stash->{'result'} = { 'stemmaid' => $stemmaid, 'stemmasvg' => $stemma_xml };
+		$c->forward('View::JSON');
+	}
 }
 
 =head2 stemmadot
 
- GET /stemmadot/$textid
+ GET /stemmadot/$textid/$stemmaseq
  
 Returns the 'dot' format representation of the current stemma hypothesis.
 
 =cut
 
-sub stemmadot :Local :Args(1) {
-	my( $self, $c, $textid ) = @_;
+sub stemmadot :Local :Args(2) {
+	my( $self, $c, $textid, $stemmaid ) = @_;
 	my $m = $c->model('Directory');
 	my $tradition = $m->tradition( $textid );
-	
-	$c->response->body( $tradition->stemma->editable );
-	$c->forward('View::Plain');
+	unless( $tradition ) {
+		return _json_error( $c, 404, "No tradition with ID $textid" );
+	}	
+	my $ok = _check_permission( $c, $tradition );
+	return unless $ok;
+	my $stemma = $tradition->stemma( $stemmaid );
+	unless( $stemma ) {
+		return _json_error( $c, 404, "Tradition $textid has no stemma ID $stemmaid" );
+	}
+	# Get the dot and transmute its line breaks to literal '|n'
+	$c->stash->{'result'} = { 'dot' =>  $stemma->editable( { linesep => '|n' } ) };
+	$c->forward('View::JSON');
+}
+
+####################
+### Helper functions
+####################
+
+# Helper to check what permission, if any, the active user has for
+# the given tradition
+sub _check_permission {
+	my( $c, $tradition ) = @_;
+    my $user = $c->user_exists ? $c->user->get_object : undef;
+    if( $user ) {
+    	return 'full' if ( $user->is_admin || 
+    		( $tradition->has_user && $tradition->user->id eq $user->id ) );
+    }
+	# Text doesn't belong to us, so maybe it's public?
+	return 'readonly' if $tradition->public;
+
+	# ...nope. Forbidden!
+	return _json_error( $c, 403, 'You do not have permission to view this tradition.' );
+}
+
+# Helper to throw a JSON exception
+sub _json_error {
+	my( $c, $code, $errmsg ) = @_;
+	$c->response->status( $code );
+	$c->stash->{'result'} = { 'error' => $errmsg };
+	$c->forward('View::JSON');
+	return 0;
 }
 
 =head2 default