feat: write .env at project creation

Author: Tobi-De

docs/the_cli/usage.rst

@@ -33,33 +33,27 @@ Each **entry** represents a journal entry within the **myjourney** app.
 
 If necessary, adjust the python_version value in the ``.pre-commit-config.yaml`` file.
 
-**4. Create a new .env file**
-
-.. code-block:: bash
-
-    falco sync-dotenv
-
-**5. Fill in some values for the admin user**
+**4. Fill in some values for the admin user**
 
 .. code-block:: text
     :caption: .env
 
     DJANGO_SUPERUSER_EMAIL=admin@mail.com
     DJANGO_SUPERUSER_PASSWORD=admin
 
-**6. Migrate, and create the admin user**
+**5. Migrate, and create the admin user**
 
 .. code-block:: bash
 
     hatch run migrate && falco setup-admin
 
-**7. Create the new app, entries**
+**6. Create the new app, entries**
 
 .. code-block:: bash
 
     falco start-app entries
 
-**8. Add some fields to your Entry model**
+**7. Add some fields to your Entry model**
 
 .. code-block:: python
 
@@ -98,7 +92,7 @@ If necessary, adjust the python_version value in the ``.pre-commit-config.yaml``
     However, please note that this approach may not be the most advisable.
 
 
-**9.  Make migrations for the new model and run them**
+**8.  Make migrations for the new model and run them**
 
 .. code-block:: bash
 
@@ -116,21 +110,21 @@ If necessary, adjust the python_version value in the ``.pre-commit-config.yaml``
         [tool.falco.crud]
         always-migrate = true
 
-**10. Generate CRUD views for the Entry model**
+**9. Generate CRUD views for the Entry model**
 
 .. code-block:: bash
 
     falco crud entries.entry --entry-point --skip-git-check
 
-**11. Run the project**
+**10. Run the project**
 
 .. code-block:: bash
 
     falco work
 
 Now, check out http://127.0.0.1:8000/entries to see your running app.
 
-This process currently requires 11 commands. Considering the outcome, it's not too shabby! However, I'm confident there's still plenty of room for improvement.
+This process currently requires 10 commands. Considering the outcome, it's not too shabby! However, I'm confident there's still plenty of room for improvement.
 If you have any suggestions on how to improve this workflow, feel free to open a discussion at https://github.com/Tobi-De/falco/discussions.
 
 .. todo::

src/falco/commands/start_project.py

@@ -17,6 +17,8 @@
 from falco.commands.crud.utils import run_html_formatters
 from falco.commands.htmx import get_latest_tag as htmx_latest_tag
 from falco.commands.htmx import Htmx
+from falco.commands.sync_dotenv import get_updated as get_updated_dotenv
+from falco.commands.sync_dotenv import SyncDotenv
 from falco.config import read_falco_config
 from falco.config import write_falco_config
 from falco.utils import clean_project_name
@@ -27,6 +29,7 @@
 from rich import print as rich_print
 from rich.prompt import Prompt
 
+
 DEFAULT_SKIP = [
     "playground.ipynb",
     "README.md",
@@ -96,7 +99,18 @@ def __call__(self) -> None:
         with change_directory(project_dir):
             pyproject_path = Path("pyproject.toml")
             falco_config = read_falco_config(pyproject_path)
+
             crud_utils = InstallCrudUtils().install(project_name=self.project_name, falco_config=falco_config)
+
+            env_file = Path(".env")
+            env_file.touch()
+            env_file_content = env_file.read_text()
+            env_template_file = Path(".env.template")
+            env_config = SyncDotenv().get_config(
+                env_content=env_file_content, env_template_content=env_template_file.read_text()
+            )
+            env_file.write_text(get_updated_dotenv(env_file_content, env_config))
+
             config = {
                 "crud": {"utils-path": str(crud_utils)},
                 **self.cruft_file_to_falco_config(git_installed),

src/falco/commands/sync_dotenv.py

@@ -38,21 +38,7 @@ def __call__(self, project_name: Annotated[str, cappa.Dep(get_project_name)]):
         dotenv_content = dotenv_file.read_text() if dotenv_file.exists() else ""
         dotenv_template_content = dotenv_template_file.read_text() if dotenv_template_file.exists() else ""
 
-        default_values = {
-            "DJANGO_DEBUG": True,
-            "DJANGO_ENV": "dev",
-            "DJANGO_SECRET_KEY": secrets.token_urlsafe(64),
-            "DJANGO_ALLOWED_HOSTS": "*",
-            "DATABASE_URL": "sqlite:///db.sqlite3",
-            "DJANGO_SUPERUSER_EMAIL": "",
-            "DJANGO_SUPERUSER_PASSWORD": "",
-        }
-
-        config = {
-            **parse(dotenv_template_content),
-            **default_values,
-            **parse(dotenv_content),
-        }
+        config = self.get_config(dotenv_content, dotenv_template_content)
 
         if self.fill_missing:
             for key, value in config.items():
@@ -78,6 +64,22 @@ def __call__(self, project_name: Annotated[str, cappa.Dep(get_project_name)]):
 
         rich_print(f"[green] {dotenv_file} and {dotenv_template_file} synchronised [/green]")
 
+    def get_config(self, env_content: str, env_template_content: str) -> dict:
+        default_values = {
+            "DJANGO_DEBUG": True,
+            "DJANGO_ENV": "dev",
+            "DJANGO_SECRET_KEY": secrets.token_urlsafe(64),
+            "DJANGO_ALLOWED_HOSTS": "*",
+            "DATABASE_URL": "sqlite:///db.sqlite3",
+            "DJANGO_SUPERUSER_EMAIL": "",
+            "DJANGO_SUPERUSER_PASSWORD": "",
+        }
+        return {
+            **parse(env_template_content),
+            **default_values,
+            **parse(env_content),
+        }
+
 
 def parse(env_content: str) -> dict:
     result = {}