build: move docx package under src/ directory

This improves packaging reliability because it prevents tests from
running against the current directory instead of the installed version
of the package.

Author: scanny

.gitignore

@@ -1,7 +1,8 @@
+/build/
 .coverage
 /dist/
 /docs/.build/
-/*.egg-info
+/src/*.egg-info
 *.pyc
 .pytest_cache/
 _scratch/

MANIFEST.in

@@ -1,5 +1,5 @@
 include HISTORY.rst LICENSE README.rst tox.ini
-graft docx/templates
+graft src/docx/templates
 graft features
 graft tests
 graft docs

setup.py

@@ -21,7 +21,9 @@ def text_of(relpath):
 # Read the version from docx.__version__ without importing the package
 # (and thus attempting to import packages it depends on that may not be
 # installed yet)
-version = re.search(r'__version__ = "([^"]+)"', text_of("docx/__init__.py")).group(1)
+version = re.search(r'__version__ = "([^"]+)"', text_of("src/docx/__init__.py")).group(
+    1
+)
 
 
 NAME = "python-docx"
@@ -32,7 +34,7 @@ def text_of(relpath):
 AUTHOR_EMAIL = "python-docx@googlegroups.com"
 URL = "https://github.com/python-openxml/python-docx"
 LICENSE = text_of("LICENSE")
-PACKAGES = find_packages(exclude=["tests", "tests.*"])
+PACKAGES = find_packages(where="src")
 PACKAGE_DATA = {"docx": ["templates/*.xml", "templates/*.docx"]}
 
 INSTALL_REQUIRES = ["lxml>=2.3.2"]
@@ -72,6 +74,7 @@ def text_of(relpath):
     "license": LICENSE,
     "packages": PACKAGES,
     "package_data": PACKAGE_DATA,
+    "package_dir": {"": "src"},
     "install_requires": INSTALL_REQUIRES,
     "tests_require": TESTS_REQUIRE,
     "test_suite": TEST_SUITE,