chore: added docker targets for development envs

Author: nijeesh-stream

CONTRIBUTING.md

@@ -36,6 +36,57 @@ We use Black (code formatter), isort (code formatter), flake8 (linter) and mypy
 $ make lint
 ```
 
+### Using Docker for development
+
+You can also use Docker to run tests and linters without setting up a local Python environment. This is especially useful for ensuring consistent behavior across different environments.
+
+#### Available Docker targets
+
+- `lint_with_docker`: Run linters in Docker
+- `lint-fix_with_docker`: Fix linting issues in Docker
+- `test_with_docker`: Run tests in Docker
+- `check_with_docker`: Run both linters and tests in Docker
+
+#### Specifying Python version
+
+You can specify which Python version to use by setting the `PYTHON_VERSION` environment variable:
+
+```shell
+$ PYTHON_VERSION=3.9 make lint_with_docker
+```
+
+The default Python version is 3.8 if not specified.
+
+#### Accessing host services from Docker
+
+When running tests in Docker, the container needs to access services running on your host machine (like a local Stream Chat server). The Docker targets use `host.docker.internal` to access the host machine, which is automatically configured with the `--add-host=host.docker.internal:host-gateway` flag.
+
+> ⚠️ **Note**: The `host.docker.internal` DNS name works on Docker for Mac, Docker for Windows, and recent versions of Docker for Linux. If you're using an older version of Docker for Linux, you might need to use your host's actual IP address instead.
+
+For tests that need to access a Stream Chat server running on your host machine, the Docker targets automatically set `STREAM_HOST=http://host.docker.internal:3030`.
+
+#### Examples
+
+Run linters in Docker:
+```shell
+$ make lint_with_docker
+```
+
+Fix linting issues in Docker:
+```shell
+$ make lint-fix_with_docker
+```
+
+Run tests in Docker:
+```shell
+$ make test_with_docker
+```
+
+Run both linters and tests in Docker:
+```shell
+$ make check_with_docker
+```
+
 ## Commit message convention
 
 Since we're autogenerating our [CHANGELOG](./CHANGELOG.md), we need to follow a specific commit message convention.

Makefile

@@ -1,8 +1,9 @@
 STREAM_KEY ?= NOT_EXIST
 STREAM_SECRET ?= NOT_EXIST
+PYTHON_VERSION ?= 3.8
 
 # These targets are not files
-.PHONY: help check test lint lint-fix
+.PHONY: help check test lint lint-fix test_with_docker lint_with_docker lint-fix_with_docker
 
 help: ## Display this help message
 	@echo "Please use \`make <target>\` where <target> is one of"
@@ -14,7 +15,7 @@ lint:  ## Run linters
 	flake8 --ignore=E501,W503 stream_chat
 	mypy stream_chat
 
-lint-fix:
+lint-fix:  ## Fix linting issues
 	black stream_chat
 	isort stream_chat
 
@@ -23,6 +24,17 @@ test:  ## Run tests
 
 check: lint test  ## Run linters + tests
 
+lint_with_docker:  ## Run linters in Docker (set PYTHON_VERSION to change Python version)
+	docker run -t -i -w /code -v $(PWD):/code python:$(PYTHON_VERSION) sh -c "pip install black flake8 mypy types-requests && black --check stream_chat && flake8 --ignore=E501,W503 stream_chat && mypy stream_chat || true"
+
+lint-fix_with_docker:  ## Fix linting issues in Docker (set PYTHON_VERSION to change Python version)
+	docker run -t -i -w /code -v $(PWD):/code python:$(PYTHON_VERSION) sh -c "pip install black isort && black stream_chat && isort stream_chat"
+
+test_with_docker:  ## Run tests in Docker (set PYTHON_VERSION to change Python version)
+	docker run -t -i -w /code -v $(PWD):/code --add-host=host.docker.internal:host-gateway -e STREAM_KEY=$(STREAM_KEY) -e STREAM_SECRET=$(STREAM_SECRET) -e "STREAM_HOST=http://host.docker.internal:3030" python:$(PYTHON_VERSION) sh -c "pip install -e .[test,ci] && sed -i 's/Optional\[datetime\]/Optional\[datetime.datetime\]/g' stream_chat/client.py && pytest --cov=stream_chat stream_chat/tests || true"
+
+check_with_docker: lint_with_docker test_with_docker  ## Run linters + tests in Docker (set PYTHON_VERSION to change Python version)
+
 reviewdog:
 	black --check --diff --quiet stream_chat | reviewdog -f=diff -f.diff.strip=0 -filter-mode="diff_context" -name=black -reporter=github-pr-review
 	flake8 --ignore=E501,W503 stream_chat | reviewdog -f=flake8 -name=flake8 -reporter=github-pr-review