docs: define module level docstrings

src/prisma/generator/templates/actions.py.jinja

@@ -1,3 +1,13 @@
+"""
+prisma.actions
+~~~~~~~~~~~~~~
+
+A module that lets you perform certain actions - creating, searching, updating
+and deleting objects - to the database using a ``prisma.Client`` object.
+
+:auto-generated:
+"""
+
 {% set annotations = true %}
 {% include '_header.py.jinja' %}
 {% from '_utils.py.jinja' import is_async, maybe_async_def, maybe_await, methods, operations, recursive_types, active_provider with context %}

src/prisma/generator/templates/bases.py.jinja

@@ -1,3 +1,13 @@
+"""
+prisma.bases
+~~~~~~~~~~~~
+
+A module that defines all the base models to create complete models
+based on the user defined schema.
+
+:auto-generated:
+"""
+
 {% include '_header.py.jinja' %}
 {% from '_utils.py.jinja' import recursive_types with context %}
 # -- template models.py.jinja --

src/prisma/generator/templates/client.py.jinja

@@ -1,3 +1,13 @@
+"""
+prisma.client
+~~~~~~~~~~~~~
+
+Main interface for the Client API - handles connecting, disconnecting
+and querying the underlying Prisma Engine.
+
+:auto-generated:
+"""
+
 {% set annotations = true %}
 {% include '_header.py.jinja' %}
 {% from '_utils.py.jinja' import is_async, maybe_async_def, maybe_await, methods, operations, recursive_types, active_provider with context %}

src/prisma/generator/templates/enums.py.jinja

@@ -1,3 +1,13 @@
+"""
+prisma.enums
+~~~~~~~~~~~~
+
+Defines and make usable all the Enum models
+defined by the user in the schema.
+
+:auto-generated:
+"""
+
 {% include '_header.py.jinja' %}
 # -- template enums.py.jinja --
 from enum import Enum

src/prisma/generator/templates/http.py.jinja

@@ -1,3 +1,23 @@
+"""
+prisma.http
+~~~~~~~~~~~
+
+Imports an async or sync HTTP client based on the user
+defined interface in the schema.
+
+For example this generator defined in the schema will generate
+an async HTTP client.
+```prisma
+generator client {
+ provider = "prisma-client-py"
+ interface = "asyncio"
+ recursive_type_depth = -1
+}
+```
+
+:auto-generated:
+"""
+
 {% include '_header.py.jinja' %}
 # -- template http.py.jinja --
 {% if generator.config.interface == 'asyncio' %}

src/prisma/generator/templates/models.py.jinja

@@ -1,3 +1,13 @@
+"""
+prisma.models
+~~~~~~~~~~~~~
+
+A model that defines all the models defined by the user
+in the schema making them usable.
+
+:auto-generated:
+"""
+
 {% include '_header.py.jinja' %}
 {% from '_utils.py.jinja' import recursive_types with context %}
 # -- template models.py.jinja --

src/prisma/generator/templates/types.py.jinja

@@ -1,3 +1,13 @@
+"""
+prisma.types
+~~~~~~~~~~~~
+
+Dinamically generated types based on models and on the user defined
+schema.
+
+:auto-generated:
+"""
+
 {% include '_header.py.jinja' %}
 {% from '_utils.py.jinja' import recursive_types, active_provider with context %}
 # -- template types.py.jinja --