docs: use markdown for readme file

.gitignore

@@ -1 +1,4 @@
+*~
+*.pyc
+dist/
 rattail_cognitive.egg-info

CHANGELOG.md

@@ -1,59 +1,60 @@
 
-CHANGELOG
+# Changelog
-=========
+All notable changes to rattail_cognitive will be documented in this file.
 
-0.3.6 (2023-06-01)
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
-------------------
+and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+
+## v0.4.0 (2024-07-09)
+
+### Feat
+
+- switch from setup.cfg to pyproject.toml + hatchling
+
+## 0.3.6 (2023-06-01)
 
 * Replace ``setup.py`` contents with ``setup.cfg``.
 
 
-0.3.5 (2019-01-21)
+## 0.3.5 (2019-01-21)
-------------------
 
 * Remove unused reference to ``cStringIO``.
 
 
-0.3.4 (2017-07-07)
+## 0.3.4 (2017-07-07)
-------------------
 
 * Switch license to GPL v3 (no longer Affero)
 
 
-0.3.3
+## 0.3.3
------
 
 * Refactor some config usage per rattail changes.
 
 
-0.3.2
+## 0.3.2
------
 
 * Fix broken barcode commands.
     
   UPC wasn't working, and EAN wasn't even being attempted...
 
 
-0.3.1
+## 0.3.1
------
 
 * Refactor ``rattail.hw.cognitive`` -> ``rattail_cognitive``.
 
 
-0.3a3
+## 0.3a3
------
 
 - [general] Fixed namespace package declaration.
 
 - [general] Added initial Fabric script.
 
 
-0.3a2
+## 0.3a2
------
 
 - Tweaked default label format.
 
-0.3a1
+## 0.3a1
------
 
 -  Initial port to Rattail v0.3.

README.md

@@ -0,0 +1,11 @@
+
+# rattail-cognitive
+
+Rattail is a retail software framework, released under the GNU General Public
+License.
+
+This package contains hardware interfaces for
+[Cognitive](http://www.cognitive.com/) devices.
+
+Please see Rattail's [home page](https://rattailproject.org/) for more
+information.

README.txt

@@ -1,13 +0,0 @@
-
-rattail-cognitive
-=================
-
-Rattail is a retail software framework, released under the GNU General Public
-License.
-
-This package contains hardware interfaces for `Cognitive`_ devices.
-
-Please see Rattail's `home page`_ for more information.
-
-.. _Cognitive: http://www.cognitive.com/
-.. _home page: https://rattailproject.org/

pyproject.toml

@@ -0,0 +1,44 @@
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+
+[project]
+name = "rattail_cognitive"
+version = "0.4.0"
+description = "Hardware Interfaces for Cognitive Devices"
+readme = "README.md"
+authors = [{name = "Lance Edgar", email = "lance@edbob.org"}]
+license = {text = "GNU GPL v3+"}
+classifiers = [
+        "Development Status :: 3 - Alpha",
+        "Environment :: Console",
+        "Environment :: Web Environment",
+        "Environment :: Win32 (MS Windows)",
+        "Environment :: X11 Applications",
+        "Intended Audience :: Developers",
+        "Intended Audience :: System Administrators",
+        "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
+        "Natural Language :: English",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 3",
+        "Topic :: Office/Business",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+        "rattail",
+]
+
+
+[project.urls]
+Homepage = "https://rattailproject.org"
+Repository = "https://kallithea.rattailproject.org/rattail-project-contrib/rattail-cognitive"
+Changelog = "https://kallithea.rattailproject.org/rattail-project-contrib/rattail-cognitive/files/master/CHANGELOG.md"
+
+
+[tool.commitizen]
+version_provider = "pep621"
+tag_format = "v$version"
+update_changelog_on_bump = true

rattail_cognitive/_version.py

@@ -1,3 +1,6 @@
 # -*- coding: utf-8; -*-
 
-__version__ = '0.3.6'
+from importlib.metadata import version
+
+
+__version__ = version('rattail_cognitive')

setup.cfg

@@ -1,36 +0,0 @@
-# -*- coding: utf-8; -*-
-
-[metadata]
-name = rattail_cognitive
-version = attr: rattail_cognitive.__version__
-author = Lance Edgar
-author_email = lance@edbob.org
-url = http://rattailproject.org/
-license = GNU GPL v3
-description = Hardware Interfaces for Cognitive Devices
-long_description = file: README.txt
-classifiers =
-        Development Status :: 3 - Alpha
-        Environment :: Console
-        Environment :: Web Environment
-        Environment :: Win32 (MS Windows)
-        Environment :: X11 Applications
-        Intended Audience :: Developers
-        Intended Audience :: System Administrators
-        License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
-        Natural Language :: English
-        Operating System :: OS Independent
-        Programming Language :: Python
-        Programming Language :: Python :: 2.6
-        Programming Language :: Python :: 2.7
-        Topic :: Office/Business
-        Topic :: Software Development :: Libraries :: Python Modules
-
-
-[options]
-install_requires =
-        rattail>=0.3a6
-
-packages = find:
-include_package_data = True
-zip_safe = False

setup.py

@@ -1,27 +0,0 @@
-# -*- coding: utf-8; -*-
-################################################################################
-#
-#  Rattail -- Retail Software Framework
-#  Copyright © 2010-2023 Lance Edgar
-#
-#  This file is part of Rattail.
-#
-#  Rattail is free software: you can redistribute it and/or modify it under the
-#  terms of the GNU General Public License as published by the Free Software
-#  Foundation, either version 3 of the License, or (at your option) any later
-#  version.
-#
-#  Rattail is distributed in the hope that it will be useful, but WITHOUT ANY
-#  WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-#  FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
-#  details.
-#
-#  You should have received a copy of the GNU General Public License along with
-#  Rattail.  If not, see <http://www.gnu.org/licenses/>.
-#
-################################################################################
-
-
-from setuptools import setup
-
-setup()

tasks.py

@@ -2,7 +2,7 @@
 ################################################################################
 #
 #  Rattail -- Retail Software Framework
-#  Copyright © 2010-2019 Lance Edgar
+#  Copyright © 2010-2024 Lance Edgar
 #
 #  This file is part of Rattail.
 #
@@ -24,23 +24,22 @@
 Tasks for rattail-cognitive
 """
 
-from __future__ import unicode_literals, absolute_import
-
 import os
 import shutil
 
 from invoke import task
 
 
-here = os.path.abspath(os.path.dirname(__file__))
-exec(open(os.path.join(here, 'rattail_cognitive', '_version.py')).read())
-
-
 @task
-def release(ctx):
+def release(c):
     """
     Release a new version of `rattail`.
     """
-    shutil.rmtree('rattail_cognitive.egg-info')
+    if os.path.exists('rattail_cognitive.egg-info'):
-    ctx.run('python setup.py sdist --formats=gztar')
+        shutil.rmtree('rattail_cognitive.egg-info')
-    ctx.run('twine upload dist/rattail_cognitive-{}.tar.gz'.format(__version__))
+    if os.path.exists('dist'):
+        shutil.rmtree('dist')
+
+    c.run('python -m build --sdist')
+
+    c.run('twine upload dist/*')