Merge pull request #18 from Real-Dev-Squad/develop

Dev to Main Sync

Author: iamitprakash

.coveragerc

@@ -0,0 +1,7 @@
+[coverage:run]
+# This section tells coverage to ignore certain files or directories
+omit =
+    */__init__.py
+    todo_project/wsgi.py
+    manage.py
+    */tests/*

.env.example

@@ -0,0 +1,5 @@
+ENV='DEVELOPMENT'
+SECRET_KEY='unique-secret'
+ALLOWED_HOSTS='localhost,127.0.0.1'
+MONGODB_URI='mongodb://localhost:27017'
+DB_NAME='todo-app'

.github/workflows/test.yml

@@ -0,0 +1,39 @@
+name: Tests
+on:
+  pull_request:
+    branches:
+      - "**"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    services:
+      db:
+        image: mongo:latest
+        ports:
+          - 27017:27017
+    
+    env:
+      MONGODB_URI: mongodb://db:27017
+      DB_NAME: todo-app
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11.*'
+
+      - name: Install dependencies
+        run: |
+          python3.11 -m pip install -r requirements.txt
+
+      - name: Lint check
+        run: |
+          ruff check
+
+      - name: Run tests
+        run: |
+          python3.11 manage.py test

.gitignore

@@ -0,0 +1,107 @@
+__pycache__
+*.py[cod]
+*$py.class
+
+*.so
+
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+*.manifest
+*.spec
+
+pip-log.txt
+pip-delete-this-directory.txt
+
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+*.mo
+*.pot
+
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+instance/
+.webassets-cache
+
+.scrapy
+
+docs/_build/
+
+.pybuilder/
+target/
+
+.ipynb_checkpoints
+
+profile_default/
+ipython_config.py
+
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+__pypackages__/
+
+celerybeat-schedule
+celerybeat.pid
+
+*.sage.py
+
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+.spyderproject
+.spyproject
+
+.ropeproject
+
+/site
+
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+.pyre/
+
+.pytype/
+
+cython_debug/
+
+.ruff_cache
+mongo_data
+logs

.python-version

@@ -0,0 +1 @@
+3.11.5

Dockerfile

@@ -0,0 +1,17 @@
+# Use an official Python runtime as a parent image
+FROM python:3.12-slim-bookworm
+
+# Set environment variables
+ENV PYTHONUNBUFFERED 1
+
+# Set the working directory in the container
+WORKDIR /app
+
+# Copy the requirements file into the container
+COPY requirements.txt /app/
+
+# Install any needed packages specified in requirements.txt
+RUN pip install -r requirements.txt
+
+# Copy the rest of the application code into the container
+COPY . /app/

README.md

@@ -1,2 +1,96 @@
-# This is for backned service
-A template to create all public facing sites
+# TODO Backend
+
+## Local development setup
+1. Install pyenv
+    - For Mac/Linux - https://github.com/pyenv/pyenv?tab=readme-ov-file#installation
+    - For Windows - https://github.com/pyenv-win/pyenv-win/blob/master/docs/installation.md#chocolatey
+2. Install the configured python version (3.12.7) using pyenv by running the command
+    - For Mac/Linux
+        ```
+        pyenv install
+        ```
+    - For Windows
+        ```
+        pyenv install 3.11.5
+        ```
+3. Create virtual environment by running the command
+    - For Mac/Linux
+        ```
+        pyenv virtualenv 3.11.5 venv
+        ```
+    - For Windows
+        ```
+        python -m pip install virtualenv
+        python -m virtualenv venv
+        ```
+4. Activate the virtual environment by running the command
+    - For Mac/Linux
+        ```
+        pyenv activate venv
+        ```
+    - For Windows
+        ```
+        .\venv\Scripts\activate
+        ```
+5. Install the project dependencies by running the command
+    ```
+    python -m pip install -r requirements.txt
+    ```
+6. Create a `.env` file in the root directory, and copy the content from the `.env.example` file to it
+7. Install [docker](https://docs.docker.com/get-docker/) and [docker compose](https://docs.docker.com/compose/install/)
+8. Start MongoDB using docker
+    ```
+    docker-compose up -d db
+    ```
+9. Start the development server by running the command
+    ```
+    python manage.py runserver
+    ```
+10. Go to http://127.0.0.1:8000/v1/health API to make sure the server it up. You should see this response
+    ```
+    {
+        "status": "UP",
+        "components": {
+            "db": {
+                "status": "UP"
+            }
+        }
+    }
+    ```
+
+## To simply try out the app
+1. Install [docker](https://docs.docker.com/get-docker/) and [docker compose](https://docs.docker.com/compose/install/)
+2. Start Django application and MongoDB using docker
+    ```
+    docker-compose up -d
+    ```
+3. Go to http://127.0.0.1:8000/v1/health API to make sure the server it up. You should see this response
+    ```
+    {
+    "status": "UP"
+    }
+    ```
+4. On making changes to code and saving, live reload will work in this case as well
+
+## Command reference
+1. To run the tests, run the following command
+    ```
+    python manage.py test
+    ```
+2. To check test coverage, run the following command
+    ```
+    coverage run --source='.' manage.py test
+    coverage report
+    ```
+3. To run the formatter
+    ```
+    ruff format
+    ```
+4. To run lint check
+    ```
+    ruff check
+    ```
+5. To fix lint issues
+    ```
+    ruff check --fix
+    ```

docker-compose.yml

@@ -0,0 +1,39 @@
+version: "3"
+
+services:
+  django-app:
+    build: .
+    container_name: todo-django-app
+    command: python manage.py runserver 0.0.0.0:8000
+    environment:
+      MONGODB_URI: mongodb://db:27017
+      DB_NAME: todo-app
+    volumes:
+      - .:/app
+    ports:
+      - "8000:8000"
+    depends_on:
+      - db
+
+  db:
+    image: mongo:latest
+    container_name: todo-mongo
+    ports:
+      - "27017:27017"
+    volumes:
+      - ./mongo_data:/data/db
+    healthcheck:
+      test: ["CMD", "mongosh", "--eval", "'db.runCommand({ping:1})'"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 15s
+
+    #to enable replica set, requirement for enabling transactions
+    command: >
+      sh -c "
+        mongod --replSet rs0 --bind_ip_all --logpath /var/log/mongodb.log --logappend &
+        sleep 5 &&
+        mongosh --eval 'try { rs.initiate() } catch(e) { print(e) }' &&
+        tail -f /var/log/mongodb.log
+      "

manage.py

@@ -0,0 +1,25 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+
+import sys
+
+from todo_project.settings.configure import configure_settings_module
+
+
+def main():
+    """Run administrative tasks."""
+    configure_settings_module()
+
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == "__main__":
+    main()