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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
|
#!/usr/bin/env python
#
# Copyright (c) 2008-2010 by Enthought, Inc.
# All rights reserved.
"""
Drawing and interaction packages.
The Enable *project* provides two related multi-platform *packages* for drawing
GUI objects.
- **Enable**: An object drawing library that supports containment and event
notification.
- **Kiva**: A multi-platform DisplayPDF vector drawing engine.
Enable
------
The Enable package is a multi-platform object drawing library built on top of
Kiva. The core of Enable is a container/component model for drawing and event
notification. The core concepts of Enable are:
- Component
- Container
- Events (mouse, drag, and key events)
Enable provides a high-level interface for creating GUI objects, while
enabling a high level of control over user interaction. Enable is a supporting
technology for the Chaco and BlockCanvas projects.
Kiva
----
Kiva is a multi-platform DisplayPDF vector drawing engine that supports
multiple output backends, including Windows, GTK, and Macintosh native
windowing systems, a variety of raster image formats, PDF, and Postscript.
DisplayPDF is more of a convention than an actual specification. It is a
path-based drawing API based on a subset of the Adobe PDF specification.
Besides basic vector drawing concepts such as paths, rects, line sytles, and
the graphics state stack, it also supports pattern fills, antialiasing, and
transparency. Perhaps the most popular implementation of DisplayPDF is
Apple's Quartz 2-D graphics API in Mac OS X.
Kiva Features
`````````````
Kiva currently implements the following features:
- paths and compiled paths; arcs, bezier curves, rectangles
- graphics state stack
- clip stack, disjoint rectangular clip regions
- raster image blitting
- arbitrary affine transforms of the graphics context
- bevelled and mitered joins
- line width, line dash
- Freetype or native fonts
- RGB, RGBA, or grayscale color depths
- transparency
Prerequisites
-------------
You must have the following libraries installed before building or installing
the Enable project:
* `setuptools <http://pypi.python.org/pypi/setuptools/0.6c8>`_
* `SWIG <http://www.swig.org/>`_ version 1.3.30 or later.
* `Cython <http://www.cython.org>`_ version 0.12.1 or later
* `Numpy <http://pypi.python.org/pypi/numpy/1.1.1>`_ version 1.1.0 or later is
preferred. Version 1.0.4 will work, but some tests may fail.
* `ReportLab Toolkit <http://www.reportlab.org/rl_toolkit.html/>`_ for PDF
backend support in Kiva.
"""
# FIXME: Hack to add arguments to setup.py develop
#
# These are necessary to get the clib compiled. The following also adds
# an additional option --compiler=STR to develop, which usually does not
# have such an option. The code below is a bad hack, as it changes
# sys.argv to fool setuptools which therefore has to be imported BELOW
# this hack.
import sys
if 'develop' in sys.argv:
idx = sys.argv.index('develop')
compiler = []
for arg in sys.argv[idx+1:]:
if arg.startswith('--compiler='):
compiler = ['-c', arg[11:]]
del sys.argv[idx+1:]
# insert extra options right before 'develop'
sys.argv[idx:idx] = ['build_src', '--inplace', 'build_clib'] + compiler + \
['build_ext', '--inplace'] + compiler
# Setuptools must be imported BEFORE numpy.distutils for things to work right!
import setuptools
import distutils
import numpy
import os
import shutil
import zipfile
from numpy.distutils.core import setup
# FIXME: This works around a setuptools bug which gets setup_data.py metadata
# from incorrect packages. Ticket #1592
#from setup_data import INFO
setup_data = dict(__name__='', __file__='setup_data.py')
execfile('setup_data.py', setup_data)
INFO = setup_data['INFO']
# Configure python extensions.
def configuration(parent_package='', top_path=None):
from numpy.distutils.misc_util import Configuration
config = Configuration(None, parent_package, top_path)
config.set_options(
ignore_setup_xxx_py=True,
assume_default_configuration=True,
delegate_options_to_subpackages=True,
quiet=True,
)
config.add_subpackage('enthought.kiva')
config.add_subpackage('enthought')
return config
# Build the full set of packages by appending any found by setuptools'
# find_packages to those discovered by numpy.distutils.
config = configuration().todict()
packages = setuptools.find_packages(exclude=config['packages'] +
['docs', 'examples'])
packages += ['enthought.savage.traits.ui.wx.data']
config['packages'] += packages
# The following monkeypatching code comes from Numpy distutils.
#
# numpy 1.0.3 provides a fix to distutils to make sure that build_clib is
# run before build_ext. This is critical for semi-automatic building of
# many extension modules using numpy. Here, we monkey-patch the run method
# of the build_ext command to provide the fix in 1.0.3.
if numpy.__version__[:5] < '1.0.3':
from numpy.distutils.command import build_ext
old_run = build_ext.build_ext.run
def new_run(self):
if not self.extensions:
return
# Make sure that extension sources are complete.
self.run_command('build_src')
if self.distribution.has_c_libraries():
self.run_command('build_clib')
build_clib = self.get_finalized_command('build_clib')
self.library_dirs.append(build_clib.build_clib)
else:
build_clib = None
old_run(self)
build_ext.build_ext.run = new_run
# Monkeypatch the 'develop' command so that we build_src will execute
# inplace. This is fixed in numpy 1.0.5 (svn r4569).
if numpy.__version__[:5] < '1.0.5':
# Replace setuptools's develop command with our own
from setuptools.command import develop
old_develop = develop.develop
class develop(old_develop):
__doc__ = old_develop.__doc__
def install_for_development(self):
self.reinitialize_command('build_src', inplace=1)
old_develop.install_for_development(self)
develop.develop = develop
# Make numpy distutils use this develop.
from numpy.distutils import core
core.numpy_cmdclass['develop'] = develop
class MyDevelop(setuptools.command.develop.develop):
'''
Subclass to generate our docs when doing a develop.
This subclasses setuptools' develop since numpy.distutils doesn't have one.
'''
def run(self):
setuptools.command.develop.develop.run(self)
self.run_command('build_docs')
class MyBuild(numpy.distutils.command.build.build):
'''
Subclass to generate our docs when doing a build.
This subclasses numpy.distutils' version because we're using the
numpy.distutils setup function below.
'''
def run(self):
numpy.distutils.command.build.build.run(self)
self.run_command('build_docs')
class MyClean(distutils.command.clean.clean):
'''
Subclass to remove any files created in an inplace build.
This subclasses distutils' clean because neither setuptools nor
numpy.distutils implements a clean command.
'''
def run(self):
distutils.command.clean.clean.run(self)
# Clean any build or dist directory
if os.path.isdir("build"):
shutil.rmtree("build", ignore_errors=True)
if os.path.isdir("dist"):
shutil.rmtree("dist", ignore_errors=True)
# Clean out any files produced by an in-place build. Note that our
# code assumes the files are relative to the 'enthought/kiva' dir.
INPLACE_FILES = (
# Common AGG
os.path.join("agg", "agg.py"),
os.path.join("agg", "plat_support.py"),
os.path.join("agg", "agg_wrap.cpp"),
# Mac
os.path.join("mac", "ABCGI.so"),
os.path.join("mac", "macport.so"),
os.path.join("mac", "ABCGI.c"),
os.path.join("mac", "ATSFont.so"),
os.path.join("mac", "ATSFont.c"),
# Win32 Agg
os.path.join("agg", "_agg.pyd"),
os.path.join("agg", "_plat_support.pyd"),
os.path.join("agg", "src", "win32", "plat_support.pyd"),
# *nix Agg
os.path.join("agg", "_agg.so"),
os.path.join("agg", "_plat_support.so"),
os.path.join("agg", "src", "x11", "plat_support_wrap.cpp"),
# Misc
os.path.join("agg", "src", "gl", "plat_support_wrap.cpp"),
os.path.join("agg", "src", "gl", "plat_support.py"),
)
for f in INPLACE_FILES:
f = os.path.join("enthought", "kiva", f)
if os.path.isfile(f):
os.remove(f)
# The actual setup call.
DOCLINES = __doc__.split("\n")
setup(
author = 'Enthought, Inc',
author_email = 'info@enthought.com',
classifiers = [c.strip() for c in """\
Development Status :: 5 - Production/Stable
Intended Audience :: Developers
Intended Audience :: Science/Research
License :: OSI Approved :: BSD License
Operating System :: MacOS
Operating System :: Microsoft :: Windows
Operating System :: OS Independent
Operating System :: POSIX
Operating System :: Unix
Programming Language :: C
Programming Language :: Python
Topic :: Scientific/Engineering
Topic :: Software Development
Topic :: Software Development :: Libraries
""".splitlines() if len(c.strip()) > 0],
cmdclass = {
# Work around a numpy distutils bug by forcing the use of the
# setuptools' sdist command.
'sdist': setuptools.command.sdist.sdist,
# Use our customized commands
'build': MyBuild,
'clean': MyClean,
'develop': MyDevelop,
},
description = DOCLINES[1],
download_url = ('http://www.enthought.com/repo/ETS/Enable-%s.tar.gz' %
INFO['version']),
extras_require = INFO['extras_require'],
include_package_data = True,
install_requires = INFO['install_requires'],
license = 'BSD',
long_description = '\n'.join(DOCLINES[3:]),
maintainer = 'ETS Developers',
maintainer_email = 'enthought-dev@enthought.com',
name = INFO['name'],
namespace_packages = [
"enthought",
],
package_data = {'': ['*.zip', '*.svg']},
platforms = ["Windows", "Linux", "Mac OS-X", "Unix", "Solaris"],
setup_requires = [
'cython',
'setupdocs>=1.0',
],
tests_require = [
'nose >= 0.10.3',
],
test_suite = 'nose.collector',
url = 'http://code.enthought.com/projects/enable',
version = INFO['version'],
zip_safe = False,
**config
)
|