Migrate examples to src-layout

.gitattributes

@@ -0,0 +1,3 @@
+**/**/setup.py merge=ours
+**/**/pyproject.toml merge=ours
+table.md merge=ours

README.md

@@ -44,8 +44,8 @@ However, developers might be interested in carrying out a *staggered migration*
 to mitigate the migration effort and spread the work load in time.
 
 Based on the results for the scenarios mixing `pkg_resources` and other namespace methods reported in
-[table.md](table.md) and [legacy_table.md](legacy_table.md),
-we can see that (in principle) a staggered migration plan can be successful,
+[table.md](table.md) and [legacy_table.md](https://github.com/pypa/sample-namespace-packages/blob/master/legacy_table.md)
+(only available for flat layout), we can see that (in principle) a staggered migration plan can be successful,
 as long as the developers are willing to accept some limitations:
 
 - Deprecated installation methods will not be supported (e.g. `python setup.py install`),
@@ -57,4 +57,4 @@ specific use cases they are interested in supporting.
 
 
 [^1]: If you would like to know about deprecated installation methods (e.g. via
-  `python setup.py install`) or Python 2.7, please have a look at [legacy_table.md](legacy_table.md).
+  `python setup.py install`) or Python 2.7 for the flat layout, please have a look at [legacy_table.md](https://github.com/pypa/sample-namespace-packages/blob/master/legacy_table.md).

native/pkg_a/setup.py

@@ -27,7 +27,8 @@
     author_email='jonwayne@google.com',
 
     license='Apache Software License',
-
-    packages=['example_pkg.a'],
+    # This example uses automatic discovery. You can also implement custom discovery like this:
+    # packages=find_namespace_packages(where='src', include=['example_pkg.a']),
+    # package_dir={'': 'src'},
     zip_safe=False,
 )

native/pkg_b/setup.py

@@ -27,7 +27,8 @@
     author_email='jonwayne@google.com',
 
     license='Apache Software License',
-
-    packages=['example_pkg.b'],
+    # This example uses automatic discovery. You can also implement custom discovery like this:
+    # packages=find_namespace_packages(where='src', include=['example_pkg.b']),
+    # package_dir={'': 'src'},
     zip_safe=False,
 )

noxfile.py

@@ -25,18 +25,20 @@
     USE_PYTHON_VERSIONS = USE_PYTHON_VERSIONS_DEFAULT
 
 
-install_commands = (("pip", "install", "."), ("pip", "install", "-e", "."))
-
+install_commands = (
+    ('pip', 'install', '.'),
+    ('pip', 'install', '-e', '.')
+)
 
 def install_packages(session, package_a, package_b, command_a, command_b):
     env = {**os.environ, "PIP_CONSTRAINT": f"{HERE}/constraints.txt"}
     session.install("--upgrade", "pip", env=env)
     session.chdir(package_a)
-    session.run("rm", "-rf", "dist", "build", "*.egg-info")
+    session.run("rm", "-rf", "dist", "build", "*.egg-info", external=True)
     session.run(*command_a, env=env)
     session.chdir(HERE)
     session.chdir(package_b)
-    session.run("rm", "-rf", "dist", "build", "*.egg-info")
+    session.run("rm", "-rf", "dist", "build", "*.egg-info", external=True)
     session.run(*command_b, env=env)
     session.chdir(HERE)
 

pkg_resources/pkg_a/setup.py

@@ -28,7 +28,8 @@
 
     license='Apache Software License',
 
-    packages=find_packages(),
+    packages=find_packages(where='src'),
     namespace_packages=['example_pkg'],
+    package_dir={'': 'src'},
     zip_safe=False,
 )

pkg_resources/pkg_b/setup.py

@@ -28,7 +28,8 @@
 
     license='Apache Software License',
 
-    packages=find_packages(),
+    packages=find_packages(where='src'),
     namespace_packages=['example_pkg'],
+    package_dir={'': 'src'},
     zip_safe=False,
 )

pkgutil/pkg_a/setup.py

@@ -28,6 +28,7 @@
 
     license='Apache Software License',
 
-    packages=find_packages(),
+    packages=find_packages(where='src'),
+    package_dir={'': 'src'},
     zip_safe=False,
 )

pkgutil/pkg_b/setup.py

@@ -28,6 +28,7 @@
 
     license='Apache Software License',
 
-    packages=find_packages(),
+    packages=find_packages(where='src'),
+    package_dir={'': 'src'},
     zip_safe=False,
 )

requirements.txt

@@ -1,4 +1,5 @@
 # -- PYTHON PACKAGE REQUIREMENTS:
 # USE: pip install -r <THIS_FILE>
 
+setuptools >= 68.2.2
 nox >= 2023.04.22