Python bindings for mapnik
Project description
==========================
Introduction
==========================
.. contents::
Official mapnik bindings repackaged in the distutils way to facilitate deployments.
MAPNIK2 Notes
===============
The python bindings are tied to the mapnik2 library version.
To use with:
- :mapnik2 library - 2.0.1: -> mapnik2 2.0.1.2 ::
easy_install -U mapnik2==2.0.1.2
- :mapnik2 library - 2.0.2: -> mapnik2 2.0.2.1 ::
easy_install -U mapnik2==2.0.2.1
Credits
=========
Companies
----------------
|makinacom|_
* `Planet Makina Corpus <http://www.makina-corpus.org>`_
* `Contact us <mailto:python@makina-corpus.org>`_
.. |makinacom| image:: http://depot.makina-corpus.org/public/logo.gif
.. _makinacom: http://www.makina-corpus.com
Authors
---------------
Contributors
---------------
- kiorky <kiorky@cryptelium.net>
Installation
======================================
Prerequisites
-------------------
Don't forget that you can play with LDFLAGS/CFLAGS/LD_LIBRARY_PATH dto indicate non standart locations for the following requirements if it applies.
You will have to have the includes and libraries for
- The new mapnik-config utility to be in your $PATH
- Boost_python linked to your python interpreter
If it is not installed in standart envionments, you ll have to handle the CFLAGS/LDFLAGS to find it, or use minitage ;)
- cairo / cairomm (optionnal but enabled if you compiled mapnik with cairo support)
- mapnik2
- The current python interpreter
BOOST NOTES
--------------
To specify which boostpython lib to link against, you can use, you can use the following::
export MAPNIK2_BOOST_PYTHON="libboost_python.so.1"
Where you have on your filesystem::
/usr/lib/libboost_python.so.1
Easy_install with or without virtualenv
---------------------------------------------
* Say where to find mapnik-config by settings correctly your PATH environment variable
* When you're reading this you have probably already run
``easy_install mapnik2``. Find out how to install setuptools
(and EasyInstall) here:
http://peak.telecommunity.com/DevCenter/EasyInstall
::
virtualenv --no-site-packages test
source test/bin/activate
easy_install mapnik2
If your boost python installation is not in a standart place, just set the [LD_LIBRARY_PATH, LDFLAGS, CFLAGS] to find it.
Buildout
----------
Some developers use buildout_ to ease deployments.
* Say where to find mapnik-config by settings correctly your PATH environment variable
* Add ``mapnik`` to the list of eggs to install, e.g.
::
[buildout]
parts = somepart
[somepart]
recipe = minitage.recipe.scripts
...
# (options like include dirs)
...
eggs =
...
mapnik2
* Re-run buildout, e.g. with::
$ ./bin/buildout
You can read the buildout installation shipped with this egg for inspiration.
Minitage
--------------
Some developers use minitage_ to ease deployments (a layer upon buildout).
Indeed, it takes care a lot of things like those boring compilation flags.
As an example, to work on this egg in development mode, you can boostrap it by doing this::
::
easy_install -U virtualenv
virtualenv --no-site-packages --distribute ~/minitage
mkdir ~/minitage/others
Install minitage, if you haven't yet ::
source ~/minitage/bin/activate
easy_install -U minitage.core
Initialize it (**mandatory**) ::
source ~/minitage/bin/activate
minimerge -s
To install the minilay for the mapnik2 egg development you can do
::
cd ~/minitage/others
git clone https://github.com/mapnik/pymapnik2.git mapnik-egg-(py26 or py27)
ln -fs ~/minitage/others/mapnik-egg*/minilays/mapnik-egg/ ~/minitage/minilays/mapnik-egg
#for python-2.6
minimerge -av mapnik-egg-py26
#for python-2.7
minimerge -av mapnik-egg-py27
Enjoy your installation
::
cd ~/minitage/others/mapnik-egg-py26
or cd ~/minitage/others/mapnik-egg-py27
./bin/mypy
>>> import mapnik2
For using mapnik2 inside your minitagified application:
- Inside the eggs parts of you buildout add::
[part]
...
eggs += mapnik2
- In your minibuild, merge the mapnik2 dependencies that you can find here:
- for python2.6: https://github.com/mapnik/pymapnik2/blob/master/minilays/mapnik-egg/mapnik-egg-py26
- for python2.7: https://github.com/mapnik/pymapnik2/blob/master/minilays/mapnik-egg/mapnik-egg-py27
- Reminimerge your project to build the mapnik2 egg
- Then add mapnik2 to your setup.py or buildout for it to be grabbed in your pythonpath.
- Rerun buildout, you're done
.. _minitage: http://www.minitage.org
.. _buildout: http://buildout.org
.. _pythonproducts: http://plone.org/products/pythonproducts
Changelog for mapnik2
========================
2.0.1.2 (2012-08-05)
--------------------
- Nothing changed yet.
2.0.1.1 (2012-08-05)
--------------------
- renaming release
2.0.2 (2012-08-04)
------------------
- Multi Arch Support, thx to noirbizarre. [kiorky]
See https://github.com/mapnik/pymapnik2/pull/4
2.0.1 (2012-05-06)
------------------
First public release of mapnik2 eggified python bindings
Introduction
==========================
.. contents::
Official mapnik bindings repackaged in the distutils way to facilitate deployments.
MAPNIK2 Notes
===============
The python bindings are tied to the mapnik2 library version.
To use with:
- :mapnik2 library - 2.0.1: -> mapnik2 2.0.1.2 ::
easy_install -U mapnik2==2.0.1.2
- :mapnik2 library - 2.0.2: -> mapnik2 2.0.2.1 ::
easy_install -U mapnik2==2.0.2.1
Credits
=========
Companies
----------------
|makinacom|_
* `Planet Makina Corpus <http://www.makina-corpus.org>`_
* `Contact us <mailto:python@makina-corpus.org>`_
.. |makinacom| image:: http://depot.makina-corpus.org/public/logo.gif
.. _makinacom: http://www.makina-corpus.com
Authors
---------------
Contributors
---------------
- kiorky <kiorky@cryptelium.net>
Installation
======================================
Prerequisites
-------------------
Don't forget that you can play with LDFLAGS/CFLAGS/LD_LIBRARY_PATH dto indicate non standart locations for the following requirements if it applies.
You will have to have the includes and libraries for
- The new mapnik-config utility to be in your $PATH
- Boost_python linked to your python interpreter
If it is not installed in standart envionments, you ll have to handle the CFLAGS/LDFLAGS to find it, or use minitage ;)
- cairo / cairomm (optionnal but enabled if you compiled mapnik with cairo support)
- mapnik2
- The current python interpreter
BOOST NOTES
--------------
To specify which boostpython lib to link against, you can use, you can use the following::
export MAPNIK2_BOOST_PYTHON="libboost_python.so.1"
Where you have on your filesystem::
/usr/lib/libboost_python.so.1
Easy_install with or without virtualenv
---------------------------------------------
* Say where to find mapnik-config by settings correctly your PATH environment variable
* When you're reading this you have probably already run
``easy_install mapnik2``. Find out how to install setuptools
(and EasyInstall) here:
http://peak.telecommunity.com/DevCenter/EasyInstall
::
virtualenv --no-site-packages test
source test/bin/activate
easy_install mapnik2
If your boost python installation is not in a standart place, just set the [LD_LIBRARY_PATH, LDFLAGS, CFLAGS] to find it.
Buildout
----------
Some developers use buildout_ to ease deployments.
* Say where to find mapnik-config by settings correctly your PATH environment variable
* Add ``mapnik`` to the list of eggs to install, e.g.
::
[buildout]
parts = somepart
[somepart]
recipe = minitage.recipe.scripts
...
# (options like include dirs)
...
eggs =
...
mapnik2
* Re-run buildout, e.g. with::
$ ./bin/buildout
You can read the buildout installation shipped with this egg for inspiration.
Minitage
--------------
Some developers use minitage_ to ease deployments (a layer upon buildout).
Indeed, it takes care a lot of things like those boring compilation flags.
As an example, to work on this egg in development mode, you can boostrap it by doing this::
::
easy_install -U virtualenv
virtualenv --no-site-packages --distribute ~/minitage
mkdir ~/minitage/others
Install minitage, if you haven't yet ::
source ~/minitage/bin/activate
easy_install -U minitage.core
Initialize it (**mandatory**) ::
source ~/minitage/bin/activate
minimerge -s
To install the minilay for the mapnik2 egg development you can do
::
cd ~/minitage/others
git clone https://github.com/mapnik/pymapnik2.git mapnik-egg-(py26 or py27)
ln -fs ~/minitage/others/mapnik-egg*/minilays/mapnik-egg/ ~/minitage/minilays/mapnik-egg
#for python-2.6
minimerge -av mapnik-egg-py26
#for python-2.7
minimerge -av mapnik-egg-py27
Enjoy your installation
::
cd ~/minitage/others/mapnik-egg-py26
or cd ~/minitage/others/mapnik-egg-py27
./bin/mypy
>>> import mapnik2
For using mapnik2 inside your minitagified application:
- Inside the eggs parts of you buildout add::
[part]
...
eggs += mapnik2
- In your minibuild, merge the mapnik2 dependencies that you can find here:
- for python2.6: https://github.com/mapnik/pymapnik2/blob/master/minilays/mapnik-egg/mapnik-egg-py26
- for python2.7: https://github.com/mapnik/pymapnik2/blob/master/minilays/mapnik-egg/mapnik-egg-py27
- Reminimerge your project to build the mapnik2 egg
- Then add mapnik2 to your setup.py or buildout for it to be grabbed in your pythonpath.
- Rerun buildout, you're done
.. _minitage: http://www.minitage.org
.. _buildout: http://buildout.org
.. _pythonproducts: http://plone.org/products/pythonproducts
Changelog for mapnik2
========================
2.0.1.2 (2012-08-05)
--------------------
- Nothing changed yet.
2.0.1.1 (2012-08-05)
--------------------
- renaming release
2.0.2 (2012-08-04)
------------------
- Multi Arch Support, thx to noirbizarre. [kiorky]
See https://github.com/mapnik/pymapnik2/pull/4
2.0.1 (2012-05-06)
------------------
First public release of mapnik2 eggified python bindings
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mapnik2-2.0.1.2.zip
(4.4 MB
view hashes)