just some random PR for test

.gitignore

@@ -1,101 +1,6 @@
-# Byte-compiled / optimized / DLL files
-__pycache__/
-*.py[cod]
-*$py.class
-
-# C extensions
-*.so
-
-# Distribution / packaging
-.Python
-env/
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-
-# PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
-*.manifest
-*.spec
-
-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
-
-# Unit test / coverage reports
-htmlcov/
-.tox/
-.coverage
-.coverage.*
-.cache
-nosetests.xml
-coverage.xml
-*.cover
-.hypothesis/
-
-# Translations
-*.mo
-*.pot
-
-# Django stuff:
-*.log
-local_settings.py
-
-# Flask stuff:
-instance/
-.webassets-cache
-
-# Scrapy stuff:
-.scrapy
-
-# Sphinx documentation
-docs/_build/
-
-# PyBuilder
-target/
-
-# Jupyter Notebook
-.ipynb_checkpoints
-
-# pyenv
-.python-version
-
-# celery beat schedule file
-celerybeat-schedule
-
-# SageMath parsed files
-*.sage.py
-
-# dotenv
+*.pyc
+env
 .env
-
-# virtualenv
-.venv
-venv/
-ENV/
-
-# Spyder project settings
-.spyderproject
-.spyproject
-
-# Rope project settings
-.ropeproject
-
-# mkdocs documentation
-/site
-
-# mypy
-.mypy_cache/
+dist
+bundles
+repos

.travis.yml

@@ -0,0 +1,13 @@
+language: python
+python:
+- '3.3'
+- '3.4'
+- '3.5'
+- '3.6'
+
+sudo: false
+dist: trusty
+
+install: pip install -r requirements.txt
+
+script: cd aslo && flake8

Procfile

@@ -0,0 +1,2 @@
+site: gunicorn -c gunicorn_config.py wsgi
+worker: celery -A worker worker

README.md

