-
Notifications
You must be signed in to change notification settings - Fork 0
/
PKG-INFO
154 lines (108 loc) · 5.77 KB
/
PKG-INFO
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
Metadata-Version: 1.1
Name: planar
Version: 0.4
Summary: 2D planar geometry library for Python.
Home-page: http://bitbucket.org/caseman/planar/
Author: Casey Duncan
Author-email: [email protected]
License: BSD
Description: Planar Overview
===============
Planar is a 2D geometry library for Python. It is intended for use by games
and interactive real-time applications, but is designed to be useful for
most any program that needs a convenient, high-performance geometry API.
Planar is being developed as part of the larger Grease game framework.
However, it is a standalone library and has no external dependencies besides
Python, and optionally a C compiler.
Planar is purely a math library, presentation, graphical or otherwise is
left up to the application.
Project Goals
-------------
* Do one thing, 2D geometry, and do it well.
* Provide a high-level, clean, Pythonic API.
* All APIs have both a Python reference implementation and a high performance
implementation in C with the same interface.
* Compatibility with Python 2.6+, and Python 3.1+
* 100% test coverage.
* Full narrative and API reference documentation.
* Platform-independent.
* Release early and often.
* Be responsive to community input.
* Don't take ourselves too seriously.
License
-------
Planar is distributed under the terms of the new BSD license. You are free to
use it for commercial or non-commercial projects with little or no
restriction, all we ask is that:
* Redistributions of the code, in whole or part, retain the original
copyright notice and license text.
* You do not claim our endorsement of any derived product.
For a complete text of the license see the ``LICENSE.txt`` file in the source
distrbution.
Acknowledgements
----------------
The API for planar, and some of the code is derived from the excellent
work done by the Super Effective Team, thanks guys!
* http://www.supereffective.org/pages/Vector-2d-Vector-Library
Requirements
------------
Planar requires Python 2.6, 2.7, 3.1, or better.
To experience the exhilaration of native-code performance, a C compiler is
required. If someone volunteers, binary releases for platforms where this
is not common (you know who you are) will be happily made available.
Downloading Planar
------------------
Planar releases can be downloaded from the python package index (pypi):
* http://pypi.python.org/pypi/planar/
You can get the latest code in development from the planar mercurial
repository on bitbucket:
* http://bitbucket.org/caseman/planar/
Installation
------------
To build and install Planar from the source distribution or repository use::
python setup.py install
To install only the pure-Python modules without compiling, use::
python setup.py build_py install --skip-build
Only performance is sacrificed without the C extensions, all functionality is
still available when using only the pure-Python modules.
Tests
-----
Planar requires nose for testing. You can install it for Python 2.x
using easy_install::
easy_install nose
For Python 3.x, you can download and install distribute from here:
* http://pypi.python.org/pypi/distribute
For now, you can get a copy of nose3 for Python 3.x, patched to install
properly on Python 3.1 here:
* http://bitbucket.org/caseman/nose3-caseman-fix/get/7c9181ad403d.zip
Once nose is installed you can run the tests from the source directory
using ``nosetests``, first building the C extensions, like so (on Unix)::
python setup.py build && nosetests -d -w build/lib.*/planar/
This runs the tests inside the ``build`` directory so that the C extensions
can be tested. You can put a ``3`` suffix on the ``python`` and ``nosetests``
commands above for Python 3.x.
Documentation
-------------
You can browse the documentation online here:
* http://pygamesf.org/~casey/planar/doc/
The same documentation is also available for offline browsing in the
``doc/build/html`` subdirectory of the source distribution.
Contributing and Getting Support
--------------------------------
Come visit us at the Grease users google group to get help, moral support,
lavish praise, complain bitterly, report a bug, or contribute ideas:
* http://groups.google.com/group/grease-users
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: BSD License
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.1
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Provides: planar