# Model W Project Maker
This project maker is the simplest way to start a
[Model W](https://model-w.readthedocs.io/en/latest/) project.
The goal is to be extremely simple:
```bash
curl -s https://pypi.run/modelw-project-maker/model_w.project_maker | python3.11
```
This will ask you a few questions and create the project's directory for you.
## Prerequisites
In order to execute the script, you need:
- Python 3.11 (you can use pyenv to load it in your current shell)
- Poetry (follow the instructions on
[their website](https://python-poetry.org/docs/#installation))
- Git (you know where to get it)
- Git Flow (`apt install git-flow` or `brew install git-flow` depending on
your OS)
- Node and NPM (get it your favorite way)
- PostgreSQL and Redis (if you enable the API side)
## What to do next
Once the script is done, you'll have a directory with the project's name. You
can then `cd` into it and start working on it.
### Environment setup
You can start by installing the dependencies:
```bash
# If you enabled the API
cd api
poetry install
cd ..
# If you enabled the frontend
cd front
npm install
```
If you enabled the API, you then need to create the database:
```bash
sudo -u postgres psql -c "CREATE DATABASE <project_name>"
sudo -u postgres psql -c "CREATE USER <project_name> WITH LOGIN PASSWORD '<project_name>'"
sudo -u postgres psql -c "GRANT ALL PRIVILEGES ON DATABASE <project_name> TO <project_name>"
```
Finally, have a look at `api/.env` and/or `front/.env` and make sure that values
there are correct.
For the Django side, until you add more settings by yourself to `settings.py`,
you can use all the settings from the
[Model W Django Preset](https://modelw-django-preset.readthedocs.io/en/latest/).
If you've enabled Wagtail, you need to configure the
[storage environment variables](https://modelw-django-preset.readthedocs.io/en/latest/storage.html),
which should be commented out in your `.env`. You need to check with someone in
charge of the infrastructure to get those values (if it's yourself, you're in
luck).
### Django models customization
Something important in Django is to customize the User model to your needs. Even
if you don't need it right now, you'll eventually be happy that you did it
because you'll _always_ need to add fields to it.
Thus one of the first things you should do is to go check in the `people` app's
models the custom `User` model that is provided by default in this template.
Modify it to your needs.
> **Note** — If you modify the User model and you are not satisfied with
> the initial migration then you can delete it and create it anew. The only
> thing is that you'll have to manually add `CreateExtension("citext")` on top
> of the operations list in the `0001_initial.py` migration file.
If you've enabled Wagtail, the same applies for the `Image` and `Document`
models present in the `cms` app.
Still in Wagtail, the root page is replaced by a `HomePage` (defined in
`cms/models.py`) in one of the migrations generated by the template. If that's
not okay for you, now is the time to change it. However most likely it's going
to be convenient for you, because otherwise you'll need to do it manually in
Wagtail's admin. The only drawback is that when you'll want to add fields to the
`HomePage` you will have to figure default values.
Once you've adjusted all the models to your needs, feel free to make the
migrations and run them:
```bash
api/pmanage makemigrations
api/pmanage migrate
```
> **Note** — You'll notice that there is a `pmanage` script in addition of
> the `manage.py` script. It's simply a wrapper to call `manage.py` through the
> Poetry virtual environment.
### SvelteKit/Wagtail integration
If you have chosen a CMS, there will be a SvelteKit/Wagtail integration, using
Wagtail's v2 API.
A [...cmsPath] directory will be created in the `front` directory, which is a
catch-all for all the CMS paths.
Inside, `$lib/components/` there is a `cms` directory, which contains the Svelte
components for the CMS such as blocks and pages.
To make a CMS page work, create a component in the `cms` directory with the same
name as the Wagtail page type, and it will automatically be imported and
rendered when landing on a page of that type.
## Contributing
If you're developing this package and you want to make a release, you can simply
run:
```bash
make release VERSION=<version>
```
Then you'll still need to push the branches and tags.
Raw data
{
"_id": null,
"home_page": "https://github.com/ModelW/project-maker",
"name": "modelw-project-maker",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.11",
"maintainer_email": null,
"keywords": "model-w, django, nuxt, boilerplate, template",
"author": "R\u00e9my Sanchez",
"author_email": "remy.sanchez@hyperthese.net",
"download_url": "https://files.pythonhosted.org/packages/b8/b9/e1be3350ad3d9ead2139cd1eded14ff98995ae835fe0b39b3ef4f5711c44/modelw_project_maker-2024.10.1.tar.gz",
"platform": null,
"description": "# Model W Project Maker\n\nThis project maker is the simplest way to start a\n[Model W](https://model-w.readthedocs.io/en/latest/) project.\n\nThe goal is to be extremely simple:\n\n```bash\ncurl -s https://pypi.run/modelw-project-maker/model_w.project_maker | python3.11\n```\n\nThis will ask you a few questions and create the project's directory for you.\n\n## Prerequisites\n\nIn order to execute the script, you need:\n\n- Python 3.11 (you can use pyenv to load it in your current shell)\n- Poetry (follow the instructions on\n [their website](https://python-poetry.org/docs/#installation))\n- Git (you know where to get it)\n- Git Flow (`apt install git-flow` or `brew install git-flow` depending on\n your OS)\n- Node and NPM (get it your favorite way)\n- PostgreSQL and Redis (if you enable the API side)\n\n## What to do next\n\nOnce the script is done, you'll have a directory with the project's name. You\ncan then `cd` into it and start working on it.\n\n### Environment setup\n\nYou can start by installing the dependencies:\n\n```bash\n# If you enabled the API\ncd api\npoetry install\ncd ..\n\n# If you enabled the frontend\ncd front\nnpm install\n```\n\nIf you enabled the API, you then need to create the database:\n\n```bash\nsudo -u postgres psql -c \"CREATE DATABASE <project_name>\"\nsudo -u postgres psql -c \"CREATE USER <project_name> WITH LOGIN PASSWORD '<project_name>'\"\nsudo -u postgres psql -c \"GRANT ALL PRIVILEGES ON DATABASE <project_name> TO <project_name>\"\n```\n\nFinally, have a look at `api/.env` and/or `front/.env` and make sure that values\nthere are correct.\n\nFor the Django side, until you add more settings by yourself to `settings.py`,\nyou can use all the settings from the\n[Model W Django Preset](https://modelw-django-preset.readthedocs.io/en/latest/).\n\nIf you've enabled Wagtail, you need to configure the\n[storage environment variables](https://modelw-django-preset.readthedocs.io/en/latest/storage.html),\nwhich should be commented out in your `.env`. You need to check with someone in\ncharge of the infrastructure to get those values (if it's yourself, you're in\nluck).\n\n### Django models customization\n\nSomething important in Django is to customize the User model to your needs. Even\nif you don't need it right now, you'll eventually be happy that you did it\nbecause you'll _always_ need to add fields to it.\n\nThus one of the first things you should do is to go check in the `people` app's\nmodels the custom `User` model that is provided by default in this template.\nModify it to your needs.\n\n> **Note** — If you modify the User model and you are not satisfied with\n> the initial migration then you can delete it and create it anew. The only\n> thing is that you'll have to manually add `CreateExtension(\"citext\")` on top\n> of the operations list in the `0001_initial.py` migration file.\n\nIf you've enabled Wagtail, the same applies for the `Image` and `Document`\nmodels present in the `cms` app.\n\nStill in Wagtail, the root page is replaced by a `HomePage` (defined in\n`cms/models.py`) in one of the migrations generated by the template. If that's\nnot okay for you, now is the time to change it. However most likely it's going\nto be convenient for you, because otherwise you'll need to do it manually in\nWagtail's admin. The only drawback is that when you'll want to add fields to the\n`HomePage` you will have to figure default values.\n\nOnce you've adjusted all the models to your needs, feel free to make the\nmigrations and run them:\n\n```bash\napi/pmanage makemigrations\napi/pmanage migrate\n```\n\n> **Note** — You'll notice that there is a `pmanage` script in addition of\n> the `manage.py` script. It's simply a wrapper to call `manage.py` through the\n> Poetry virtual environment.\n\n### SvelteKit/Wagtail integration\n\nIf you have chosen a CMS, there will be a SvelteKit/Wagtail integration, using\nWagtail's v2 API.\n\nA [...cmsPath] directory will be created in the `front` directory, which is a\ncatch-all for all the CMS paths.\n\nInside, `$lib/components/` there is a `cms` directory, which contains the Svelte\ncomponents for the CMS such as blocks and pages.\n\nTo make a CMS page work, create a component in the `cms` directory with the same\nname as the Wagtail page type, and it will automatically be imported and\nrendered when landing on a page of that type.\n\n## Contributing\n\nIf you're developing this package and you want to make a release, you can simply\nrun:\n\n```bash\nmake release VERSION=<version>\n```\n\nThen you'll still need to push the branches and tags.\n",
"bugtrack_url": null,
"license": "WTFPL",
"summary": "A tool to create Model-W-compliant projects",
"version": "2024.10.1",
"project_urls": {
"Documentation": "https://github.com/ModelW/project-maker",
"Homepage": "https://github.com/ModelW/project-maker",
"Repository": "https://github.com/ModelW/project-maker"
},
"split_keywords": [
"model-w",
" django",
" nuxt",
" boilerplate",
" template"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1a9c726270e0d2ba44a6391367ceae5815a4457c800c88996e31caf18fba8938",
"md5": "c15fd16638fabb94f3549ffee4eca886",
"sha256": "825607b079790793201c863141a9f31bd3d295f42477f4d7e9c1168bafd38afb"
},
"downloads": -1,
"filename": "modelw_project_maker-2024.10.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c15fd16638fabb94f3549ffee4eca886",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 261944,
"upload_time": "2024-10-07T11:23:45",
"upload_time_iso_8601": "2024-10-07T11:23:45.421703Z",
"url": "https://files.pythonhosted.org/packages/1a/9c/726270e0d2ba44a6391367ceae5815a4457c800c88996e31caf18fba8938/modelw_project_maker-2024.10.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b8b9e1be3350ad3d9ead2139cd1eded14ff98995ae835fe0b39b3ef4f5711c44",
"md5": "18cb0ac425ef896ecef8734b9a4318a2",
"sha256": "a2be57499d3b8ae65b520125695be71c5e1455c1edd07045ab02d15f8f423268"
},
"downloads": -1,
"filename": "modelw_project_maker-2024.10.1.tar.gz",
"has_sig": false,
"md5_digest": "18cb0ac425ef896ecef8734b9a4318a2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.11",
"size": 213064,
"upload_time": "2024-10-07T11:23:47",
"upload_time_iso_8601": "2024-10-07T11:23:47.267342Z",
"url": "https://files.pythonhosted.org/packages/b8/b9/e1be3350ad3d9ead2139cd1eded14ff98995ae835fe0b39b3ef4f5711c44/modelw_project_maker-2024.10.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-07 11:23:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ModelW",
"github_project": "project-maker",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "modelw-project-maker"
}