django-ray 0.1.0__tar.gz

django_ray-0.1.0/.dockerignore

@@ -0,0 +1,62 @@
+# Docker ignore file for django-ray
+# Exclude files not needed in Docker builds
+
+# Git
+.git/
+.gitignore
+.github/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Python cache
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Build artifacts
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+coverage.xml
+*.cover
+
+# Linting/Type checking
+.ruff_cache/
+.mypy_cache/
+
+# Database (use volume mount or external DB in production)
+*.sqlite3
+
+# Documentation
+docs/_build/
+adr/
+
+# Scripts (not needed in container)
+scripts/
+
+# Lock file included for reproducible builds
+# uv.lock
+
+# Kubernetes manifests
+k8s/
+
+# CI/CD
+.github/
+

django_ray-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,109 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint & Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --frozen
+
+      - name: Check formatting
+        run: uv run ruff format --check .
+
+      - name: Check linting
+        run: uv run ruff check .
+
+  typecheck:
+    name: Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --frozen
+
+      - name: Type check
+        run: uv run ty check
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --frozen
+
+      - name: Run tests
+        run: uv run pytest --cov=src --cov-report=xml --cov-report=term -v
+
+      - name: Upload coverage to Codecov
+        if: matrix.python-version == '3.12'
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+  build:
+    name: Build Package
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck, test]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+

