Flask-Analytics
Flask Analytics is an extension for Flask which generates analytics snippets for inclusion in templates.
Installation
$ pip install Flask-Analytics
Usage
app.py
from flask import Flask, render_template
from flask_analytics import Analytics
app = Flask(__name__)
Analytics(app)
app.config['ANALYTICS']['GAUGES']['SITE_ID'] = 'XXXXXXXXXXXXX'
@app.route('/')
def index():
return render_template('index.html')
index.html
{{ analytics }}
result
$ curl http://localhost:5000/
<script type="text/javascript">
var _gauges = _gauges || [];
(function() {
var t = document.createElement('script');
t.type = 'text/javascript';
t.async = true;
t.id = 'gauges-tracker';
t.setAttribute('data-site-id', 'XXXXXXXXXXXXX');
t.src = '//secure.gaug.es/track.js';
var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(t, s);
})();
</script>
Services
Flask-Analytics uses keys defined in app.config['ANALYTICS'] to determine which for which services analytics snippets should be generated.
| Service | Keys Required |
|---|---|
| Google Analytics (ga.js) | ['GOOGLE_CLASSIC_ANALYTICS']['ACCOUNT'] |
| Universal Analytics (analytics.js) | ['GOOGLE_UNIVERSAL_ANALYTICS']['ACCOUNT'] |
| Piwik | ['PIWIK']['BASE_URL']['PIWIK']['SITE_ID'] |
| Gaug.es | ['GAUGES']['SITE_ID'] |
| Chartbeat | ['CHARTBEAT']['UID']['CHARTBEAT']['DOMAIN'] |
| GoSquared | ['GOSQUARED']['UID'] |
Individual services can be disabled by setting the ENABLED key for that service (e.g. ['ANALYTICS']['PIWIK']['ENABLED']). Analytics as a whole can be disabled by setting the ENABLED key at the top (e.g. ['ANALYTICS']['ENABLED']).
When a service, or analytics as a whole, is disabled, it returns an empty string, so it's safe to keep {{analytics}} in your template.
When the configuration changes, the source for the analytics code will automatically be rebuilt the next time it's called.
Tests
$ nosetests -v --with-coverage --cover-package=flask_analytics --cover-html
test_all (test_app.TestAnalytics) ... ok
test_boostrap (test_app.TestAnalytics) ... ok
test_chartbeat (test_app.TestAnalytics) ... ok
test_disabled (test_app.TestAnalytics) ... ok
test_gauges (test_app.TestAnalytics) ... ok
test_google_classic (test_app.TestAnalytics) ... ok
test_google_universal (test_app.TestAnalytics) ... ok
test_gosquared (test_app.TestAnalytics) ... ok
test_none (test_app.TestAnalytics) ... ok
test_piwik (test_app.TestAnalytics) ... ok
Name Stmts Miss Cover Missing
-------------------------------------------------------------------------------------
flask_analytics.py 1 0 100%
flask_analytics/analytics.py 60 1 98% 77
flask_analytics/providers.py 0 0 100%
flask_analytics/providers/base.py 2 0 100%
flask_analytics/providers/chartbeat.py 13 0 100%
flask_analytics/providers/gauges.py 11 0 100%
flask_analytics/providers/googleclassicanalytics.py 11 0 100%
flask_analytics/providers/googleuniversalanalytics.py 11 0 100%
flask_analytics/providers/gosquared.py 11 0 100%
flask_analytics/providers/piwik.py 13 0 100%
-------------------------------------------------------------------------------------
TOTAL 133 1 99%
----------------------------------------------------------------------
Ran 10 tests in 0.111s
OK
License
Flask-Analytics is dedicated to the public domain. Please read the license for more information.
174 Dec 01, 2022
815 Jan 03, 2023
34 Dec 16, 2022
48 Mar 07, 2022
1.3k Jan 05, 2023
2.2k Jan 04, 2023
397 Dec 15, 2022
1.6k Dec 19, 2022
922 Jan 08, 2023
2 Nov 29, 2021
803 Jan 01, 2023
165 Dec 27, 2022
8 Aug 30, 2022
248 Dec 26, 2022
10 Dec 08, 2022
204 Dec 26, 2022
2 Jan 20, 2022
59 Dec 18, 2022
3 Feb 28, 2022