Add training command to example Django app (for gunthercox#2079)

Author: gunthercox

docs/django/index.rst

@@ -15,7 +15,7 @@ Begin by making sure that you have installed both ``django`` and ``chatterbot``.
 
    pip install django chatterbot
 
-For more details on installing Django, see the `Django documentation`_.
+For more details on installing and using Django, see the `Django documentation`_.
 
 Installed Apps
 --------------

docs/django/views.rst

@@ -1,6 +1,6 @@
-=======================
-ChatterBot Django Views
-=======================
+=============================
+ChatterBot Django Sample Code
+=============================
 
 .. note::
 
@@ -25,3 +25,16 @@ The endpoint expects a JSON request in the following format:
    :caption: examples/django_example/django_example/views.py
    :language: python
    :pyobject: ChatterBotApiView
+
+
+Example Django Management Commands
+==================================
+
+ChatterBot's Django example includes a management command that
+demonstrates a simple example of training. This can be used as
+a basis for other custom management commands used with other
+:ref:`training options <Training>`.
+
+.. literalinclude:: ../../examples/django_example/django_example/management/commands/train.py
+   :caption: examples/django_example/django_example/management/commands/train.py
+   :language: python

examples/django_example/django_example/management/__init__.py

@@ -0,0 +1,39 @@
+"""
+This is an example of a custom Django management command that
+trains a ChatterBot instance with specified data.
+
+For more information on how to create custom management commands,
+see the Django documentation:
+https://docs.djangoproject.com/en/4.2/howto/custom-management-commands/
+
+For details on the available training options for ChatterBot see:
+http://docs.chatterbot.us/training/ 
+"""
+
+from django.core.management.base import BaseCommand
+from django.conf import settings
+
+from chatterbot import ChatBot
+from chatterbot.trainers import ListTrainer
+
+
+class Command(BaseCommand):
+    help = 'Train a ChatterBot instance with specified data.'
+
+    def handle(self, *args, **options):
+        chatbot = ChatBot(**settings.CHATTERBOT)
+
+        trainer = ListTrainer(chatbot)
+
+        trainer.train([
+            'Hello, how are you?',
+            'I am good.',
+            'That is good to hear.',
+            'I am glad to hear that.',
+            'Thank you.',
+            'You are welcome.',
+        ])
+
+        self.stdout.write(
+            self.style.SUCCESS('Training completed successfully')
+        )

examples/django_example/django_example/management/commands/__init__.py

@@ -39,6 +39,9 @@
     'django.contrib.staticfiles',
 
     'chatterbot.ext.django_chatterbot',
+
+    # Our example app:
+    'django_example',
 ]
 
 # ChatterBot settings

examples/django_example/django_example/management/commands/train.py

@@ -2,8 +2,9 @@
 from django.views.generic.base import TemplateView
 from django.views.generic import View
 from django.http import JsonResponse
+from django.conf import settings
+
 from chatterbot import ChatBot
-from chatterbot.ext.django_chatterbot import settings
 
 
 class ChatterBotAppView(TemplateView):