plain.dev 0.0.1__tar.gz → 0.2.0__tar.gz

plain_dev-0.2.0/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.1
+Name: plain.dev
+Version: 0.2.0
+Summary: Local development tools for Plain.
+Home-page: https://plainframework.com
+License: BSD-3-Clause
+Author: Dave Gaeddert
+Author-email: dave.gaeddert@dropseed.dev
+Requires-Python: >=3.11,<4.0
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: click (>=8.0.0)
+Requires-Dist: debugpy (>=1.6.3,<2.0.0)
+Requires-Dist: gunicorn (>20)
+Requires-Dist: honcho (>=1.1.0,<2.0.0)
+Requires-Dist: plain (<1.0.0)
+Requires-Dist: psycopg2-binary (>=2.9.3,<3.0.0)
+Requires-Dist: requests (>=2.0.0)
+Requires-Dist: tomli (>=2.0.1,<3.0.0) ; python_version < "3.11"
+Project-URL: Documentation, https://plainframework.com/docs/
+Project-URL: Repository, https://github.com/dropseed/plain
+Description-Content-Type: text/markdown
+
+<!-- This file is compiled from plain-dev/plain/dev/README.md. Do not edit this file directly. -->
+
+# plain.dev
+
+A single command that runs everything you need for local development.
+
+![Plain dev command example](https://github.com/dropseed/plain/assets/649496/3643bb64-a99b-4a8e-adab-8c6b81791ea9)
+
+The `plain.dev` package can be [installed from PyPI](https://pypi.org/project/plain.dev/), and does *not* need to be added to `INSTALLED_PACKAGES`.
+
+- [`plain dev`](#plain-dev)
+- [`plain dev services`](#plain-dev-services)
+- [`plain pre-commit`](#plain-pre-commit)
+- [`plain contrib`](#plain-contrib)
+- [VS Code debugging](#vscode-debugging)
+
+## `plain dev`
+
+The `plain dev` command does several things:
+
+- Sets `PLAIN_CSRF_TRUSTED_ORIGINS` to localhost by default
+- Runs `plain preflight` to check for any issues
+- Executes any pending model migrations
+- Starts `gunicorn` with `--reload`
+- Runs `plain tailwind compile --watch`, if `plain.tailwind` is installed
+- Any custom process defined in `pyproject.toml` at `tool.plain.dev.run`
+- Necessary services (ex. Postgres) defined in `pyproject.toml` at `tool.plain.dev.services`
+
+### Services
+
+Use services to define databases or other processes that your app *needs* to be functional. The services will be started automatically in `plain dev`, but also in `plain pre-commit` (so preflight and tests have a database).
+
+Ultimately, how you run your development database is up to you. But a recommended starting point is to use Docker:
+
+```toml
+# pyproject.toml
+[tool.plain.dev.services]
+postgres = {cmd = "docker run --name app-postgres --rm -p 54321:5432 -v $(pwd)/.plain/dev/pgdata:/var/lib/postgresql/data -e POSTGRES_PASSWORD=postgres postgres:15 postgres"}
+```
+
+### Custom processes
+
+Unlike [services](#services), custom processes are *only* run during `plain dev`. This is a good place to run something like [ngrok](https://ngrok.com/) or a [Plain worker](../../../plain-worker), which you might need to use your local site, but don't need running for executing tests, for example.
+
+```toml
+# pyproject.toml
+[tool.plain.dev.run]
+ngrok = {command = "ngrok http $PORT"}
+```
+
+## `plain dev services`
+
+Starts your [services](#services) by themselves.
+
+## `plain pre-commit`
+
+A built-in pre-commit hook that can be installed with `plain pre-commit --install`.
+
+Runs:
+
+- Custom commands defined in `pyproject.toml` at `tool.plain.pre-commit.run`
+- `plain code check`, if [`plain.code`](https://plainframework.com/docs/plain-code/plain/code/) is installed
+- `poetry check --lock`, if using [Poetry](https://python-poetry.org/)
+- `plain preflight --database default`
+- `plain legacy migrate --check`
+- `plain legacy makemigrations --dry-run --check`
+- `plain compile`
+- `plain test`
+
+## VS Code debugging
+
+![Debug Plain with VS Code](https://github.com/dropseed/plain-public/assets/649496/250138b6-7702-4ab6-bf38-e0c8e3c56d06)
+
+Since `plain dev` runs multiple processes at once, the regular [pdb](https://docs.python.org/3/library/pdb.html) debuggers don't quite work.
+
+Instead, we include [microsoft/debugpy](https://github.com/microsoft/debugpy) and an `attach` function to make it even easier to use VS Code's debugger.
+
+First, import and run the `debug.attach()` function:
+
+```python
+class HomeView(TemplateView):
+    template_name = "home.html"
+
+    def get_template_context(self):
+        context = super().get_template_context()
+
+        # Make sure the debugger is attached (will need to be if runserver reloads)
+        from plain.dev import debug; debug.attach()
+
+        # Add a breakpoint (or use the gutter in VS Code to add one)
+        breakpoint()
+
+        return context
+```
+
+When you load the page, you'll see "Waiting for debugger to attach...".
+
+You can then run the VS Code debugger and attach to an existing Python process, at localhost:5678.
+

plain_dev-0.2.0/README.md

@@ -0,0 +1,98 @@
+<!-- This file is compiled from plain-dev/plain/dev/README.md. Do not edit this file directly. -->
+
+# plain.dev
+
+A single command that runs everything you need for local development.
+
+![Plain dev command example](https://github.com/dropseed/plain/assets/649496/3643bb64-a99b-4a8e-adab-8c6b81791ea9)
+
+The `plain.dev` package can be [installed from PyPI](https://pypi.org/project/plain.dev/), and does *not* need to be added to `INSTALLED_PACKAGES`.
+
+- [`plain dev`](#plain-dev)
+- [`plain dev services`](#plain-dev-services)
+- [`plain pre-commit`](#plain-pre-commit)
+- [`plain contrib`](#plain-contrib)
+- [VS Code debugging](#vscode-debugging)
+
+## `plain dev`
+
+The `plain dev` command does several things:
+
+- Sets `PLAIN_CSRF_TRUSTED_ORIGINS` to localhost by default
+- Runs `plain preflight` to check for any issues
+- Executes any pending model migrations
+- Starts `gunicorn` with `--reload`
+- Runs `plain tailwind compile --watch`, if `plain.tailwind` is installed
+- Any custom process defined in `pyproject.toml` at `tool.plain.dev.run`
+- Necessary services (ex. Postgres) defined in `pyproject.toml` at `tool.plain.dev.services`
+
+### Services
+
+Use services to define databases or other processes that your app *needs* to be functional. The services will be started automatically in `plain dev`, but also in `plain pre-commit` (so preflight and tests have a database).
+
+Ultimately, how you run your development database is up to you. But a recommended starting point is to use Docker:
+
+```toml
+# pyproject.toml
+[tool.plain.dev.services]
+postgres = {cmd = "docker run --name app-postgres --rm -p 54321:5432 -v $(pwd)/.plain/dev/pgdata:/var/lib/postgresql/data -e POSTGRES_PASSWORD=postgres postgres:15 postgres"}
+```
+
+### Custom processes
+
+Unlike [services](#services), custom processes are *only* run during `plain dev`. This is a good place to run something like [ngrok](https://ngrok.com/) or a [Plain worker](../../../plain-worker), which you might need to use your local site, but don't need running for executing tests, for example.
+
+```toml
+# pyproject.toml
+[tool.plain.dev.run]
+ngrok = {command = "ngrok http $PORT"}
+```
+
+## `plain dev services`
+
+Starts your [services](#services) by themselves.
+
+## `plain pre-commit`
+
+A built-in pre-commit hook that can be installed with `plain pre-commit --install`.
+
+Runs:
+
+- Custom commands defined in `pyproject.toml` at `tool.plain.pre-commit.run`
+- `plain code check`, if [`plain.code`](https://plainframework.com/docs/plain-code/plain/code/) is installed
+- `poetry check --lock`, if using [Poetry](https://python-poetry.org/)
+- `plain preflight --database default`
+- `plain legacy migrate --check`
+- `plain legacy makemigrations --dry-run --check`
+- `plain compile`
+- `plain test`
+
+## VS Code debugging
+
+![Debug Plain with VS Code](https://github.com/dropseed/plain-public/assets/649496/250138b6-7702-4ab6-bf38-e0c8e3c56d06)
+
+Since `plain dev` runs multiple processes at once, the regular [pdb](https://docs.python.org/3/library/pdb.html) debuggers don't quite work.
+
+Instead, we include [microsoft/debugpy](https://github.com/microsoft/debugpy) and an `attach` function to make it even easier to use VS Code's debugger.
+
+First, import and run the `debug.attach()` function:
+
+```python
+class HomeView(TemplateView):
+    template_name = "home.html"
+
+    def get_template_context(self):
+        context = super().get_template_context()
+
+        # Make sure the debugger is attached (will need to be if runserver reloads)
+        from plain.dev import debug; debug.attach()
+
+        # Add a breakpoint (or use the gutter in VS Code to add one)
+        breakpoint()
+
+        return context
+```
+
+When you load the page, you'll see "Waiting for debugger to attach...".
+
+You can then run the VS Code debugger and attach to an existing Python process, at localhost:5678.

plain_dev-0.2.0/plain/dev/README.md

@@ -0,0 +1,96 @@
+# plain.dev
+
+A single command that runs everything you need for local development.
+
+![Plain dev command example](https://github.com/dropseed/plain/assets/649496/3643bb64-a99b-4a8e-adab-8c6b81791ea9)
+
+The `plain.dev` package can be [installed from PyPI](https://pypi.org/project/plain.dev/), and does *not* need to be added to `INSTALLED_PACKAGES`.
+
+- [`plain dev`](#plain-dev)
+- [`plain dev services`](#plain-dev-services)
+- [`plain pre-commit`](#plain-pre-commit)
+- [`plain contrib`](#plain-contrib)
+- [VS Code debugging](#vscode-debugging)
+
+## `plain dev`
+
+The `plain dev` command does several things:
+
+- Sets `PLAIN_CSRF_TRUSTED_ORIGINS` to localhost by default
+- Runs `plain preflight` to check for any issues
+- Executes any pending model migrations
+- Starts `gunicorn` with `--reload`
+- Runs `plain tailwind compile --watch`, if `plain.tailwind` is installed
+- Any custom process defined in `pyproject.toml` at `tool.plain.dev.run`
+- Necessary services (ex. Postgres) defined in `pyproject.toml` at `tool.plain.dev.services`
+
+### Services
+
+Use services to define databases or other processes that your app *needs* to be functional. The services will be started automatically in `plain dev`, but also in `plain pre-commit` (so preflight and tests have a database).
+
+Ultimately, how you run your development database is up to you. But a recommended starting point is to use Docker:
+
+```toml
+# pyproject.toml
+[tool.plain.dev.services]
+postgres = {cmd = "docker run --name app-postgres --rm -p 54321:5432 -v $(pwd)/.plain/dev/pgdata:/var/lib/postgresql/data -e POSTGRES_PASSWORD=postgres postgres:15 postgres"}
+```
+
+### Custom processes
+
+Unlike [services](#services), custom processes are *only* run during `plain dev`. This is a good place to run something like [ngrok](https://ngrok.com/) or a [Plain worker](../../../plain-worker), which you might need to use your local site, but don't need running for executing tests, for example.
+
+```toml
+# pyproject.toml
+[tool.plain.dev.run]
+ngrok = {command = "ngrok http $PORT"}
+```
+
+## `plain dev services`
+
+Starts your [services](#services) by themselves.
+
+## `plain pre-commit`
+
+A built-in pre-commit hook that can be installed with `plain pre-commit --install`.
+
+Runs:
+
+- Custom commands defined in `pyproject.toml` at `tool.plain.pre-commit.run`
+- `plain code check`, if [`plain.code`](https://plainframework.com/docs/plain-code/plain/code/) is installed
+- `poetry check --lock`, if using [Poetry](https://python-poetry.org/)
+- `plain preflight --database default`
+- `plain legacy migrate --check`
+- `plain legacy makemigrations --dry-run --check`
+- `plain compile`
+- `plain test`
+
+## VS Code debugging
+
+![Debug Plain with VS Code](https://github.com/dropseed/plain-public/assets/649496/250138b6-7702-4ab6-bf38-e0c8e3c56d06)
+
+Since `plain dev` runs multiple processes at once, the regular [pdb](https://docs.python.org/3/library/pdb.html) debuggers don't quite work.
+
+Instead, we include [microsoft/debugpy](https://github.com/microsoft/debugpy) and an `attach` function to make it even easier to use VS Code's debugger.
+
+First, import and run the `debug.attach()` function:
+
+```python
+class HomeView(TemplateView):
+    template_name = "home.html"
+
+    def get_template_context(self):
+        context = super().get_template_context()
+
+        # Make sure the debugger is attached (will need to be if runserver reloads)
+        from plain.dev import debug; debug.attach()
+
+        # Add a breakpoint (or use the gutter in VS Code to add one)
+        breakpoint()
+
+        return context
+```
+
+When you load the page, you'll see "Waiting for debugger to attach...".
+
+You can then run the VS Code debugger and attach to an existing Python process, at localhost:5678.

{plain_dev-0.0.1 → plain_dev-0.2.0}/plain/dev/precommit/cli.py

@@ -61,7 +61,7 @@ def cli(install):
             check_short("Running plain code checks", "plain", "code", "check")
 
         if Path("poetry.lock").exists():
-            check_short("Checking poetry.lock", "poetry", "lock", "--check")
+            check_short("Checking poetry.lock", "poetry", "check", "--lock")
 
         if plain_db_connected():
             check_short(

{plain_dev-0.0.1 → plain_dev-0.2.0}/pyproject.toml

@@ -5,14 +5,14 @@ packages = [
     { include = "plain" },
 ]
 
-version = "0.0.1"
-description = "Work library for Plain"
+version = "0.2.0"
+description = "Local development tools for Plain."
 authors = ["Dave Gaeddert <dave.gaeddert@dropseed.dev>"]
-license = "MIT"
+license = "BSD-3-Clause"
 readme = "README.md"
-homepage = "https://www.plainpackages.com/"
-documentation = "https://www.plainpackages.com/docs/"
-repository = "https://github.com/plainpackages/plain-dev"
+homepage = "https://plainframework.com"
+documentation = "https://plainframework.com/docs/"
+repository = "https://github.com/dropseed/plain"
 
 # Make the CLI available without adding to INSTALLED_APPS
 [tool.poetry.plugins."plain.cli"]
@@ -21,7 +21,10 @@ repository = "https://github.com/plainpackages/plain-dev"
 "contrib" = "plain.dev.contribute:cli"
 
 [tool.poetry.dependencies]
-python = "^3.8"
+python = "^3.11"
+
+plain = "<1.0.0"
+
 click = ">=8.0.0"
 honcho = "^1.1.0"
 debugpy = "^1.6.3"
@@ -36,7 +39,9 @@ requests = ">=2.0.0"
 psycopg2-binary = "^2.9.3"
 
 
-[tool.poetry.dev-dependencies]
+[tool.poetry.group.dev.dependencies]
+plain = {path = "../plain", develop = true}
+
 pytest = "^7.1.2"
 ipdb = "^0.13.9"
 

plain_dev-0.0.1/PKG-INFO

@@ -1,178 +0,0 @@
-Metadata-Version: 2.1
-Name: plain.dev
-Version: 0.0.1
-Summary: Work library for Plain
-Home-page: https://www.plainpackages.com/
-License: MIT
-Author: Dave Gaeddert
-Author-email: dave.gaeddert@dropseed.dev
-Requires-Python: >=3.8,<4.0
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: click (>=8.0.0)
-Requires-Dist: debugpy (>=1.6.3,<2.0.0)
-Requires-Dist: gunicorn (>20)
-Requires-Dist: honcho (>=1.1.0,<2.0.0)
-Requires-Dist: psycopg2-binary (>=2.9.3,<3.0.0)
-Requires-Dist: requests (>=2.0.0)
-Requires-Dist: tomli (>=2.0.1,<3.0.0) ; python_version < "3.11"
-Project-URL: Documentation, https://www.plainpackages.com/docs/
-Project-URL: Repository, https://github.com/plainpackages/plain-dev
-Description-Content-Type: text/markdown
-
-<!-- This file is compiled from plain-dev/plain/dev/README.md. Do not edit this file directly. -->
-
-# plain-dev
-
-A single command to run everything you need for local Plain development.
-
-![Plain work command example](https://user-images.githubusercontent.com/649496/176533533-cfd44dc5-afe5-42af-8b5d-33a9fa23f8d9.gif)
-
-The `plain dev` command runs a combination of local commands + a Docker container for your database.
-
-The following processes will run simultaneously (some will only run if they are detected as available):
-
-<!-- - [`manage.py runserver` (and migrations)](#runserver)
-- [`plain-models start --logs`](#plain-models)
-- [`plain-tailwind compile --watch`](#plain-tailwind)
-- [`npm run watch`](#package-json)
-- [`stripe listen --forward-to`](#stripe)
-- [`ngrok http --subdomain`](#ngrok)
-
-It also comes with [debugging](#debugging) tools to make local debugging easier with VS Code. -->
-
-## Installation
-
-```sh
-pip install plain-dev
-```
-
-If you have `plain-models` installed (i.e. you're using a database),
-then add `DATABASE_URL` to your `.env` file.
-
-```sh
-DATABASE_URL=postgres://postgres:postgres@localhost:54321/postgres
-```
-
-```toml
-# pyproject.toml
-[tool.plain.dev.services]
-postgres = {cmd = "docker run --name app-postgres --rm -p 54321:5432 -v $(pwd)/.plain/dev/pgdata:/var/lib/postgresql/data -e POSTGRES_PASSWORD=postgres postgres:15 postgres"}
-```
-
-```sh
-plain dev
-```
-
-## `plain dev`
-
-### Default processes
-
-- plain preflight
-- gunicorn
-- migrations
-- tailwind
-
-### Custom processes
-
-- package.json "dev" script
-- pyproject.toml `tool.plain.dev.run = {command = "..."}`
-
-### GitHub Codespaces
-
-The `BASE_URL` setting is automatically set to the Codespace URL.
-
-TODO
-
-## `plain dev db`
-
-Only supports Postgres currently.
-
-- snapshot
-- import
-- export
-
-
-## Development processes
-
-### Gunicorn
-
-The key process here is still `manage.py runserver`.
-But, before that runs, it will also wait for the database to be available and run `manage.py migrate`.
-
-### plain-models
-
-If [`plain-models`](https://github.com/plainpackages/plain-models) is installed, it will automatically start and show the logs of the running database container.
-
-### plain-tailwind
-
-If [`plain-tailwind`](https://github.com/plainpackages/plain-tailwind) is installed, it will automatically run the Tailwind `compile --watch` process.
-
-## Debugging
-
-[View on YouTube →](https://www.youtube.com/watch?v=pG0KaJSVyBw)
-
-Since `plain work` runs multiple processes at once, the regular [pdb](https://docs.python.org/3/library/pdb.html) debuggers can be hard to use.
-Instead, we include [microsoft/debugpy](https://github.com/microsoft/debugpy) and an `attach` function to make it even easier to use VS Code's debugger.
-
-First, import and run the `debug.attach()` function:
-
-```python
-class HomeView(TemplateView):
-    template_name = "home.html"
-
-    def get_context(self, **kwargs):
-        context = super().get_context(**kwargs)
-
-        # Make sure the debugger is attached (will need to be if runserver reloads)
-        from plain.work import debug; debug.attach()
-
-        # Add a breakpoint (or use the gutter in VSCode to add one)
-        breakpoint()
-
-        return context
-```
-
-When you load the page, you'll see "Waiting for debugger to attach...".
-
-Add a new VS Code debug configuration (using localhost and port 5768) by saving this to `.vscode/launch.json` or using the GUI:
-
-```json
-// .vscode/launch.json
-{
-    // Use IntelliSense to learn about possible attributes.
-    // Hover to view descriptions of existing attributes.
-    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "name": "Plain: Attach to Django",
-            "type": "python",
-            "request": "attach",
-            "connect": {
-                "host": "localhost",
-                "port": 5678
-            },
-            "pathMappings": [
-                {
-                    "localRoot": "${workspaceFolder}",
-                    "remoteRoot": "."
-                }
-            ],
-            "justMyCode": true,
-            "django": true
-        }
-    ]
-}
-```
-
-Then in the "Run and Debug" tab, you can click the green arrow next to "Plain: Attach to Django" to start the debugger.
-
-In your terminal is should tell you it was attached, and when you hit a breakpoint you'll see the debugger information in VS Code.
-If Django's runserver reloads, you'll be prompted to reattach by clicking the green arrow again.
-

plain_dev-0.0.1/README.md

@@ -1,150 +0,0 @@
-<!-- This file is compiled from plain-dev/plain/dev/README.md. Do not edit this file directly. -->
-
-# plain-dev
-
-A single command to run everything you need for local Plain development.
-
-![Plain work command example](https://user-images.githubusercontent.com/649496/176533533-cfd44dc5-afe5-42af-8b5d-33a9fa23f8d9.gif)
-
-The `plain dev` command runs a combination of local commands + a Docker container for your database.
-
-The following processes will run simultaneously (some will only run if they are detected as available):
-
-<!-- - [`manage.py runserver` (and migrations)](#runserver)
-- [`plain-models start --logs`](#plain-models)
-- [`plain-tailwind compile --watch`](#plain-tailwind)
-- [`npm run watch`](#package-json)
-- [`stripe listen --forward-to`](#stripe)
-- [`ngrok http --subdomain`](#ngrok)
-
-It also comes with [debugging](#debugging) tools to make local debugging easier with VS Code. -->
-
-## Installation
-
-```sh
-pip install plain-dev
-```
-
-If you have `plain-models` installed (i.e. you're using a database),
-then add `DATABASE_URL` to your `.env` file.
-
-```sh
-DATABASE_URL=postgres://postgres:postgres@localhost:54321/postgres
-```
-
-```toml
-# pyproject.toml
-[tool.plain.dev.services]
-postgres = {cmd = "docker run --name app-postgres --rm -p 54321:5432 -v $(pwd)/.plain/dev/pgdata:/var/lib/postgresql/data -e POSTGRES_PASSWORD=postgres postgres:15 postgres"}
-```
-
-```sh
-plain dev
-```
-
-## `plain dev`
-
-### Default processes
-
-- plain preflight
-- gunicorn
-- migrations
-- tailwind
-
-### Custom processes
-
-- package.json "dev" script
-- pyproject.toml `tool.plain.dev.run = {command = "..."}`
-
-### GitHub Codespaces
-
-The `BASE_URL` setting is automatically set to the Codespace URL.
-
-TODO
-
-## `plain dev db`
-
-Only supports Postgres currently.
-
-- snapshot
-- import
-- export
-
-
-## Development processes
-
-### Gunicorn
-
-The key process here is still `manage.py runserver`.
-But, before that runs, it will also wait for the database to be available and run `manage.py migrate`.
-
-### plain-models
-
-If [`plain-models`](https://github.com/plainpackages/plain-models) is installed, it will automatically start and show the logs of the running database container.
-
-### plain-tailwind
-
-If [`plain-tailwind`](https://github.com/plainpackages/plain-tailwind) is installed, it will automatically run the Tailwind `compile --watch` process.
-
-## Debugging
-
-[View on YouTube →](https://www.youtube.com/watch?v=pG0KaJSVyBw)
-
-Since `plain work` runs multiple processes at once, the regular [pdb](https://docs.python.org/3/library/pdb.html) debuggers can be hard to use.
-Instead, we include [microsoft/debugpy](https://github.com/microsoft/debugpy) and an `attach` function to make it even easier to use VS Code's debugger.
-
-First, import and run the `debug.attach()` function:
-
-```python
-class HomeView(TemplateView):
-    template_name = "home.html"
-
-    def get_context(self, **kwargs):
-        context = super().get_context(**kwargs)
-
-        # Make sure the debugger is attached (will need to be if runserver reloads)
-        from plain.work import debug; debug.attach()
-
-        # Add a breakpoint (or use the gutter in VSCode to add one)
-        breakpoint()
-
-        return context
-```
-
-When you load the page, you'll see "Waiting for debugger to attach...".
-
-Add a new VS Code debug configuration (using localhost and port 5768) by saving this to `.vscode/launch.json` or using the GUI:
-
-```json
-// .vscode/launch.json
-{
-    // Use IntelliSense to learn about possible attributes.
-    // Hover to view descriptions of existing attributes.
-    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "name": "Plain: Attach to Django",
-            "type": "python",
-            "request": "attach",
-            "connect": {
-                "host": "localhost",
-                "port": 5678
-            },
-            "pathMappings": [
-                {
-                    "localRoot": "${workspaceFolder}",
-                    "remoteRoot": "."
-                }
-            ],
-            "justMyCode": true,
-            "django": true
-        }
-    ]
-}
-```
-
-Then in the "Run and Debug" tab, you can click the green arrow next to "Plain: Attach to Django" to start the debugger.
-
-In your terminal is should tell you it was attached, and when you hit a breakpoint you'll see the debugger information in VS Code.
-If Django's runserver reloads, you'll be prompted to reattach by clicking the green arrow again.

plain_dev-0.0.1/plain/dev/README.md

@@ -1,148 +0,0 @@
-# plain-dev
-
-A single command to run everything you need for local Plain development.
-
-![Plain work command example](https://user-images.githubusercontent.com/649496/176533533-cfd44dc5-afe5-42af-8b5d-33a9fa23f8d9.gif)
-
-The `plain dev` command runs a combination of local commands + a Docker container for your database.
-
-The following processes will run simultaneously (some will only run if they are detected as available):
-
-<!-- - [`manage.py runserver` (and migrations)](#runserver)
-- [`plain-models start --logs`](#plain-models)
-- [`plain-tailwind compile --watch`](#plain-tailwind)
-- [`npm run watch`](#package-json)
-- [`stripe listen --forward-to`](#stripe)
-- [`ngrok http --subdomain`](#ngrok)
-
-It also comes with [debugging](#debugging) tools to make local debugging easier with VS Code. -->
-
-## Installation
-
-```sh
-pip install plain-dev
-```
-
-If you have `plain-models` installed (i.e. you're using a database),
-then add `DATABASE_URL` to your `.env` file.
-
-```sh
-DATABASE_URL=postgres://postgres:postgres@localhost:54321/postgres
-```
-
-```toml
-# pyproject.toml
-[tool.plain.dev.services]
-postgres = {cmd = "docker run --name app-postgres --rm -p 54321:5432 -v $(pwd)/.plain/dev/pgdata:/var/lib/postgresql/data -e POSTGRES_PASSWORD=postgres postgres:15 postgres"}
-```
-
-```sh
-plain dev
-```
-
-## `plain dev`
-
-### Default processes
-
-- plain preflight
-- gunicorn
-- migrations
-- tailwind
-
-### Custom processes
-
-- package.json "dev" script
-- pyproject.toml `tool.plain.dev.run = {command = "..."}`
-
-### GitHub Codespaces
-
-The `BASE_URL` setting is automatically set to the Codespace URL.
-
-TODO
-
-## `plain dev db`
-
-Only supports Postgres currently.
-
-- snapshot
-- import
-- export
-
-
-## Development processes
-
-### Gunicorn
-
-The key process here is still `manage.py runserver`.
-But, before that runs, it will also wait for the database to be available and run `manage.py migrate`.
-
-### plain-models
-
-If [`plain-models`](https://github.com/plainpackages/plain-models) is installed, it will automatically start and show the logs of the running database container.
-
-### plain-tailwind
-
-If [`plain-tailwind`](https://github.com/plainpackages/plain-tailwind) is installed, it will automatically run the Tailwind `compile --watch` process.
-
-## Debugging
-
-[View on YouTube →](https://www.youtube.com/watch?v=pG0KaJSVyBw)
-
-Since `plain work` runs multiple processes at once, the regular [pdb](https://docs.python.org/3/library/pdb.html) debuggers can be hard to use.
-Instead, we include [microsoft/debugpy](https://github.com/microsoft/debugpy) and an `attach` function to make it even easier to use VS Code's debugger.
-
-First, import and run the `debug.attach()` function:
-
-```python
-class HomeView(TemplateView):
-    template_name = "home.html"
-
-    def get_context(self, **kwargs):
-        context = super().get_context(**kwargs)
-
-        # Make sure the debugger is attached (will need to be if runserver reloads)
-        from plain.work import debug; debug.attach()
-
-        # Add a breakpoint (or use the gutter in VSCode to add one)
-        breakpoint()
-
-        return context
-```
-
-When you load the page, you'll see "Waiting for debugger to attach...".
-
-Add a new VS Code debug configuration (using localhost and port 5768) by saving this to `.vscode/launch.json` or using the GUI:
-
-```json
-// .vscode/launch.json
-{
-    // Use IntelliSense to learn about possible attributes.
-    // Hover to view descriptions of existing attributes.
-    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "name": "Plain: Attach to Django",
-            "type": "python",
-            "request": "attach",
-            "connect": {
-                "host": "localhost",
-                "port": 5678
-            },
-            "pathMappings": [
-                {
-                    "localRoot": "${workspaceFolder}",
-                    "remoteRoot": "."
-                }
-            ],
-            "justMyCode": true,
-            "django": true
-        }
-    ]
-}
-```
-
-Then in the "Run and Debug" tab, you can click the green arrow next to "Plain: Attach to Django" to start the debugger.
-
-In your terminal is should tell you it was attached, and when you hit a breakpoint you'll see the debugger information in VS Code.
-If Django's runserver reloads, you'll be prompted to reattach by clicking the green arrow again.