Thuban/Model/data.py

# Copyright (C) 2003 by Intevation GmbH
# Authors:
# Bernhard Herzog <[email protected]>
#
# This program is free software under the GPL (>=v2)
# Read the file COPYING coming with the software for details.

"""Data source abstractions"""

__version__ = "$Revision$"
# $Source$
# $Id$

import os
import warnings
import weakref

import shapelib
import table
import transientdb


class ShapeTable(transientdb.AutoTransientTable):

    """A Table that depends on a ShapefileStore

    Intended use is by the ShapefileStore for the table associated with
    the shapefiles.
    """

    def __init__(self, store, db, table):
        """Initialize the ShapeTable.

        Parameters:
            store -- the ShapefileStore the table is to depend on
            db -- The transient database to use
            table -- the table
        """
        transientdb.AutoTransientTable.__init__(self, db, table)
        self.store = weakref.ref(store)

    def Dependencies(self):
        """Return a tuple containing the shapestore"""
        return (self.store(),)


class ShapefileStore:

    """Combine a shapefile and the corresponding DBF file into one object"""

    def __init__(self, session, filename):
        # Make the filename absolute. The filename will be
        # interpreted relative to that anyway, but when saving a
        # session we need to compare absolute paths and it's usually
        # safer to always work with absolute paths.
        self.filename = os.path.abspath(filename)

        self.shapefile = shapelib.ShapeFile(self.filename)
        self.dbftable = table.DBFTable(filename)
        self.table = ShapeTable(self, session.TransientDB(), self.dbftable)

    def Table(self):
        """Return the table containing the attribute data"""
        return self.table

    def Shapefile(self):
        """Return the shapefile object"""
        return self.shapefile

    def FileName(self):
        """Return the filename used to open the shapefile"""
        return self.filename

    def FileType(self):
        """Return the filetype. This is always the string 'shapefile'"""
        return "shapefile"

    def Dependencies(self):
        """Return the empty tuple.

        The ShapefileStore doesn't depend on anything else.
        """
        return ()


class DerivedShapeStore:

    """A ShapeStore derived from other shapestores or tables"""

    def __init__(self, shapestore, table):
        """Initialize the derived shapestore.

        The arguments are a shapestore for the shapedata and a table for
        the tabular data.
        """
        self.shapestore = shapestore
        self.table = table

    def Table(self):
        """Return the table"""
        return self.table

    def Shapefile(self):
        """Return the shapefile of he underlying shapestore"""
        return self.shapestore.Shapefile()

    def Dependencies(self):
        """Return a tuple containing the shapestore and the table"""
        return (self.shapestore, self.table)


class SimpleStore:

    """Combine a shapefile and a table object"""

    def __init__(self, shapefile, table):
        warnings.warn("The SimpleStore is deprecated."
                      " Use DerivedShapeStore instead",
                      DeprecationWarning, stacklevel = 2)
        self.shapefile = shapefile
        self.table = table
        self.filename = None

    def Table(self):
        return self.table

    def Shapefile(self):
        return self.shapefile
1	bh	723	# Copyright (C) 2003 by Intevation GmbH
2			# Authors:
3			# Bernhard Herzog <[email protected]>
4			#
5			# This program is free software under the GPL (>=v2)
6			# Read the file COPYING coming with the software for details.
7
8			"""Data source abstractions"""
9
10			__version__ = "$Revision$"
11			# $Source$
12			# $Id$
13
14			import os
15	bh	984	import warnings
16			import weakref
17	bh	723
18			import shapelib
19			import table
20	bh	765	import transientdb
21	bh	723
22	bh	765
23	bh	984	class ShapeTable(transientdb.AutoTransientTable):
24
25			"""A Table that depends on a ShapefileStore
26
27			Intended use is by the ShapefileStore for the table associated with
28			the shapefiles.
29			"""
30
31			def __init__(self, store, db, table):
32			"""Initialize the ShapeTable.
33
34			Parameters:
35			store -- the ShapefileStore the table is to depend on
36			db -- The transient database to use
37			table -- the table
38			"""
39			transientdb.AutoTransientTable.__init__(self, db, table)
40			self.store = weakref.ref(store)
41
42			def Dependencies(self):
43			"""Return a tuple containing the shapestore"""
44			return (self.store(),)
45
46
47	bh	723	class ShapefileStore:
48
49			"""Combine a shapefile and the corresponding DBF file into one object"""
50
51			def __init__(self, session, filename):
52			# Make the filename absolute. The filename will be
53			# interpreted relative to that anyway, but when saving a
54			# session we need to compare absolute paths and it's usually
55			# safer to always work with absolute paths.
56			self.filename = os.path.abspath(filename)
57
58			self.shapefile = shapelib.ShapeFile(self.filename)
59	bh	765	self.dbftable = table.DBFTable(filename)
60	bh	984	self.table = ShapeTable(self, session.TransientDB(), self.dbftable)
61	bh	723
62			def Table(self):
63	bh	984	"""Return the table containing the attribute data"""
64	bh	723	return self.table
65
66			def Shapefile(self):
67	bh	984	"""Return the shapefile object"""
68	bh	723	return self.shapefile
69	bh	765
70	bh	984	def FileName(self):
71			"""Return the filename used to open the shapefile"""
72			return self.filename
73	bh	765
74	bh	984	def FileType(self):
75			"""Return the filetype. This is always the string 'shapefile'"""
76			return "shapefile"
77
78			def Dependencies(self):
79			"""Return the empty tuple.
80
81			The ShapefileStore doesn't depend on anything else.
82			"""
83			return ()
84
85
86			class DerivedShapeStore:
87
88			"""A ShapeStore derived from other shapestores or tables"""
89
90			def __init__(self, shapestore, table):
91			"""Initialize the derived shapestore.
92
93			The arguments are a shapestore for the shapedata and a table for
94			the tabular data.
95			"""
96			self.shapestore = shapestore
97			self.table = table
98
99			def Table(self):
100			"""Return the table"""
101			return self.table
102
103			def Shapefile(self):
104			"""Return the shapefile of he underlying shapestore"""
105			return self.shapestore.Shapefile()
106
107			def Dependencies(self):
108			"""Return a tuple containing the shapestore and the table"""
109			return (self.shapestore, self.table)
110
111
112	bh	765	class SimpleStore:
113
114			"""Combine a shapefile and a table object"""
115
116			def __init__(self, shapefile, table):
117	bh	984	warnings.warn("The SimpleStore is deprecated."
118			" Use DerivedShapeStore instead",
119			DeprecationWarning, stacklevel = 2)
120	bh	765	self.shapefile = shapefile
121			self.table = table
122			self.filename = None
123
124			def Table(self):
125			return self.table
126
127			def Shapefile(self):
128			return self.shapefile
Name	Value
svn:eol-style	native
svn:keywords	Author Date Id Revision