modernize with pyproject, use scm for version

replace use of python 3.7 with more recent versions

Author: ischneider

.github/workflows/autopublish-testpypi.yml

@@ -16,7 +16,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v3
         with:
-          python-version: 3.7
+          python-version: 3.12
 
       - name: Pip cache
         uses: actions/cache@v2

.github/workflows/publish-pypi.yml

@@ -14,7 +14,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v3
         with:
-          python-version: 3.7
+          python-version: 3.12
 
       - name: Pip cache
         uses: actions/cache@v2

.github/workflows/release.yml

@@ -4,7 +4,7 @@ on:
   workflow_dispatch:
     inputs:
       prerelease:
-        description: 'Is this a pre-release?'     
+        description: 'Is this a pre-release?'
         required: true
         type: boolean
 
@@ -17,7 +17,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/setup-python@v3
         with:
-          python-version: "3.10"
+          python-version: "3.12"
 
       - name: Create GitHub Release
         uses: actions/create-release@v1

.github/workflows/test.yml

@@ -12,7 +12,7 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v4
       with:
-        python-version: 3.8
+        python-version: 3.12
     - name: Pip cache
       uses: actions/cache@v2
       with:
@@ -26,15 +26,15 @@ jobs:
         nox -s lint
 
   analyze:
-    name: Analyze Typing 
+    name: Analyze Typing
     runs-on: ubuntu-latest
     steps:
     - name: Checkout code
       uses: actions/checkout@v3
     - name: Set up Python
       uses: actions/setup-python@v4
       with:
-        python-version: 3.8
+        python-version: 3.12
     - name: Pip cache
       uses: actions/cache@v2
       with:
@@ -53,7 +53,7 @@ jobs:
 
     strategy:
       matrix:
-        python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', '3.12']
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
 
     steps:
     - name: Checkout code
@@ -84,7 +84,7 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v4
       with:
-        python-version: 3.8
+        python-version: 3.12
     - name: Pip cache
       uses: actions/cache@v2
       with:
@@ -106,7 +106,7 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v4
       with:
-        python-version: 3.8
+        python-version: 3.12
     - name: Pip cache
       uses: actions/cache@v2
       with:
@@ -118,5 +118,3 @@ jobs:
       run: |
         pip install --upgrade nox
         nox -s docs
-
-

CONTRIBUTING.md

@@ -174,24 +174,24 @@ run the tests on a certain file, use:
 By default, Nox runs tests on all supported Python versions along with other
 CI checks. However, Nox can run a test on a single Python version.
 
-To run tests on python 3.7:
+To run tests on python 3.13:
 
 ```console
-    $ nox -s test-3.7
+    $ nox -s test-3.13
 ```
 
 Configuration can be passed onto pytest through Nox.
 
 To only run tests in a specific file:
 
 ```console
-    $ nox -s test3.7 -- tests/unit/test_http.py
+    $ nox -s test3.13 -- tests/unit/test_http.py
 ```
 
 Or to only run tests filtered by keyword:
 
 ```console
-   $ nox -s test3.7 -- -k test__Limiter
+   $ nox -s test3.13 -- -k test__Limiter
 ```
 
 ## Code coverage

docs/get-started/quick-start-guide.md

@@ -11,9 +11,9 @@ Take the following steps to install the SDK and connect with the Planet Server.
 
 [TOC]
 
-## Step 1: Install Python 3.7+ and a virtual environment
+## Step 1: Install Python 3.8+ and a virtual environment
 
-This is a Python package, so you’ll need to install Python (version 3.7 or greater), and set up and install a virtual environment.
+This is a Python package, so you’ll need to install Python (version 3.8 or greater), and set up and install a virtual environment.
 
 Yes. Even if you’re not writing code—and only using the "no code" CLI part of the Planet SDK for Python—you’re using Python to communicate with the Planet Labs PBC servers. If you need help with Python install and setting up a virtual environment, read [Virtual Environments and the Planet SDK for Python](venv-tutorial.md).
 

noxfile.py

@@ -37,7 +37,7 @@ def coverage(session):
     session.run('coverage', 'report')
 
 
-@nox.session(python=["3.7", "3.8", "3.9", "3.10", "3.11", "3.12"])
+@nox.session(python=["3.9", "3.10", "3.11", "3.12", "3.13"])
 def test(session):
     session.run('python', '-m', 'ensurepip', '--upgrade')
     session.install('-U', 'setuptools')

planet/__version__.py

