gae-flask-html5

          E
         DtD
        .itGD                                                ffffffffffffffffff 
        :tttG                        E                       fffffffffjjjjjjjjf 
        ;ttjLD     ..                ##                      fffffffffjjjjjjjjf 
        ijjjfGEED;.:::D             WE,KE                    fffLLLLLLfjjjjjjff 
        jfffLLt:.::::::t           D### # #                  fff......      jff 
        LLLLf::.::ffjt::D         ,i#G.#DG                   fff......      jff 
        DLL:::..:;:itii::E         G##W  t                   fff...fffjjjjjjjff 
        EL::::.:;,.,jiii:j         #W#                       fff,..fffjjjjjjjff 
       ,E:::::.:i,;:i;ii::         #Ki,                      Lfff.....     jjf; 
       D::::::::ffL;,,ii,:,        L#  W .                   jfff.....     jjf. 
       j::::::..LLL:.iii;:j         ,#G                      ,fff:::::...  jjf  
       i:::::::.LLi;;;ii,:i         ##Gt. D                   ffffffffjjj  jjf  
     LDtjfLLf:::GGG.:jii::           WW # .                   fff..fffjjj  jjf  
   EDtitj;GGG:,:t:,;;iii::;DL        K#E##                    fff..fffjjj  jff  
 DLLfjLGGGGDG::::i::,ii;:GGLD         D# iK :                 fff.....     jff  
 DitifLDD;;;::::::iiiii:,GDD           L#GK# j,               ffff....   .jjff  
  DEEE   E;,::::::::,:::t               t###K  f# #           ffffffffjjjjjjff  
          D:::::::::::,E                  E############       ffffffffjjjjjfff  
            EDG,:::jEE                        ;EKL            ,fffffffjjffffL,  
                                                                  iffffffi      
                                                                     ..     


                      github.com/zachwill/gae-flask-html5

What is this?

It's just a simple Flask skeleton for Google App Engine, but made with all the baked-in-goodness of html5 boilerplate.

I'm planning on using this for my GAE projects going forward (I really like the speed of Flask compared to Django-Nonrel on GAE), so I thought someone else might find it useful, too.

Just about everything is ready to go right out of the box -- including QUnit for JavaScript tests and a test directory for Python's unittest. Also, I included a style.less file since I primarily only use the Less app when writing stylesheets nowadays.

Why should I use it?

I stumbled a bit figuring out how to add tests and use the unittest module, and also setup an appengine_console.py file to connect to GAE's remote API, so this skeleton might come in handy for you.

I looked at two other Flask GAE skeletons on Github (flask-gae-skeleton and flask-gae-template -- both of which were awesome for learning), and I adapted what I felt were some of their best parts. Recently, I've updated this project's structure after browsing the source code of another project skeleton.

Lastly, as an added bonus, the scripts are PEP8 compliant.

How do I use it?

Make sure you have the Google App Engine SDK installed on your computer, and you've created an application for your Google account.

Setup

git clone https://github.com/zachwill/gae-flask-html5.git <your_app_name_here>

Run

dev_appserver.py .

Deploy

appcfg.py update .

Test

Run your application with the dev_appserver.py . command, and then point your browser to http://localhost:<YOUR-PORT-NUMBER>/test

Remote Console

python appengine_console.py .

Todo

• add more tests to tests.py
• add pep8.py to libs
  • create PEP8 TestCase, too