init commit

Author: kkung

.gitignore

@@ -0,0 +1,13 @@
+# Standard ignores
+*.pyc
+*.pyo
+*.DS_Store
+*.swp
+*.idea
+*.project
+*.pydevproject
+*.kpf
+
+# Don't store secret keys in version control
+secret_keys.py
+

app.yaml

@@ -0,0 +1,30 @@
+application: langdevlinks
+version: 1
+runtime: python
+api_version: 1
+
+default_expiration: "5d"
+
+builtins:
+- appstats: on
+- datastore_admin: on
+- deferred: on
+- remote_api: on
+
+inbound_services:
+- warmup
+
+handlers:
+- url: /favicon.ico
+  static_files: application/static/img/favicon.ico
+  upload: application/static/img/favicon.ico
+
+- url: /robots.txt
+  static_files: application/static/robots.txt
+  upload: application/static/robots.txt
+
+- url: /static
+  static_dir: application/static
+
+- url: .*
+  script: main.py

application/__init__.py

@@ -0,0 +1,13 @@
+"""
+Initialize Flask app
+
+"""
+
+from flask import Flask
+from flaskext.gae_mini_profiler import GAEMiniProfiler
+
+app = Flask('application')
+app.config.from_object('application.settings')
+GAEMiniProfiler(app)
+
+import urls

application/decorators.py

@@ -0,0 +1,31 @@
+"""
+decorators.py
+
+Decorators for URL handlers
+
+"""
+
+from functools import wraps
+from google.appengine.api import users
+from flask import redirect, request
+
+
+def login_required(func):
+    """Requires standard login credentials"""
+    @wraps(func)
+    def decorated_view(*args, **kwargs):
+        if not users.get_current_user():
+            return redirect(users.create_login_url(request.url))
+        return func(*args, **kwargs)
+    return decorated_view
+
+
+def admin_required(func):
+    """Requires App Engine admin credentials"""
+    @wraps(func)
+    def decorated_view(*args, **kwargs):
+        if not users.is_current_user_admin():
+            return redirect(users.create_login_url(request.url))
+        return func(*args, **kwargs)
+    return decorated_view
+

application/forms.py

@@ -0,0 +1,13 @@
+"""
+forms.py
+
+Web forms based on Flask-WTForms
+
+See: http://flask.pocoo.org/docs/patterns/wtforms/
+     http://wtforms.simplecodes.com/
+
+"""
+
+from flaskext import wtf
+from flaskext.wtf import validators
+

application/generate_keys.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python
+# encoding: utf-8
+"""
+generate_keys.py
+
+Generate CSRF and Session keys, output to secret_keys.py file
+
+Usage:
+    generate_keys.py [-f]
+
+Outputs secret_keys.py file in current folder
+
+By default, an existing secret_keys file will not be replaced.
+Use the '-f' flag to force the new keys to be written to the file
+
+
+"""
+
+import string
+import os.path
+
+from optparse import OptionParser
+from random import choice
+from string import Template
+
+
+# File settings
+file_name = 'secret_keys.py'
+file_template = Template('''# CSRF- and Session keys
+
+CSRF_SECRET_KEY = '$csrf_key'
+SESSION_KEY = '$session_key'
+''')
+
+
+# Get options from command line
+parser = OptionParser()
+parser.add_option("-f", "--force", dest="force", 
+    help="force overwrite of existing secret_keys file", action="store_true")
+parser.add_option("-r", "--randomness", dest="randomness", 
+    help="length (randomness) of generated key; default = 24", default=24)
+(options, args) = parser.parse_args()
+
+
+def generate_randomkey(length):
+    """Generate random key, given a number of characters"""
+    chars = string.letters + string.digits
+    return ''.join([choice(chars) for i in range(length)])
+
+
+def write_file(contents):
+    f = open(file_name, 'wb')
+    f.write(contents)
+    f.close()
+
+
+def generate_keyfile(csrf_key, session_key):
+    """Generate random keys for CSRF- and session key"""
+    output = file_template.safe_substitute(dict(
+        csrf_key=csrf_key, session_key=session_key
+    ))
+    if os.path.exists(file_name):
+        if options.force is None:
+            print "Warning: secret_keys.py file exists.  Use '-f' flag to force overwrite."
+        else:
+            write_file(output)
+    else:
+        write_file(output)
+
+
+def main():
+    r = options.randomness
+    csrf_key = generate_randomkey(r)
+    session_key = generate_randomkey(r)
+    generate_keyfile(csrf_key, session_key)
+
+
+if __name__ == "__main__":
+    main()
+

application/models.py

@@ -0,0 +1,18 @@
+"""
+models.py
+
+App Engine datastore models
+
+"""
+
+
+from google.appengine.ext import db
+
+
+class LinkModel(db.Model):
+  author_id = db.StringProperty(required=True)
+  link_url = db.StringProperty(required=True)
+
+  created_at = db.DateTimeProperty(auto_now_add=True)
+  updated_at = db.DateTimeProperty(auto_now_add=True)
+

application/settings.py

@@ -0,0 +1,29 @@
+"""
+settings.py
+
+Configuration for Flask app
+
+Important: Place your keys in the secret_keys.py module, 
+           which should be kept out of version control.
+
+"""
+
+import os
+
+from secret_keys import CSRF_SECRET_KEY, SESSION_KEY
+
+
+DEBUG_MODE = False
+
+# Auto-set debug mode based on App Engine dev environ
+if 'SERVER_SOFTWARE' in os.environ and os.environ['SERVER_SOFTWARE'].startswith('Dev'):
+    DEBUG_MODE = True
+
+DEBUG = DEBUG_MODE
+
+# Set secret keys for CSRF protection
+SECRET_KEY = CSRF_SECRET_KEY
+CSRF_SESSION_KEY = SESSION_KEY
+
+CSRF_ENABLED = True
+

application/static/css/main.css

@@ -0,0 +1,8 @@
+
+/* Main stylesheet */
+
+html {background-color: #333;}
+body {background-color: #fff; margin: 2em auto; width: 960px; padding: 1em; border: 8px solid #ccc;}
+form label {display: block;}
+
+/* Your customizations here */

application/static/img/favicon.ico

@@ -0,0 +1 @@
+/* Your custom JavaScript here */

application/static/img/favicon.png

@@ -0,0 +1,2 @@
+User-agent: *
+Disallow: /

application/static/js/main.js

@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<title>not found</title>
+
+<style>
+body { text-align: center;}
+h1 { font-size: 50px; }
+body { font: 20px Constantia, 'Hoefler Text',  "Adobe Caslon Pro", Baskerville, Georgia, Times, serif; color: #999; text-shadow: 2px 2px 2px rgba(200, 200, 200, 0.5); }
+::-moz-selection{ background:#FF5E99; color:#fff; }
+::selection { background:#FF5E99; color:#fff; } 
+details { display:block; }
+a { color: rgb(36, 109, 56); text-decoration:none; }
+a:hover { color: rgb(96, 73, 141) ; text-shadow: 2px 2px 2px rgba(36, 109, 56, 0.5); }
+span[frown] { transform: rotate(90deg); display:inline-block; color: #bbb; }
+</style>
+
+
+
+
+<details>
+  <summary><h1>Not found</h1></summary>
+  <p><span frown>:(</span></p>
+</details>