Add dockerfile. (#4)

Author: balhoff

.dockerignore

@@ -0,0 +1,48 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+dist/
+build/
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Git
+.git/
+.gitignore
+.github/
+
+# Testing
+.pytest_cache/
+htmlcov/
+.coverage
+.tox/
+
+# HDT and output files
+*.hdt
+*.ttl
+
+# Example files
+example-inputs/
+example-outputs/
+
+# Documentation
+*.md
+!README.md
+
+# Misc
+.DS_Store

Dockerfile

@@ -0,0 +1,48 @@
+# Build stage: compile dependencies
+# Use bullseye (Debian 11) with GCC 10 instead of bookworm with GCC 12+
+# rdflib-hdt 3.2 has C++ code missing #include <cstdint>, which fails on newer GCC
+FROM python:3.12-bullseye AS builder
+
+# Set working directory
+WORKDIR /app
+
+# Install uv for fast, reliable dependency management
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
+
+# Set environment variables for uv
+ENV UV_COMPILE_BYTECODE=1
+
+# Copy dependency files first for better caching
+COPY pyproject.toml uv.lock ./
+
+# Install dependencies (this creates .venv with compiled packages)
+# --frozen ensures we use the exact versions from uv.lock
+# --no-dev skips development dependencies
+RUN uv sync --frozen --no-dev
+
+# Copy the application code
+COPY void_hdt/ ./void_hdt/
+
+# Runtime stage: slim image with only runtime dependencies
+FROM python:3.12-slim
+
+# Set working directory
+WORKDIR /app
+
+# Install uv in runtime image
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
+
+# Copy the virtual environment from builder
+COPY --from=builder /app/.venv /app/.venv
+
+# Copy the application code
+COPY --from=builder /app/void_hdt /app/void_hdt
+
+# Copy project files needed by uv
+COPY pyproject.toml uv.lock ./
+
+# Set the entrypoint to use uv run (handles environment automatically)
+ENTRYPOINT ["uv", "run", "void-hdt"]
+
+# Default help command if no args provided
+CMD ["--help"]

README.md

@@ -18,7 +18,15 @@ void-hdt analyzes HDT files and produces comprehensive metadata about RDF datase
 
 ## Installation
 
-### Using uv (recommended)
+### Using Docker (recommended for quick usage)
+
+Build the Docker image:
+
+```bash
+docker build -t void-hdt .
+```
+
+### Using uv (for development)
 
 ```bash
 uv sync
@@ -32,6 +40,25 @@ pip install -e .
 
 ## Usage
 
+### Docker
+
+Process an HDT file using Docker:
+
+```bash
+docker run --rm -v /path/to/data:/data void-hdt /data/input.hdt -o /data/output.ttl
+```
+
+Or with custom dataset URI:
+
+```bash
+docker run --rm -v /path/to/data:/data void-hdt \
+  /data/input.hdt \
+  -o /data/output.ttl \
+  --dataset-uri http://example.org/mydata
+```
+
+### Local Installation
+
 ### Command Line
 
 ```bash