https://github.com/authomatic/gae_installer
Python Google App Engine Installer
https://github.com/authomatic/gae_installer
Last synced: about 2 months ago
JSON representation
Python Google App Engine Installer
- Host: GitHub
- URL: https://github.com/authomatic/gae_installer
- Owner: authomatic
- License: mit
- Created: 2014-05-14T12:05:49.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2017-06-02T12:38:53.000Z (over 8 years ago)
- Last Synced: 2025-09-25T07:31:00.670Z (5 months ago)
- Language: Python
- Size: 49.8 KB
- Stars: 17
- Watchers: 5
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.rst
- License: LICENSE.txt
Awesome Lists containing this project
README
.. |version| replace:: 1.9.54
.. |fullversion| replace:: |version|.4
.. |checksum| replace:: ``afec2639b27aabaacf54697d51dee959``
========================================
Googe App Engine Installer |fullversion|
========================================
.. image:: https://travis-ci.org/peterhudec/gae_installer.svg?branch=master
:target: https://travis-ci.org/peterhudec/gae_installer
This package installs the
`Google App Engine SDK `_
|version| to the ``site-packages`` directory of the **current Python
interpreter** so that you can use ``from google import appengine`` outside the
``dev_appserver.py`` runtime. This is useful if you want to use the
`google.appengine.ext.testbed `_
package in your tests.
It also makes all of the GAE commands like ``dev_appserver.py``,
``bulkloader.py``, etc. globaly available without the ``.py`` extension.
The installer works wit `Virtualenv `_.
The **version** of this package mirrors the
`GAE SDK `_
version (currently |version|) and if there will be a new release of the SDK,
there will be a corresponding release of this package too.
Usage
-----
Create a virtual environment
.. code-block:: bash
$ virtualenv e
$ . e/bin/activate
Install with pip,
.. code-block:: bash
$(e) pip install gae_installer
or with easy_install,
.. code-block:: bash
$(e) easy_install gae_installer
or manually
.. code-block:: bash
$(e) git clone https://github.com/peterhudec/gae_installer.git
$(e) python gae_installer/setup.py install
$(e) rm -rf gae_installer
The installation will take a while. After it is complete, you should be able to
import the ``google.appengine`` module:
.. code-block:: bash
(e)$ python -c "from google import appengine; print appengine.__file__"
/Users/peterhudec/demo/e/lib/python2.7/site-packages/google_appengine/google/appengine/__init__.pyc
And the GAE executables should be in the ``./e/bin/`` directory.
.. code-block:: bash
$(e) ls -l ./e/bin/
total 232
-rw-r--r-- 1 peterhudec staff 2224 May 14 12:38 activate
-rw-r--r-- 1 peterhudec staff 1280 May 14 12:38 activate.csh
-rw-r--r-- 1 peterhudec staff 2493 May 14 12:38 activate.fish
-rw-r--r-- 1 peterhudec staff 1129 May 14 12:38 activate_this.py
-rwxr-xr-x 1 peterhudec staff 42 May 13 19:36 api_server
-rwxr-xr-x 1 peterhudec staff 42 May 13 19:48 backends_conversion
-rwxr-xr-x 1 peterhudec staff 42 May 13 19:48 bulkload_client
-rwxr-xr-x 1 peterhudec staff 42 May 13 19:48 bulkloader
-rwxr-xr-x 1 peterhudec staff 42 May 13 19:36 dev_appserver
-rwxr-xr-x 1 peterhudec staff 42 May 13 19:48 download_appstats
-rwxr-xr-x 1 peterhudec staff 271 May 14 12:38 easy_install
-rwxr-xr-x 1 peterhudec staff 271 May 14 12:38 easy_install-2.7
-rwxr-xr-x 1 peterhudec staff 42 May 13 19:48 endpointscfg
-rwxr-xr-x 1 peterhudec staff 42 May 13 19:48 gen_protorpc
-rwxr-xr-x 1 peterhudec staff 69 May 13 19:35 get_gae_dir
-rwxr-xr-x 1 peterhudec staff 42 May 13 19:48 google_sql
-rwxr-xr-x 1 peterhudec staff 42 May 13 19:49 old_dev_appserver
-rwxr-xr-x 1 peterhudec staff 42 May 13 19:49 php_cli
-rwxr-xr-x 1 peterhudec staff 243 May 14 12:38 pip
-rwxr-xr-x 1 peterhudec staff 243 May 14 12:38 pip2
-rwxr-xr-x 1 peterhudec staff 243 May 14 12:38 pip2.7
-rwxr-xr-x 1 peterhudec staff 12752 May 14 12:38 python
lrwxr-xr-x 1 peterhudec staff 6 May 14 12:38 python2 -> python
lrwxr-xr-x 1 peterhudec staff 6 May 14 12:38 python2.7 -> python
-rwxr-xr-x 1 peterhudec staff 42 May 13 19:49 remote_api_shell
-rwxr-xr-x 1 peterhudec staff 42 May 13 19:49 wrapper_util
How It Works
------------
Runnig the ``python setup.py install`` tries to download the
`Google App Engine SDK `_
for *Linux/Other Platforms* from the
https://storage.googleapis.com/appengine-sdks/featured/google_appengine_X.X.X.zip
URL. If the response mime-type is not ``application/zip``, the requested version
is deprecated and the installer will download the GAE SDK from
https://storage.googleapis.com/appengine-sdks/deprecated/XXX/google_appengine_X.X.X.zip
where XXX is the **GAE SDK** version matching the **GAE Installer** version.
The downloaded ZIP archive will then be checked against the MD5 checksum
|checksum| and extracted into the ``site-packages/google_appengine`` directory of the
**current Python interpreter** and made available to the PYTHONPATH with the
``site-packages/google_appengine.pth`` file. **GAE Installer** also creates Bash
executables in the *scripts directory* of the current Python interpreter
which wrap the GAE Python executables in the ``site-packages/google_appengine``
directory.