167 lines
5.0 KiB
Python
167 lines
5.0 KiB
Python
#!/usr/bin/env python
|
|
# coding=utf8
|
|
|
|
__version__ = '2.3.3'
|
|
|
|
import re
|
|
|
|
from flask import Blueprint, current_app, url_for
|
|
|
|
|
|
class CDN(object):
|
|
"""Base class for CDN objects."""
|
|
def get_resource_url(self, filename):
|
|
"""Return resource url for filename."""
|
|
raise NotImplementedError
|
|
|
|
|
|
class StaticCDN(object):
|
|
"""A CDN that serves content from the local application.
|
|
|
|
:param static_endpoint: Endpoint to use.
|
|
:param rev: If ``True``, honor ``ADMINLTE_QUERYSTRING_REVVING``.
|
|
"""
|
|
def __init__(self, static_endpoint='static', rev=False):
|
|
self.static_endpoint = static_endpoint
|
|
self.rev = rev
|
|
|
|
def get_resource_url(self, filename):
|
|
extra_args = {}
|
|
|
|
if self.rev and current_app.config['ADMINLTE_QUERYSTRING_REVVING']:
|
|
extra_args['adminlte'] = __version__
|
|
|
|
return url_for(self.static_endpoint, filename=filename, **extra_args)
|
|
|
|
|
|
class WebCDN(object):
|
|
"""Serves files from the Web.
|
|
|
|
:param baseurl: The baseurl. Filenames are simply appended to this URL.
|
|
"""
|
|
def __init__(self, baseurl):
|
|
self.baseurl = baseurl
|
|
|
|
def get_resource_url(self, filename):
|
|
return self.baseurl + filename
|
|
|
|
|
|
class ConditionalCDN(object):
|
|
"""Serves files from one CDN or another, depending on whether a
|
|
configuration value is set.
|
|
|
|
:param confvar: Configuration variable to use.
|
|
:param primary: CDN to use if the configuration variable is ``True``.
|
|
:param fallback: CDN to use otherwise.
|
|
"""
|
|
def __init__(self, confvar, primary, fallback):
|
|
self.confvar = confvar
|
|
self.primary = primary
|
|
self.fallback = fallback
|
|
|
|
def get_resource_url(self, filename):
|
|
if current_app.config[self.confvar]:
|
|
return self.primary.get_resource_url(filename)
|
|
return self.fallback.get_resource_url(filename)
|
|
|
|
|
|
def adminlte_find_resource(filename, cdn, use_minified=None, local=True):
|
|
"""Resource finding function, also available in templates.
|
|
|
|
Tries to find a resource, will force SSL depending on
|
|
``ADMINLTE_CDN_FORCE_SSL`` settings.
|
|
|
|
:param filename: File to find a URL for.
|
|
:param cdn: Name of the CDN to use.
|
|
:param use_minified': If set to ``True``/``False``, use/don't use
|
|
minified. If ``None``, honors
|
|
``ADMINLTE_USE_MINIFIED``.
|
|
:param local: If ``True``, uses the ``local``-CDN when
|
|
``ADMINLTE_SERVE_LOCAL`` is enabled. If ``False``, uses
|
|
the ``static``-CDN instead.
|
|
:return: A URL.
|
|
"""
|
|
config = current_app.config
|
|
|
|
if None == use_minified:
|
|
use_minified = config['ADMINLTE_USE_MINIFIED']
|
|
|
|
if use_minified:
|
|
filename = '%s.min.%s' % tuple(filename.rsplit('.', 1))
|
|
|
|
cdns = current_app.extensions['adminlte']['cdns']
|
|
resource_url = cdns[cdn].get_resource_url(filename)
|
|
|
|
if resource_url.startswith('//') and config['ADMINLTE_CDN_FORCE_SSL']:
|
|
resource_url = 'https:%s' % resource_url
|
|
|
|
return resource_url
|
|
|
|
|
|
class AdminLTE(object):
|
|
def __init__(self, app=None):
|
|
if app is not None:
|
|
self.init_app(app)
|
|
|
|
def init_app(self, app):
|
|
ADMINLTE_VERSION = re.sub(r'^(\d+\.\d+\.\d+).*', r'\1', __version__)
|
|
JQUERY_VERSION = '2.1.4'
|
|
HTML5SHIV_VERSION = '3.7.0'
|
|
RESPONDJS_VERSION = '1.3.0'
|
|
|
|
app.config.setdefault('ADMINLTE_USE_MINIFIED', True)
|
|
app.config.setdefault('ADMINLTE_CDN_FORCE_SSL', False)
|
|
|
|
app.config.setdefault('ADMINLTE_QUERYSTRING_REVVING', True)
|
|
app.config.setdefault('ADMINLTE_SERVE_LOCAL', False)
|
|
|
|
blueprint = Blueprint(
|
|
'adminlte',
|
|
__name__,
|
|
template_folder='templates',
|
|
static_folder='static',
|
|
static_url_path=app.static_url_path + '/adminlte')
|
|
|
|
app.register_blueprint(blueprint)
|
|
|
|
app.jinja_env.globals['adminlte_find_resource'] =\
|
|
adminlte_find_resource
|
|
|
|
if not hasattr(app, 'extensions'):
|
|
app.extensions = {}
|
|
|
|
local = StaticCDN('adminlte.static', rev=True)
|
|
static = StaticCDN()
|
|
|
|
def lwrap(cdn, primary=static):
|
|
return ConditionalCDN('ADMINLTE_SERVE_LOCAL', primary, cdn)
|
|
|
|
bootstrap = lwrap(
|
|
WebCDN('//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/%s/'
|
|
% ADMINLTE_VERSION),
|
|
local)
|
|
|
|
jquery = lwrap(
|
|
WebCDN('//cdnjs.cloudflare.com/ajax/libs/jquery/%s/'
|
|
% JQUERY_VERSION),
|
|
local)
|
|
|
|
html5shiv = lwrap(
|
|
WebCDN('//cdnjs.cloudflare.com/ajax/libs/html5shiv/%s/'
|
|
% HTML5SHIV_VERSION))
|
|
|
|
respondjs = lwrap(
|
|
WebCDN('//cdnjs.cloudflare.com/ajax/libs/respond.js/%s/'
|
|
% RESPONDJS_VERSION))
|
|
|
|
app.extensions['adminlte'] = {
|
|
'cdns': {
|
|
'local': local,
|
|
'static': static,
|
|
'bootstrap': bootstrap,
|
|
'jquery': jquery,
|
|
'html5shiv': html5shiv,
|
|
'respond.js': respondjs,
|
|
},
|
|
}
|