Migrate packaging from setup.py to pyproject.toml (PEP 517/621) (#536)

* Migrate packaging from setup.py to pyproject.toml (PEP 517/621)

Consolidate build configuration onto a PEP 621 pyproject.toml with the
setuptools backend. The version stays single-sourced in
dropbox/dropbox_client.py via `[tool.setuptools.dynamic]` attr: (resolved
by setuptools>=61 AST parsing, so the module is not imported at build
time and scripts/update_version.sh is unchanged).

- Add pyproject.toml: project metadata, runtime deps (requests, stone),
  optional-dependencies (test/docs/dev), pytest config, and
  Description-Content-Type text/x-rst (previously missing).
- Delete setup.py and setup.cfg.
- tox.ini: [testenv:check] uses `python -m build` (add build dep);
  [testenv:lint] drops the setup.py flake8 target.
- ci.yml: flake8 target drops setup.py.
- coverage.yml: `python setup.py install` -> `pip install .` (both jobs).
- README.rst: install-from-source uses `pip install .`.
- .readthedocs.yml: install via `method: pip` with the docs extra.
- requirements.txt: reword sync comment to point at pyproject.toml.

Closes #487

* Use SPDX license expression in pyproject.toml

Switch to the PEP 639 form: license = "MIT" + license-files, drop the
redundant License classifier, and raise the setuptools floor to >=77.0
(first version supporting the SPDX license expression). Produces
License-Expression: MIT in the metadata.

Author: AndreyVMarkelov

.github/workflows/ci.yml

@@ -48,7 +48,7 @@ jobs:
 
       - name: Run linter
         run: |
-          flake8 setup.py dropbox example test
+          flake8 dropbox example test
 
       - name: Run unit tests
         run: |

.github/workflows/coverage.yml

@@ -27,7 +27,7 @@ jobs:
           pip install coverage pytest
           pip install -r requirements.txt
           pip install -r test/requirements.txt
-          python setup.py install
+          pip install .
       - name: Generate Unit Test Coverage
         run: |
           coverage run --rcfile=.coveragerc -m pytest test/unit/test_dropbox_unit.py
@@ -57,7 +57,7 @@ jobs:
           pip install coverage pytest
           pip install -r requirements.txt
           pip install -r test/requirements.txt
-          python setup.py install
+          pip install .
       - name: Generate Unit Test Coverage
         env:
           LEGACY_USER_DROPBOX_TOKEN: ${{ secrets.LEGACY_USER_DROPBOX_TOKEN }}

.readthedocs.yml

@@ -11,9 +11,10 @@ build:
 
 python:
   install:
-    - requirements: requirements.txt
-    - method: setuptools
+    - method: pip
       path: .
+      extra_requirements:
+        - docs
 
 sphinx:
   configuration: docs/conf.py

README.rst

@@ -40,7 +40,7 @@ Install from source:
 
     $ git clone git://github.com/dropbox/dropbox-sdk-python.git
     $ cd dropbox-sdk-python
-    $ python setup.py install
+    $ pip install .
 
 After installation, follow one of our `Examples`_ or read the documentation on `Read The Docs`_.
 

pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=77.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dropbox"
+dynamic = ["version"]
+description = "Official Dropbox API Client"
+readme = { file = "README.rst", content-type = "text/x-rst" }
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Dropbox", email = "dev-platform@dropbox.com" }]
+dependencies = [
+    "requests>=2.16.2",
+    "stone>=3.4.0,<4",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "http://www.dropbox.com/developers"
+Source = "https://github.com/dropbox/dropbox-sdk-python"
+
+[project.optional-dependencies]
+test = ["pytest", "mock", "pytest-mock", "coverage", "stone>=3.4.0,<4"]
+docs = ["sphinx", "sphinx_rtd_theme"]
+dev = ["flake8", "twine", "wheel", "build"]
+
+[tool.setuptools]
+packages = ["dropbox"]
+zip-safe = false
+
+[tool.setuptools.dynamic]
+version = { attr = "dropbox.dropbox_client.__version__" }
+
+[tool.pytest.ini_options]
+norecursedirs = [".tox", ".venv", ".venv-*", "stone"]

requirements.txt

@@ -1,4 +1,4 @@
-# Dependencies required for installation (keep in sync with setup.py)
+# Dependencies required for installation (keep in sync with pyproject.toml)
 requests>=2.16.2
 stone>=3.4.0,<4
 # Other dependencies for development

setup.cfg

@@ -36,10 +36,11 @@ deps =
 [testenv:check]
 
 commands =
-    python setup.py sdist bdist_wheel
+    python -m build
     twine check dist/*
 
 deps =
+    build
     twine
 
 usedevelop = true
@@ -48,7 +49,7 @@ usedevelop = true
 [testenv:lint]
 description = format the code base to adhere to our styles, and complain about what we cannot do automatically
 commands =
-    flake8 setup.py dropbox example test
+    flake8 dropbox example test
 deps =
     flake8
     -rtest/requirements.txt