daglint 1.0.0

A linting tool for Apache Airflow DAG files

DAGLint

A linting tool for Apache Airflow DAG files using Python's AST (Abstract Syntax Tree) to enforce standardization and best practices.

Features

• DAG ID Convention: Ensures DAG IDs follow naming conventions
• Owner Validation: Checks that DAG owners are specified and valid
• Task ID Convention: Validates task IDs follow naming patterns
• Retry Configuration: Ensures retry settings are properly configured
• Tag Requirements: Validates required tags are present
• Max Active Runs Validation: Ensures DAGs explicitly set max_active_runs to the configured value
• Import Validation: Checks for prohibited or required imports
• Schedule Validation: Ensures schedule_interval is properly set
• Documentation Checks: Validates DAG and task documentation

Installation

From Source

pip install -e .

From PyPI

DAGLint is available on PyPI: https://pypi.org/project/daglint/

pip install daglint

Usage

# Lint a single DAG file
daglint check path/to/dag.py

# Lint all DAGs in a directory
daglint check path/to/dags/

# Lint with specific rules
daglint check path/to/dag.py --rules dag_id_convention,owner_validation

# List all available rules
daglint rules

# Generate a configuration file
daglint init

Configuration

Create a .daglint.yaml file in your project root:

rules:
  dag_id_convention:
    enabled: true
    pattern: "^[a-z][a-z0-9_]*$"
  
  owner_validation:
    enabled: true
    valid_owners:
      - "data-team"
      - "analytics-team"
  
  task_id_convention:
    enabled: true
    pattern: "^[a-z][a-z0-9_]*$"
  
  retry_configuration:
    enabled: true
    min_retries: 1
    max_retries: 5
  
  tag_requirements:
    enabled: true
    required_tags:
      - "environment"
      - "team"

  max_active_runs_validation:
    enabled: true
    max_active_runs: 1
    severity: warning
  
  schedule_validation:
    enabled: true
    allow_none: false

Development

# Install development dependencies
make install-dev

# Run tests
make test

# Run tests with coverage
make test-cov

# Format code
make format

# Run linting checks
make lint

# Run all quality checks
make check

# See all available commands
make help

Version Management

This project uses bumpver to manage version numbers. See VERSION_MANAGEMENT.md for detailed usage instructions.

# Preview version bump (dry run)
bumpver update --patch --dry --no-fetch

# Bump patch version (0.5.0 -> 0.5.1)
bumpver update --patch --no-fetch

# Bump minor version (0.5.0 -> 0.6.0)
bumpver update --minor --no-fetch

# Bump major version (0.5.0 -> 1.0.0)
bumpver update --major --no-fetch

License

MIT