summaryrefslogtreecommitdiff
path: root/morphlib/artifact.py
blob: f5c2e8a544a0d35904504446b1090d0a63b0db06 (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
# Copyright (C) 2012  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.


class Artifact(object):

    '''Represent a build result generated from a source.
    
    Has the following properties:
    
    * ``source`` -- the source from which the artifact is built
    * ``name`` -- the name of the artifact
    * ``cache_key`` -- a cache key to uniquely identify the artifact
    * ``dependencies`` -- list of Artifacts that need to be built beforehand
    * ``dependents`` -- list of Artifacts that need this Artifact to be built
    
    The ``dependencies`` and ``dependents`` lists MUST be modified by
    the ``add_dependencies`` and ``add_dependent`` methods only.
    
    '''
    
    def __init__(self, source, name, cache_key):
        self.source = source
        self.name = name
        self.cache_key = cache_key
        self.dependencies = []
        self.dependents = []

    def add_dependency(self, artifact):
        '''Add ``artifact`` to the dependency list.'''
        if artifact not in self.dependencies:
            self.dependencies.append(artifact)
            artifact.dependents.append(self)

    def depends_on(self, artifact):
        '''Do we depend on ``artifact``?'''
        return artifact in self.dependencies

    def basename(self): # pragma: no cover
        return '%s.%s.%s' % (self.cache_key,
                             self.source.morphology['kind'],
                             self.name)

    def __str__(self): # pragma: no cover
        return '%s|%s' % (self.source, self.name)