setup/pyproject.toml: Migrate fully from setup.py to pyproject.toml.

This transfers details from setup.py to equivalent ones in pyproject.toml,
and similarly removes or substitutes references to these files.

Note: This introduces two changes from the previous state:
* Building packages no longer removes the top title line shown on GitHub
* The `zip_safe` property is detected automatically by `setuptools`

This also adds a note to the making-a-new-release doc, since while it was
previously out of date, setup.py will now be absent completely.

Author: neiljp

.github/workflows/lint-and-test.yml

@@ -31,7 +31,7 @@ jobs:
         with:
           python-version: ${{ env.LINTING_PYTHON_VERSION }}
           cache: 'pip'
-          cache-dependency-path: 'setup.py'
+          cache-dependency-path: 'pyproject.toml'
       - name: Install with type-checking tools, stubs & minimal test libraries
         run: pip install .[typing,testing_minimal]
       - name: Run mypy
@@ -48,11 +48,11 @@ jobs:
         with:
           python-version: ${{ env.LINTING_PYTHON_VERSION }}
           cache: 'pip'
-          cache-dependency-path: 'setup.py'
+          cache-dependency-path: 'pyproject.toml'
       - name: Install with linting tools
         run: pip install .[linting]
       - name: Run ruff
-        run: ruff zulipterminal/ tests/ setup.py `tools/python_tools.py`
+        run: ruff zulipterminal/ tests/ `tools/python_tools.py`
 
   isort:
     runs-on: ubuntu-latest
@@ -65,7 +65,7 @@ jobs:
         with:
           python-version: ${{ env.LINTING_PYTHON_VERSION }}
           cache: 'pip'
-          cache-dependency-path: 'setup.py'
+          cache-dependency-path: 'pyproject.toml'
       - name: Install with linting tools & minimal test libraries
         # NOTE: Install pytest so that isort recognizes it as a known library
         run: pip install .[linting,minimal_testing]
@@ -83,11 +83,11 @@ jobs:
         with:
           python-version: ${{ env.LINTING_PYTHON_VERSION }}
           cache: 'pip'
-          cache-dependency-path: 'setup.py'
+          cache-dependency-path: 'pyproject.toml'
       - name: Install with linting tools
         run: pip install .[linting]
       - name: Check code & tests meet black standards
-        run: black --check zulipterminal/ tests/ setup.py `tools/python_tools.py`
+        run: black --check zulipterminal/ tests/ `tools/python_tools.py`
 
   spellcheck:
     runs-on: ubuntu-latest
@@ -100,7 +100,7 @@ jobs:
         with:
           python-version: ${{ env.LINTING_PYTHON_VERSION }}
           cache: 'pip'
-          cache-dependency-path: 'setup.py'
+          cache-dependency-path: 'pyproject.toml'
       - name: Install with linting tools
         run: pip install .[linting]
       - name: Check spelling
@@ -117,7 +117,7 @@ jobs:
         with:
           python-version: ${{ env.LINTING_PYTHON_VERSION }}
           cache: 'pip'
-          cache-dependency-path: 'setup.py'
+          cache-dependency-path: 'pyproject.toml'
       - name: Minimal install
         run: pip install .
       - name: Run lint-hotkeys
@@ -134,7 +134,7 @@ jobs:
         with:
           python-version: ${{ env.LINTING_PYTHON_VERSION }}
           cache: 'pip'
-          cache-dependency-path: 'setup.py'
+          cache-dependency-path: 'pyproject.toml'
       - name: Minimal install
         run: pip install .
       - name: Run lint-docstring
@@ -181,7 +181,7 @@ jobs:
         with:
           python-version: 3.7
           cache: 'pip'
-          cache-dependency-path: 'setup.py'
+          cache-dependency-path: 'pyproject.toml'
       - name: Output Python version
         run: python --version
       - name: Upgrade pip
@@ -220,7 +220,7 @@ jobs:
         with:
           python-version: ${{ env.LINTING_PYTHON_VERSION }}
           cache: 'pip'
-          cache-dependency-path: 'setup.py'
+          cache-dependency-path: 'pyproject.toml'
       - name: Run check-branch
         if: github.event_name == 'pull_request'
         # Note that we install at each step since dependencies may change
@@ -258,7 +258,7 @@ jobs:
         with:
           python-version: ${{ matrix.env.PYTHON }}
           cache: 'pip'
-          cache-dependency-path: 'setup.py'
+          cache-dependency-path: 'pyproject.toml'
       - name: Output Python version
         run: python --version
       - name: Upgrade pip

docs/making-a-new-release.md

@@ -1,3 +1,6 @@
+**NOTE: This has been out of date for some time, particularly now since we have
+transitioned completely from setup.py to pyproject.toml.**
+
 The thrilling process of making a new release has (sadly) been automated. Worry not, we still have a few things to check and a few steps to follow!
 To install the required dependencies for making a release, in the venv activated zulip-terminal directory, run:
 ```

makefile

@@ -9,7 +9,7 @@ ZT_VENV?=zt_venv
 VENV_ACTIVATE=. $(ZT_VENV)/bin/activate
 PYTHON=${ZT_VENV}/bin/$(BASEPYTHON)
 
-SOURCES = zulipterminal tests setup.py
+SOURCES = zulipterminal tests
 
 # Default target at top
 install-devel: venv
@@ -42,8 +42,8 @@ force-fix: venv
 # Short name for file dependency
 venv: $(ZT_VENV)/bin/activate
 
-# If setup.py is updated or activate script doesn't exist, update virtual env
-$(ZT_VENV)/bin/activate: setup.py
+# If pyproject.toml is updated or activate script doesn't exist, update virtual env
+$(ZT_VENV)/bin/activate: pyproject.toml
 	@echo "=== Installing development environment ==="
 	test -d $(ZT_VENV) || $(BASEPYTHON) -m venv $(ZT_VENV)
 	$(PYTHON) -m pip install wheel && $(PYTHON) -m pip install -U pip && $(PYTHON) -m pip install -e .[dev] && touch $(ZT_VENV)/bin/activate

pyproject.toml

@@ -1,3 +1,93 @@
+[build-system]
+# setuptools added pyproject.toml support in v61.0.0
+requires = ["setuptools >= 61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zulip-term"
+description = "Zulip's official terminal client"
+authors = [
+    {name="Zulip Open Source Project", email="zulip-devel@googlegroups.com"}
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: End Users/Desktop",
+    "Topic :: Communications :: Chat",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+]
+keywords = []
+requires-python = ">=3.7, <3.12"
+dynamic = ["version", "readme"]
+dependencies = [
+    "urwid~=2.1.2",
+    "zulip>=0.8.2",
+    "urwid_readline>=0.13",
+    "beautifulsoup4>=4.11.1",
+    "lxml>=4.9.2",
+    "pygments>=2.14.0",
+    "typing_extensions~=4.5.0",
+    "python-dateutil>=2.8.2",
+    "pytz>=2022.7.1",
+    "tzlocal>=2.1",
+    "pyperclip>=1.8.1",
+]
+
+[project.optional-dependencies]
+dev = ["zulip-term[testing,linting,typing,dev-helper]"]
+testing = [
+    "pytest~=7.2.0",
+    "pytest-cov~=4.0.0",
+    "pytest-mock~=3.10.0",
+]
+linting = [
+    "isort~=5.11.0",
+    "black~=23.0",
+    "ruff==0.0.253",
+    "codespell[toml]~=2.2.2",
+]
+typing = [
+    "lxml-stubs",
+    "mypy~=1.0.0",
+    "types-pygments",
+    "types-python-dateutil",
+    "types-tzlocal",
+    "types-pytz",
+    "types-requests",
+]
+dev-helper = [
+    "pudb==2022.1.1",
+    "snakeviz>=2.1.1",
+    "gitlint~=0.18.0",
+]
+
+[project.scripts]
+zulip-term = "zulipterminal.cli.run:main"
+zulip-term-check-symbols = "zulipterminal.scripts.render_symbols:main"
+
+[project.urls]
+Changelog = "https://github.com/zulip/zulip-terminal/blob/main/CHANGELOG.md"
+FAQs = "https://github.com/zulip/zulip-terminal/blob/main/docs/FAQ.md"
+Issues = "https://github.com/zulip/zulip-terminal/issues"
+"Hot Keys" = "https://github.com/zulip/zulip-terminal/blob/main/docs/hotkeys.md"
+# NOTE: This Was home-page, ie. url
+Repository = "https://github.com/zulip/zulip-terminal"
+
+[tool.setuptools.packages.find]
+include=["zulipterminal"]
+
+[tool.setuptools.dynamic]
+version = {attr = "zulipterminal.version.ZT_VERSION"}
+# FIXME ? This doesn't support losing the top title line, like with setup.py
+readme = {file = ["README.md"], content-type = "text/markdown"}
+
 [tool.black]
 # Default line-length, but use explicit value here since used for isort & ruff
 line-length = 88
@@ -191,8 +281,6 @@ select = [
     "YTT", # Year TwentyTwenty (flake8-2020), sys.version checks
 ]
 [tool.ruff.per-file-ignores]
-# ANN: We don't consider this worth typing
-"setup.py" = ["ANN"]
 # ANN: These test files are not yet typed
 "tests/model/test_model.py" = ["ANN"]
 "tests/ui/test_ui_tools.py" = ["ANN"]

tools/lint-all

@@ -9,7 +9,6 @@ from python_tools import lintable_tools_files
 python_sources = [
     "zulipterminal/",
     "tests/",
-    "setup.py",
 ]
 
 python_sources += lintable_tools_files

tools/run-isort-check

@@ -5,7 +5,7 @@ import sys
 
 
 cmds = ["isort"]
-files = ["zulipterminal", "tests", "tools", "setup.py"]
+files = ["zulipterminal", "tests", "tools"]
 
 result = subprocess.call(cmds + ["--check-only", "--diff"] + files)