2013-02-14 12:54:53 -08:00
|
|
|
|
|
|
|
1. REQUIREMENTS:
|
2013-02-25 11:05:17 -08:00
|
|
|
----------------
|
2013-02-14 12:54:53 -08:00
|
|
|
|
2013-02-25 11:05:17 -08:00
|
|
|
* Python 2.7 or higher (http://www.python.org/)
|
2013-02-14 12:54:53 -08:00
|
|
|
- Tested with Python 2.7 / 3.2
|
2013-02-25 11:05:17 -08:00
|
|
|
|
|
|
|
* Cython 0.17.3 or higher (http://cython.org/)
|
2013-02-14 12:54:53 -08:00
|
|
|
- Tested with Cython 0.17.3
|
2013-02-25 11:05:17 -08:00
|
|
|
|
|
|
|
* EFL core library
|
2013-02-28 08:13:07 -08:00
|
|
|
- eo, evas, ecore, edje, elementary, edbus and emotion
|
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
|
|
|
|
- [optional] youtube module from the sphinx contrib repository.
|
2013-02-14 12:54:53 -08:00
|
|
|
|
|
|
|
|
2013-02-25 11:05:17 -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
|
|
|
|
building the wrapper.
|
|
|
|
|
|
|
|
|
2013-02-25 11:05:17 -08:00
|
|
|
* BUILDING WITH GCC/G++ (Linux, OS X, etc.)
|
2013-02-14 12:54:53 -08:00
|
|
|
|
|
|
|
python setup.py build_ext
|
|
|
|
|
2013-02-25 11:05:17 -08:00
|
|
|
* BUILDING WITH Visual Studio (Windows)
|
2013-02-14 12:54:53 -08:00
|
|
|
|
|
|
|
python setup.py build_ext
|
|
|
|
|
2013-02-25 11:05:17 -08:00
|
|
|
* BUILDING WITH MINGW (Windows)
|
2013-02-14 12:54:53 -08:00
|
|
|
|
|
|
|
python setup.py build_ext -c mingw32
|
|
|
|
|
|
|
|
|
|
|
|
|
2013-02-25 11:05:17 -08:00
|
|
|
3. 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
|
|
|
|
|
|
|
python setup.py install
|
|
|
|
|
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
|
|
|
|
|
|
|
python3 setup.py install (also cython need to be installed with py3)
|
|
|
|
|
|
|
|
|
|
|
|
|
2013-02-25 11:05:17 -08:00
|
|
|
4. DOCUMENTATION:
|
|
|
|
-----------------
|
|
|
|
|
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-02-25 11:05:17 -08:00
|
|
|
packages: python-sphinx, graphviz
|
|
|
|
|
2013-03-27 13:18:24 -07:00
|
|
|
To build the docs just run:
|
2013-02-25 11:05:17 -08:00
|
|
|
python setup.py build_doc
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
|
5. 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
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
6. UNINSTALL:
|
|
|
|
-------------
|
|
|
|
|
2013-02-28 08:13:07 -08:00
|
|
|
Unfortunately setup.py does not provide a way to remove the installed packages,
|
2013-02-25 11:05:17 -08:00
|
|
|
|
2013-02-28 08:13:07 -08:00
|
|
|
To completely remove the installed stuff just remove the 'efl' folder in
|
2013-02-25 11:05:17 -08:00
|
|
|
your python installation, usually /usr/(local/)lib/pythonX.X/dist-packages/efl
|
|
|
|
|
|
|
|
|