cs-djutils 20241110__tar.gz

cs_djutils-20241110/MANIFEST.in

@@ -0,0 +1 @@
+include README.md

cs_djutils-20241110/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.1
+Name: cs.djutils
+Version: 20241110
+Summary: My collection of things for working with Django.
+Author-email: Cameron Simpson <cs@cskk.id.au>
+License: GNU General Public License v3 or later (GPLv3+)
+Project-URL: Monorepo Hg/Mercurial Mirror, https://hg.sr.ht/~cameron-simpson/css
+Project-URL: Monorepo Git Mirror, https://github.com/cameron-simpson/css
+Project-URL: MonoRepo Commits, https://bitbucket.org/cameron_simpson/css/commits/branch/main
+Project-URL: Source, https://github.com/cameron-simpson/css/blob/main/lib/python/cs/djutils.py
+Keywords: python3
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Description-Content-Type: text/markdown
+Requires-Dist: cs.cmdutils>=20241110
+Requires-Dist: django
+
+My collection of things for working with Django.
+
+*Latest release 20241110*:
+Initial PyPI release with DjangoBaseCommand, cs.cmdutils.BaseCommand subclass suppplanting django.core.management.base.BaseCommand.
+
+## <a name="DjangoBaseCommand"></a>Class `DjangoBaseCommand(cs.cmdutils.BaseCommand, django.core.management.base.BaseCommand)`
+
+A drop in class for `django.core.management.base.BaseCommand`
+which subclasses `cs.cmdutils.BaseCommand`.
+
+This lets me write management commands more easily, particularly
+if there are subcommands.
+
+Usage summary:
+
+    Usage: djangobase [common-options...] [options...]
+      A drop in class for `django.core.management.base.BaseCommand`
+      which subclasses `cs.cmdutils.BaseCommand`.
+      Subcommands:
+        help [common-options...] [-l] [subcommand-names...]
+          Print help for subcommands.
+          This outputs the full help for the named subcommands,
+          or the short help for all subcommands if no names are specified.
+          -l  Long help even if no subcommand-names provided.
+        info [common-options...] [field-names...]
+          Recite general information.
+          Explicit field names may be provided to override the default listing.
+        shell [common-options...]
+          Run a command prompt via cmd.Cmd using this command's subcommands.
+
+*`DjangoBaseCommand.add_arguments(self, parser)`*:
+Add the `Options.COMMON_OPT_SPECS` to the `argparse` parser.
+This is basicly to support the Django `call_command` function.
+
+*`DjangoBaseCommand.handle(*, argv, **options)`*:
+The Django `BaseComand.handle` method.
+This creates another instance for `argv` and runs it.
+
+*`DjangoBaseCommand.run_from_argv(argv)`*:
+Intercept `django.core.management.base.BaseCommand.run_from_argv`.
+Construct an instance of cs.djutils.DjangoBaseCommand` and run it.
+
+# Release Log
+
+
+
+*Release 20241110*:
+Initial PyPI release with DjangoBaseCommand, cs.cmdutils.BaseCommand subclass suppplanting django.core.management.base.BaseCommand.

cs_djutils-20241110/README.md

@@ -0,0 +1,48 @@
+My collection of things for working with Django.
+
+*Latest release 20241110*:
+Initial PyPI release with DjangoBaseCommand, cs.cmdutils.BaseCommand subclass suppplanting django.core.management.base.BaseCommand.
+
+## <a name="DjangoBaseCommand"></a>Class `DjangoBaseCommand(cs.cmdutils.BaseCommand, django.core.management.base.BaseCommand)`
+
+A drop in class for `django.core.management.base.BaseCommand`
+which subclasses `cs.cmdutils.BaseCommand`.
+
+This lets me write management commands more easily, particularly
+if there are subcommands.
+
+Usage summary:
+
+    Usage: djangobase [common-options...] [options...]
+      A drop in class for `django.core.management.base.BaseCommand`
+      which subclasses `cs.cmdutils.BaseCommand`.
+      Subcommands:
+        help [common-options...] [-l] [subcommand-names...]
+          Print help for subcommands.
+          This outputs the full help for the named subcommands,
+          or the short help for all subcommands if no names are specified.
+          -l  Long help even if no subcommand-names provided.
+        info [common-options...] [field-names...]
+          Recite general information.
+          Explicit field names may be provided to override the default listing.
+        shell [common-options...]
+          Run a command prompt via cmd.Cmd using this command's subcommands.
+
+*`DjangoBaseCommand.add_arguments(self, parser)`*:
+Add the `Options.COMMON_OPT_SPECS` to the `argparse` parser.
+This is basicly to support the Django `call_command` function.
+
+*`DjangoBaseCommand.handle(*, argv, **options)`*:
+The Django `BaseComand.handle` method.
+This creates another instance for `argv` and runs it.
+
+*`DjangoBaseCommand.run_from_argv(argv)`*:
+Intercept `django.core.management.base.BaseCommand.run_from_argv`.
+Construct an instance of cs.djutils.DjangoBaseCommand` and run it.
+
+# Release Log
+
+
+
+*Release 20241110*:
+Initial PyPI release with DjangoBaseCommand, cs.cmdutils.BaseCommand subclass suppplanting django.core.management.base.BaseCommand.

