docs: update project links, kallithea -> forgejo

not sure why this fix was needed, did setuptools behavior change?

.gitignore

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

CHANGELOG.md

@@ -5,7 +5,28 @@ All notable changes to rattail-wave will be documented in this file.
 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).
 
-## Unreleased
+## v0.3.2 (2024-08-18)
+
+### Fix
+
+- avoid deprecated base class for config extension
+
+## v0.3.1 (2024-07-01)
+
+### Fix
+
+- remove legacy command definitions
+
+## v0.3.0 (2024-06-10)
+
+### Feat
+
+- switch from setup.cfg to pyproject.toml + hatchling
+
+## [0.2.0] - 2024-06-06
+### Changed
+- Migrate all commands to use `typer`.
+- Add alembic scripts to project manifest.
 
 ## [0.1.1] - 2024-04-03
 ### Changed

MANIFEST.in

@@ -1,3 +1,5 @@
 include *.md
 include *.rst
+
 recursive-include rattail_wave/db/alembic *.mako
+recursive-include rattail_wave/db/alembic *.py

README.md

@@ -0,0 +1,11 @@
+
+# rattail-wave
+
+Rattail is a retail software framework, released under the GNU General
+Public License.
+
+This package contains software interfaces for
+[Wave](https://www.waveapps.com/).
+
+Please see the [Rattail Project](https://rattailproject.org/) for more
+information.

README.rst

@@ -1,14 +0,0 @@
-
-rattail-wave
-============
-
-Rattail is a retail software framework, released under the GNU General
-Public License.
-
-This package contains software interfaces for `Wave`_.
-
-.. _`Wave`: https://www.waveapps.com/
-
-Please see the `Rattail Project`_ for more information.
-
-.. _`Rattail Project`: https://rattailproject.org/

pyproject.toml

@@ -0,0 +1,53 @@
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+
+[project]
+name = "rattail-wave"
+version = "0.3.2"
+description = "Rattail integration package for Wave"
+readme = "README.md"
+authors = [{name = "Lance Edgar", email = "lance@edbob.org"}]
+license = {text = "GNU GPL v3+"}
+classifiers = [
+        "Development Status :: 3 - Alpha",
+        "Environment :: Console",
+        "Intended Audience :: Developers",
+        "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 = [
+        "invoke",
+        "rattail[db]",
+]
+
+
+[project.entry-points."rattail.typer_imports"]
+rattail_wave = "rattail_wave.commands"
+
+
+[project.entry-points."rattail.config.extensions"]
+rattail_wave = "rattail_wave.config:RattailWaveExtension"
+
+
+[project.entry-points."rattail.importing"]
+"to_rattail.from_wave.import" = "rattail_wave.importing.wave:FromWaveToRattail"
+
+
+[project.urls]
+Homepage = "https://rattailproject.org"
+Repository = "https://forgejo.wuttaproject.org/rattail/rattail-wave"
+Changelog = "https://forgejo.wuttaproject.org/rattail/rattail-wave/src/branch/master/CHANGELOG.md"
+
+
+[tool.commitizen]
+version_provider = "pep621"
+tag_format = "v$version"
+update_changelog_on_bump = true

rattail_wave/_version.py

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

rattail_wave/commands.py

@@ -2,7 +2,7 @@
 ################################################################################
 #
 #  Rattail -- Retail Software Framework
-#  Copyright © 2010-2022 Lance Edgar
+#  Copyright © 2010-2024 Lance Edgar
 #
 #  This file is part of Rattail.
 #
@@ -24,13 +24,25 @@
 rattail-wave commands
 """
 
-from rattail import commands
+import typer
+
+from rattail.commands import rattail_typer
+from rattail.commands.typer import importer_command, typer_get_runas_user
+from rattail.commands.importing import ImportCommandHandler
 
 
-class ImportWave(commands.ImportSubcommand):
+@rattail_typer.command()
+@importer_command
+def import_wave(
+        ctx: typer.Context,
+        **kwargs
+):
     """
     Import data to Rattail, from Wave API
     """
-    name = 'import-wave'
-    description = __doc__.strip()
-    handler_key = 'to_rattail.from_wave.import'
+    config = ctx.parent.rattail_config
+    progress = ctx.parent.rattail_progress
+    handler = ImportCommandHandler(
+        config, import_handler_key='to_rattail.from_wave.import')
+    kwargs['user'] = typer_get_runas_user(ctx)
+    handler.run(kwargs, progress=progress)

rattail_wave/config.py

@@ -2,7 +2,7 @@
 ################################################################################
 #
 #  Rattail -- Retail Software Framework
-#  Copyright © 2010-2022 Lance Edgar
+#  Copyright © 2010-2024 Lance Edgar
 #
 #  This file is part of Rattail.
 #
@@ -24,10 +24,10 @@
 Config Extension
 """
 
-from rattail.config import ConfigExtension
+from wuttjamaican.conf import WuttaConfigExtension
 
 
-class RattailWaveExtension(ConfigExtension):
+class RattailWaveExtension(WuttaConfigExtension):
     """
     Config extension for rattail-wave.
     """

setup.cfg

@@ -1,42 +0,0 @@
-# -*- coding: utf-8; -*-
-
-[metadata]
-name = rattail-wave
-version = attr: rattail_wave.__version__
-author = Lance Edgar
-author_email = lance@edbob.org
-url = https://rattailproject.org/
-description = Rattail integration package for Wave
-long_description = file: README.rst
-classifiers =
-        Development Status :: 3 - Alpha
-        Environment :: Console
-        Intended Audience :: Developers
-        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
-
-
-[options]
-install_requires =
-        invoke
-        rattail[db]
-
-packages = find:
-include_package_data = True
-
-
-[options.entry_points]
-
-rattail.subcommands =
-        import-wave = rattail_wave.commands:ImportWave
-
-rattail.config.extensions =
-        rattail_wave = rattail_wave.config:RattailWaveExtension
-
-rattail.importing =
-        to_rattail.from_wave.import = rattail_wave.importing.wave:FromWaveToRattail

setup.py

@@ -1,29 +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/>.
-#
-################################################################################
-"""
-rattail-wave setup script
-"""
-
-from setuptools import setup
-
-setup()

tasks.py

@@ -2,7 +2,7 @@
 ################################################################################
 #
 #  Rattail -- Retail Software Framework
-#  Copyright © 2010-2022 Lance Edgar
+#  Copyright © 2010-2024 Lance Edgar
 #
 #  This file is part of Rattail.
 #
@@ -25,13 +25,24 @@ Tasks for rattail-wave
 """
 
 import os
+import re
 import shutil
 
 from invoke import task
 
 
 here = os.path.abspath(os.path.dirname(__file__))
-exec(open(os.path.join(here, 'rattail_wave', '_version.py')).read())
+__version__ = None
+pattern = re.compile(r'^version = "(\d+\.\d+\.\d+)"$')
+with open(os.path.join(here, 'pyproject.toml'), 'rt') as f:
+    for line in f:
+        line = line.rstrip('\n')
+        match = pattern.match(line)
+        if match:
+            __version__ = match.group(1)
+            break
+if not __version__:
+    raise RuntimeError("could not parse version!")
 
 
 @task
@@ -45,5 +56,5 @@ def release(c):
     c.run('python -m build --sdist')
 
     # upload to public PyPI
-    filename = 'rattail-wave-{}.tar.gz'.format(__version__)
-    c.run('twine upload dist/{}'.format(filename))
+    filename = f'rattail_wave-{__version__}.tar.gz'
+    c.run(f'twine upload dist/{filename}')