Skip to content

Commit 467a0b6

Browse files
authored
Merge pull request piccolo-orm#113 from piccolo-orm/missing_docstrings
add docstring for AppConfig
2 parents 0597aba + d5b0d5b commit 467a0b6

File tree

1 file changed

+19
-1
lines changed

1 file changed

+19
-1
lines changed

piccolo/conf/apps.py

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,24 @@ class Command:
9494
class AppConfig:
9595
"""
9696
Each app needs an AppConfig, which is defined in piccolo_app.py.
97+
98+
:param app_name:
99+
The name of the app, for example ``'article'``.
100+
:param migrations_folder_path:
101+
The path of the folder containing this app's migration files.
102+
:param table_classes:
103+
By registering table classes, Piccolo's auto migrations can detect
104+
changes to tables.
105+
:param migration_dependencies:
106+
A list of Piccolo apps whose migrations this app depends on. For
107+
example: ``['piccolo.apps.user.piccolo_conf']``. The migrations for
108+
those apps will be run before the migrations for this app.
109+
:param commands:
110+
A list of functions and coroutines, which are then registered with
111+
the Piccolo CLI. For example, with a Piccolo app called ``'article'``,
112+
and a command called ``new``, it can be called on the command line
113+
using ``piccolo article new``.
114+
97115
"""
98116

99117
app_name: str
@@ -262,7 +280,7 @@ def _import_app_modules(
262280
for config_module_path in config_module_paths:
263281
try:
264282
config_module = t.cast(
265-
PiccoloAppModule, import_module(config_module_path),
283+
PiccoloAppModule, import_module(config_module_path)
266284
)
267285
except ImportError:
268286
raise Exception(f"Unable to import {config_module_path}")

0 commit comments

Comments
 (0)