Move build system to poetry

Author: marco-neumann-by

.github/workflows/ci.yml

@@ -17,55 +17,35 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v2
-      - name: Conda Bootstrap
-        uses: goanpeca/setup-miniconda@v1
+      - name: Set up Python ${{ matrix.python }}
+        uses: actions/setup-python@v2
         with:
-          auto-update-conda: true
           python-version: ${{ matrix.python }}
-      - name: Conda Config
-        run: |
-          conda config --add channels conda-forge
-          conda config --add channels numba
-          conda config --set channel_priority strict
-          conda config --set always_yes yes
-          conda config --set changeps1 no
-          conda config --set pip_interop_enabled True
-      - name: Conda Install
-        shell: bash -l {0}
-        run: conda install --yes shellcheck --file=requirements.txt --file=test-requirements.txt
-      - name: Pip Install
-        shell: bash -l {0}
-        run: pip install --no-deps -e .[testing]
+      - name: Install Poetry Itself
+        run: pip install poetry
+      - name: Poetry Install
+        run: poetry install
       - name: Flake8
-        shell: bash -l {0}
-        run: flake8
+        run: poetry run flake8
       - name: Mypy
-        shell: bash -l {0}
-        run: mypy .
+        run: poetry run mypy .
       - name: Black
-        shell: bash -l {0}
-        run: black --check .
+        run: poetry run black --check .
       - name: Isort
-        shell: bash -l {0}
-        run: isort --recursive --check-only
+        run: poetry run isort --recursive --check-only
       - name: Pytest
-        shell: bash -l {0}
-        run: pytest
+        run: poetry run pytest
       - name: ASV
-        shell: bash -l {0}
         run: |
-          asv --config ./asv_bench/asv.conf.json machine --machine travis --os unknown --arch unknown --cpu unknown --ram unknown
-          asv --config ./asv_bench/asv.conf.json run --show-stderr --environment existing --quick
+          poetry run asv --config ./asv_bench/asv.conf.json machine --machine travis --os unknown --arch unknown --cpu unknown --ram unknown
+          poetry run asv --config ./asv_bench/asv.conf.json run --show-stderr --environment existing --quick
       - name: Sphinx
-        shell: bash -l {0}
         run: |
-          python setup.py build_sphinx
+          poetry run python setup.py build_sphinx
           touch ./docs/_build/html/.nojekyll
-      - name: Build Wheel
-        shell: bash -l {0}
-        run: python setup.py sdist bdist_wheel
+      - name: Build
+        run: poetry build
       - name: Shellcheck