cs_djutils-20241110/lib/python/cs/djutils.py

@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+
+''' My collection of things for working with Django.
+'''
+
+import sys
+
+from django.core.management.base import (
+    BaseCommand as BaseDjangoBaseCommand,
+    CommandError as DjangoCommandError,
+)
+
+from cs.cmdutils import BaseCommand
+
+__version__ = '20241110'
+
+DISTINFO = {
+    'keywords': ["python3"],
+    'classifiers': [
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 3",
+    ],
+    'install_requires': [
+        'cs.cmdutils',
+        'django',
+    ],
+}
+
+class DjangoBaseCommand(BaseCommand, BaseDjangoBaseCommand):
+  ''' A drop in class for `django.core.management.base.BaseCommand`
+      which subclasses `cs.cmdutils.BaseCommand`.
+
+      This lets me write management commands more easily, particularly
+      if there are subcommands.
+  '''
+
+  @classmethod
+  def run_from_argv(cls, argv):
+    ''' Intercept `django.core.management.base.BaseCommand.run_from_argv`.
+        Construct an instance of cs.djutils.DjangoBaseCommand` and run it.
+    '''
+    _, djcmdname, *argv = argv
+    command = cls(argv, cmd=djcmdname)
+    return command.run()
+
+  @classmethod
+  def handle(cls, *, argv, **options):
+    ''' The Django `BaseComand.handle` method.
+        This creates another instance for `argv` and runs it.
+    '''
+    if cls.has_subcommands():
+      subcmd = options.pop('subcmd', None)
+      if subcmd is not None:
+        argv.insert(0, subcmd)
+    argv.insert(0, sys.argv[0])
+    command = cls(argv, **options)
+    xit = command.run()
+    if xit:
+      raise DjangoCommandError(xit)
+
+  def add_arguments(self, parser):
+    ''' Add the `Options.COMMON_OPT_SPECS` to the `argparse` parser.
+        This is basicly to support the Django `call_command` function.
+    '''
+    if self.has_subcommands():
+      parser.add_argument('subcmd', nargs='?')
+    options = self.options
+    _, _, getopt_spec_map = options.getopt_spec_map({})
+    for opt, opt_spec in getopt_spec_map.items():
+      # known django argument conflicts
+      # TODO: can I inspect the parser to detect these?
+      if opt in ('-v',):
+        continue
+      opt_spec.add_argument(parser, options=options)
+    parser.add_argument('argv', nargs='*')

