SETUP move code to src

This way we can ensure that the packaged code is tested.
See https://hynek.me/articles/testing-packaging/ or c62a78c015

+ DOC adapt doc to new structure and test doc with travis

.travis.yml

@@ -1,6 +1,10 @@
 language: python
 sudo: false
 cache: pip
+addons:
+  apt:
+    packages:
+      - graphviz
 matrix:
   include:
     - python: 2.7
@@ -19,6 +23,8 @@ matrix:
       env: TOXENV=pypy
     - python: pypy3
       env: TOXENV=pypy3
+    - python: 2.7
+      env: TOXENV=docs
   allow_failures:
     - python: 3.5-dev
     - python: nightly

doc/conf.py

@@ -20,7 +20,7 @@ from setuptools_scm import get_version
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.insert(0, os.path.abspath('..'))
+sys.path.insert(0, os.path.abspath('../src'))
 root = os.path.relpath(os.path.join(os.path.dirname(__file__), '..'))
 
 # -- General configuration ------------------------------------------------
@@ -42,6 +42,11 @@ extensions = [
     'sphinx.ext.inheritance_diagram',
 ]
 
+# supress warnings for external images
+suppress_warnings = [
+    'image.nonlocal_uri',
+]
+
 # enable todos
 todo_include_todos = True
 

doc/dev/contributing.rst

@@ -1 +1 @@
-.. include:: ../../CONTRIBUTING.rst
+.. include:: ../../CONTRIBUTING.rst

setup.py

@@ -2,10 +2,18 @@
 
 import os
 import sys
-from setuptools import setup
+from setuptools import find_packages, setup
 from setuptools.command.test import test as test_command
 
 
+base_dir = os.path.dirname(__file__)
+src_dir = os.path.join(base_dir, "src")
+
+# When executing the setup.py, we need to be able to import ourselves, this
+# means that we need to add the src/ directory to the sys.path.
+sys.path.insert(0, src_dir)
+
+
 def read(fname):
     """read file from same path as setup.py"""
     return open(os.path.join(os.path.dirname(__file__), fname)).read()
@@ -58,9 +66,8 @@ setup(
         'receipt,',
     ],
     platforms='any',
-    packages=[
+    package_dir={"": "src"},
-        'escpos',
+    packages=find_packages(where="src", exclude=["tests", "tests.*"]),
-    ],
     package_data={'': ['COPYING']},
     classifiers=[
         'Development Status :: 4 - Beta',

tox.ini

@@ -1,8 +1,15 @@
 [tox]
-envlist = py27, py34, py35
+envlist = py27, py34, py35, docs
 
 [testenv]
 deps = nose
        coverage
        scripttest
 commands = nosetests --with-coverage --cover-erase --cover-branches
+
+[testenv:docs]
+basepython = python
+changedir = doc
+deps = sphinx
+       setuptools_scm
+commands = sphinx-build -W -b html -d {envtmpdir}/doctrees .  {envtmpdir}/html