CHANGELOG.md

@@ -5,24 +5,6 @@ All notable changes to rattail-mailchimp 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).
 
-## v0.3.3 (2024-07-05)
-
-### Fix
-
-- define `host_key` for MailChimp -> Rattail import
-
-## v0.3.2 (2024-07-01)
-
-### Fix
-
-- remove legacy command definitions
-
-## v0.3.1 (2024-06-14)
-
-### Fix
-
-- fallback to `importlib_metadata` on older python
-
 ## v0.3.0 (2024-06-10)
 
 ### Feat

README.md

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

README.rst

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

pyproject.toml

@@ -6,9 +6,9 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rattail-mailchimp"
-version = "0.3.3"
+version = "0.3.0"
 description = "Rattail Software Interfaces for MailChimp"
-readme = "README.md"
+readme = "README.rst"
 authors = [{name = "Lance Edgar", email = "lance@edbob.org"}]
 license = {text = "GNU GPL v3+"}
 classifiers = [
@@ -34,6 +34,10 @@ dependencies = [
 rattail_mailchimp = "rattail_mailchimp.config:MailchimpConfigExtension"
 
 
+[project.entry-points."rattail.subcommands"]
+import-mailchimp = "rattail_mailchimp.commands:ImportMailChimp"
+
+
 [project.entry-points."rattail.typer_imports"]
 rattail_mailchimp = "rattail_mailchimp.commands"
 

rattail_mailchimp/_version.py

@@ -1,9 +1,6 @@
 # -*- coding: utf-8; -*-
 
-try:
-    from importlib.metadata import version
-except ImportError:
-    from importlib_metadata import version
+from importlib.metadata import version
 
 
 __version__ = version('rattail-mailchimp')

rattail_mailchimp/commands.py

@@ -26,7 +26,7 @@ Rattail Commands for MailChimp integration
 
 import typer
 
-from rattail.commands import rattail_typer
+from rattail.commands import rattail_typer, ImportSubcommand
 from rattail.commands.typer import importer_command, typer_get_runas_user
 from rattail.commands.importing import ImportCommandHandler
 
@@ -46,3 +46,21 @@ def import_mailchimp(
         config, import_handler_key='to_rattail.from_mailchimp.import')
     kwargs['user'] = typer_get_runas_user(ctx)
     handler.run(kwargs, progress=progress)
+
+
+class ImportMailChimp(ImportSubcommand):
+    """
+    Import data to Rattail, from MailChimp API
+    """
+    name = 'import-mailchimp'
+    description = __doc__.strip()
+    default_handler_spec = 'rattail_mailchimp.importing.mailchimp:FromMailChimpToRattail'
+
+    def get_handler_factory(self, **kwargs):
+        if self.config:
+            spec = self.config.get('rattail.importing', 'mailchimp.handler',
+                                   default=self.default_handler_spec)
+        else:
+            # just use default, for sake of cmd line help
+            spec = self.default_handler_spec
+        return self.app.load_object(spec)

rattail_mailchimp/config.py

@@ -24,10 +24,10 @@
 Config extensions for rattail-mailchimp
 """
 
-from wuttjamaican.conf import WuttaConfigExtension
+from rattail.config import ConfigExtension
 
 
-class MailchimpConfigExtension(WuttaConfigExtension):
+class MailchimpConfigExtension(ConfigExtension):
     """
     Config extension for rattail-mailchimp
     """

rattail_mailchimp/importing/mailchimp.py

@@ -2,7 +2,7 @@
 ################################################################################
 #
 #  Rattail -- Retail Software Framework
-#  Copyright © 2010-2024 Lance Edgar
+#  Copyright © 2010-2023 Lance Edgar
 #
 #  This file is part of Rattail.
 #
@@ -30,6 +30,7 @@ from collections import OrderedDict
 from mailchimp3 import MailChimp
 
 from rattail import importing
+from rattail.time import localtime, make_utc
 from rattail_mailchimp import importing as mailchimp_importing
 
 
@@ -37,9 +38,7 @@ class FromMailChimpToRattail(importing.ToRattailHandler):
     """
     Handler for MailChimp -> Rattail cache import
     """
-    host_key = 'mailchimp'
     host_title = "MailChimp"
-    generic_host_title = "MailChimp"
     
     def get_importers(self):
         importers = OrderedDict()
@@ -54,7 +53,7 @@ class FromMailChimp(importing.Importer):
     """
 
     def setup(self):
-        super().setup()
+        super(FromMailChimp, self).setup()
 
         self.api_key = self.config.require('mailchimp', 'api_key')
         self.mailchimp = MailChimp(self.api_key)
@@ -66,10 +65,10 @@ class FromMailChimp(importing.Importer):
             # issue..since we clearly have a UTC value
             value = value[:-6]
             dt = datetime.datetime.strptime(value, '%Y-%m-%dT%H:%M:%S')
-            dt = self.app.localtime(dt, from_utc=True)
+            dt = localtime(self.config, dt, from_utc=True)
         else:
             dt = datetime.datetime.strptime(value, '%Y-%m-%dT%H:%M:%S%z')
-            dt = self.app.localtime(dt)
+            dt = localtime(self.config, dt)
         return dt
 
 
@@ -96,7 +95,7 @@ class MailChimpListImporter(FromMailChimp, mailchimp_importing.model.MailChimpLi
         return {
             'id': mclist['id'],
             'name': mclist['name'],
-            'date_created': self.app.make_utc(date_created),
+            'date_created': make_utc(date_created),
         }
 
 
@@ -161,6 +160,6 @@ class MailChimpListMemberImporter(FromMailChimp, mailchimp_importing.model.MailC
             'status': member['status'],
             # TODO: this API endpoint does not appear to include this field?
             # 'unsubscribe_reason': member.get('unsubscribe_reason'),
-            'last_changed': self.app.make_utc(last_changed),
+            'last_changed': make_utc(last_changed),
             'source': member['source'],
         }