# Copyright (c) 2014 The Chromium OS Authors. All rights reserved.
|
# Use of this source code is governed by a BSD-style license that can be
|
# found in the LICENSE file.
|
|
"""This files contains helper methods to interact with the readonly database."""
|
|
# Please note this file doesn't contain and should not contain any logic to
|
# establish connections outside of Django, as that might lead to effects where
|
# connections get leaked, which will lead to Django not cleaning them up
|
# properly. See http://crbug.com/422637 for more details on this failure.
|
|
from django import db as django_db
|
|
_DISABLED = False
|
|
def set_globally_disabled(disable):
|
"""Disable and enable the use of readonly connections globally.
|
|
If disabled, connection() will return the global connection instead of the
|
readonly connection.
|
|
@param disable: When True, readonly connections will be disabled.
|
"""
|
_DISABLED = disable
|
|
|
def connection():
|
"""Return a readonly database connection."""
|
if _DISABLED:
|
return django_db.connections['global']
|
return django_db.connections['readonly']
|
|
|
def cursor():
|
"""Return a cursor on the readonly database connection."""
|
return connection().cursor()
|
