Skip to main content

Kitica Devicepool.

Project description

Kitica API

Introduction

Kitica's REST API was built to support parallel device automation testing, It serves device's information through HTTP protocol.

Setup

Kitica's API service was designed to be hosted behind nginx web server, but could also be run locally for development.

Development Server Setup

Step 1
Before anything else, it is recommended that you run the service in a virtual environment.
So, first, install python'3 virtualenv.

pip install virtualenv

After installing, create a virtualenv inside the api folder(repository_root/api). Run:

virtualenv venv

Where venv is the name of the virtualenv instance.

Output

Using base prefix '/usr'
New python executable in /home/yourusername/sample/venv/bin/python3
Also creating executable in /home/yourusername/sample/venv/bin/python
Installing setuptools, pip, wheel...
done.

Next, activate the virtualenv:

source venv/bin/activate

Now that virtualenv is active, install the dependencies for the api service.

pip install -r requirements.txt

After that, all dependencies should be installed.

Step 2 To start the API service, run:

python kiticaApi.py

Output

 * Serving Flask app "kiticaAPI" (lazy loading)
 * Environment: production
   WARNING: This is a development server. Do not use it in a production deployment.
   Use a production WSGI server instead.
 * Debug mode: on
 * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)
 * Restarting with stat
 * Debugger is active!
 * Debugger PIN: xxx-xxx-xxx

Service should be running now.
To Verify, Create a get request in postman.

url: http://localhost:5000/devices
method: GET
Response should be something like this:

[
    {
        "deviceId": 3,
        "deviceName": "Pixel 2",
        "platformName": "Android",
        "server": "xxx.xxx.xxx.xxx",
        "port": "4723/wd/hub",
        "udid": "emulator-5554",
        "platformVersion": "9",
        "status": "FREE",
        "teamName": "TEAM",
        "version": 1,
        "borrowerIp": null,
        "borrowerHostname": null,
        "lastBorrowed": "2020-02-12 15:29:29",
        "deviceType": "Emulator"
    }
]

That's it, local development server is now running.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for kitica, version 1.4a7
Filename, size File type Python version Upload date Hashes
Filename, size kitica-1.4a7-py3-none-any.whl (22.0 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page