@@ -1,37 +1,38 @@
-# aslo-v3
-Upcoming Software center for SugarLabs (ASLO V3)
+[![Build Status](https://travis-ci.org/scgnu/aslo-v3.svg?branch=master)](https://travis-ci.org/scgnu/aslo-v3)
 
+### aslo-v3
+This repo hosts the upcoming version of ASLO (Software centre) for SugarLabs.
 
-## Setup Instructions
+### Instructions
 
-### Install virtualenv
+#### Install Dependenices
+**Python 3.x** supported 
 
-`pip install virtualenv`
+* **Docker (System)** - For running build tasks
+* **Mongo (System)** - Primary Database Engine
+* **Redis (System)** - Broker for Background Tasks
+* **Celery** - For running background tasks
+* **Imgur** - For hosting Screenshots
+* **Flower (Optional)** - Dashboard for Celery
 
-### Create a vritualenv
-`virtualenv ~/envs/flask-dev`
+Install most of the app/python dependencies  by running `pip install -r requirements.txt `
 
-### Activate virtualenv
-`source ~/envs/flask-dev/bin/activate`
+##### How to Run
 
-### Install Dependencies
-`pip install -r requirements.txt`
+`honcho` which is used in this project, looks for `.env` file, so define all the environment variables like `GITHUB_HOOK_SECRET`, `IMGUR_CLIENT_ID` , `IMGUR_CLIENT_SECRET` and others defined in the `default_settings.py` 
 
-### Install Redis
+**A sample example**
 
-``` bash
+``` bash 
+$ cat >.env <<EOM
+PORT=5000
+GITHUB_HOOK_SECRET="XXXXXXXX"
+IMGUR_CLIENT_ID="XXXXXXXXXXXXXXXX"
+IMGUR_CLIENT_SECRET="XXXXXXXXXXXXXXX"
+REDIS_URI=redis://localhost:6789/0
+EOM
 
-cd /tmp
-wget http://download.redis.io/releases/redis-stable.tar.gz
-tar xzf redis-stable.tar.gz
-make
-make test
-sudo make install
 ```
- For a more comprehensive guide follow this [Tutorial from DigitalOcean](https://www.digitalocean.com/community/tutorials/how-to-install-and-configure-redis-on-ubuntu-16-04)
+Run `./start.sh` to run the server 
 
-Make sure redis is running by logging in `redis-cli`
-
-### Run the Flask Server
-
-`python app.py` will start Flask server listening on all interfaces `0.0.0.0` and port `5000`
+Run `flower -A worker --port=5555` to run the dashboard server 

activity-build-docker/Dockerfile

@@ -0,0 +1,9 @@
+FROM fedora:22
+
+RUN dnf install -y git gettext sugar-toolkit-gtk3 sugar-toolkit
+
+VOLUME /activity
+WORKDIR /activity
+
+CMD python /activity/setup.py dist_xo; \
+    chmod 777 -R /activity/

aslo/__init__.py

@@ -0,0 +1,40 @@
+from flask import Flask
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+def init_app():
+    app = Flask(__name__)
+    app.config.from_object('aslo.settings')
+
+    # init celery
+    from .celery_app import init_celery
+    init_celery(app)
+
+    # blueprints
+    from .web import web
+    app.register_blueprint(web)
+
+    from .api import api
+    app.register_blueprint(api, url_prefix='/api')
+
+    # logging
+    logger.setLevel(logging.INFO)
+    fmt = logging.Formatter('[%(asctime)s] %(levelname).3s %(message)s')
+    stream_handler = logging.StreamHandler()
+    stream_handler.setFormatter(fmt)
+    logger.addHandler(stream_handler)
+
+    if app.config['DEBUG']:
+        logger.setLevel(logging.DEBUG)
+
+    # setup db
+    from .service import setup_db
+    setup_db(app)
+
+    # custom jinja filters
+    from .filters import init_filters
+    init_filters(app)
+
+    return app

aslo/api/__init__.py

@@ -0,0 +1,5 @@
+from flask import Blueprint
+
+api = Blueprint('api', __name__)
+
+from . import views, errors # noqa

aslo/api/errors.py

@@ -0,0 +1,12 @@
+import json
+from flask import make_response
+from . import api
+from .exceptions import ApiHttpError
+
+
+@api.errorhandler(ApiHttpError)
+def HandleHttpApiError(e):
+    error_msg = json.dumps(e.to_dict())
+    response = make_response(error_msg, e.status_code)
+    response.headers['Content-Type'] = 'application/json'
+    return response

aslo/api/exceptions.py

@@ -0,0 +1,26 @@
+
+
+class ReleaseError(Exception):
+    pass
+
+
+class BuildProcessError(ReleaseError):
+    pass
+
+
+class ScreenshotDoesNotExist(ReleaseError):
+    pass
+
+
+class ApiHttpError(Exception):
+
+    def __init__(self, message, status_code=None):
+        Exception.__init__(self)
+        self.message = message
+        self.status_code = status_code if status_code else 400
+
+    def to_dict(self):
+        return {
+            'message': self.message,
+            'status_code': self.status_code
+        }

aslo/api/gh.py

@@ -0,0 +1,51 @@
+import hmac
+import hashlib
+from flask import current_app as app
+from urllib.parse import urlparse
+from github import Github
+
+
+def verify_signature(gh_signature, body, secret):
+    sha1 = hmac.new(secret.encode(), body, hashlib.sha1).hexdigest()
+    return hmac.compare_digest('sha1=' + sha1, gh_signature)
+
+
+def auth():
+    g = Github(app.config['GITHUB_OAUTH_TOKEN'])
+    return g
+
+
+def get_developers(repo_url):
+    o = urlparse(repo_url)
+    repo = o.path[1:].strip('.git')
+
+    g = auth()
+    repository = g.get_repo(repo)
+    contributors = repository.get_contributors()
+    developers = []
+    for c in contributors:
+        dev = {'email': c.email, 'page': c.html_url, 'avatar': c.avatar_url}
+        dev['name'] = c.name if c.name else c.login
+        developers.append(dev)
+
+    return developers
+
+
+def find_tag_commit(repo_name, tag_name):
+    g = auth()
+    tags = g.get_repo(repo_name).get_tags()
+    for tag in tags:
+        if tag.name == tag_name:
+            return tag.commit
+
+    return None
+
+
+def comment_on_commit(commit, message):
+    commit.create_comment(message)
+
+
+def render_markdown(message):
+    # https://developer.github.com/v3/markdown/
+    g = auth()
+    return g.render_markdown(message).decode()