elm-review/tests/NoDebug/Log.elm

module NoDebug.Log exposing (rule)

{-|

@docs rule

-}

import Elm.Syntax.Expression as Expression exposing (Expression)
import Elm.Syntax.Node as Node exposing (Node(..))
import Elm.Syntax.Range exposing (Range)
import Review.Fix
import Review.ModuleNameLookupTable as ModuleNameLookupTable exposing (ModuleNameLookupTable)
import Review.Rule as Rule exposing (Error, Rule)


{-| Forbid the use of [`Debug.log`](https://package.elm-lang.org/packages/elm/core/latest/Debug) before it goes into production or fails in the CI.

🔧 Running with `--fix` will automatically remove all the reported errors.

`Debug.log` is useful to debug your code, but should not be pushed to production.

    config =
        [ NoDebug.Log.rule
        ]


## Fail

    if Debug.log "condition" condition then
        a

    else
        b


## Success

    if condition then
        a

    else
        b


# When (not) to use this rule

You should use this rule if you're developing a package meant to be published,
or an application that is put into production, and wish to know about the use of
[`Debug.log`](https://package.elm-lang.org/packages/elm/core/latest/Debug#log)
module before committing your changes.

You should not use this rule if you are developing an application that is not
put into production, and you do not care about having stray debug logs, and you
do not ship to production.


## Try it out

You can try this rule out by running the following command:

```bash
elm-review --template jfmengels/elm-review-debug/example --rules NoDebug.Log
```

-}
rule : Rule
rule =
    Rule.newModuleRuleSchemaUsingContextCreator "NoDebug.Log" initContext
        |> Rule.withExpressionEnterVisitor expressionVisitor
        |> Rule.fromModuleRuleSchema


type alias Context =
    { lookupTable : ModuleNameLookupTable
    , rangesToIgnore : List Range
    }


initContext : Rule.ContextCreator () Context
initContext =
    Rule.initContextCreator
        (\lookupTable () ->
            { lookupTable = lookupTable
            , rangesToIgnore = []
            }
        )
        |> Rule.withModuleNameLookupTable


error : Node a -> Maybe Range -> Error {}
error node rangeToRemove =
    Rule.errorWithFix
        { message = "Remove the use of `Debug.log` before shipping to production"
        , details =
            [ "`Debug.log` is useful when developing, but is not meant to be shipped to production or published in a package. I suggest removing its use before committing and attempting to push to production."
            ]
        }
        (Node.range node)
        (case rangeToRemove of
            Just range ->
                [ Review.Fix.removeRange range ]

            Nothing ->
                []
        )


handleWhenSingleArg : Range -> Context -> Node Expression -> ( List (Error {}), Context )
handleWhenSingleArg rangeToPotentiallyRemove context node =
    case Node.value node of
        Expression.Application (((Node logFunctionRange (Expression.FunctionOrValue _ "log")) as logFunctionNode) :: logArguments) ->
            case ModuleNameLookupTable.moduleNameAt context.lookupTable logFunctionRange of
                Just [ "Debug" ] ->
                    let
                        rangeToRemove : Maybe Range
                        rangeToRemove =
                            case logArguments of
                                [ _ ] ->
                                    Just rangeToPotentiallyRemove

                                _ ->
                                    Nothing
                    in
                    ( [ error logFunctionNode rangeToRemove ]
                    , { context | rangesToIgnore = Node.range node :: logFunctionRange :: context.rangesToIgnore }
                    )

                _ ->
                    ( [], context )

        _ ->
            ( [], context )


expressionVisitor : Node Expression -> Context -> ( List (Error {}), Context )
expressionVisitor node context =
    case Node.value node of
        Expression.OperatorApplication "|>" _ left right ->
            handleWhenSingleArg
                { start = (Node.range left).end
                , end = (Node.range right).end
                }
                context
                right

        Expression.OperatorApplication "<|" _ left right ->
            handleWhenSingleArg
                { start = (Node.range left).start
                , end = (Node.range right).start
                }
                context
                left

        Expression.OperatorApplication "<<" _ left right ->
            let
                ( errorsLeft, contextAfterLeft ) =
                    handleWhenSingleArg
                        { start = (Node.range left).start
                        , end = (Node.range right).start
                        }
                        context
                        left

                ( errorsRight, contextAfterRight ) =
                    handleWhenSingleArg
                        { start = (Node.range left).end
                        , end = (Node.range right).end
                        }
                        contextAfterLeft
                        right
            in
            ( errorsLeft ++ errorsRight, contextAfterRight )

        Expression.OperatorApplication ">>" _ left right ->
            let
                ( errorsLeft, contextAfterLeft ) =
                    handleWhenSingleArg
                        { start = (Node.range left).start
                        , end = (Node.range right).start
                        }
                        context
                        left

                ( errorsRight, contextAfterRight ) =
                    handleWhenSingleArg
                        { start = (Node.range left).end
                        , end = (Node.range right).end
                        }
                        contextAfterLeft
                        right
            in
            ( errorsLeft ++ errorsRight, contextAfterRight )

        Expression.Application (((Node logFunctionRange (Expression.FunctionOrValue _ "log")) as logFunctionNode) :: logArguments) ->
            let
                rangeToRemove : Maybe Range
                rangeToRemove =
                    case logArguments of
                        [ _, valueToLog ] ->
                            Just
                                { start = logFunctionRange.start
                                , end = (Node.range valueToLog).start
                                }

                        _ ->
                            Nothing
            in
            reportIfDebugLog logFunctionNode context rangeToRemove

        Expression.FunctionOrValue _ "log" ->
            reportIfDebugLog node context Nothing

        _ ->
            ( [], context )


reportIfDebugLog : Node Expression -> Context -> Maybe Range -> ( List (Error {}), Context )
reportIfDebugLog node context rangeToRemove =
    if List.member (Node.range node) context.rangesToIgnore then
        ( [], context )

    else
        case ModuleNameLookupTable.moduleNameFor context.lookupTable node of
            Just [ "Debug" ] ->
                ( [ error node rangeToRemove ]
                , { context | rangesToIgnore = Node.range node :: context.rangesToIgnore }
                )

            _ ->
                ( [], context )