summaryrefslogtreecommitdiff
path: root/morphlib/morphologyfinder.py
blob: affa0e97aead1a0329338d85c1b9160c47a58bb2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
# Copyright (C) 2013  Codethink Limited
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 2 of the License.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along
# with this program; if not, write to the Free Software Foundation, Inc.,
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
#
# =*= License: GPL-2 =*=


import cliapp

import morphlib


class MorphologyFinder(object):

    '''Abstract away finding morphologies in a git repository.

    This class provides an abstraction layer between a git repository
    and the morphologies contained in it.

    '''

    def __init__(self, gitdir, ref=None):
        self.gitdir = gitdir
        self.ref = ref

    def read_morphology(self, name):
        '''Return the un-parsed text of a morphology.
        
        For the given morphology name, locate and return the contents
        of the morphology as a string.

        Also returns a string describing where in the repository the
        morphology is located.

        Parsing of this morphology into a form useful for manipulating
        is handled by the MorphologyLoader class.
        
        '''
        filename = '%s.morph' % name
        return self.gitdir.read_file(filename, self.ref), filename

    def list_morphologies(self):
        '''Return the names of all morphologies in the (repo, ref).

        Finds all morphologies in the git directory at the specified
        ref. Morphology names are returned instead of filenames,
        so the implementation may change how morphologies are stored
        in git repositories.

        '''

        def is_morphology_path(path):
            return path.endswith('.morph')

        def transform_path_to_name(path):
            return path[:-len('.morph')]

        return (transform_path_to_name(path)
                for path in self.gitdir.list_files(self.ref)
                if is_morphology_path(path))