-        shell: bash -l {0}
         run: shellcheck scripts/*.sh
       - name: Preserve Dist
         uses: actions/upload-artifact@v1

.gitignore

@@ -7,6 +7,7 @@
 __pycache__/
 build/
 coverage.xml
+poetry.lock
 dist/
 docs/_build/
 docs/_rst/

CONTRIBUTING.md

@@ -21,20 +21,13 @@ tooling. See the "Development Plan" in the README for the generic prioritization
 ## Development
 
 ### Installation
-To get started, set up a new virtual environment and install all requirements, either using pip:
+To get started, set up a new virtual environment and install all requirements:
 
 ```bash
 virtualenv --python=python3.6 .venv
 source .venv/bin/activate
-pip install -e .[testing]
-```
-
-or using conda:
-
-```bash
-conda create --name=rle_array shellcheck --file=requirements.txt --file=test-requirements.txt
-conda activate rle_array
-pip install -e .[testing]
+pip install poetry
+poetry install
 ```
 
 ### Code style
@@ -48,45 +41,45 @@ To ensure a consistent code style across the code base we're using the following
 We have a convenience script that runs all these tools and a code style check for you:
 
 ```bash
-./scripts/fmt.sh
+poetry run ./scripts/fmt.sh
 ```
 
 ### Testing
 There are different tools that ensure a well tested and presented library. To run them all at once (useful for
 development), use:
 
 ```bash
-./scripts/test.sh
+poetry run ./scripts/test.sh
 ```
 
 ### Pytest
 We're using [pytest](https://pytest.org) as a testing framework and make heavy use of `fixtures` and `parametrization`.
 To run the tests simply run:
 
 ```bash
-pytest
+poetry run pytest
 ```
 
 ### Benchmarks
 For performance critical code paths we have [asv](https://asv.readthedocs.io/) benchmarks in place in the subfolder
 `asv_bench`. To run the benchmarks a single time and receive immediate feedback run
 
 ```bash
-asv run --python=same --show-stderr
+poetry run asv run --python=same --show-stderr
 ```
 
 ### Documentation
 Documentation is created using [Sphinx](https://www.sphinx-doc.org/) and can be build by using:
 
 ```bash
-python setup.py build_sphinx
+poetry run python setup.py build_sphinx
 ```
 
 ### Typing
 We use [mypy](http://mypy-lang.org/) to check python types. It can be run using:
 
 ```bash
-mypy .
+poetry run mypy .
 ```
 
 ## Performance Improvements

pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = [
+    "poetry>=0.12",
+]
+build-backend = "poetry.masonry.api"
+
+[tool.poetry]
+name = "rle-array"
+description = "Run-length encoded pandas."
+authors= [
+    "JDA Software, Inc",
+]
+version = "0.1"
+readme = "README.rst"
+license = "MIT"
+packages = [
+    { include = "rle_array" },
+]
+repository = "https://github.com/JDASoftwareGroup/rle_array"
+keywords = [
+    "python",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+]
+
+[tool.poetry.dependencies]
+python = ">=3.6.1,<3.9"
+numba = ">=0.45"
+numpy = ">=1.17"
+pandas = ">=1.0.3,<2"
+
+[tool.poetry.dev-dependencies]
+asv = "*"
+black = "19.10b0"
+flake8-mutable = "1.2.0"
+flake8 = "3.8.3"
+isort = "5.0.9"
+mypy = "*"
+pytest = "*"
+pytest-cov = "*"
+setuptools_scm = "*"
+sphinx = "*"

requirements.txt

@@ -9,4 +9,3 @@ isort --recursive --check-only
 flake8
 asv --config ./asv_bench/asv.conf.json run --show-stderr --environment existing --quick
 python setup.py build_sphinx
-shellcheck scripts/*.sh

scripts/test.sh

@@ -0,0 +1,5 @@
+[build_sphinx]
+source-dir = docs
+build-dir = docs/_build
+builder = doctest,html
+warning-is-error = true

setup.cfg

@@ -1,50 +1,5 @@
-import os
-from typing import List
-
-from setuptools import setup
-
-
-def get_requirements(path: str) -> List[str]:
-    with open(os.path.join(os.path.dirname(__file__), path)) as fp:
-        content = fp.read()
-    return [req for req in content.split("\n") if req != "" and not req.startswith("#")]
-
-
-def setup_package() -> None:
-    name = "rle_array"
-
-    setup(
-        name=name,
-        packages=["rle_array"],
-        description="Run-length encoded pandas.",
-        author="JDA Software, Inc",
-        python_requires=">=3.6",
-        url="https://github.com/JDASoftwareGroup/rle_array",
-        license="MIT",
-        long_description=open("README.rst", "r").read(),
-        install_requires=get_requirements("requirements.txt"),
-        tests_require=get_requirements("test-requirements.txt"),
-        extras_require={"testing": get_requirements("test-requirements.txt")},
-        keywords=["python"],
-        classifiers=[
-            "Development Status :: 4 - Beta",
-            "Environment :: Console",
-            "Intended Audience :: Developers",
-            "Natural Language :: English",
-            "Programming Language :: Python",
-            "Programming Language :: Python :: 3",
-        ],
-        use_scm_version=True,
-        command_options={
-            "build_sphinx": {
-                "source_dir": ("setup.py", "docs"),
-                "build_dir": ("setup.py", "docs/_build"),
-                "builder": ("setup.py", "doctest,html"),
-                "warning_is_error": ("setup.py", "1"),
-            }
-        },
-    )
-
+#!/usr/bin/env python
+import setuptools
 
 if __name__ == "__main__":
-    setup_package()
+    setuptools.setup()