Initial commit.

.coveragerc

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8; mode: ini -*-
+
+# ========================================================================
+# Copyright (c) 2017 Dropbox, Inc. <https://www.dropbox.com/>.
+#
+# Please see the accompanying LICENSE and CREDITS file(s) for rights and
+# restrictions governing use of this software. All rights not expressly
+# waived or licensed are reserved. If such a file did not accompany this
+# software, then please contact the author before viewing or using this
+# software in any capacity.
+# ========================================================================
+
+[run]  # -----------------------------------------------------------------
+
+omit =
+    .eggs/*
+    .tox/*
+    *.c
+    */distutils/*
+    */lib_pypy/*
+    */site-packages/*
+    tests/*

.gitattributes

@@ -0,0 +1,2 @@
+*.env text eol=lf
+*.sh text eol=lf

.gitignore

@@ -0,0 +1,78 @@
+# -*- encoding: utf-8 -*-
+
+# ========================================================================
+# Copyright (c) 2017 Dropbox, Inc. <https://www.dropbox.com/>.
+#
+# Please see the accompanying LICENSE and CREDITS file(s) for rights and
+# restrictions governing use of this software. All rights not expressly
+# waived or licensed are reserved. If such a file did not accompany this
+# software, then please contact the author before viewing or using this
+# software in any capacity.
+# ========================================================================
+
+# Various build/test entities
+__pycache__
+_trial_temp
+.coverage
+.eggs
+.tox
+.venv
+.venv-*
+.virtualenv
+*_flymake.py
+*.egg
+*.egg-info
+build
+dist
+docs/_build
+docs/_static
+htmlcov
+
+# Compiled objects
+*.class
+*.com
+*.dll
+*.exe
+*.o
+*.py[co]
+*.so
+dropin.cache
+node_modules
+
+# Packages
+*.7z
+*.bz2
+*.dmg
+*.gz
+*.iso
+*.jar
+*.rar
+*.tar
+*.xz
+*.zip
+
+# Logs, databases, etc.
+*.err
+*.log
+*.log.[0-9]*
+*.out
+*.pid
+*.sqlite
+nohup.out
+
+# OS/app generated entities
+._*
+.~*
+.DS_Store
+.DS_Store?
+.Spotlight-V100
+.Trashes
+desktop.ini
+ehthumbs.db
+Thumbs.db
+
+# Exceptions
+
+# Other
+/dbx_api_primer/primer.db
+/settings.cfg

.pylintrc

@@ -0,0 +1,6 @@
+[MESSAGES CONTROL]
+disable=C,R,fixme,locally-disabled,missing-super-argument,no-init,no-member
+enable=useless-suppression
+
+[REPORTS]
+reports=n

.travis.yml

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8; mode: yaml -*-
+
+# ========================================================================
+# Copyright (c) 2017 Dropbox, Inc. <https://www.dropbox.com/>.
+#
+# Please see the accompanying LICENSE and CREDITS file(s) for rights and
+# restrictions governing use of this software. All rights not expressly
+# waived or licensed are reserved. If such a file did not accompany this
+# software, then please contact the author before viewing or using this
+# software in any capacity.
+# ========================================================================
+
+language: python
+
+python:
+    - "2.7"
+    - pypy
+    - "3.3"
+    - "3.4"
+    - "3.5"
+    - pypy3
+
+install:
+    - pip install coveralls tox-travis
+
+script:
+    - tox
+
+after_success:
+    - coveralls

CREDITS

@@ -0,0 +1,17 @@
+The following individuals or entities have created and contributed
+derivative works of this software. By adding your name to this list, you
+transfer all title, license, and any other rights to your contributions to
+this software to its owner. You further warrant and agree that: (1) your
+contributions are exclusively your own creations and no one else has any
+right or claim to them; (2) once accepted, your contributions become the
+exclusive property of this software' owner and you retain no rights to
+them; and (3) you indemnify and hold harmless this software's owner of
+against any colorable claim of infringement by a third party for this
+software's owner's otherwise lawful use of your contribution, whether or
+not such use was contemplated by you at the time you made the
+contribution.
+
+Contributors:
+
+*   `Matt Bogosian <https://github.com/posita>`_ (see
+    `https://github.com/posita/_skel <https://github.com/posita/_skel>`_)

LICENSE

@@ -0,0 +1,34 @@
+The MIT License (MIT)
+
+Copyright |(c)| 2017 `Dropbox, Inc.`_
+
+.. |(c)| unicode:: u+a9
+.. _`Dropbox, Inc.`: https://www.dropbox.com/
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+
+This software is a derivative work of the following, and its distribution
+and use may be subject to any respective licenses or terms.
+
+*   `Flask <https://github.com/pallets/flask>`_. From
+    `LICENSE <https://github.com/pallets/flask/blob/master/LICENSE>`_:
+
+        Copyright (c) 2015 by Armin Ronacher and contributors. See
+        `AUTHORS <https://github.com/pallets/flask/blob/master/AUTHORS>`_
+        for more details. Some rights reserved.

MANIFEST.in

@@ -0,0 +1,3 @@
+graft dbx_api_primer/static
+graft dbx_api_primer/templates
+include dbx_api_primer/schema.sql

README.rst

@@ -0,0 +1,75 @@
+.. -*- encoding: utf-8; mode: rst -*-
+    >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>><<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
+    >>>>>>>>>>>>>>>> IMPORTANT: READ THIS BEFORE EDITING! <<<<<<<<<<<<<<<<
+    >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>><<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
+    Please keep each sentence on its own unwrapped line.
+    It looks like crap in a text editor, but it has no effect on rendering, and it allows much more useful diffs.
+    Thank you!
+
+Copyright |(c)| 2017 `Dropbox, Inc.`_
+
+.. |(c)| unicode:: u+a9
+.. _`Dropbox, Inc.`: https://www.dropbox.com/
+
+Please see the accompanying |LICENSE|_ and |CREDITS|_ file(s) for rights and restrictions governing use of this software.
+All rights not expressly waived or licensed are reserved.
+If such a file did not accompany this software, then please contact the author before viewing or using this software in any capacity.
+
+.. |LICENSE| replace:: ``LICENSE``
+.. _`LICENSE`: LICENSE
+.. |CREDITS| replace:: ``CREDITS``
+.. _`CREDITS`: CREDITS
+
+.. image:: https://travis-ci.org/posita/dropbox-api-primer.svg?branch=master
+    :target: https://travis-ci.org/posita/dropbox-api-primer?branch=master
+    :alt: [Build Status]
+
+.. image:: https://coveralls.io/repos/posita/dropbox-api-primer/badge.svg?branch=master
+    :target: https://coveralls.io/r/posita/dropbox-api-primer?branch=master
+    :alt: [Coverage Status]
+
+Curious about integrating your project with the above services?
+Jeff Knupp (|@jeffknupp|_) `describes how <https://www.jeffknupp.com/blog/2013/08/16/open-sourcing-a-python-project-the-right-way/>`__.
+
+.. |@jeffknupp| replace:: **@jeffknupp**
+.. _`@jeffknupp`: https://github.com/jeffknupp
+
+``dropbox-api-primer`` - Dropbox APIv2 Primer
+=============================================
+
+.. image:: https://img.shields.io/pypi/v/dropbox-api-primer.svg
+    :target: https://pypi.python.org/pypi/dropbox-api-primer
+    :alt: [master Version]
+
+.. image:: https://readthedocs.org/projects/dropbox-api-primer/badge/?version=master
+    :target: https://dropbox-api-primer.readthedocs.org/en/master/
+    :alt: [master Documentation]
+
+.. image:: https://img.shields.io/pypi/l/dropbox-api-primer.svg
+    :target: http://opensource.org/licenses/MIT
+    :alt: [master License]
+
+.. image:: https://img.shields.io/pypi/pyversions/dropbox-api-primer.svg
+    :target: https://pypi.python.org/pypi/dropbox-api-primer
+    :alt: [master Supported Python Versions]
+
+.. image:: https://img.shields.io/pypi/implementation/dropbox-api-primer.svg
+    :target: https://pypi.python.org/pypi/dropbox-api-primer
+    :alt: [master Supported Python Implementations]
+
+.. image:: https://img.shields.io/pypi/status/dropbox-api-primer.svg
+    :target: https://pypi.python.org/pypi/dropbox-api-primer
+    :alt: [master Development Stage]
+
+..
+
+``dropbox-api-primer`` is a tutorial for the Dropbox API v2 using the official Python SDK.
+It is licensed under the `MIT License <https://opensource.org/licenses/MIT>`_.
+Source code is `available on GitHub <https://github.com/posita/dropbox-api-primer>`__.
+See `the docs <https://dropbox-api-primer.readthedocs.org/en/master/>`__ for more information.
+
+Issues
+------
+
+If you find a bug, or want a feature, please `file an issue <https://github.com/posita/dropbox-api-primer/issues>`__ (if it hasn't already been filed).
+If you're willing and able, consider `contributing <https://dropbox-api-primer.readthedocs.org/en/master/contrib.html>`__.

dbx_api_primer/__init__.py

@@ -0,0 +1,35 @@
+# -*- encoding: utf-8; grammar-ext: py; mode: python -*-
+
+# ========================================================================
+"""
+  Copyright |(c)| 2017 `Dropbox, Inc.`_
+
+  .. |(c)| unicode:: u+a9
+  .. _`Dropbox, Inc.`: https://www.dropbox.com/
+
+  Please see the accompanying ``LICENSE`` and ``CREDITS`` file(s) for
+  rights and restrictions governing use of this software. All rights not
+  expressly waived or licensed are reserved. If such a file did not
+  accompany this software, then please contact the author before viewing
+  or using this software in any capacity.
+"""
+# ========================================================================
+
+from __future__ import (
+    absolute_import, division, print_function, unicode_literals,
+)
+from builtins import *  # noqa: F401,F403; pylint: disable=redefined-builtin,unused-wildcard-import,useless-suppression,wildcard-import
+from future.builtins.disabled import *  # noqa: F401,F403; pylint: disable=redefined-builtin,unused-wildcard-import,useless-suppression,wildcard-import
+
+# ---- Imports -----------------------------------------------------------
+
+import logging as _logging
+
+from .app import *  # noqa: F401,F403; pylint: disable=wildcard-import
+from .version import __version__  # noqa: F401
+
+# ---- Constants ---------------------------------------------------------
+
+__all__ = ()
+
+LOGGER = _logging.getLogger(__name__)