django_ray-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,139 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version to release (e.g., 0.1.0)"
+        required: true
+        type: string
+
+jobs:
+  build:
+    name: Build Package
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --frozen
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  test:
+    name: Test Built Package
+    runs-on: ubuntu-latest
+    needs: build
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create venv and install built package
+        run: |
+          uv venv --python ${{ matrix.python-version }}
+          uv pip install dist/*.whl
+
+      - name: Verify import
+        run: |
+          uv run python -c "import django_ray; print('django-ray imported successfully')"
+
+  publish-testpypi:
+    name: Publish to TestPyPI
+    runs-on: ubuntu-latest
+    needs: [build, test]
+    if: github.event_name == 'workflow_dispatch'
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/django-ray
+    permissions:
+      id-token: write
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: [build, test]
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/django-ray
+    permissions:
+      id-token: write
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    needs: publish-pypi
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: dist/*
+          generate_release_notes: true
+          draft: false
+          prerelease: ${{ contains(github.ref, '-alpha') || contains(github.ref, '-beta') || contains(github.ref, '-rc') }}
+

django_ray-0.1.0/.gitignore

@@ -0,0 +1,28 @@
+# Django-Ray Development Files
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.env
+.venv
+venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.pyright/
+*.log
+.coverage
+coverage.xml
+htmlcov/
+.idea/
+.vscode/
+
+# Django development database
+db.sqlite3
+*.sqlite3
+
+# UV lock (optional - uncomment if you don't want to commit lock file)
+# uv.lock
+

django_ray-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

django_ray-0.1.0/Dockerfile

@@ -0,0 +1,99 @@
+# syntax=docker/dockerfile:1
+# Django-Ray Docker Image
+# Multi-stage build for optimized production image
+#
+# Usage:
+#   docker run django-ray web          # Production web server (gunicorn)
+#   docker run django-ray web-dev      # Development web server
+#   docker run django-ray worker       # Django-Ray task worker (local Ray)
+#   docker run django-ray worker-cluster  # Worker connecting to Ray cluster
+#   docker run django-ray migrate      # Run migrations
+#   docker run django-ray shell        # Django shell
+
+ARG PYTHON_VERSION=3.12
+
+# =============================================================================
+# Stage 1: Build stage - install dependencies
+# =============================================================================
+FROM python:${PYTHON_VERSION}-slim AS builder
+
+# Install uv for fast dependency management
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
+
+# Set environment variables
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy
+
+WORKDIR /app
+
+# Copy dependency files
+COPY pyproject.toml uv.lock ./
+
+# Install dependencies with postgres support
+# Note: We include dev dependencies because testproject requires django-ninja and whitenoise
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --no-install-project --extra postgres
+
+# Copy source code
+COPY src/ src/
+COPY testproject/ testproject/
+COPY README.md ./
+
+# Install the project itself
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --extra postgres
+
+# Install gunicorn for production
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv pip install gunicorn
+
+# =============================================================================
+# Stage 2: Runtime stage - minimal production image
+# =============================================================================
+FROM python:${PYTHON_VERSION}-slim AS runtime
+
+# Create non-root user for security
+RUN groupadd --gid 1000 django && \
+    useradd --uid 1000 --gid django --shell /bin/bash --create-home django
+
+# Set environment variables
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PATH="/app/.venv/bin:$PATH" \
+    DJANGO_SETTINGS_MODULE="testproject.settings"
+
+WORKDIR /app
+
+# Copy virtual environment from builder
+COPY --from=builder --chown=django:django /app/.venv /app/.venv
+
+# Copy application code
+COPY --chown=django:django src/ src/
+COPY --chown=django:django testproject/ testproject/
+
+# Create staticfiles directory with proper permissions
+RUN mkdir -p /app/staticfiles && chown django:django /app/staticfiles
+
+# Copy and set up entrypoint script
+COPY --chown=django:django docker-entrypoint.sh /app/
+RUN chmod +x /app/docker-entrypoint.sh
+
+# Switch to non-root user
+USER django
+
+# Expose ports
+# 8000 - Django web server
+EXPOSE 8000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD python -c "import django; django.setup()" || exit 1
+
+# Entrypoint handles different modes
+ENTRYPOINT ["/app/docker-entrypoint.sh"]
+
+# Default mode is production web server
+CMD ["web"]
+

django_ray-0.1.0/Dockerfile.dev

@@ -0,0 +1,49 @@
+# Django-Ray Docker Image (Development)
+# Includes dev dependencies and tools for testing
+
+ARG PYTHON_VERSION=3.12
+
+FROM python:${PYTHON_VERSION}-slim
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install uv for fast dependency management
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
+
+# Set environment variables
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy \
+    PATH="/app/.venv/bin:$PATH" \
+    DJANGO_SETTINGS_MODULE="testproject.settings"
+
+WORKDIR /app
+
+# Copy dependency files
+COPY pyproject.toml uv.lock ./
+
+# Install ALL dependencies including dev
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --no-install-project
+
+# Copy source code
+COPY src/ src/
+COPY testproject/ testproject/
+COPY tests/ tests/
+COPY README.md ./
+
+# Install the project itself
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen
+
+# Expose ports
+EXPOSE 8000 6379 8265
+
+# Default command - run tests
+CMD ["pytest", "-v"]
+

django_ray-0.1.0/Dockerfile.ray

@@ -0,0 +1,34 @@
+# Ray Worker Image with django-ray installed
+# This image is used for Ray head and workers so they can execute django-ray tasks
+#
+# Build: docker build -f Dockerfile.ray -t django-ray-worker:latest .
+
+ARG RAY_VERSION=2.53.0
+ARG PYTHON_VERSION=py312
+
+FROM rayproject/ray:${RAY_VERSION}-${PYTHON_VERSION}
+
+# Install uv for fast dependency management
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
+
+WORKDIR /app
+
+# Copy dependency files
+COPY pyproject.toml uv.lock ./
+
+# Copy source code
+COPY src/ src/
+COPY testproject/ testproject/
+COPY README.md ./
+
+# Install django-ray and dependencies using uv
+# Include postgres for database driver, plus testproject dependencies
+RUN uv pip install --system -e ".[postgres]" django-ninja whitenoise --no-cache-dir
+
+# Set environment variables
+ENV DJANGO_SETTINGS_MODULE=testproject.settings \
+    PYTHONPATH=/app/src:/app
+
+# Verify installation
+RUN python -c "import django_ray; import psycopg; import ninja; print('django-ray and dependencies installed successfully')"
+

django_ray-0.1.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Dariusz Panas
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.