Switch packaging from setuptools to poetry

.github/workflows/ci_cd.yml

@@ -24,7 +24,7 @@ jobs:
 
       - name: Install style requirements
         run: |
-          pip install -r requirements_style.txt --disable-pip-version-check
+          pip install .[style] --disable-pip-version-check
 
       - name: Codespell
         run: |
@@ -47,20 +47,19 @@ jobs:
 
       - name: Create wheel
         run: |
-          pip install wheel
-          python setup.py bdist_wheel
+          pip install build
+          python -m build --wheel
 
       - name: Validate wheel
         run: |
           pip install twine
           twine check dist/*
 
-      - name: Install library
-        run: pip install dist/*
+      - name: Install library, with test extra
+        run: pip install dist/*[test]
 
       - name: Unit testing
         run: |
-          pip install -r requirements_test.txt
           cd tests  # so we're testing the install, not local
           pytest -vx
 
@@ -82,12 +81,11 @@ jobs:
         with:
           python-version: 3.8
 
-      - name: Install library
-        run: pip install .
+      - name: Install library, with docs extra
+        run: pip install .[docs]
 
       - name: Build HTML
         run: |
-          pip install -r requirements_docs.txt
           make -C doc html SPHINXOPTS="-W"
 
       - name: Build PDF Documentation

ansys/product/library/__init__.py

@@ -16,11 +16,13 @@
    >>> library.add(1, 2)
 
 .. note::
-   It's best to import the version here as well so it can be
-   referenced at the library level.
+   The version should be defined here so it can be referenced at the
+   library level. It is also used by the 'flit' packaging tool.
 
 """
 
-from ansys.product.library._version import __version__
+# Nice string for the version
+__version__ = "0.1.0.dev0"
+
 from ansys.product.library.module import add
 from ansys.product.library.other_module import Complex

pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["flit_core >=3.2,<4"]
+build-backend = "flit_core.buildapi"
+
+[project]
+name = "ansys-product-library"
+authors = [{name = "ANSYS, Inc."}] # this is required
+
+# You can change the name. The email group works.
+maintainers = [{name = "PyAnsys developers", email = "[email protected]"}]
+readme = "README.rst"
+description = "Template PyAnsys library"
+license = {file = "LICENSE"}
+
+# The version is automatically parsed from 'ansys/product/library/__init__.py'
+dynamic = ["version"]
+
+# Include all install requirements here.
+dependencies = []
+
+# Plan on supporting only the currently supported versions of Python
+requires-python = ">=3.7"
+
+# Less than critical but helpful
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.optional-dependencies]
+docs = [
+    "sphinx",
+    "numpydoc>=1.2",
+    "pyansys_sphinx_theme>=0.2.0",
+    "sphinx-copybutton",
+]
+
+style = [
+    "codespell==2.1.0",
+    "flake8==3.9.2",
+]
+
+test = [
+    "pytest",
+    "pytest-cov",
+]
+
+[project.urls]
+Source = "https://github.com/pyansys/template/"
+
+[tool.flit.module]
+name = "ansys.product.library"