6-api-documentation

README.md

@@ -30,19 +30,19 @@
 - Install and launch [Cloud SQL Proxy](https://cloud.google.com/sql/docs/mysql/sql-proxy)
 
   ```sh
-  cloud_sql_proxy -dir=/tmp/cloudsql -instances=yori_instance_name=tcp:3306
+  ./cloud_sql_proxy -dir=/tmp/cloudsql -instances=yori_instance_name=tcp:3306
   ```
 
 - Launch server
 
   ```sh
-  env FLASK_APP=main.py DB_USER=username DB_PASS=password DB_NAME=database_name CLOUD_SQL_CONNECTION_NAME=yori_instance_name flask run
+  env FLASK_APP=main.py DB_USER=username DB_PASS=password CLOUD_SQL_CONNECTION_NAME=yori_instance_name flask run
   ```
 
   or if you want to enable network access to local server (especially when you are developing yori-view)
 
   ```sh
-  env FLASK_APP=main.py DB_USER=username DB_PASS=password DB_NAME=database_name CLOUD_SQL_CONNECTION_NAME=yori_instance_name flask run --host=0.0.0.0
+  env FLASK_APP=main.py DB_USER=username DB_PASS=password CLOUD_SQL_CONNECTION_NAME=yori_instance_name flask run --host=0.0.0.0
   ```
 
   If setting environments bothers you, write them in your dotfiles.

apis/__init__.py

@@ -0,0 +1,11 @@
+from flask_restplus import Api
+from .member import api as member
+
+api = Api(
+    title='Yori API',
+    version='1.0',
+    description='API Documentation',
+    # All API metadatas
+)
+
+api.add_namespace(member)

apis/member.py

@@ -0,0 +1,31 @@
+from flask import jsonify
+from flask_restplus import Namespace, Resource, fields
+
+api = Namespace('member', description='Members related operations')
+
+member = api.model('member', {
+    'member_name_en': fields.String(required=True, description='英語'),
+    'member_name': fields.String(required=True, description='名前'),
+    'member_name_gana': fields.String(required=True, description='ひらがな'),
+    'member_gen': fields.Integer(required=True, description='期'),
+    'member_graduated': fields.Boolean(required=True, description='卒業'),
+    'group_id': fields.String(required=True, description='group id')
+})
+
+MEMBERS = [
+    {
+        'member_name_en': 'imaizumi_yui',
+        'member_name': '今泉佑唯',
+        'member_name_gana': 'いまいずみ_ゆい',
+        'member_gen': 1,
+        'member_graduated': True,
+        'group_id': 'keyakizaka'
+    }
+]
+
+@api.route('/')
+class MemberList(Resource):
+    @api.doc('get_members')
+    @api.marshal_list_with(member)
+    def get(self):
+        return MEMBERS

app.yaml

@@ -7,4 +7,4 @@ env_variables:
   CLOUD_SQL_CONNECTION_NAME: your-connection-name
   DB_USER: USER
   DB_PASS: PASSWORD
-  DB_NAME: DATABASE
+  DB_NAME: yori_database

main.py

@@ -1,20 +1,21 @@
 import datetime
 import logging
 import os
-import json
 
 from flask import Flask
 from flask_cors import CORS
 import sqlalchemy
 import requests
 
+from apis import api
 
 def onGAE():
     return os.getenv('GAE_ENV', '').startswith('standard')
 
 
 app = Flask(__name__)
 CORS(app)
+api.init_app(app)
 app.config['JSON_AS_ASCII'] = False
 
 db_user = os.environ.get('DB_USER')
@@ -51,7 +52,6 @@ def onGAE():
 
 db = sqlalchemy.create_engine(connection_string)
 
-
 # TODO:
 # We should create a package and move this into __init__.py of that package
 def notify():
@@ -65,15 +65,6 @@ def notify():
         logger.info(message)
         requests.post(slack_webhook_url, json={'text': message})
 
-
-# TODO:
-# We should create a package and move this into that package
-@app.route('/photo', methods=['GET'])
-def index():
-    result = db.execute('select * from photos')
-    return json.dumps([dict(data) for data in result])
-
-
 # TODO:
 # We should create a package and move this into __init__.py of that package
 if onGAE():

requirements.txt

@@ -1,5 +1,6 @@
 Flask==1.0.2
 flask-cors>=3.0.8
+flask_restplus==0.12.1
 SQLAlchemy>=1.3.0
 PyMySQL==0.9.3
 google-cloud-logging>=1.8.0