Development¶
For developers who want to build Avame from source code, proper development environments should be set up. According to the platform, the system requirements and instructions are different.
Avame’s source code is hosted on GitHub at https://github.com/eavatar/eavatar-me . Therefore, Git is used for management of the source code.
virtualenv is used to have a relatively isolated Python runtime during development. However, it becomes tricky due to the fact that Avame needs access to some packages that cannot be installed via pip. So, even virtualenv is used, the –system-site-packages argument is set for all supported platforms.
Refer to the section for the platform of your choice. Should you encountered any issues , please file issues at https://github.com/eavatar/eavatar-me/issues
On Windows Platform¶
System Requirements¶
| Operating system | CPU Architecture |
|---|---|
| Windows 7 Pro | X86-64 |
Git for Windows¶
To check out source codes on Windows platform, Git for Windows command line tool is needed. Please download and install it from https://git-scm.com/download/win .
Please note that all command-line instructions are assumed to be run using the shell provided by Git for Windows, which provides a Unix-like interface.
Python Distribution¶
The Python distribution for development on Windows platform is Anaconda Python 2.7. Download it from https://www.continuum.io/downloads .
Get the Source Code¶
Use following command to check out the source code:
git checkout https://github.com/eavatar/eavatar-me avame
It’s assumed that source code is cloned to the local host at $WORKDIR directory.
Virtual Environment¶
virtualenv --system-site-packages env
source env/Scripts/activate
It’s assumed that command-line instructions in the following sections are run with the virtual environment activated.
Installing Dependencies¶
Use following instruction to install
pip install -r requirements/requirements_win32.txt
Avame needs `pywin32’, ‘lxml’ packages on Windows platform, which should be already provided by Anaconda Python Distribution.
Run from the Source¶
To run the program form the source, please ensure following paths are in the sys.path. This can be done by setting an environment variable PYTHONPATH to be like this:
export PYTHONPATH="./src"
Note that this is assumed to be run from the Git for Windows shell. If you use an IDE, the root and the ‘src’ sub-folder of the project should be in the paths as mentioned above.
Build the Binaries¶
pyinstaller pack\avame.spec --clean -y
The application binaries are located at $WORKDIRdistavame. You may use following instruction to launch it:
.\dist\avame\avame.exe
On OS X Platform¶
System Requirements¶
The instructions are tested on following configuration.
| Operating system | CPU Architecture |
|---|---|
| OS X 10.10 | X86-64 |
Python Distribution¶
Although OS X has a bundled Python runtime, the one used should be from python.org. Please download version 2.7.10 from that site.
Note that it’s assumed you have XCode command-line tools installed already.
Virtual Environment¶
virtualenv --system-site-packages env
source env/bin/activate
It’s assumed that command-line instructions in the following sections are run with the virtual environment activated.
Get the Source Code¶
Avame’s source code is hosted on GitHub at https://github.com/eavatar/eavatar-me . Therefore, Git is used for management of the source code.
Use following command to check out the source code:
git checkout https://github.com/eavatar/eavatar-me avame
It’s assumed that source code is cloned to the local host at $WORKDIR directory.
Installing Dependencies¶
On OS X development machine, should you encountered an error with message like error: ‘_Noreturn’ keyword must precede function declarator, then gevent package needs to be installed with following instruction:
CFLAGS='-std=c99' pip install gevent==1.0.2
Install other dependencies:
pip install -r requirements/requirements_osx.txt
lxml package needs extra steps to install with following instructions:
brew install libxml2
pip install lxml
Run from the Source¶
To run the program form the source, please ensure following paths are in the sys.path. This can be done by setting an environment variable PYTHONPATH to be like this:
export PYTHONPATH="./src"
If you use an IDE, the the ‘src’ subfolder of the project should be in the paths as mentioned above.
Build the Binaries¶
pyinstaller pack/avame.spec --clean -y
The application binaries are located at $WORKDIR/dist/avame/. You may use following command to launch it:
./dist/avame/avame
In addition to the binaries, an application bundle for OS X is created and placed at $WORKDIR/dist/EAvatar.app/ . An application bundle is a special directory on OS X, which may be launched from the command line with following instruction:
open ./dist/EAvatar.app
On Ubuntu Platform¶
System Requirements¶
| Operating system | CPU Architecture |
|---|---|
| Ubuntu 14.04 | X86-64 |
Python Distribution¶
Avame uses the system-bundled Python distribution for the development on Ubuntu platform. Note that the version used is 2.7.6.
Virtual Environment¶
virtualenv --system-site-packages env
source env/bin/activate
It’s assumed that command-line instructions in the following sections are run with the virtual environment activated.
Get the Source Code¶
Avame’s source code is hosted on GitHub at https://github.com/eavatar/eavatar-me . Therefore, Git is used for management of the source code.
Use following command to check out the source code:
git checkout https://github.com/eavatar/eavatar-me avame
It’s assumed that source code is cloned to the local host at $WORKDIR directory.
Installing Dependencies¶
Use following instructions to install Python and system packages:
sudo apt-get install libxml2-dev libxslt1-dev python-dev python-lxml
pip install -r requirements/requirements_gtk.txt
Run from the Source¶
To run the program form the source, please ensure following paths are in the sys.path. This can be done by setting an environment variable PYTHONPATH to be like this:
export PYTHONPATH="./src"
If you use an IDE, the root and the ‘src’ subfolder of the project should be in the paths as mentioned above.
Build the Binaries¶
pyinstaller pack/avame.spec --clean -y
The application binaries are located at $WORKDIR/dist/avame/. You may use following command to launch it:
./dist/avame/avame