# Copyright (C) 2009-2012 Chris Ball <cjb@laptop.org>
# W. Trevor King <wking@tremily.us>
#
# This file is part of Bugs Everywhere.
#
# Bugs Everywhere is free software: you can redistribute it and/or modify it
# under the terms of the GNU General Public License as published by the Free
# Software Foundation, either version 2 of the License, or (at your option) any
# later version.
#
# Bugs Everywhere is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
# more details.
#
# You should have received a copy of the GNU General Public License along with
# Bugs Everywhere. If not, see <http://www.gnu.org/licenses/>.
"""Define the :py:class:`~libbe.storage.base.Storage` and
:py:class:`~libbe.storage.base.VersionedStorage` classes for storing BE
data.
Also define assorted implementations for the Storage classes:
* :py:mod:`libbe.storage.vcs`
Also define an assortment of storage-related tools and utilities:
* :py:mod:`libbe.storage.util`
"""
from . import base as _base
ConnectionError = _base.ConnectionError
InvalidStorageVersion = _base.InvalidStorageVersion
InvalidID = _base.InvalidID
InvalidRevision = _base.InvalidRevision
InvalidDirectory = _base.InvalidDirectory
NotWriteable = _base.NotWriteable
NotReadable = _base.NotReadable
EmptyCommit = _base.EmptyCommit
# a list of all past versions
STORAGE_VERSIONS = ['Bugs Everywhere Tree 1 0',
'Bugs Everywhere Directory v1.1',
'Bugs Everywhere Directory v1.2',
'Bugs Everywhere Directory v1.3',
'Bugs Everywhere Directory v1.4',
'Bugs Everywhere Directory v1.5',
]
# the current version
STORAGE_VERSION = STORAGE_VERSIONS[-1]
def get_vcs_storage(location):
import vcs
s = vcs.detect_vcs(location)
s.repo = location
return s
def get_storage(location):
"""
Return a Storage instance from a repo location string.
"""
if location.startswith('http://') or location.startswith('https://'):
raise ConnectionError('HTTP URLs are no longer supported')
return get_vcs_storage(location)
__all__ = [ConnectionError, InvalidStorageVersion, InvalidID,
InvalidRevision, InvalidDirectory, NotWriteable, NotReadable,
EmptyCommit, STORAGE_VERSIONS, STORAGE_VERSION,
get_storage]