Commit | Line | Data |
dd3b58b0 |
1 | package Text::Tradition; |
2 | |
4a8828f0 |
3 | use Module::Load; |
dd3b58b0 |
4 | use Moose; |
8e1394aa |
5 | use Text::Tradition::Collation; |
6 | use Text::Tradition::Witness; |
dd3b58b0 |
7 | |
8 | has 'collation' => ( |
8e1394aa |
9 | is => 'ro', |
10 | isa => 'Text::Tradition::Collation', |
11 | writer => '_save_collation', |
12 | ); |
dd3b58b0 |
13 | |
14 | has 'witnesses' => ( |
8e1394aa |
15 | traits => ['Array'], |
8e1394aa |
16 | isa => 'ArrayRef[Text::Tradition::Witness]', |
17 | handles => { |
910a0a6d |
18 | witnesses => 'elements', |
19 | add_witness => 'push', |
8e1394aa |
20 | }, |
4a8828f0 |
21 | default => sub { [] }, |
8e1394aa |
22 | ); |
c5104dc0 |
23 | |
df6d9812 |
24 | has 'name' => ( |
25 | is => 'rw', |
26 | isa => 'Str', |
27 | default => 'Tradition', |
28 | ); |
910a0a6d |
29 | |
30 | around 'add_witness' => sub { |
31 | my $orig = shift; |
32 | my $self = shift; |
33 | my $new_wit = Text::Tradition::Witness->new( @_ ); |
34 | $self->$orig( $new_wit ); |
35 | return $new_wit; |
36 | }; |
37 | |
df6d9812 |
38 | |
8e1394aa |
39 | sub BUILD { |
40 | my( $self, $init_args ) = @_; |
c5104dc0 |
41 | |
8e1394aa |
42 | if( exists $init_args->{'witnesses'} ) { |
910a0a6d |
43 | # We got passed an uncollated list of witnesses. Make a |
44 | # witness object for each witness, and then send them to the |
45 | # collator. |
46 | my $autosigil = 0; |
47 | foreach my $wit ( %{$init_args->{'witnesses'}} ) { |
48 | # Each item in the list is either a string or an arrayref. |
49 | # If it's a string, it is a filename; if it's an arrayref, |
50 | # it is a tuple of 'sigil, file'. Handle either case. |
51 | my $args; |
52 | if( ref( $wit ) eq 'ARRAY' ) { |
53 | $args = { 'sigil' => $wit->[0], |
54 | 'file' => $wit->[1] }; |
55 | } else { |
56 | $args = { 'sigil' => chr( $autosigil+65 ), |
57 | 'file' => $wit }; |
58 | $autosigil++; |
59 | } |
60 | $self->witnesses->add_witness( $args ); |
61 | # TODO Now how to collate these? |
62 | } |
c5104dc0 |
63 | } else { |
910a0a6d |
64 | # Else we need to parse some collation data. Make a Collation object |
65 | my $collation = Text::Tradition::Collation->new( %$init_args, |
66 | 'tradition' => $self ); |
67 | $self->_save_collation( $collation ); |
4a8828f0 |
68 | |
910a0a6d |
69 | # Call the appropriate parser on the given data |
d9e873d0 |
70 | my @formats = grep { /^(Self|CollateX|CSV|CTE|KUL|TEI|Tabular)$/ } keys( %$init_args ); |
910a0a6d |
71 | my $format = shift( @formats ); |
72 | unless( $format ) { |
73 | warn "No data given to create a collation; will initialize an empty one"; |
74 | } |
4d85a60e |
75 | if( $format && $format =~ /^(KUL)$/ && |
910a0a6d |
76 | !exists $init_args->{'base'} ) { |
77 | warn "Cannot make a collation from $format without a base text"; |
78 | return; |
79 | } |
4a8828f0 |
80 | |
910a0a6d |
81 | # Now do the parsing. |
82 | my @sigla; |
83 | if( $format ) { |
84 | my @parseargs; |
4d85a60e |
85 | if( $format =~ /^(KUL)$/ ) { |
910a0a6d |
86 | $init_args->{'data'} = $init_args->{$format}; |
87 | $init_args->{'format'} = $format; |
88 | $format = 'BaseText'; |
89 | @parseargs = %$init_args; |
90 | } else { |
91 | @parseargs = ( $init_args->{ $format } ); |
92 | } |
93 | my $mod = "Text::Tradition::Parser::$format"; |
94 | load( $mod ); |
95 | $mod->can('parse')->( $self, @parseargs ); |
96 | } |
c5104dc0 |
97 | } |
8e1394aa |
98 | } |
c5104dc0 |
99 | |
de51424a |
100 | sub witness { |
101 | my( $self, $sigil ) = @_; |
102 | my $requested_wit; |
910a0a6d |
103 | foreach my $wit ( $self->witnesses ) { |
ecff899f |
104 | if( $wit->sigil eq $sigil ) { |
105 | $requested_wit = $wit; |
106 | last; |
107 | } |
de51424a |
108 | } |
e2902068 |
109 | # We depend on an undef return value for no such witness. |
110 | # warn "No such witness $sigil" unless $requested_wit; |
de51424a |
111 | return $requested_wit; |
112 | } |
ecff899f |
113 | |
910a0a6d |
114 | |
4a8828f0 |
115 | |
dd3b58b0 |
116 | # The user will usually be instantiating a Tradition object, and |
117 | # examining its collation. The information about the tradition can |
118 | # come via several routes: |
119 | # - graphML from CollateX or elsewhere, standalone |
120 | # - TEI parallel segmentation |
121 | # - Leuven-style spreadsheet of variants, converted to CSV, plus base text |
122 | # - apparatus pulled from CTE, plus base text |
123 | # From this we should be able to get basic witness information. |
124 | # |
125 | # Alternatively the user can just give us the uncollated texts. Then |
126 | # instead of passing a collation, s/he is passing a set of witnesses |
127 | # from which we will generate a collation. Those witnesses can be in |
128 | # plaintext or in TEI with certain constraints adopted. |
129 | |
130 | # So the constructor for a tradition needs to take one of these infosets, |
131 | # and construct the collation and the witness objects. |
132 | |
133 | no Moose; |
134 | __PACKAGE__->meta->make_immutable; |