Python Bindings For Efl
Python bindings for EFL
The Python bindings have complete abstraction, or rather a translation to Python types, of the underlying C types.
Stable releases
All the stable releases of python-efl can always be found at:
http://download.enlightenment.org/rel/bindings/python/
Source repository
Development take place on git, in the master branch, while we backport bugfixes in the release branches.
You will find a branch for each released version, branches are named as python-efl-X.X.
https://git.enlightenment.org/bindings/python/python-efl.git/
Install from pypi
The easiest way to install the bindings are from pypi, just use:
sudo pip install python-efl
This will download, build and install the latest release from pypi on your machine. You can also uninstall using:
sudo pip uninstall python-efl
Otherwise you can download a stable release or the latest development from git.
Documentation
The bindings are fully documented and the documentation is automatically generated at every git change, you can browse the latest development version online or download a zip file that contains the latest generated docs. Documentation for the last stable release can be found here.
Additionally you can generate the documentation yourself from the source code using the following command:
python setup.py build build_doc
Live source tarball
We provide a live source tarball for you to install and test. This archive is automatically generated at every developer commit so it is considered unstable. To compile and install this tarball you do not need cython as it contains pre-generated c files. The tarball can be found at:
https://build.enlightenment.org/job/base_pyefl_build/lastSuccessfulBuild/artifact/dist/
To install the tarball just untar the archive and run:
sudo python setup.py install
Coverage
| Elementary | Evas | Ecore | Edje | Emotion | Eldbus | Efreet |
|---|---|---|---|---|---|---|
| ~95% | ~65% | ~65% | ~55% | 100% | see below | see below |
Additional Resources
Contacts
IRC channel
#e.py @ FreeNode
Projects using Python-EFL (in random order)
| Project | Website |
|---|---|
| EpyMC - Media Center | https://github.com/DaveMDS/epymc |
| Espionage - D-Bus inspector | https://phab.enlightenment.org/w/projects/espionage/ |
| Epour - BitTorrent Client | https://phab.enlightenment.org/w/projects/epour/ |
| Econnman - Connman GUI | https://phab.enlightenment.org/w/projects/econnman/ |
| Eluminance - Fast photo browser | https://github.com/DaveMDS/eluminance |
| Egitu - Git User Interface | https://github.com/DaveMDS/egitu |
| Edone - GettingThingsDone | https://github.com/DaveMDS/edone |
| Lekha - PDF viewer | https://github.com/kaihu/lekha |
| Polkit-EFL - Polkit agent | https://git.enlightenment.org/misc/polkit-efl.git |
| Epack - Archive extractor | https://github.com/wfx/epack |
... and many more that cannot fit in this short list. If have some code and want it in this list just let us know.
A short history of Python-EFL
Python-EFL was begun in 2007 by work of Gustavo Sverzut Barbieri (@barbieri) and others while working for Nokia on the software project Canola Media Player. The language bindings were initially developed for the individual components of EFL, until merged together in 2013.
He was later joined by Ulisses Furquim Freire da Silva (@ulisses), who together formed the company ProFUSION embedded systems where the developement continued and a new software project called Editje was created, which uses the Python bindings for most of its functionality.
Python-EFL gained many more developers, also at this time an independent application project called EpyMC was created by Davide Andreoli (@DaveMDS).
In the beginning of the year 2011 the developement was practically halted. In 2012 Davide Andreoli picked up the developement and Kai Huuhko (@kuuko) joined him shortly after. Work at this time was focused on finishing the Python bindings for Elementary, the toolkit library.
In 2013 the individual components were merged together and a new documentation system was implemented, enabling easier access for the end-user developers.
1.7 API (deprecated, no more supported)
Source repository
http://git.enlightenment.org/legacy/bindings/python/
Releases
http://download.enlightenment.org/releases/BINDINGS/python/
Coverage
estimated 20-90%
Documentation
http://bodhilinux.com/e_docs.php
Generated with Epydoc, with mostly full documentation for supported API features.