55— [ @pythoninthegrass ] ( https://github.com/pythoninthegrass )
66
77## Setup
8+
89* Install
910 * [ asdf] ( https://asdf-vm.com/guide/getting-started.html )
10- * [ poetry ] ( https://python-poetry.org/docs / )
11+ * [ uv ] ( https://docs.astral.sh/uv/getting-started/installation / )
1112 * [ docker-compose] ( https://docs.docker.com/compose/install/ )
1213 * [ editorconfig] ( https://editorconfig.org/ )
1314 * [ playwright] ( https://playwright.dev/python/docs/intro#installation )
@@ -54,62 +55,70 @@ Additional tooling includes but is not limited to:
5455
5556* Install [ asdf] ( https://asdf-vm.com/guide/getting-started.html#_2-download-asdf )
5657* Usage
58+
5759 ``` bash
5860 # add python plugin
59- asdf plugin- add python
61+ asdf plugin add python
6062
6163 # install stable python
62- asdf install python < latest| 3.11. 11 >
64+ asdf install python < latest| 3.12. 10 >
6365
6466 # set stable to system python
65- asdf global python latest
67+ asdf set -u python 3.12.10
6668
67- # add poetry asdf plugin
68- asdf plugin- add poetry https://github.com/asdf-community/asdf-poetry .git
69+ # add uv asdf plugin
70+ asdf plugin add uv https://github.com/asdf-community/asdf-uv .git
6971
7072 # install latest version via asdf
71- asdf install poetry < latest| 2.0. 1 >
73+ asdf install uv < latest| 0.7. 4 >
7274
7375 # set latest version as default
74- asdf global poetry latest
76+ asdf set -u uv latest
7577 ```
7678
77- # ### poetry
79+ # ### uv
7880
79- * Install [poetry ](https://python-poetry.org/docs/ # installation) if not using `asdf`
81+ * Install [uv ](https://docs.astral.sh/uv/getting-started/ installation/ ) if not using ` asdf`
8082* Usage
83+
8184 ` ` ` bash
82- # use venv in repo
83- poetry config virtualenvs.in-project true
85+ # create a venv w/system python (./.venv)
86+ uv venv
87+
88+ # activate venv
89+ source .venv/bin/activate
8490
8591 # install dependencies
86- poetry install
92+ uv pip install -r pyproject.toml
93+
94+ # install with extras (for development)
95+ uv pip install -r pyproject.toml --all-extras
8796
8897 # add new dependency
89- poetry add < package>
98+ uv add < package>
9099
91- # remove dependency
92- poetry remove < package>
100+ # add optional dependency to dev group
101+ uv add --optional dev < package>
93102
94- # activate virtual environment
95- poetry shell
103+ # export requirements.txt from pyproject.toml
104+ uv pip compile pyproject.toml -o requirements.txt
96105
97106 # run program
98107 python main.py
99108
100109 # exit virtual environment
101- exit
110+ deactivate
102111 ` ` `
103112
104- # ### vscode
113+ # ### VSCode
105114
106- * Install [vscode ](https://code.visualstudio.com/download)
107- * Setup [vscode settings](.vscode/launch.json)
115+ * Install [VSCode ](https://code.visualstudio.com/download)
116+ * Setup [VSCode settings](.vscode/launch.json)
108117 * Handles debug settings for generic python programs as well as others (e.g., django, flask, etc.)
109118* Dev Containers
110119 * [Command palette](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette) (⇧⌘P) > Dev Containers: Reopen in Container
111120 * F5 for debug
112- * May need to select interpreter (e.g., ` /opt/venv/bin/python` ) first
121+ * May need to select interpreter (e.g., ` /opt/venv/bin/python` ) first
113122
114123# ### ruff
115124
@@ -143,7 +152,7 @@ Additional tooling includes but is not limited to:
143152
144153` ` ` bash
145154# install pre-commit dev dependency
146- poetry install
155+ uv pip install -r pyproject.toml --all-extras
147156
148157# install pre-commit hooks
149158pre-commit install
@@ -160,49 +169,27 @@ Handles formatting of files. [Install the editorconfig plugin](https://editorcon
160169
161170* [Dependabot](https://dependabot.com/) is a GitHub tool that automatically creates pull requests to keep dependencies up to date.
162171
172+ # ### repomix
173+
174+ * Capture upstream source code context for LLMs via [repomix](https://repomix.com/guide/)
175+
176+ ` ` ` bash
177+ # install repomix
178+ brew install repomix
179+
180+ # generate summary
181+ repomix --remote https://github.com/flet-dev/flet \
182+ --output docs/flet_summary.md \
183+ --style markdown \
184+ --compress \
185+ --remove-comments \
186+ --remove-empty-lines
187+ ` ` `
188+
163189# # TODO
164190
165- * Build
166- * justfile -> taskfile
167- * UI/UX
168- * Fix padding between buttons
169- * Move " logo" to top left of container
170- * Package
171- * Web
172- * Fly.io
173- * Self-host
174- * Desktop [Tauri](https://v1.tauri.app/)
175- * macOS
176- * Linux
177- * Windows
178- * Mobile (TBD)
179- * iOS
180- * Android
181- * Test
182- * Unit tests
183- * Integration tests
184- * E2E tests
185- * CI/CD
186- * Docker
187- * GitHub Actions
188- * semver
189- * [release-please](https://github.com/marketplace/actions/release-please-action)
190- * Lint
191- * Format
192- * Run tests
193- * Build
194- * ArgoCD / Flux
195- * Extend
196- * sqlite -> ~ ~postgres~~ [Litestream](https://litestream.io/) / [Turso](https://turso.tech/)
197- * Fancy category
198- * Images
199- * Menus
200- * API calls to Yelp, Google, etc.
201- * Tinder swipe right/left mechanic hehehe
202- * Document
191+ See [TODO.md](TODO.md).
203192
204193# # Further Reading
205194
206- * [FastHTML](https://fastht.ml/)
207- * [Python Poetry, finally easy build and deploy packages | by Jose Alberto Torres Agüera | Lambda Automotive | Medium](https://medium.com/lambda-automotive/python-poetry-finally-easy-build-and-deploy-packages-e1e84c23401f)
208- * [Python 101: Developing Package with Poetry | by Julio Anthony Leonard | Bootcampers | Medium](https://medium.com/bootcampers/python-101-developing-package-with-poetry-449c57690350)
195+ * ^^
0 commit comments