2013-02-14 12:54:53 -08:00
|
|
|
|
2014-12-21 03:43:56 -08:00
|
|
|
1. REQUIREMENTS
|
|
|
|
===============
|
2013-02-14 12:54:53 -08:00
|
|
|
|
2015-03-31 05:49:17 -07:00
|
|
|
* Python 2.6 or higher, 3.2 or higher (http://www.python.org/)
|
|
|
|
- Tested with Python 2.7 / 3.3 / 3.4
|
2013-02-25 11:05:17 -08:00
|
|
|
|
2015-01-04 11:44:45 -08:00
|
|
|
* Cython 0.21 or higher (http://cython.org/)
|
2015-01-04 07:00:15 -08:00
|
|
|
- Tested with Cython 0.21.2
|
2013-02-25 11:05:17 -08:00
|
|
|
|
|
|
|
* EFL core library
|
2013-05-12 10:15:09 -07:00
|
|
|
- eo, evas, ecore, edje, emotion and elementary
|
2013-02-25 11:05:17 -08:00
|
|
|
|
|
|
|
* pkg-config (http://www.freedesktop.org/wiki/Software/pkg-config)
|
2013-02-14 12:54:53 -08:00
|
|
|
- Windows executable (and GLib dependency) can be downloaded from
|
|
|
|
http://www.gtk.org/download/win32.php
|
|
|
|
|
2013-02-25 11:05:17 -08:00
|
|
|
* To build the DOCS you will also need:
|
2013-02-28 08:13:07 -08:00
|
|
|
- python-sphinx
|
|
|
|
- [optional] graphviz
|
2013-02-14 12:54:53 -08:00
|
|
|
|
|
|
|
|
2013-02-25 11:05:17 -08:00
|
|
|
|
2014-12-21 03:43:56 -08:00
|
|
|
2. BUILDING PYTHON-EFL
|
|
|
|
======================
|
2013-02-14 12:54:53 -08:00
|
|
|
|
|
|
|
Once EFL is built and installed in your desired destination, proceed with
|
2015-01-04 07:00:15 -08:00
|
|
|
building the wrapper using:
|
|
|
|
|
|
|
|
python setup.py build
|
2013-02-14 12:54:53 -08:00
|
|
|
|
2015-01-02 03:26:33 -08:00
|
|
|
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
|
2013-02-14 12:54:53 -08:00
|
|
|
|
|
|
|
|
2015-01-02 03:26:33 -08:00
|
|
|
* FORCE C SOURCES FOR BUILD
|
2013-02-14 12:54:53 -08:00
|
|
|
|
2015-01-02 03:26:33 -08:00
|
|
|
env DISABLE_CYTHON=1 python setup.py build
|
2013-02-14 12:54:53 -08:00
|
|
|
|
|
|
|
|
2015-01-02 03:26:33 -08:00
|
|
|
* FORCE THE USAGE OF CYTHON
|
2014-04-30 08:59:19 -07:00
|
|
|
|
2015-01-02 03:26:33 -08:00
|
|
|
env ENABLE_CYTHON=1 python setup.py build
|
2014-04-30 08:59:19 -07:00
|
|
|
|
2013-02-14 12:54:53 -08:00
|
|
|
|
|
|
|
|
2014-12-21 03:43:56 -08:00
|
|
|
3. CLEANUP
|
|
|
|
==========
|
|
|
|
|
2015-01-04 07:00:15 -08:00
|
|
|
* For cleaning up:
|
|
|
|
|
|
|
|
python setup.py clean --all
|
2014-07-23 13:05:59 -07:00
|
|
|
|
2015-01-04 07:00:15 -08:00
|
|
|
* To also remove all the C/HTML files generated by Cython:
|
2015-03-31 05:49:17 -07:00
|
|
|
|
2014-07-23 13:05:59 -07:00
|
|
|
python setup.py clean_generated_files
|
|
|
|
|
2015-01-04 07:00:15 -08:00
|
|
|
WARNING: you will need cython to regenerate the C files, do not use this
|
2015-01-05 01:25:33 -08:00
|
|
|
in distribution tarballs, unless you know what are you doing.
|
2015-01-04 07:00:15 -08:00
|
|
|
|
2014-07-23 13:05:59 -07:00
|
|
|
|
|
|
|
|
2014-12-21 03:43:56 -08:00
|
|
|
4. INSTALLATION
|
|
|
|
===============
|
2013-02-14 12:54:53 -08:00
|
|
|
|
2013-02-25 11:05:17 -08:00
|
|
|
* For system-wide installation (needs administrator privileges):
|
2013-02-14 12:54:53 -08:00
|
|
|
|
2015-01-05 01:25:33 -08:00
|
|
|
(sudo) python setup.py install
|
2013-02-14 12:54:53 -08:00
|
|
|
|
2013-02-25 11:05:17 -08:00
|
|
|
* For user installation:
|
2013-02-14 12:54:53 -08:00
|
|
|
|
|
|
|
python setup.py install --user
|
|
|
|
|
2013-02-25 11:05:17 -08:00
|
|
|
* To install for python3:
|
2013-02-14 12:54:53 -08:00
|
|
|
|
2015-01-04 07:00:15 -08:00
|
|
|
(sudo) python3 setup.py install (also cython need to be installed with py3)
|
2013-02-14 12:54:53 -08:00
|
|
|
|
2013-05-04 10:15:09 -07:00
|
|
|
* Install with a custom prefix:
|
|
|
|
|
2015-01-04 07:00:15 -08:00
|
|
|
(sudo) python setup.py install --prefix=/MY_PREFIX
|
2013-05-04 10:15:09 -07:00
|
|
|
|
2015-01-04 07:00:15 -08:00
|
|
|
* You can also uninstall using:
|
|
|
|
|
2015-01-05 01:25:33 -08:00
|
|
|
(sudo) python setup.py uninstall
|
2013-02-14 12:54:53 -08:00
|
|
|
|
|
|
|
|
2014-12-21 03:43:56 -08:00
|
|
|
5. DOCUMENTATION
|
|
|
|
================
|
2013-02-25 11:05:17 -08:00
|
|
|
|
2013-02-28 08:13:07 -08:00
|
|
|
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.
|
2013-09-15 06:16:44 -07:00
|
|
|
packages: python-sphinx, graphviz, python-pygraphviz, libgv-python
|
2013-02-25 11:05:17 -08:00
|
|
|
|
2013-03-27 13:18:24 -07:00
|
|
|
To build the docs just run:
|
2015-01-05 01:25:33 -08:00
|
|
|
|
|
|
|
python setup.py build_doc
|
2013-02-25 11:05:17 -08:00
|
|
|
|
|
|
|
You will find the generated html docs under the folder:
|
|
|
|
build/sphinx/html
|
2013-02-28 08:13:07 -08:00
|
|
|
|
2013-03-27 13:18:24 -07:00
|
|
|
Note: you must build the bindings before building the docs, or you will end
|
|
|
|
up with empty documentation.
|
2013-02-25 11:05:17 -08:00
|
|
|
|
|
|
|
|
2014-12-21 03:43:56 -08:00
|
|
|
6. TESTS and EXAMPLES
|
|
|
|
=====================
|
2013-02-14 12:54:53 -08:00
|
|
|
|
2013-02-28 08:13:07 -08:00
|
|
|
The tests/ folder contains all the unit tests available, you can run individual
|
2013-02-16 02:47:27 -08:00
|
|
|
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.
|
2013-02-14 12:54:53 -08:00
|
|
|
|
2015-03-31 05:49:17 -07:00
|
|
|
Python 2.7 / 3.2 or greater is required for running the tests.
|
2013-12-28 08:26:52 -08:00
|
|
|
|
2013-02-28 08:13:07 -08:00
|
|
|
The scripts in examples/ folder must be run by the user as they require
|
|
|
|
user interaction.
|
2013-02-25 11:05:17 -08:00
|
|
|
|