summaryrefslogtreecommitdiff
path: root/INSTALL
blob: 5f02597e351a47dcdebd1b489b1ef50fd63b53a6 (plain)
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

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