Vocabulary learning strategy

• Python 2.7
• Dev Enviroment: Windows 7, 8.1

• Install virtualenv for dev: easy_install virtualenv
• Install create virtual env_variables using virtualenv: virtualenv flask
• Install moduels in file: requirements.txt, eg. flask\Scripts\pip install -r requirements.txt
• Install npm modules: npm install
  • Above that, for windows, modules like gulp and react-tools should be installed using -g
• Install bower components: bower install
• Compile jsx file to js: jsx app/static/jsx/ app/static/js/
• Create basic database: flask/Scripts/python manager.py createdb
• Create your own settings.py using the template of settings.example.py, add your own OAUTH_CRENDENTIALS, and change the SECRET_KEY if you're not too lazy

• flask/Scripts/python manager.py runserver
• Navigator: http://localhost:5000
• Mailer: flask/Scripts/python reminder_mailer.py

• Jsx watching: jsx --watch app/static/jsx/ app/static/js

Assuming you have MySQL, PYTHON 2.6+, Nginx etc already.

Principal thoughts explained in example of uWSGI

the web client <-> the web server <-> the socket <-> uWSGI <-> Python

• Use uWSGI run app with serveral workers
• Create socket to connect with Nginx
• Use Nginx as webserver

Here's how to proceed

• Git clone
• virtualenv flask
• flask/bin/pip install -r requirements.txt
• flask/bin/pip install mysql-python
• Don't forget to follow the installation instructions:
• Setup env variable for DB path :

  • $ WHATSTODAY_DATABASE_URL=mysql://example:example@localhost/example

  • Then write it to the ENV export WHATSTODAY_DATABASE_URL

  • Create database user:

    mysql> create database whatstoday character set utf8 collate utf8_bin;
    mysql> create user 'whatstoday'@'localhost' identified by 'whatstoday';
    mysql> grant all privileges on whatstoday.* to 'whatstoday'@'localhost';
    mysql> flush privileges;
    mysql> quit;
    

  • Create database using createdb commande in manager.py

    DATABASE_URL=mysql://whatstoday:whatstoday@localhost/whatstoday 
    flask/bin/python manager.py createdb
    

• Setup uWSGI
  • Check your chown-socket in whatstoday.ini file, make sure it's ok for public (usually it's fine with chmod 664)
  • Create a service to handle the uWSGI process: sudo vim /etc/systemd/system/whatstoday.service
  • Write something like this:

    Description=uWSGI instance to serve whatstoday
    After=network.target
    
    [Service]
    Group=apache
    WorkingDirectory=/home/user/apps/whats-today
    Environment="PATH=/home/user/apps/whats-today/flask/bin"
    ExecStart=/home/user/apps/whats-today/flask/bin/uwsgi --ini whatstoday.ini
    
    [Install]
    WantedBy=multi-user.target
    

  • Now you can start your socket:

    sudo systemctl start myproject
    sudo systemctl enable myproject
    

• Setup Nginx

  • You may want to add a server block in 'conf.d' or 'sites-enabled' in Nginx

  • Here's an example:

    upstream whatstoday {
        server unix:/home/user/apps/whats-today/whatstoday.sock;
    }
    
    server {
        listen 8000;
        server_name 127.0.0.1;
    
        location / {
            include uwsgi_params;
            uwsgi_pass whatstoday;
        }
    
        # Cache static files
        location /static {
            alias /home/user/apps/whats-today/app/static;
            expires 1d;
            add_header Cache-Control "public";
        }
        
        # No cache for html/data files etc
        location ~* \.(?:manifest|appcache|html?|xml|json)$ {
            expires -1;
        }
    }
    

  • Also make sure your Nginx runs by correct user-group (I know a group of apache nginx is weird...)

     sudo vim /etc/nginx/nginx.conf
     // In Nginx, an example
     user user apache;
    

  • Before running Nginx, check syntax sudo nginx -t

  • Run Nginx

    sudo systemctl start nginx
    sudo systemctl enable nginx
    

  • http://YOUR_IP_OR_DOMAIN:8000/

This project uses Flask-Cache's memcached system, so it requires

• pylibmc which requires also libmemcached in system's ENV

    sudo yum install libmemcached libmemcached-devel

Then

    pip install pylibmc==1.2.3

(notice that 1.3 seems wrong for me...)

• memcached server

    sudo yum install memcached

Along with its config file

    sudo vim /etc/sysconfig/memcached

Change the option to localhost only

    OPTIONS="-l 127.0.0.1"

• Check if memcached server runs

      memcached -u memcached -vv
  

• In __init__.py

  Already in codes, if env == prod, then use memcached server with 127.0.0.1:11211

• Use flask-cache to cache html
• Use nginx to cache assets
• Minify react's JS files
• Logger
• Mailer system
• Pagination of list page
• Weibo connect
• Unit tests (for god's sake...)