add more docs, add final tests for now, and improve imports

Author: BrandonShar

README.md

@@ -52,7 +52,7 @@ You can also check out the official Inertia docs at https://inertiajs.com/.
 Render Inertia responses is simple, you can either use the provided inertia render function or, for the most common use case, the inertia decorator. The render function accepts four arguments, the first is your request object. The second is the name of the component you want to render from within your pages directory (without extension). The third argument is a dict of `props` that should be provided to your components. The final argument is `view_data`, for any variables you want to provide to your template, but this is much less common.
 
 ```python
-from inertia.http import render
+from inertia import render
 from .models import Event
 
 def index(request):
@@ -64,7 +64,7 @@ def index(request):
 Or use the simpler decorator for the most common use cases
 
 ```python
-from inertia.http import inertia
+from inertia import inertia
 from .models import Event
 
 @inertia('Event/Index')
@@ -79,7 +79,7 @@ def index(request):
 If you have data that you want to be provided as a prop to every component (a common use-case is information about the authenticated user) you can use the `share` method. A common place to put this would be in some custom middleware.
 
 ```python
-from inertia.share import share
+from inertia import share
 from django.conf import settings
 from .models import User
 
@@ -95,6 +95,21 @@ def inertia_share(get_response):
   return middleware
 ```
 
+### Lazy Props
+On the front end, Inertia supports the concept of "partial reloads" where only the props requested
+are returned by the server. Sometimes, you may want to use this flow to avoid processing a particularly slow prop on the intial load. In this case, you can use `Lazy props`. Lazy props aren't evaluated unless they're specifically requested by name in a partial reload.
+
+```python
+from inertia import lazy, inertia
+
+@inertia('ExampleComponent')
+def example(request):
+  return {
+    'name': lambda: 'Brandon', # this will be rendered on the first load as usual
+    'data': lazy(lambda: some_long_calculation()), # this will only be run when specifically requested by partial props and WILL NOT be included on the initial load
+  }
+```
+
 ### Json Encoding
 
 Inertia Django ships with a custom JsonEncoder at `inertia.utils.InertiaJsonEncoder` that extends Django's 

inertia/__init__.py

@@ -0,0 +1,3 @@
+from .http import inertia, render
+from .utils import lazy
+from .share import share

inertia/tests/test_encoder.py

@@ -0,0 +1,35 @@
+from inertia.tests.testapp.models import User
+from django.test import TestCase
+from inertia.utils import InertiaJsonEncoder
+from json import dumps
+from datetime import date, datetime
+
+class InertiaJsonEncoderTestCase(TestCase):
+  def setUp(self):
+    self.encode = lambda obj: dumps(obj, cls=InertiaJsonEncoder)
+
+  def test_it_handles_models_with_dates_and_removes_passwords(self):
+    user = User(
+      name='Brandon',
+      password='something-top-secret',
+      birthdate=date(1987, 2, 15),
+      registered_at=datetime(2022, 10, 31, 10, 13, 1),
+    )
+
+    self.assertEqual(
+      dumps({'id': None, 'name': 'Brandon', 'birthdate': '1987-02-15', 'registered_at': '2022-10-31T10:13:01'}),
+      self.encode(user)
+    )
+
+  def test_it_handles_querysets(self):
+    User(
+      name='Brandon',
+      password='something-top-secret',
+      birthdate=date(1987, 2, 15),
+      registered_at=datetime(2022, 10, 31, 10, 13, 1),
+    ).save()
+
+    self.assertEqual(
+      dumps([{'id': 1, 'name': 'Brandon', 'birthdate': '1987-02-15', 'registered_at': '2022-10-31T10:13:01'}]),
+      self.encode(User.objects.all())
+    )

inertia/tests/testapp/models.py

@@ -0,0 +1,7 @@
+from django.db import models
+
+class User(models.Model):
+  name = models.CharField(max_length=255)
+  password = models.CharField(max_length=255)
+  birthdate = models.DateField()
+  registered_at = models.DateTimeField()

inertia/tests/testapp/views.py

@@ -1,9 +1,7 @@
 from django.http.response import HttpResponse
 from django.shortcuts import redirect
 from django.utils.decorators import decorator_from_middleware
-from inertia.http import inertia, render
-from inertia.utils import lazy
-from inertia.share import share
+from inertia import inertia, render, lazy, share
 
 class ShareMiddleware:
   def __init__(self, get_response):