119 lines
2.8 KiB
Plaintext
119 lines
2.8 KiB
Plaintext
|
|
1. REQUIREMENTS
|
|
===============
|
|
|
|
* Python 2.6 or higher (http://www.python.org/)
|
|
- Tested with Python 2.6 / 2.7 / 3.2 / 3.3 / 3.4
|
|
|
|
* Cython 0.19 or higher (http://cython.org/)
|
|
- Tested with Cython 0.19.1
|
|
|
|
* EFL core library
|
|
- eo, evas, ecore, edje, emotion and elementary
|
|
|
|
* pkg-config (http://www.freedesktop.org/wiki/Software/pkg-config)
|
|
- Windows executable (and GLib dependency) can be downloaded from
|
|
http://www.gtk.org/download/win32.php
|
|
|
|
* To build the DOCS you will also need:
|
|
- python-sphinx
|
|
- [optional] graphviz
|
|
- [optional] youtube module from the sphinx contrib repository.
|
|
|
|
|
|
|
|
2. BUILDING PYTHON-EFL
|
|
======================
|
|
|
|
Once EFL is built and installed in your desired destination, proceed with
|
|
building the wrapper.
|
|
|
|
Distribution tarballs include pre-generated C source files, so
|
|
cython usage is disabled by default, while is enabled in development git
|
|
versions. You can always force the usage of cython using two environment
|
|
variables: DISABLE_CYTHON or ENABLE_CYTHON
|
|
|
|
|
|
* FORCE C SOURCES FOR BUILD
|
|
|
|
env DISABLE_CYTHON=1 python setup.py build
|
|
|
|
|
|
* FORCE THE USAGE OF CYTHON
|
|
|
|
env ENABLE_CYTHON=1 python setup.py build
|
|
|
|
|
|
|
|
3. CLEANUP
|
|
==========
|
|
|
|
* For cleaning up
|
|
|
|
python setup.py clean_generated_files
|
|
|
|
|
|
|
|
4. INSTALLATION
|
|
===============
|
|
|
|
* For system-wide installation (needs administrator privileges):
|
|
|
|
python setup.py install
|
|
|
|
* For user installation:
|
|
|
|
python setup.py install --user
|
|
|
|
* To install for python3:
|
|
|
|
python3 setup.py install (also cython need to be installed with py3)
|
|
|
|
* Install with a custom prefix:
|
|
|
|
python setup.py install --prefix=/MY_PREFIX
|
|
|
|
|
|
|
|
5. DOCUMENTATION
|
|
================
|
|
|
|
To build the docs for the bindings you need to have Sphinx installed, for
|
|
(optional) graphs you need Graphviz, for (optional) Youtube demonstration
|
|
videos you need the YouTube module from sphinx contrib repository.
|
|
packages: python-sphinx, graphviz, python-pygraphviz, libgv-python
|
|
|
|
To build the docs just run:
|
|
python setup.py build_doc
|
|
|
|
You will find the generated html docs under the folder:
|
|
build/sphinx/html
|
|
|
|
Note: you must build the bindings before building the docs, or you will end
|
|
up with empty documentation.
|
|
|
|
|
|
6. TESTS and EXAMPLES
|
|
=====================
|
|
|
|
The tests/ folder contains all the unit tests available, you can run individual
|
|
tests or use the 00_run_all_tests.py in each folder or even in the tests/ base
|
|
dir to run all the tests at once.
|
|
|
|
Python 2.7 is required for running the tests.
|
|
|
|
The scripts in examples/ folder must be run by the user as they require
|
|
user interaction.
|
|
|
|
|
|
|
|
7. UNINSTALL
|
|
============
|
|
|
|
Unfortunately setup.py does not provide a way to remove the installed packages,
|
|
|
|
To completely remove the installed stuff just remove the 'efl' folder in
|
|
your python installation, usually /usr/(local/)lib/pythonX.X/dist-packages/efl
|
|
|
|
|