1 files changed, 37 insertions, 0 deletions
diff --git a/brevisurl/__init__.py b/brevisurl/__init__.py
new file mode 100644
index 0000000..66f2efa
--- /dev/null
+++ b/brevisurl/__init__.py
@@ -0,0 +1,37 @@
+import brevisurl.settings
+from brevisurl.utils import load_object
+
+
+def get_connection(backend=None, fail_silently=False, **kwargs):
+    """Load a brevisurl backend and return an instance of it.
+
+    If backend is None (default) settings.BREVISURL_BACKEND is used.
+    Both fail_silently and other keyword arguments are used in the
+    constructor of the backend.
+
+    :param backend: path to brevisurl backend
+    :type backend: string
+    :param fail_silently: whether to fail silently when error intercepted or not
+    :type fail_silently: bool
+    :returns: instance os BaseBrevisUrlBackend
+    :rtype: brevisurl.backends.base.BaseBrevisUrlBackend
+
+    """
+    path = backend or brevisurl.settings.DEFAULT_BACKEND
+    klass = load_object(path)
+    return klass(fail_silently=fail_silently, **kwargs)
+
+
+def shorten_url(original_url, fail_silently=False, connection=None):
+    """Shortcut util for shortening urls using default brevisurl backend if none supplied.
+
+    :param original_url: url that will be shortened
+    :type original_url: string
+    :param backend: one of brevisurl backends
+    :type backend: brevisurl.backends.BaseBrevisUrlBackend
+    :returns: shortened url from original url
+    :rtype: brevisurl.models.ShortUrl
+
+    """
+    connection = connection or get_connection(fail_silently=fail_silently)
+    return connection.shorten_url(original_url)
+\ No newline at end of file