cs_djutils-20241110/lib/python/cs.djutils.egg-info/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.1
+Name: cs.djutils
+Version: 20241110
+Summary: My collection of things for working with Django.
+Author-email: Cameron Simpson <cs@cskk.id.au>
+License: GNU General Public License v3 or later (GPLv3+)
+Project-URL: Monorepo Hg/Mercurial Mirror, https://hg.sr.ht/~cameron-simpson/css
+Project-URL: Monorepo Git Mirror, https://github.com/cameron-simpson/css
+Project-URL: MonoRepo Commits, https://bitbucket.org/cameron_simpson/css/commits/branch/main
+Project-URL: Source, https://github.com/cameron-simpson/css/blob/main/lib/python/cs/djutils.py
+Keywords: python3
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Description-Content-Type: text/markdown
+Requires-Dist: cs.cmdutils>=20241110
+Requires-Dist: django
+
+My collection of things for working with Django.
+
+*Latest release 20241110*:
+Initial PyPI release with DjangoBaseCommand, cs.cmdutils.BaseCommand subclass suppplanting django.core.management.base.BaseCommand.
+
+## <a name="DjangoBaseCommand"></a>Class `DjangoBaseCommand(cs.cmdutils.BaseCommand, django.core.management.base.BaseCommand)`
+
+A drop in class for `django.core.management.base.BaseCommand`
+which subclasses `cs.cmdutils.BaseCommand`.
+
+This lets me write management commands more easily, particularly
+if there are subcommands.
+
+Usage summary:
+
+    Usage: djangobase [common-options...] [options...]
+      A drop in class for `django.core.management.base.BaseCommand`
+      which subclasses `cs.cmdutils.BaseCommand`.
+      Subcommands:
+        help [common-options...] [-l] [subcommand-names...]
+          Print help for subcommands.
+          This outputs the full help for the named subcommands,
+          or the short help for all subcommands if no names are specified.
+          -l  Long help even if no subcommand-names provided.
+        info [common-options...] [field-names...]
+          Recite general information.
+          Explicit field names may be provided to override the default listing.
+        shell [common-options...]
+          Run a command prompt via cmd.Cmd using this command's subcommands.
+
+*`DjangoBaseCommand.add_arguments(self, parser)`*:
+Add the `Options.COMMON_OPT_SPECS` to the `argparse` parser.
+This is basicly to support the Django `call_command` function.
+
+*`DjangoBaseCommand.handle(*, argv, **options)`*:
+The Django `BaseComand.handle` method.
+This creates another instance for `argv` and runs it.
+
+*`DjangoBaseCommand.run_from_argv(argv)`*:
+Intercept `django.core.management.base.BaseCommand.run_from_argv`.
+Construct an instance of cs.djutils.DjangoBaseCommand` and run it.
+
+# Release Log
+
+
+
+*Release 20241110*:
+Initial PyPI release with DjangoBaseCommand, cs.cmdutils.BaseCommand subclass suppplanting django.core.management.base.BaseCommand.

cs_djutils-20241110/lib/python/cs.djutils.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+MANIFEST.in
+README.md
+pyproject.toml
+lib/python/cs/djutils.py
+lib/python/cs.djutils.egg-info/PKG-INFO
+lib/python/cs.djutils.egg-info/SOURCES.txt
+lib/python/cs.djutils.egg-info/dependency_links.txt
+lib/python/cs.djutils.egg-info/requires.txt
+lib/python/cs.djutils.egg-info/top_level.txt

cs_djutils-20241110/lib/python/cs.djutils.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cs_djutils-20241110/lib/python/cs.djutils.egg-info/requires.txt

@@ -0,0 +1,2 @@
+cs.cmdutils>=20241110
+django

cs_djutils-20241110/lib/python/cs.djutils.egg-info/top_level.txt

@@ -0,0 +1 @@
+cs

cs_djutils-20241110/pyproject.toml

@@ -0,0 +1,100 @@
+[project]
+name = "cs.djutils"
+description = "My collection of things for working with Django."
+authors = [
+    { name = "Cameron Simpson", email = "cs@cskk.id.au" },
+]
+keywords = [
+    "python3",
+]
+dependencies = [
+    "cs.cmdutils>=20241110",
+    "django",
+]
+classifiers = [
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
+]
+version = "20241110"
+
+[project.license]
+text = "GNU General Public License v3 or later (GPLv3+)"
+
+[project.urls]
+"Monorepo Hg/Mercurial Mirror" = "https://hg.sr.ht/~cameron-simpson/css"
+"Monorepo Git Mirror" = "https://github.com/cameron-simpson/css"
+"MonoRepo Commits" = "https://bitbucket.org/cameron_simpson/css/commits/branch/main"
+Source = "https://github.com/cameron-simpson/css/blob/main/lib/python/cs/djutils.py"
+
+[project.readme]
+text = """
+My collection of things for working with Django.
+
+*Latest release 20241110*:
+Initial PyPI release with DjangoBaseCommand, cs.cmdutils.BaseCommand subclass suppplanting django.core.management.base.BaseCommand.
+
+## <a name=\"DjangoBaseCommand\"></a>Class `DjangoBaseCommand(cs.cmdutils.BaseCommand, django.core.management.base.BaseCommand)`
+
+A drop in class for `django.core.management.base.BaseCommand`
+which subclasses `cs.cmdutils.BaseCommand`.
+
+This lets me write management commands more easily, particularly
+if there are subcommands.
+
+Usage summary:
+
+    Usage: djangobase [common-options...] [options...]
+      A drop in class for `django.core.management.base.BaseCommand`
+      which subclasses `cs.cmdutils.BaseCommand`.
+      Subcommands:
+        help [common-options...] [-l] [subcommand-names...]
+          Print help for subcommands.
+          This outputs the full help for the named subcommands,
+          or the short help for all subcommands if no names are specified.
+          -l  Long help even if no subcommand-names provided.
+        info [common-options...] [field-names...]
+          Recite general information.
+          Explicit field names may be provided to override the default listing.
+        shell [common-options...]
+          Run a command prompt via cmd.Cmd using this command's subcommands.
+
+*`DjangoBaseCommand.add_arguments(self, parser)`*:
+Add the `Options.COMMON_OPT_SPECS` to the `argparse` parser.
+This is basicly to support the Django `call_command` function.
+
+*`DjangoBaseCommand.handle(*, argv, **options)`*:
+The Django `BaseComand.handle` method.
+This creates another instance for `argv` and runs it.
+
+*`DjangoBaseCommand.run_from_argv(argv)`*:
+Intercept `django.core.management.base.BaseCommand.run_from_argv`.
+Construct an instance of cs.djutils.DjangoBaseCommand` and run it.
+
+# Release Log
+
+
+
+*Release 20241110*:
+Initial PyPI release with DjangoBaseCommand, cs.cmdutils.BaseCommand subclass suppplanting django.core.management.base.BaseCommand."""
+content-type = "text/markdown"
+
+[build-system]
+build-backend = "setuptools.build_meta"
+requires = [
+    "setuptools >= 61.2",
+    "trove-classifiers",
+    "wheel",
+]
+
+[tool.setuptools]
+py-modules = [
+    "cs.djutils",
+]
+
+[tool.setuptools.package-dir]
+"" = "lib/python"

cs_djutils-20241110/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+