Skip to content

Add make import target and improve virtualenv docs#52

Merged
gosku merged 1 commit into
mainfrom
add-make-process-images
May 29, 2026
Merged

Add make import target and improve virtualenv docs#52
gosku merged 1 commit into
mainfrom
add-make-process-images

Conversation

@gosku

@gosku gosku commented May 29, 2026

Copy link
Copy Markdown
Owner

Fixes #51

What

A user reported that running python manage.py process_images was confusing because the virtualenv isn't activated by default, making it non-obvious that .venv/bin/python is needed. This PR makes importing images a first-class make target and improves the docs for users unfamiliar with virtualenvs.

Changes

  • Makefile — add make import PATH=… target, which wraps manage.py process_images using the project's own .venv/bin/python. It also appears in make help.

  • README.md — reorder the lite install quick-start to the logical sequence: setup → import → run. Replace all references to bare python manage.py process_images with make import PATH=….

  • docs/management_commands.md — add a "Running commands" section at the top explaining how to use .venv/bin/python or activate the virtualenv before running any management command. Remove the defunct process_images_sync entry.

- Add `make import PATH=…` Makefile target as a friendlier entry point to
  `manage.py process_images` for users unfamiliar with virtualenvs
- Update README quick-start sequence to setup → import → run, removing
  `make update` (which has its own section) and the now-redundant prose
  about sequential processing
- Replace bare `python manage.py process_images` with `make import PATH=…`
  throughout README
- Add "Running commands" section to docs/management_commands.md explaining
  how to use `.venv/bin/python` or activate the virtualenv before running
  any management command
- Restore `process_images` as the documented command in
  docs/management_commands.md and remove the deleted `process_images_sync`
  entry

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@gosku gosku merged commit 471facd into main May 29, 2026
4 checks passed
@gosku gosku deleted the add-make-process-images branch May 29, 2026 18:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

venv not activated when running manage.py

1 participant