build: docker setup#23
Conversation
dedoussis
left a comment
There was a problem hiding this comment.
Thanks for putting together a PR! Really appreciated 💯
Kudos for spotting the pre-commit typo's.
I generally like the docker instructions idea, but I think having the Dockerfile and docker-compose.yml files at the root of the repo takes it a bit too far.
| ```bash | ||
| $ precommit install | ||
| ``` | ||
| ``` bash |
There was a problem hiding this comment.
| ``` bash | |
| ```bash | |
| ``` |
There was a problem hiding this comment.
Just some indentation. Not important, but my local markdown linter complains 🙈
|
|
||
| __Make sure you run `precommit` before every commit!__ | ||
|
|
||
| __Make sure you run `pre-commit` before every commit!__ |
| To set it up, run the command: | ||
|
|
||
| ``` bash | ||
| docker-compose run asynction |
There was a problem hiding this comment.
Although I really like having docker as my local dev environment, this is not the case for everyone. I agree that it would be beneficial to have a docker setup section in the contributing guidelines, however I don't think we should have a Dockerfile and docker-compose featuring at the root of the repo. If we were going down this path, then we could also include vscode or PyCharm configurations (since a lot of people use their IDE to spin up the environment) and we would end up overloading the repository with multiple configuration setups.
There was a problem hiding this comment.
However, I do like your idea of having some quick docker setup instructions in the contributing guidelines. We could do this with a docker run one liner. For example:
docker run -it --rm \
-v ${PWD}:/opt/workspaces/asynction \
-w /opt/workspaces/asynction \
python:3.7 bash -c "python -m pip install --upgrade pip setuptools && make all-install && pre-commit install && exec bash"I also think that the non-docker setup instructions should be placed above the docker instructions, since most people are likely going to use the non-docker ones.
There was a problem hiding this comment.
Thanks for the reply! I see the point.
Since we are not adding the docker files, how do you want to move forward with this PR?
We could close this one and create a cleaner one with only that docker command and the precommit typo fixed.
Next time I might create an issue first to avoid these problems
There was a problem hiding this comment.
We could close this one and create a cleaner one with only that docker command and the precommit typo fixed.
Up to you -- whatever works for you best. 👍
| 1. [Docs](#docs) | ||
| 1. [Release](#release) | ||
| 1. [Finally](#finally) | ||
|
|
There was a problem hiding this comment.
I prefer it the way it was. More concise. No one is going to look for the table of contents while reading the table of contents.
My changes in this PR: