build backend: use custom wrapper around flit

For pkgcore we need to run multiple preparations of generating files
before creating sdist or wheel. Flit is a very simple and nice build
backend, much more than setuptools.

Also migrate to use snakeoil.dist sphinx extension for generating man
and html, to remove various logic from `doc/conf.py`.

Signed-off-by: Arthur Zamarin <arthurzam@gentoo.org>

Author: arthurzam

.github/workflows/doc.yml

@@ -29,11 +29,11 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install -r requirements/dev.txt -r requirements/docs.txt
+        pip install ".[doc]"
 
     - name: Build sphinx documentation
       run: |
-        python setup.py build_docs
+        make html
         # notify github this isn't a jekyll site
         touch build/sphinx/html/.nojekyll
 

.github/workflows/release.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches: [deploy]
     tags: [v*]
+  workflow_dispatch:
 
 jobs:
   build-and-deploy:
@@ -15,26 +16,26 @@ jobs:
     - name: Set up Python 3.10
       uses: actions/setup-python@v4
       with:
-        python-version: '3.10'
+        python-version: "3.10"
 
     - name: Install dependencies
       run: |
-        # install deps required for building sdist/wheels
         python -m pip install --upgrade pip
-        pip install -r requirements/dist.txt -r requirements/test.txt
+        pip install build ".[test,doc]"
 
     - name: Test with pytest
       env:
         PY_COLORS: 1 # forcibly enable pytest colors
-      run: python setup.py test
+      run: pytest
 
     - name: Build sdist
       run: |
         git clean -fxd
-        python setup.py sdist
+        make man
+        make sdist
 
     - name: Build wheel
-      run: python setup.py bdist_wheel
+      run: make wheel
 
     - name: Output dist file info
       run: |
@@ -52,8 +53,7 @@ jobs:
         TWINE_USERNAME: __token__
         TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}
       if: startsWith(github.ref, 'refs/tags/')
-      run: |
-        twine upload dist/*
+      run: twine upload dist/*
 
     - name: Create GitHub release
       uses: softprops/action-gh-release@v1

.github/workflows/test.yml

@@ -13,12 +13,12 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        python-version: ['3.8', '3.9', '3.10']
+        python-version: ['3.9', '3.10', '3.11']
         experimental: [false]
         include:
-          - os: ubuntu-latest
-            python-version: '3.11.0-beta - 3.11'
-            experimental: true
+          # - os: ubuntu-latest
+          #   python-version: '3.11.0-beta - 3.11'
+          #   experimental: true
           - os: macos-latest
             python-version: '3.10'
             experimental: false
@@ -33,7 +33,7 @@ jobs:
       with:
         python-version: ${{ matrix.python-version }}
         cache: 'pip'
-        cache-dependency-path: requirements/*.txt
+        cache-dependency-path: pyproject.toml
 
     # experimental targets generally lack lxml wheels
     - name: Install libxml2 and libxslt development packages
@@ -48,11 +48,10 @@ jobs:
         # enable gnu-sed usage as "sed"
         echo "/usr/local/opt/gnu-sed/libexec/gnubin" >> $GITHUB_PATH
 
-    - name: Install deps
+    - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install -r requirements/test.txt -r requirements/ci.txt
-        pip install .
+        pip install ".[test]"
 
     - name: Test with pytest
       env:
@@ -80,7 +79,7 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install -r requirements/dev.txt pylint
+        pip install . pylint
 
     - name: Run linting tools
       run: |

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2021, pkgdev contributors
+Copyright (c) 2021-2022, pkgdev contributors
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

MANIFEST.in

@@ -0,0 +1,14 @@
+PYTHON ?= python
+SPHINX_BUILD ?= $(PYTHON) -m sphinx.cmd.build
+
+.PHONY: man html
+man html:
+	$(SPHINX_BUILD) -a -b $@ doc build/sphinx/$@
+
+.PHONY: sdist wheel
+sdist wheel:
+	$(PYTHON) -m build --$@
+
+.PHONY: clean
+clean:
+	$(RM) -r build/sphinx doc/api doc/generated doc/_build dist

Makefile

@@ -37,22 +37,7 @@ Installing from git::
 
 Installing from a tarball::
 
-    python setup.py install
-
-Tests
-=====
-
-A standalone test runner is integrated in setup.py::
-
-    python setup.py test
-
-In addition, a tox config is provided so the testsuite can be run in a
-virtualenv setup against all supported python versions. To run tests for all
-environments just execute **tox** in the root directory of a repo or unpacked
-tarball. Otherwise, for a specific python version execute something similar to
-the following::
-
-    tox -e py39
+    pip install .
 
 
 .. _pkgcheck: https://github.com/pkgcore/pkgcheck