Architecture of the API<\/h3>\n\n\n\n
Our objective is to build a Todo api that will allow us to create Todo tasks that are assigned to a project.<\/p>\n\n\n\n
We also want to be able to add a category attribute to each Todo task which will allow us to bundle our tasks in each project by categories. For example we may have a number Todo tasks for the building out of the back end of our app and a number of other tasks for the front end of our app. It would be nice to be able to list our Todo tasks by:<\/p>\n\n\n\n
- Project
- Category
- Todo task<\/li><\/ul><\/li><\/ul><\/li><\/ul>\n\n\n\n
This also gives up the opportunity to use Django’s powerful MPTT, (Modified Preorder Tree Traversal) which allows us to store hierarchical data in our database. Very cool. You can read all about here<\/a>.<\/p>\n\n\n\n
We begin the build process of our mptt category model by first writing a test for the model that we will write.<\/p>\n\n\n\n
TDD to Test the Model<\/h4>\n\n\n\n
Our test is doomed to fail because we have yet to write the category model but that’s what TDD is all about. First we write the tests which describes what we want the app to be able to do<\/em>.<\/p>\n\n\n\n
Begin by populating the file \/server\/todo_app\/tests.py with the following:<\/p>\n\n\n
\n# \/server\/todo_app\/tests.py\n\nfrom django.test import TestCase\n\nfrom todo_app.models import Category\n\nclass CategoryModelTest(TestCase):\n def test_string_representation(self):\n category = Category(name="my category name")\n self.assertEqual(str(category), category.name)\n<\/pre><\/div>\n\n\n
Above we are using the base class TestCase for our Unit Test. TestCase class creates a clean database before tests are run and runs every test function in its own transaction.<\/p>\n\n\n\n
First we create a data entry for our first category database and give it title, then using self.assertEqual(str(category), category.name)<\/strong> we test that our category entry\u2019s string representation is equal to its name.<\/p>\n\n\n\n
Run the test:<\/p>\n\n\n
\ndocker-compose run server .\/manage.py test\nStarting postgres_dj02 ... done\nSystem check identified no issues (0 silenced).\nE\n======================================================================\nERROR: todo_app.tests (unittest.loader._FailedTest)\n----------------------------------------------------------------------\nImportError: Failed to import test module: todo_app.tests\nTraceback (most recent call last):\n File "\/usr\/local\/lib\/python3.8\/unittest\/loader.py", line 436, in _find_test_path\n module = self._get_module_from_name(name)\n File "\/usr\/local\/lib\/python3.8\/unittest\/loader.py", line 377, in _get_module_from_name\n __import__(name)\n File "\/var\/www\/server\/todo_app\/tests.py", line 5, in <module>\n from .models import Category\nImportError: cannot import name 'Category' from 'todo_app.models' (\/var\/www\/server\/todo_app\/models.py)\n\n\n----------------------------------------------------------------------\nRan 1 test in 0.001s\n\nFAILED (errors=1)\n<\/pre><\/div>\n\n\n
Our test failed as expected since we don’t have category model yet to test so, lets write that model.<\/p>\n\n\n\n
Category Model<\/h4>\n\n\n
\n# \/server\/todo_app\/models.py\n\nfrom django.db import models\nfrom autoslug import AutoSlugField\nfrom django.utils import timezone\nfrom datetime import datetime\nfrom django.conf import settings\nfrom mptt.models import MPTTModel, TreeForeignKey\n\nclass Category(MPTTModel):\n name = models.CharField(max_length=50, unique=True)\n parent = TreeForeignKey('self', on_delete=models.CASCADE, null=True, blank=True, related_name='children')\n slug = AutoSlugField(populate_from='name', default=None)\n modified = models.DateTimeField(auto_now=True, null=True, editable=False) \n created = models.DateField(default=timezone.now().strftime("%Y-%m-%d")) \n\n def __str__(self): \n return self.name \n\n class MPTTMeta: \n order_insertion_by = ['name'] \n unique_together = ('slug', 'parent') \n\n class Meta: \n verbose_name_plural = 'categories'\n<\/pre><\/div>\n\n\nNote the import statement for mptt. If you copied and pasted the code from the requirements.txt file in chapter one, the Dockerfile installed all the packages that we will need for this tutorial including MPTT.<\/p>\n\n\n\n
Install Django MPTT<\/strong><\/p>\n\n\n\n
Add mptt to our \/server\/todo_proj\/settings.py file:<\/p>\n\n\n
\n# \/server\/todo_proj\/settings.py\n\nINSTALLED_APPS = [\n'django.contrib.admin',\n'django.contrib.auth',\n'django.contrib.contenttypes',\n'django.contrib.sessions',\n'django.contrib.messages',\n'django.contrib.staticfiles',\n'todo_app',\n'mptt',\n]\n<\/pre><\/div>\n\n\n
Run django migrations:<\/p>\n\n\n
\ndocker-compose run server .\/manage.py makemigrations\ndocker-compose run server .\/manage.py migrate\n\n# reload the django settings\ndocker-compose down\ndocker-compose up -d database\ndocker-compose up -d server\n<\/pre><\/div>\n\n\n
Run our test again:<\/p>\n\n\n
\ndocker-compose run server .\/manage.py test\n\nStarting postgres ... done\nCreating test database for alias 'default'...\nSystem check identified no issues (0 silenced).\n.\n----------------------------------------------------------------------\nRan 1 test in 0.003s\n\nOK\nDestroying test database for alias 'default'...\n<\/pre><\/div>\n\n\n
Our test passed. Excellent!<\/p>\n\n\n\n
Success! What’s next? Let’s write another test. This one for a Todo task using the same drill we used for the Category model.<\/p>\n\n\n\n
Write the Todo Test<\/h4>\n\n\n
\n# todo-app-graphql\/server\/todo_app\/tests.py\n\nfrom django.test import TestCase\n\nfrom todo_app.models import Category, Todo\n\nclass CategoryModelTest(TestCase):\n def test_string_representation(self):\n category = Category(name="my category name")\n self.assertEqual(str(category), category.name)\n\nclass TodoModelTest(TestCase):\n def test_string_representation(self):\n todo = Todo(title="my todo title")\n self.assertEqual(str(todo), todo.title)\n\n<\/pre><\/div>\n\n\n
Run the test:<\/p>\n\n\n
\ndocker-compose run server .\/manage.py test\n<\/pre><\/div>\n\n\n
… and the test fails as expected:<\/p>\n\n\n
\nStarting postgres_dj02 ... done\nCreating test database for alias 'default'...\nSystem check identified no issues (0 silenced).\n.E\n======================================================================\nERROR: test_string_representation (todo_app.tests.TodoModelTest)\n----------------------------------------------------------------------\nTraceback (most recent call last):\n File "\/var\/www\/server\/todo_app\/tests.py", line 15, in test_string_representation\n todo = Todo(title="my todo title")\nNameError: name 'Todo' is not defined\n\n----------------------------------------------------------------------\nRan 2 tests in 0.021s\n\nFAILED (errors=1)\nDestroying test database for alias 'default'...\n<\/pre><\/div>\n\n\n
Now let’s create a model for Todo with a title. Also we need to add the
__str__<\/code> method so that our model returns the todo title. Ourmodels.py<\/code> file should look something like this:<\/p>\n\n\n\nfrom django.db import models\n\nfrom django.db import models\nfrom autoslug import AutoSlugField\nfrom django.utils import timezone\nfrom datetime import datetime\nfrom django.conf import settings\nfrom mptt.models import MPTTModel, TreeForeignKey\n\nclass Category(MPTTModel):\n name = models.CharField(max_length=50, unique=True)\n parent = TreeForeignKey('self', on_delete=models.CASCADE, null=True, blank=True, related_name='children')\n slug = AutoSlugField(populate_from='name', default=None)\n\n modified = models.DateTimeField(auto_now=True, null=True, editable=False)\n created = models.DateField(default=timezone.now().strftime("%Y-%m-%d"))\n\n def __str__(self):\n return self.name\n\n class MPTTMeta:\n order_insertion_by = ['name']\n unique_together = ('slug', 'parent')\n\n class Meta:\n verbose_name_plural = 'categories'\n\nclass Todo(models.Model):\n title = (models.CharField(max_length=500))\n\n def __str__(self):\n return self.title\n<\/pre><\/div>\n\n\nWith the Todo class defined we make and run migrations:<\/p>\n\n\n
\ndocker-compose run server .\/manage.py makemigrations\ndocker-compose run server .\/manage.py migrate\n<\/pre><\/div>\n\n\n
Now our test should be successful:<\/p>\n\n\n
\ndocker-compose run server .\/manage.py test\nStarting postgres_dj02 ... done\nCreating test database for alias 'default'...\nSystem check identified no issues (0 silenced).\n..\n----------------------------------------------------------------------\nRan 2 tests in 0.012s\n\nOK\nDestroying test database for alias 'default'...\n<\/pre><\/div>\n\n\n
Continuing on the same track we add additional Todo model fields to our tests.<\/p>\n\n\n
\n# todo-app-graphql\/server\/todo_app\/tests.py\n\nfrom django.test import TestCase\n\nfrom todo_app.models import Category, Todo\n\nclass CategoryModelTest(TestCase):\n def test_string_representation(self):\n category = Category(name="my category name")\n self.assertEqual(str(category), category.name)\n\nclass TodoModelTest(TestCase):\n def test_string_representation(self):\n todo = Todo(title="my todo title")\n self.assertEqual(str(todo), todo.title)\n\n def test_todo_field(self):\n todo = Todo(\n title = "my todo title",\n task = "foo",\n is_completed = False,\n due_date = "2020-06-24",\n )\n self.assertEqual(todo.title, "my todo title")\n self.assertEqual(todo.task, "foo")\n self.assertEqual(todo.is_completed, False)\n self.assertEqual(todo.due_date, "2020-06-24")\n\n<\/pre><\/div>\n\n\n
If we were to run tests again they would fail because these fields haven’t been defined in the model so, let’s define them:<\/p>\n\n\n
\nfrom django.db import models\n\nfrom django.db import models\nfrom autoslug import AutoSlugField\nfrom django.utils import timezone\nfrom datetime import datetime\nfrom django.conf import settings\nfrom mptt.models import MPTTModel, TreeForeignKey\n\nclass Category(MPTTModel):\n name = models.CharField(max_length=50, unique=True)\n parent = TreeForeignKey('self', on_delete=models.CASCADE, null=True, blank=True, related_name='children')\n slug = AutoSlugField(populate_from='name', default=None)\n\n modified = models.DateTimeField(auto_now=True, null=True, editable=False)\n created = models.DateField(default=timezone.now().strftime("%Y-%m-%d"))\n\n def __str__(self):\n return self.name\n\n class MPTTMeta:\n order_insertion_by = ['name']\n unique_together = ('slug', 'parent')\n\n class Meta:\n verbose_name_plural = 'categories'\n\nclass Todo(models.Model):\n title = (models.CharField(max_length=500))\n task = models.TextField(blank=True)\n slug = AutoSlugField(populate_from='title', default=None)\n is_completed = models.BooleanField(default=False)\n\n modified = models.DateTimeField(auto_now=True, null=True, editable=False)\n created = models.DateField(default=timezone.now().strftime("%Y-%m-%d"))\n due_date = models.DateField(default=timezone.now().strftime("%Y-%m-%d"))\n\n def __str__(self):\n return self.title\n<\/pre><\/div>\n\n\nRun migrations again:<\/p>\n\n\n
\n# we can combine the makemigrations and migrate docker-compose into one command\ndocker-compose run server .\/manage.py makemigrations && docker-compose run server .\/manage.py migrate\n<\/pre><\/div>\n\n\n
Run our tests again and…<\/p>\n\n\n
\ndocker-compose run server .\/manage.py test\n<\/pre><\/div>\n\n\n
… and voila! The tests run with 0 issues. Success!<\/p>\n\n\n
\nStarting postgres_dj02 ... done\nCreating test database for alias 'default'Creating network "todo_mptt_2_default" with the default driver\nCreating postgres_dj02 ... done\nCreating dj02 ... done\nweb:todo_mptt_2 ronleeson$ docker-compose run server .\/manage.py test\nStarting postgres_dj02 ... done\nCreating test database for alias 'default'...\nSystem check identified no issues (0 silenced).\n...\n----------------------------------------------------------------------\nRan 3 tests in 0.014s\n\nOK\nDestroying test database for alias 'default'......\nSystem check identified no issues (0 silenced).\n..\n----------------------------------------------------------------------\nRan 2 tests in 0.014s\n\nOK\nDestroying test database for alias 'default'...\n<\/pre><\/div>\n\n\n
Full speed ahead we add the relationship between the Todo and the Category model:<\/p>\n\n\n
\n# \/server\/todo_app\/models.py\n\nfrom django.db import models\n \nfrom django.db import models\nfrom autoslug import AutoSlugField\nfrom django.utils import timezone\nfrom datetime import datetime\nfrom django.conf import settings\nfrom mptt.models import MPTTModel, TreeForeignKey\n \nclass Category(MPTTModel):\n name = models.CharField(max_length=50, unique=True)\n parent = TreeForeignKey('self', on_delete=models.CASCADE, null=True, blank=True, related_name='children')\n slug = AutoSlugField(populate_from='name', default=None)\n \n modified = models.DateTimeField(auto_now=True, null=True, editable=False)\n created = models.DateField(default=timezone.now().strftime("%Y-%m-%d"))\n \n def __str__(self):\n return self.name\n \n class MPTTMeta:\n order_insertion_by = ['name']\n unique_together = ('slug', 'parent')\n \n class Meta:\n verbose_name_plural = 'categories'\n \nclass Todo(models.Model):\n title = (models.CharField(max_length=500))\n task = models.TextField(blank=True)\n slug = AutoSlugField(populate_from='title', default=None)\n is_completed = models.BooleanField(default=False)\n\n category = TreeForeignKey('Category', on_delete=models.CASCADE, null=True, blank=True, related_name='todos')\n \n modified = models.DateTimeField(auto_now=True, null=True, editable=False)\n created = models.DateField(default=timezone.now().strftime("%Y-%m-%d"))\n due_date = models.DateField(default=timezone.now().strftime("%Y-%m-%d"))\n \n def __str__(self):\n return self.title\n<\/pre><\/div>\n\n\n… and update the TodoModelTest in the tests.py file by defining a category object and assigning the object to our new Todo object<\/p>\n\n\n
\n# \/server\/todo_app\/tests.py\n\nfrom django.test import TestCase\n\nfrom todo_app.models import Category, Todo\n\n# ... code\n\nclass TodoModelTest(TestCase):\n def test_string_representation(self):\n todo = Todo(title="my todo title")\n self.assertEqual(str(todo), todo.title)\n\n def test_todo_field(self):\n\n # create a category object\n cat = Category(name="Frontend")\n\n todo = Todo(\n title = "my todo title",\n task = "foo",\n category = cat,\n is_completed = False,\n due_date = "2020-06-24",\n )\n self.assertEqual(todo.title, "my todo title")\n self.assertEqual(todo.task, "foo")\n self.assertEqual(todo.category.name, "Frontend")\n self.assertEqual(todo.is_completed, False)\n self.assertEqual(todo.due_date, "2020-06-24")\n<\/pre><\/div>\n\n\n
Run migrations:<\/p>\n\n\n
\ndocker-compose run server .\/manage.py makemigrations && docker-compose run server .\/manage.py migrate\n\n# run tests again\ndocker-compose run server .\/manage.py test\n<\/pre><\/div>\n\n
\ndocker-compose run server .\/manage.py test\nStarting postgres_dj02 ... done\nCreating test database for alias 'default'...\nSystem check identified no issues (0 silenced).\n...\n----------------------------------------------------------------------\nRan 3 tests in 0.019s\n\nOK\nDestroying test database for alias 'default'...\n<\/pre><\/div>\n\n\n
Success once again! Pushing on to our final model to test, Project. Update the tests.py file like so:<\/p>\n\n\n
\n# \/server\/todo_app\/tests.py\n\nfrom django.test import TestCase\n\nfrom todo_app.models import Category, Todo, Project\n\nclass CategoryModelTest(TestCase):\n def test_string_representation(self):\n category = Category(name="my category name")\n self.assertEqual(str(category), category.name)\n\nclass TodoModelTest(TestCase):\n def test_string_representation(self):\n todo = Todo(title="my todo title")\n self.assertEqual(str(todo), todo.title)\n\n def test_todo_field(self):\n # create category object\n cat = Category(name="Frontend")\n\n todo = Todo(\n title = "my todo title",\n task = "foo",\n category = cat,\n is_completed = False,\n due_date = "2021-07-30",\n )\n self.assertEqual(todo.title, "my todo title")\n self.assertEqual(todo.task, "foo")\n self.assertEqual(todo.category.name, "Frontend")\n self.assertEqual(todo.is_completed, False)\n self.assertEqual(todo.due_date, "2021-07-30")\n\nclass ProjectModelTest(TestCase):\n def test_string_representation(self):\n project = Project(name = "my project name")\n self.assertEqual(str(project), project.name)\n\n def test_project_field(self):\n proj = Project(\n name = "my project name",\n description = "my project description",\n )\n self.assertEqual(proj.name, "my project name")\n self.assertEqual(proj.description, "my project description")\n\n\n<\/pre><\/div>\n\n\n
… and this test will fail until we add our Project model which we can do now:<\/p>\n\n\n
\n# \/server\/todo_app\/models.py\n\nfrom django.db import models\n\nfrom django.db import models\nfrom autoslug import AutoSlugField\nfrom django.utils import timezone\nfrom datetime import datetime\nfrom django.conf import settings\nfrom mptt.models import MPTTModel, TreeForeignKey\n\nclass Category(MPTTModel):\n name = models.CharField(max_length=50, unique=True)\n parent = TreeForeignKey('self', on_delete=models.CASCADE, null=True, blank=True, related_name='children')\n slug = AutoSlugField(populate_from='name', default=None)\n\n modified = models.DateTimeField(auto_now=True, null=True, editable=False)\n created = models.DateField(default=timezone.now().strftime("%Y-%m-%d"))\n\n def __str__(self):\n return self.name\n\n class MPTTMeta:\n order_insertion_by = ['name']\n unique_together = ('slug', 'parent')\n\n class Meta:\n verbose_name_plural = 'categories'\n\nclass Todo(models.Model):\n title = (models.CharField(max_length=500))\n task = models.TextField(blank=True)\n slug = AutoSlugField(populate_from='title', default=None)\n is_completed = models.BooleanField(default=False)\n\n category = TreeForeignKey('Category', on_delete=models.CASCADE, null=True, blank=True, related_name='todos')\n\n modified = models.DateTimeField(auto_now=True, null=True, editable=False)\n created = models.DateField(default=timezone.now().strftime("%Y-%m-%d"))\n due_date = models.DateField(default=timezone.now().strftime("%Y-%m-%d"))\n\n def __str__(self):\n return self.title\n\nclass Project(models.Model):\n name = models.CharField(max_length=500)\n description = models.TextField(max_length=2500, blank=True, null=True, help_text="Description of your project.")\n slug = AutoSlugField(populate_from='name', default=None)\n modified = models.DateTimeField(auto_now=True, null=True, editable=False) \n created = models.DateField(default=timezone.now().strftime("%Y-%m-%d")) \n\n def __str__(self): \n return self.name \n\n class Meta: \n verbose_name_plural = 'projects'\n<\/pre><\/div>\n\n\nNow that we have the Project model we can associate a foreign key relationship between Todo and Project.<\/p>\n\n\n
\n# \/server\/todo_app\/models.py\n\nfrom django.db import models\n\nfrom django.db import models\nfrom autoslug import AutoSlugField\nfrom django.utils import timezone\nfrom datetime import datetime\nfrom django.conf import settings\nfrom mptt.models import MPTTModel, TreeForeignKey\n\nclass Category(MPTTModel):\n name = models.CharField(max_length=50, unique=True)\n parent = TreeForeignKey('self', on_delete=models.CASCADE, null=True, blank=True, related_name='children')\n slug = AutoSlugField(populate_from='name', default=None)\n\n modified = models.DateTimeField(auto_now=True, null=True, editable=False)\n created = models.DateField(default=timezone.now().strftime("%Y-%m-%d"))\n\n def __str__(self):\n return self.name\n\n class MPTTMeta:\n order_insertion_by = ['name']\n unique_together = ('slug', 'parent')\n\n class Meta:\n verbose_name_plural = 'categories'\n\nclass Todo(models.Model):\n title = (models.CharField(max_length=500))\n task = models.TextField(blank=True)\n slug = AutoSlugField(populate_from='title', default=None)\n is_completed = models.BooleanField(default=False)\n\n category = TreeForeignKey('Category', on_delete=models.CASCADE, null=True, blank=True, related_name='todos')\n\n project = models.ForeignKey('Project', related_name='todo_project', on_delete=models.CASCADE, null=True, blank=True)\n\n modified = models.DateTimeField(auto_now=True, null=True, editable=False)\n created = models.DateField(default=timezone.now().strftime("%Y-%m-%d"))\n due_date = models.DateField(default=timezone.now().strftime("%Y-%m-%d"))\n\n def __str__(self):\n return self.title\n\nclass Project(models.Model):\n name = models.CharField(max_length=500)\n description = models.TextField(max_length=2500, blank=True, null=True, help_text="Description of your project.")\n slug = AutoSlugField(populate_from='name', default=None)\n modified = models.DateTimeField(auto_now=True, null=True, editable=False) \n created = models.DateField(default=timezone.now().strftime("%Y-%m-%d")) \n\n def __str__(self): \n return self.name \n\n class Meta: \n verbose_name_plural = 'projects'\n<\/pre><\/div>\n\n\nUpdate tests.py to test the Todo model for the foreign key relationship with Project.<\/p>\n\n\n
\n# \/server\/todo_app\/tests.py\n \nfrom django.test import TestCase\n \nfrom todo_app.models import Category, Todo, Project\n \nclass CategoryModelTest(TestCase):\n def test_string_representation(self):\n category = Category(name="my category name")\n self.assertEqual(str(category), category.name)\n \nclass TodoModelTest(TestCase):\n def test_string_representation(self):\n todo = Todo(title="my todo title")\n self.assertEqual(str(todo), todo.title)\n \n def test_todo_field(self):\n # create category object\n cat = Category(name="Frontend")\n\n # create project object\n proj = Project(name="My Project")\n \n todo = Todo(\n title = "my todo title",\n task = "foo",\n category = cat,\n project = proj,\n is_completed = False,\n due_date = "2021-07-30",\n )\n self.assertEqual(todo.title, "my todo title")\n self.assertEqual(todo.task, "foo")\n self.assertEqual(todo.category.name, "Frontend")\n self.assertEqual(todo.project.name, "My Project")\n self.assertEqual(todo.is_completed, False)\n self.assertEqual(todo.due_date, "2021-07-30")\n \nclass ProjectModelTest(TestCase):\n def test_string_representation(self):\n project = Project(name = "my project name")\n self.assertEqual(str(project), project.name)\n \n def test_project_field(self):\n proj = Project(\n name = "my project name",\n description = "my project description",\n )\n self.assertEqual(proj.name, "my project name")\n self.assertEqual(proj.description, "my project description")\n<\/pre><\/div>\n\n\n
… run migrations…<\/p>\n\n\n
\ndocker-compose run server .\/manage.py makemigrations && docker-compose run server .\/manage.py migrate\n<\/pre><\/div>\n\n\n
… run tests…<\/p>\n\n\n
\ndocker-compose run server .\/manage.py test\nStarting postgres_dj02 ... done\nCreating test database for alias 'default'...\nSystem check identified no issues (0 silenced).\n.....\n----------------------------------------------------------------------\nRan 5 tests in 0.024s\n\nOK\nDestroying test database for alias 'default'...\n<\/pre><\/div>\n\n\n
… once again, success!<\/p>\n\n\n\n
Organize Our Tests<\/h4>\n\n\n\n
If we start writing tests for a complex project the tests.py file could get messy so, we will breakup our test file into separate files. In this case we create a file just for model tests. In order to do this we will need to reorganize the todo_app directory.<\/p>\n\n\n
\n# create a tests folder\nmkdir server\/todo_app\/tests\n\n# move the tests.py file into the new tests folder\nmv server\/todo_app\/tests.py server\/todo_app\/tests\/test_models.py\n\n# create the __init__.py so python treats directories containing it \/\n# as modules\ntouch server\/todo_app\/tests\/__init__.py\n<\/pre><\/div>\n\n\n
- todo_app
- tests [folder]
- __init__.py<\/li><\/ul>
- test_models.py<\/li><\/ul><\/li><\/ul><\/li><\/ul>\n\n\n\n
Now we should be able to run our tests again and django will look in our tests directory for all our tests:<\/p>\n\n\n
\ndocker-compose run server .\/manage.py test\nStarting postgres_dj02 ... done\nCreating test database for alias 'default'...\nSystem check identified no issues (0 silenced).\n.....\n----------------------------------------------------------------------\nRan 5 tests in 0.025s\n\nOK\nDestroying test database for alias 'default'...\n<\/pre><\/div>\n\n\n
And our tests run successfully!<\/p>\n\n\n\n
Loading Data from the Django Shell<\/h4>\n\n\n\n
Let’s enter the Django shell via docker-compose. Open a new terminal tab in our Todo App GraphQL project and enter the following:<\/p>\n\n\n
\ndocker-compose run server .\/manage.py shell\n<\/pre><\/div>\n\n\n
This should kick us into Django shell. From here we can import our todo_app model and enter data for Project, Category, and Todo:<\/p>\n\n\n
\n>>> from todo_app.models import Category, Project, Todo\n\n>>> proj = Project(name='Project 1', description='Project 1 description')\n>>> proj.save()\n\n>>> cat = Category(name='Category 1')\n>>> cat.save()\n\n>>> todo = Todo(title='My First Todo', task='Do it', category=cat, project= proj)\n>>> todo.save()\n\n>>> quit()\n<\/pre><\/div>\n\n\n
Voila! The data is there. <\/p>\n\n\n\n
Lets see if the data is really there by using the Django admin UI.<\/p>\n\n\n\n
Configure Django Admin<\/h4>\n\n\n\n
Add the following code to our todo-app-graphql\/server\/todo_app\/admin.py<\/strong> file:<\/p>\n\n\n
\n# todo-app-graphql\/server\/todo_app\/admin.py\n\nfrom django.contrib import admin\nfrom mptt.admin import MPTTModelAdmin\nfrom mptt.admin import DraggableMPTTAdmin\nfrom mptt.admin import TreeRelatedFieldListFilter\n\nfrom todo_app.models import( \n Category, \n Todo,\n Project,\n )\n\nadmin.site.register(\n Category, \n DraggableMPTTAdmin,\n list_display=(\n 'tree_actions',\n 'indented_title',\n ),\n list_display_links=(\n 'indented_title',\n )\n)\n\nclass ProjectAdmin(admin.ModelAdmin):\n list_display = ('name', 'created', 'modified')\n\nadmin.site.register(Project, ProjectAdmin)\n\nclass TodoAdmin(admin.ModelAdmin):\n model = Todo \n list_filter = (\n ('category', TreeRelatedFieldListFilter),\n )\n list_display = ('title', 'is_completed', 'created', 'modified')\n\nadmin.site.register(Todo, TodoAdmin)\n<\/pre><\/div>\n\n\nReboot the app:<\/p>\n\n\n
\ndocker-compose down && docker-compose up -d\n<\/pre><\/div>\n\n\n
Now we can add data for Category, Project and Todo from http:\/\/localhost:5555\/admin\/todo_app\/todo\/<\/a><\/p>\n\n\n\n
![\"\"](\"http:\/\/10.0.0.14:5556\/wp-content\/uploads\/2021\/12\/django_admin_ch2-1024x397.jpg\")
<\/figure>\n\n\n\nComing Up Part 3: TDD Django Graphene<\/h4>\n\n\n\n
- test_models.py<\/li><\/ul><\/li><\/ul><\/li><\/ul>\n\n\n\n
- __init__.py<\/li><\/ul>
- tests [folder]
- todo_app
- Todo task<\/li><\/ul><\/li><\/ul><\/li><\/ul>\n\n\n\n
- Category