.. _installation_python:

Python
======

Apptimize supports server-side experimentation and release management through several
server-oriented SDKs including Python.

Our server-side SDKs support programmatic experimentation (Dynamic Variables and Code
Blocks) as well as Feature Flags.

EU Cloud Site
^^^^^^^^^^^^^

Use the ``configAttributes`` flag to set your Apptimize region to EUCS if you are integrated in our EU Cloud site.


.. tabs::
    .. code-tab:: python Python

        configAttributes = {'apptimize_region' : 'eucs'}
        Apptimize.setup('<YOUR_APP_KEY>', configAttributes)


SDK Installation
^^^^^^^^^^^^^^^^

You can install our Python Server-Side SDK as a standalone downloadable tar package or by
using `PyPi <https://pypi.org/project/Apptimize/>`_.

.. rubric:: Download and install locally

To install the SDK by downloading the tar package and installing it locally, you need to
`sign in <https://apptimize.com/admin/>`_ to the Apptimize dashboard. You’ll see a welcome
page that asks for the :ref:`name of your app<app_creation>`. After entering all your
info, you’ll see these installation instructions again.

1. Download the latest Python SDK from the
   :ref:`SDK Download <sdk_download_and_documentation>` page.

#. Copy the SDK to your project directory.

#. Install the package: :code:`pip install Apptimize-<version>.tar.gz`.

#. Delete the copied SDK file :code:`Apptimize-<version>.tar.gz`.

#. In your :code:`.py` file(s), import the SDK
   :code:`from apptimize import Apptimize`.

You can find our latest `Python API Documentation here <https://sdk.apptimize.com/python-server/docs/latest>`_.

.. rubric:: Install using PyPi

With our Python Server-Side SDK being available from PyPi the installation process is as simple as running `pip install` for ``Apptimize``:

.. code-block:: bash

   $ pip install Apptimize

.. note::

   Using PyPi, you can install Apptimize starting with `1.2.29`.

   .. seealso::

      More information about Apptimize on PyPi
         https://pypi.org/project/Apptimize/

Initializing Apptimize
^^^^^^^^^^^^^^^^^^^^^^
To initialize Apptimize, make the following call with the App Key associated to
your app, which can be found in the Install tab of your Dashboard.

.. tabs::
    .. code-tab:: python Python

        Apptimize.setup("<appkey>")