{{{highlight=javascript
$.ajax({
    url: "/api/",
    success: function (body, status, jqxhr) {
        console.log("RESPONSE (" + status + ")");
        console.log(body);
    },
    error: function (jqxhr, type, error) {
        console.log("ERROR (" + type + ") - " + error);
    }
});

In [1]: from app import app
In [2]: with app.app_context():
   ...:    #do things

components:
  parameters:
    sensor:
      description: Selected sensor's unique name
      in: path
      name: sensor
      required: true
      schema:
        type: string
  schemas:
    Sensor:
      properties:
        model:
          description: Name of the sensor's model
          type: string
        name:
          description: Sensor's unique name
          type: string
      required:
      - name
      - model
      type: object
  securitySchemes:
    sensorhubKey:
      type: apiKey
      name: Sensorhub-Api-Key
      in: header

{
    "@controls": {
        "mumeta:delete": {
            "href": "/api/artists/dream theater/"
            "title": "Delete this artist"
            "method": "DELETE"
        }
    }
} 

from werkzeug.exceptions import NotFound
from werkzeug.routing import BaseConverter

class SensorConverter(BaseConverter):
    
    def to_python(self, sensor_name):
        db_sensor = Sensor.query.filter_by(name=sensor).first()
        if db_sensor is None:
            raise NotFound
        return db_sensor
        
    def to_url(self, db_sensor):
        return db_sensor.name

@app.route("/add/<float:number_1>/<float:number_2>/")
def add(number_1, number_2):
    ...

app.url_map.converters["sensor"] = SensorConverter
api.add_resource(SensorItem, "/api/sensors/<sensor:sensor>/")

sudo systemctl start nginx
sudo systemctl restart nginx
sudo systemctl stop nginx

sudo systemctl enable nginx

sudo systemctl status nginx

sudo systemctl reload nginx

def call_me_maybe(func):
    def wrapper(*args):
        if random.randint(0, 1):
            return func(*args)
        else:
            print("Too lazy, sorry")
    return wrapper

@call_me_maybe
def add(a, b):
    return a + b

export VARIABLE_NAME=value

your/app/folder$ ipython
[1]: from yourapp import db
[2]: db.create_all()

your/app/folder$ export FLASK_APP=yourapp.py
your/app/folder$ export FLASK_ENV=development
flask run

C:\your\app\folder> set FLASK_APP=yourapp.py
C:\your\app\folder> set FLASK_ENV=development
flask run

info:
  title: Sensorhub Example
  version: 0.0.1
  description: |
    This is an API example used in the Programmable Web Project course.
    It stores data about sensors and where they have been deployed.
  termsOfService: http://totally.not.placehold.er/
  contact:
    url: http://totally.not.placehold.er/
    email: pwp-course@lists.oulu.fi
    name: PWP Staff List
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html

json = json.dumps(datastructure)

with open("data.json", "w" as fd:
    json.dump(datastructure, fd)

datastructure = json.reads(json)

with open("data.json", "r" as fd:
    datastructure = json.read(fd)

text/plain
text/html
text/javascript
text/css
image/png
image/jpeg
application/json

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
app.config["SQLALCHEMY_DATABASE_URI"] = "sqlite:///test.db"
app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = False
db = SQLAlchemy(app)

class Measurement(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    sensor = db.Column(db.String(20), nullable=False)
    value = db.Column(db.Float, nullable=False)
    time = db.Column(db.DateTime, nullable=False)

{
    "@namespaces": {
        "mumeta": {
            "name": "http://wherever.this.server.is/musicmeta/link-relations/#"
        }
    }
}

description: Get the list of managed sensors
responses:
  '200':
    description: List of sensors with shortened location info
    content:
      application/json:
        example:
        - name: test-sensor-1
          model: uo-test-sensor
          location: test-site-a
        - name: test-sensor-2
          model: uo-test-sensor
          location: null

http://my.little.si.te/search/?keyword=aasi&perpage=10

keyword = request.args.get("keyword")
perpage = request.args.get("perpage")

"^[0-9]{4}-[01][0-9]-[0-3][0-9]$"

@app.route("/hello/<name>/")
def hello(name):
    return "hello {}".format(name)

from flask import Flask, url_for

href = url_for("hello", name="donkey")

api.add_resource(SensorItem, "/api/sensors/<sensor>/")

api.url_for(SensorItem, sensor=handle)

sudo useradd --system username

@app.route("/user-by-id/<int:uid>/")
def user_by_id(uid):
    ...

@app.route("/hello/<name>/")
def hello(name):
    return "hello {}".format(name)

python -m venv /path/to/the/virtualenv

source /path/to/the/virtualenv/bin/activate

C:\path\to\the\virtualenv\Scriptrs\activate

(pwp-env) user@computer:~/$ 

items:
- name: test-sensor-1
  model: uo-test-sensor
  location: test-site-a
- name: test-sensor-2
  model: uo-test-sensor
  location: null