1 package Text::Tradition::HasStemma;
6 use Text::Tradition::Stemma;
7 use Text::Tradition::StemmaUtil qw/ parse_newick /;
11 Text::Tradition::HasStemma - add-on to associate stemma hypotheses to
12 Text::Tradition objects
16 It is often the case that, for a given text tradition, the order of copying
17 of the witnesses can or should be reconstructed (or at least the attempt
18 should be made.) This class is a role that can be applied to
19 Text::Tradition objects to record stemma hypotheses. See the documentation
20 for L<Text::Tradition::Stemma> for more information.
26 Return a list of all stemmata associated with the tradition.
30 Return the number of stemma hypotheses defined for this tradition.
34 Return the L<Text::Tradition::Stemma> object identified by the given index.
38 Delete all stemma hypotheses associated with this tradition.
40 =head2 has_stemweb_jobid
42 Returns true if there is currently a Stemweb job ID, indicating that a
43 stemma tree calculation from the Stemweb service is in process.
47 Return the currently-running job ID (if any) for calculation of Stemweb
50 =head2 set_stemweb_jobid( $jobid )
52 Record a job ID for a Stemweb calculation.
58 isa => 'ArrayRef[Text::Tradition::Stemma]',
60 stemmata => 'elements',
61 _add_stemma => 'push',
63 stemma_count => 'count',
64 clear_stemmata => 'clear',
66 default => sub { [] },
69 has 'stemweb_jobid' => (
72 writer => 'set_stemweb_jobid',
73 predicate => 'has_stemweb_jobid',
74 clearer => '_clear_stemweb_jobid',
77 before 'set_stemweb_jobid' => sub {
79 if( $self->has_stemweb_jobid ) {
80 $self->throw( "Tradition already has a Stemweb jobid: "
81 . $self->stemweb_jobid );
85 =head2 add_stemma( $dotfile )
87 Initializes a Text::Tradition::Stemma object from the given dotfile,
88 and associates it with the tradition.
94 my $t = Text::Tradition->new(
95 'name' => 'simple test',
97 'file' => 't/data/simple.txt',
99 is( $t->stemma_count, 0, "No stemmas added yet" );
101 ok( $s = $t->add_stemma( dotfile => 't/data/simple.dot' ), "Added a simple stemma" );
102 is( ref( $s ), 'Text::Tradition::Stemma', "Got a stemma object returned" );
103 is( $t->stemma_count, 1, "Tradition claims to have a stemma" );
104 is( $t->stemma(0), $s, "Tradition hands back the right stemma" );
114 if( $opts{'dotfile'} ) {
115 open $stemma_fh, '<', $opts{'dotfile'}
116 or warn "Could not open file " . $opts{'dotfile'};
117 } elsif( $opts{'dot'} ) {
118 my $str = $opts{'dot'};
119 open $stemma_fh, '<', \$str;
122 binmode $stemma_fh, ':utf8';
123 my $stemma = Text::Tradition::Stemma->new(
124 'dot' => $stemma_fh );
125 $self->_add_stemma( $stemma ) if $stemma;
129 =head2 record_stemweb_result( $format, $data )
131 Records the result returned by a Stemweb calculation, and clears any
138 sub record_stemweb_result {
139 my( $self, $format, $data ) = @_;
140 if( $format eq 'dot' ) {
141 $self->add_stemma( dot => $data );
142 } elsif( $format eq 'newick' ) {
143 my $stemmata = parse_newick( $data );
144 foreach my $stemma ( @$stemmata ) {
145 $self->_add_stemma( $stemma );
147 $self->_clear_stemweb_jobid();
149 $self->throw( "Cannot parse tree results with format $format" );
157 This package is free software and is provided "as is" without express
158 or implied warranty. You can redistribute it and/or modify it under
159 the same terms as Perl itself.
163 Tara L Andrews E<lt>aurum@cpan.orgE<gt>