Function parse_dirty_app_spec

gunicorn/dirty/app.py:140–212

Parse a dirty app specification. Supports two formats: - ``"module:Class"`` - standard format, all workers load the app - ``"module:Class:N"`` - worker-limited format, only N workers load the app Args: spec: The app specification string Returns: tuple: (im

(spec)

def parse_dirty_app_spec(spec):
    """
    Parse a dirty app specification.

    Supports two formats:
    - ``"module:Class"`` - standard format, all workers load the app
    - ``"module:Class:N"`` - worker-limited format, only N workers load the app

    Args:
        spec: The app specification string

    Returns:
        tuple: (import_path, worker_count)
            - import_path: The "module:Class" part for importing
            - worker_count: Integer limit or None for all workers

    Raises:
        DirtyAppError: If the spec format is invalid or worker_count is < 1

    Examples::

        >>> parse_dirty_app_spec("myapp:App")
        ("myapp:App", None)

        >>> parse_dirty_app_spec("myapp:App:2")
        ("myapp:App", 2)

        >>> parse_dirty_app_spec("myapp.sub:App:1")
        ("myapp.sub:App", 1)
    """
    if ':' not in spec:
        raise DirtyAppError(
            f"Invalid import path format: {spec}. "
            f"Expected 'module.path:ClassName' or 'module.path:ClassName:N'",
            app_path=spec
        )

    parts = spec.split(':')

    # Standard format: "module:Class" or "module.sub:Class"
    if len(parts) == 2:
        return (spec, None)

    # Worker-limited format: "module:Class:N"
    if len(parts) == 3:
        module_path, class_name, count_str = parts
        import_path = f"{module_path}:{class_name}"

        # Validate the worker count
        try:
            worker_count = int(count_str)
        except ValueError:
            raise DirtyAppError(
                f"Invalid worker count in spec: {spec}. "
                f"Expected integer, got '{count_str}'",
                app_path=spec
            )