Suggested changes based on my setup experience

[Blackoverflow]

Hi

I try myself at the froide development setup right now.

While doing this, I try to improve the documentation.

Proposed changes so far:

• changed pyproject.toml classifiers
  because they puzzled me
• added ruff as test dependency
  because this allows me to avoid a system wide installation of ruff, which is needed for make test
• updated readme setup description, based on what the 'Froide CI' Github Job does
  because it was outdated and incomplete
• added sections about required system tools and libs
  because its tedious to find out one after another
• updated readme 'Update dependencies' using the make target
• removed a version reference from docs/about.rst
  it was outdated and it would only get outdated again

pnpm install and pnpm run build failed at the exifeader postinstall script until I also installed node 20 and npm.
Any ideas how to get by only with @pnpm/exe ?

After running the manage.py setup steps:

• visiting http://127.0.0.1:8000/ throws 'Please build frontend or run frontend dev server'
• make test failed on 31 tests. See test-summary.txt
• after running pytest --create-db once, make test runs green.
  Since pytest --create-db needs to run after each database schema change (see pytest-django docs: Example work flow with --reuse-db and --create-db), this could become another make target.

Of all the system dependencies that are installed in 'Froide CI', I only installed 'libpoppler-cpp-dev' so far.

I propose to add a make target 'setup' and reference it from the readme. I think this would be less likely to become outdated.

I also plan to update the documentation. First of all docs/development.rst which seems to be completely outdated.

Please give feedback if this is helpful to you and give pointers what else is important for development setup.

[krmax44]

Thanks! I assume the failing tests have something to do with --reuse-db. What happens when you run pytest --create-db?

[Blackoverflow]

Thanks! I assume the failing tests have something to do with --reuse-db. What happens when you run pytest --create-db?

That assumption was on the mark. pytest --create-db ran green and now make test also runs green. Thank you.
Not sure yet how I document this, so future setups will regard this.