Added tests

Author: eadwinCode

README.md

@@ -178,7 +178,7 @@ Running migrations:
 ### Start Server
 Now, that we have everything setup, we can start the server
 ```shell
-ellar runserver
+ellar runserver --reload
 ```
 In the above example, we added `/-django-example` as path prefix. This is important because we need to group all django admin views 
 with a prefix and also to avoid unnecessary `Page Not Found` errors.

tests/conftest.py

@@ -0,0 +1,24 @@
+import pytest
+from django.contrib.auth import get_user_model
+from ellar.testing import Test
+from example_app.root_module import ApplicationModule
+
+test_module = Test.create_test_module(modules=[ApplicationModule])
+test_module.create_application()
+# test_module.create_application()  is very important if there are things that requires django settings.
+# In my case, `user_model = get_user_model()`
+
+user_model = get_user_model()
+
+
+@pytest.fixture()
+def admin_user():
+    return user_model.object.create_superuser(
+        username="ellar", email="[email protected]", password="password"
+    )
+
+
+@pytest.fixture()
+def client():
+    with test_module.get_test_client() as _client:
+        yield _client

tests/example_app/__init__.py

@@ -0,0 +1,31 @@
+"""
+Define endpoints routes in python class-based fashion
+example:
+
+@Controller("/dogs", tag="Dogs", description="Dogs Resources")
+class MyController(ControllerBase):
+    @get('/')
+    def index(self):
+        return {'detail': "Welcome Dog's Resources"}
+"""
+import typing as t
+
+from ellar.common import Controller, ControllerBase, get, post
+
+from ...interfaces.events_repository import IEventRepository
+from .schemas import EventSchema, EventSchemaOut
+
+
+@Controller("/event")
+class EventController(ControllerBase):
+    def __init__(self, event_repo: IEventRepository):
+        self.event_repo = event_repo
+
+    @post("/", response={201: EventSchemaOut})
+    def create_event(self, event: EventSchema):
+        event = self.event_repo.create_event(**event.dict())
+        return 201, event
+
+    @get("/", response=t.List[EventSchema], name="event-list")
+    def list_events(self):
+        return list(self.event_repo.list_events())

tests/example_app/apps/__init__.py

@@ -0,0 +1,38 @@
+"""
+@Module(
+    controllers=[MyController],
+    providers=[
+        YourService,
+        ProviderConfig(IService, use_class=AService),
+        ProviderConfig(IFoo, use_value=FooService()),
+    ],
+    routers=(routerA, routerB)
+    statics='statics',
+    template='template_folder',
+    # base_directory -> default is the `event` folder
+)
+class MyModule(ModuleBase):
+    def register_providers(self, container: Container) -> None:
+        # for more complicated provider registrations
+        pass
+
+"""
+from ellar.common import Module
+from ellar.core import ModuleBase
+from ellar.di import Container
+
+from .controllers import EventController
+
+
+@Module(
+    controllers=[EventController],
+    providers=[],
+    routers=[],
+)
+class EventModule(ModuleBase):
+    """
+    Event Module
+    """
+
+    def register_providers(self, container: Container) -> None:
+        """for more complicated provider registrations, use container.register_instance(...)"""

tests/example_app/apps/event/__init__.py

@@ -0,0 +1,12 @@
+"""
+Define endpoints routes in python function fashion
+example:
+
+my_router = ModuleRouter("/cats", tag="Cats", description="Cats Resource description")
+
+@my_router.get('/')
+def index(request: Request):
+    return {'detail': 'Welcome to Cats Resource'}
+"""
+
+from ellar.common import ModuleRouter  # noqa

tests/example_app/apps/event/controllers.py

@@ -0,0 +1,31 @@
+"""
+Define Serializers/DTOs
+Example:
+
+class ASampleDTO(Serializer):
+    name: str
+    age: t.Optional[int] = None
+
+for dataclasses, Inherit from DataclassSerializer
+
+@dataclass
+class ASampleDTO(DataclassSerializer):
+    name: str
+    age: t.Optional[int] = None
+"""
+from datetime import date
+
+from ellar.common import Serializer
+
+
+class EventSchema(Serializer):
+    title: str
+    start_date: date
+    end_date: date
+
+    class Config:
+        orm_mode = True
+
+
+class EventSchemaOut(Serializer):
+    id: int

tests/example_app/apps/event/module.py

@@ -0,0 +1,12 @@
+"""
+Create a provider and declare its scope
+
+@injectable
+class AProvider
+    pass
+
+@injectable(scope=transient_scope)
+class BProvider
+    pass
+"""
+from ellar.di import injectable  # noqa