@@ -1 +1,3 @@
-__version__ = '2.11.0'
+from importlib.metadata import version
+
+__version__ = version("planet")

pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["setuptools>=64", "setuptools_scm>=8"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "planet"
+authors = [ {name = "Planet", email = "python-sdk-contributors@planet.com"} ]
+description = "Planet SDK for Python"
+dependencies = [
+    "click>=8.0",
+    "geojson",
+    "httpx>=0.23.0",
+    "jsonschema",
+    "pyjwt>=2.1",
+    "tqdm>=4.56",
+    "typing-extensions",
+]
+readme = "README.md"
+requires-python = ">=3.9"
+keywords = ["planet", "api", "sdk", "client"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Software Development",
+    "Topic :: Utilities",
+]
+license = {file = "LICENSE"}
+dynamic = ["version"]
+
+[project.optional-dependencies]
+test = [
+    "pytest",
+    "anyio",
+    "pytest-cov",
+    "respx>=0.20",
+]
+lint = [
+    "flake8",
+    "mypy",
+    "yapf",
+]
+docs = [
+    "mkdocs==1.3",
+    "mkdocs-click==0.7.0",
+    "mkdocs-material==8.2.11",
+    "mkdocstrings==0.18.1",
+    "mkdocs_autorefs==1.0.1",
+]
+dev = [
+    "planet[test, docs, lint]",
+]
+
+[project.scripts]
+planet = "planet.cli.cli:main"
+
+[project.urls]
+Repository = "https://github.com/planetlabs/planet-client-python"
+
+[tool.setuptools_scm]

setup.cfg

@@ -1,12 +1,18 @@
-[metadata]
-license_file: LICENSE
+[options]
+packages = planet, planet.cli, planet.clients, planet.data
+
+[options.packages.find]
+exclude = examples, tests
+
+; [options.package_data]
+; planet = data/*
 
 [tool:pytest]
 addopts =
     -rxXs
 
 [coverage:run]
-source = planet,tests
+source = planet, tests
 branch = True
 
 [coverage:report]

setup.py

@@ -12,80 +12,6 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-from pathlib import Path
-from setuptools import setup, find_packages
+from setuptools import setup
 
-with open('planet/__version__.py') as f:
-    for line in f:
-        if line.find("__version__") >= 0:
-            version = line.split("=")[1].strip()
-            version = version.strip('"')
-            version = version.strip("'")
-            continue
-
-install_requires = [
-    'click>=8.0',
-    'geojson',
-    'httpx>=0.23.0',
-    'jsonschema',
-    'pyjwt>=2.1',
-    'tqdm>=4.56',
-    'typing-extensions',
-]
-
-test_requires = ['pytest', 'anyio', 'pytest-cov', 'respx>=0.20']
-
-lint_requires = ['flake8', 'mypy', 'yapf']
-
-doc_requires = [
-    'mkdocs==1.3',
-    'mkdocs-click==0.7.0',
-    'mkdocs-material==8.2.11',
-    'mkdocstrings==0.18.1',
-    'mkdocs_autorefs==1.0.1',
-]
-
-setup(
-    name='planet',
-    version=version,
-    description=u"Planet SDK for Python",
-    long_description=Path("README.md").read_text("utf-8"),
-    long_description_content_type="text/markdown",
-    classifiers=[
-        'Development Status :: 5 - Production/Stable',
-        'Environment :: Console',
-        'Intended Audience :: Developers',
-        'License :: OSI Approved :: Apache Software License',
-        'Operating System :: OS Independent',
-        'Programming Language :: Python :: 3',
-        'Topic :: Scientific/Engineering',
-        'Topic :: Software Development',
-        'Topic :: Utilities'
-    ],
-    keywords='planet api sdk client',
-    author='Planet',
-    maintainer='Planet',
-    maintainer_email='python-sdk-contributors@planet.com',
-    url='https://github.com/planetlabs/planet-client-python',
-    license='Apache 2.0',
-    packages=find_packages(exclude=['examples', 'tests']),
-    package_data={
-        "": ["LICENSE", "CONTRIBUTING.md"],
-        "planet": ["data/*"],
-    },
-    include_package_data=True,
-    zip_safe=False,
-    python_requires='>=3.7',
-    install_requires=install_requires,
-    extras_require={
-        'test': test_requires,
-        'lint': lint_requires,
-        'docs': doc_requires,
-        'dev': test_requires + lint_requires + doc_requires
-    },
-    entry_points={
-        'console_scripts': [
-            'planet=planet.cli.cli:main',
-        ],
-    },
-)
+setup()