feat: add update command

docs/requirements.txt

@@ -1,7 +1,7 @@
 #
 # This file is autogenerated by hatch-pip-compile with Python 3.12
 #
-# [constraints] requirements.txt (SHA256: 46a5e85c2e204a780e967f13eea604515f17aaf08e510c0a08060d9e93c60039)
+# [constraints] requirements.txt (SHA256: d6147fe36a113178ba35ce440afb64c9866486184a83096746369cd12e2fad2a)
 #
 # - sphinx
 # - sphinx-autobuild
@@ -20,6 +20,7 @@
 # - black
 # - cappa
 # - cookiecutter
+# - cruft
 # - djlint
 # - honcho
 # - httpx
@@ -37,6 +38,8 @@ anyio==4.4.0
     #   httpx
     #   starlette
     #   watchfiles
+appnope==0.1.4
+    # via ipykernel
 arrow==1.3.0
     # via
     #   -c requirements.txt
@@ -90,7 +93,9 @@ click==8.1.7
     #   -c requirements.txt
     #   black
     #   cookiecutter
+    #   cruft
     #   djlint
+    #   typer
     #   uvicorn
 colorama==0.4.6
     # via
@@ -105,6 +110,11 @@ cookiecutter==2.6.0
     # via
     #   -c requirements.txt
     #   hatch.envs.docs
+    #   cruft
+cruft==2.15.0
+    # via
+    #   -c requirements.txt
+    #   hatch.envs.docs
 cssbeautifier==1.15.1
     # via
     #   -c requirements.txt
@@ -139,6 +149,14 @@ executing==2.1.0
     #   stack-data
 fastjsonschema==2.20.0
     # via nbformat
+gitdb==4.0.11
+    # via
+    #   -c requirements.txt
+    #   gitpython
+gitpython==3.1.43
+    # via
+    #   -c requirements.txt
+    #   cruft
 h11==0.14.0
     # via
     #   -c requirements.txt
@@ -364,12 +382,17 @@ rich==13.8.0
     #   hatch.envs.docs
     #   cappa
     #   cookiecutter
+    #   typer
 rpds-py==0.20.0
     # via
     #   jsonschema
     #   referencing
 setuptools==74.1.1
     # via sphinx-togglebutton
+shellingham==1.5.4
+    # via
+    #   -c requirements.txt
+    #   typer
 shibuya==2024.8.30
     # via hatch.envs.docs
 six==1.16.0
@@ -380,6 +403,10 @@ six==1.16.0
     #   cssbeautifier
     #   jsbeautifier
     #   python-dateutil
+smmap==5.0.1
+    # via
+    #   -c requirements.txt
+    #   gitdb
 sniffio==1.3.1
     # via
     #   -c requirements.txt
@@ -466,6 +493,10 @@ traitlets==5.14.3
     #   nbclient
     #   nbconvert
     #   nbformat
+typer==0.12.5
+    # via
+    #   -c requirements.txt
+    #   cruft
 types-python-dateutil==2.9.0.20240821
     # via
     #   -c requirements.txt
@@ -474,6 +505,7 @@ typing-extensions==4.12.2
     # via
     #   -c requirements.txt
     #   cappa
+    #   typer
     #   typing-inspect
 typing-inspect==0.9.0
     # via

docs/the_cli/start_project/index.rst

@@ -32,6 +32,18 @@ can still bring you value.
    configuration. If you haven't set it yet, `see this page <https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup#_your_identity>`_.
 
 
+.. admonition:: Experimental
+  :class: important
+
+  You can update your project to stay current with the latest changes in the project starter. Please note that this is an experimental feature. Ensure you commit your 
+  changes before running the command. If there are conflicts, `.rej` files will be generated, which you will need to review and manually update the corresponding files 
+  if necessary.
+
+  .. code-block:: shell
+
+    falco update-project  
+
+
 The subsequent sections will delve deeper into the folder structure, package choices, and provide guidance on deploying your project.
 
 Alternative starters

justfile

@@ -4,6 +4,9 @@ default := "blueprints/falco_tailwind"
 _default:
     @just --list
 
+@install:
+    hatch run python --version
+
 # Install dependencies
 @bootstrap:
     hatch env create

pyproject.toml

@@ -42,6 +42,7 @@ dependencies = [
   "black",
   "cappa",
   "cookiecutter",
+  "cruft",
   "djlint",
   "honcho",
   "httpx",

requirements.txt

@@ -17,6 +17,7 @@
 # - black
 # - cappa
 # - cookiecutter
+# - cruft
 # - djlint
 # - honcho
 # - httpx
@@ -66,16 +67,21 @@ click==8.1.7
     #   black
     #   bump-my-version
     #   cookiecutter
+    #   cruft
     #   djlint
     #   rich-click
+    #   typer
 colorama==0.4.6
     # via djlint
 cookiecutter==2.6.0
     # via
     #   hatch.envs.default
+    #   cruft
     #   pytest-cookies
 coverage==7.6.1
     # via hatch.envs.default
+cruft==2.15.0
+    # via hatch.envs.default
 cssbeautifier==1.15.1
     # via djlint
 decorator==5.1.1
@@ -106,6 +112,10 @@ executing==2.1.0
     # via stack-data
 filelock==3.15.4
     # via virtualenv
+gitdb==4.0.11
+    # via gitpython
+gitpython==3.1.43
+    # via cruft
 h11==0.14.0
     # via httpcore
 honcho==1.1.0
@@ -236,14 +246,19 @@ rich==13.8.0
     #   cappa
     #   cookiecutter
     #   rich-click
+    #   typer
 rich-click==1.8.3
     # via bump-my-version
+shellingham==1.5.4
+    # via typer
 six==1.16.0
     # via
     #   asttokens
     #   cssbeautifier
     #   jsbeautifier
     #   python-dateutil
+smmap==5.0.1
+    # via gitdb
 sniffio==1.3.1
     # via
     #   anyio
@@ -264,6 +279,8 @@ traitlets==5.14.3
     # via
     #   ipython
     #   matplotlib-inline
+typer==0.12.5
+    # via cruft
 types-python-dateutil==2.9.0.20240821
     # via arrow
 typing-extensions==4.12.2
@@ -272,6 +289,7 @@ typing-extensions==4.12.2
     #   pydantic
     #   pydantic-core
     #   rich-click
+    #   typer
     #   typing-inspect
 typing-inspect==0.9.0
     # via cappa

src/falco/__main__.py

@@ -8,6 +8,7 @@
 from falco.commands import StartApp
 from falco.commands import StartProject
 from falco.commands import SyncDotenv
+from falco.commands import UpdateProject
 from falco.commands import Work
 
 
@@ -17,6 +18,7 @@
 class Falco:
     subcommand: cappa.Subcommands[
         StartProject
+        | UpdateProject
         | StartApp
         | ModelCRUD
         | InstallCrudUtils

src/falco/commands/__init__.py

@@ -7,4 +7,5 @@
 from .start_app import StartApp  # noqa
 from .start_project import StartProject  # noqa
 from .sync_dotenv import SyncDotenv  # noqa
+from .update_project import UpdateProject  # noqa
 from .work import Work  # noqa