|
3 | 3 |
|
4 | 4 | This is the source repo for [SoCalPython.org], the official SoCal Python website. 🐍 |
5 | 5 |
|
6 | | -It's built using [corvid] and below instructions rely on [Poetry]. |
| 6 | +It's built using [corvid] and below instructions rely on [just], [uv], [modd], and [devd]. |
7 | 7 |
|
8 | 8 |
|
9 | 9 | ## Setup |
10 | 10 |
|
11 | | -1. Install [Poetry] |
12 | | -2. Run `poetry install` |
| 11 | +1. Install [just], [uv], [modd], and [devd] |
| 12 | +2. Run `uv sync` |
13 | 13 |
|
14 | 14 |
|
15 | 15 | ## Developing |
16 | 16 |
|
17 | | -1. Run `make serve` in a terminal window continuously |
18 | | -2. Go to [http://localhost:8765] |
| 17 | +You can run `just --list` to see all available options. Anything requiring uv should be run “inside” it, e.g., `uv run just dev`. You can run all commands like so if you don’t want to have to actively think about it. |
| 18 | + |
| 19 | +1. Run `uv run just dev` to start the automa-build-and-serve process |
| 20 | +2. Go to [http://localhost:8000] |
19 | 21 | 3. Make changes |
20 | | -4. Run `make build` in another terminal window |
21 | | -5. Refresh to see changes |
22 | | -6. Repeat steps 3, 4, and 5 as needed |
| 22 | +4. Refresh to see changes |
| 23 | +5. Repeat steps 3 and 4 as needed |
23 | 24 |
|
24 | 25 |
|
25 | 26 | ## Infrastructure |
26 | 27 |
|
27 | | -The site is deployed on [Netlify] from the `main` branch of this repository. |
28 | | -The domain is registered by [@nkantar] through [Hover], and SSL is provided by [Let's Encrypt]. |
| 28 | +The site is deployed on [Netlify] from the `main` branch of this repository. The domain is registered by [@nkantar] through [Porkbun], and SSL is provided by [Let's Encrypt]. |
29 | 29 |
|
30 | 30 |
|
31 | 31 | ## Code of Conduct |
32 | 32 |
|
33 | | -The SoCal Python community has a [Code of Conduct], which covers contributing to this codebase as well as participating in the community in any way. |
34 | | -Doing so implies you agree to abide by its terms. |
| 33 | +The SoCal Python community has a [Code of Conduct], which covers contributing to this codebase as well as participating in the community in any way. Doing so implies you agree to abide by its terms. |
35 | 34 |
|
36 | 35 |
|
37 | 36 | [SoCalPython.org]: https://socalpython.org/ "SoCalPython.org | The official site of the Los Angeles Python programming language community." |
38 | 37 | [corvid]: https://github.com/di/corvid/ "GitHub - di/corvid: An opinionated simple static site generator" |
39 | | -[Poetry]: https://python-poetry.org/ "Poetry - Python dependency management and packaging made easy" |
40 | | -[http://localhost:8765]: http://localhost:8765 |
| 38 | +[just]: https://github.com/casey/just "casey/just: 🤖 Just a command runner" |
| 39 | +[modd]: https://github.com/cortesi/modd "cortesi/modd: A flexible developer tool that runs processes and responds to filesystem changes" |
| 40 | +[devd]: https://github.com/cortesi/devd "cortesi/devd: A local webserver for developers" |
| 41 | +[http://localhost:8000]: http://localhost:8000 |
41 | 42 | [Netlify]: https://netlify.com "Netlify: Develop & deploy the best web experiences in record time" |
42 | 43 | [@nkantar]: https://github.com/nkantar "nkantar (Nik Kantar) · GitHub" |
43 | | -[Hover]: https://hover.com "Domain Names | Buy Domains & Email At Hover.com" |
| 44 | +[Porkbun]: https://porkbun.com/ "porkbun.com | An oddly satisfying experience." |
44 | 45 | [Let's Encrypt]: https://letsencrypt.org/ " Let's Encrypt" |
45 | 46 | [Code of Conduct]: https://socalpython.org/conduct/ "SoCalPython.org | Code of Conduct" |
0 commit comments