phino-0.0.0.48: src/Rule.hs
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE RecordWildCards #-}
-- SPDX-FileCopyrightText: Copyright (c) 2025 Objectionary.com
-- SPDX-License-Identifier: MIT
module Rule (RuleContext (..), isNF, matchProgramWithRule, meetCondition) where
import AST
import Builder (buildAttribute, buildBinding, buildBindingThrows, buildExpression, buildExpressionThrows)
import Control.Exception (SomeException (SomeException), evaluate)
import Control.Exception.Base (try)
import Control.Monad (when)
import Data.Aeson (FromJSON)
import qualified Data.ByteString.Char8 as B
import Data.Foldable (foldlM)
import qualified Data.Map.Strict as M
import Data.Maybe (catMaybes, fromMaybe)
import Deps (BuildTermFunc, Term (..))
import GHC.IO (unsafePerformIO)
import Logger (logDebug)
import Matcher
import Misc (btsToUnescapedStr)
import Printer
import Regexp (match)
import Text.Printf (printf)
import Yaml (normalizationRules)
import qualified Yaml as Y
newtype RuleContext = RuleContext
{ _buildTerm :: BuildTermFunc
}
-- Returns True if given expression matches with any of given normalization rules
-- Here we use unsafePerformIO because we're sure that conditions which are used
-- in normalization rules doesn't throw an exception.
matchesAnyNormalizationRule :: Expression -> RuleContext -> Bool
matchesAnyNormalizationRule expr ctx = matchesAnyNormalizationRule' expr normalizationRules ctx
where
matchesAnyNormalizationRule' :: Expression -> [Y.Rule] -> RuleContext -> Bool
matchesAnyNormalizationRule' _ [] _ = False
matchesAnyNormalizationRule' expr (rule : rules) ctx =
let matched = unsafePerformIO (matchProgramWithRule (Program expr) rule ctx)
in not (null matched) || matchesAnyNormalizationRule' expr rules ctx
-- Returns True if given expression is in the normal form
isNF :: Expression -> RuleContext -> Bool
isNF ExThis _ = True
isNF ExGlobal _ = True
isNF ExTermination _ = True
isNF (ExDispatch ExThis _) _ = True
isNF (ExDispatch ExGlobal _) _ = True
isNF (ExDispatch ExTermination _) _ = False -- dd rule
isNF (ExApplication ExTermination _) _ = False -- dc rule
isNF (ExFormation []) _ = True
isNF (ExFormation bds) ctx = normalBindings bds || not (matchesAnyNormalizationRule (ExFormation bds) ctx)
where
-- Returns True if all given bindings are 100% in normal form
normalBindings :: [Binding] -> Bool
normalBindings [] = True
normalBindings (bd : bds) =
let next = normalBindings bds
in case bd of
BiDelta _ -> next
BiVoid _ -> next
BiLambda _ -> next
_ -> False
isNF expr ctx = not (matchesAnyNormalizationRule expr ctx)
_or :: [Y.Condition] -> Subst -> RuleContext -> IO [Subst]
_or [] _ _ = pure []
_or (cond : rest) subst ctx = do
met <- meetCondition' cond subst ctx
if null met
then _or rest subst ctx
else pure met
_and :: [Y.Condition] -> Subst -> RuleContext -> IO [Subst]
_and [] subst _ = pure [subst]
_and (cond : rest) subst ctx = do
met <- meetCondition' cond subst ctx
if null met
then pure []
else _and rest subst ctx
_not :: Y.Condition -> Subst -> RuleContext -> IO [Subst]
_not cond subst ctx = do
met <- meetCondition' cond subst ctx
pure [subst | null met]
_in :: Attribute -> Binding -> Subst -> RuleContext -> IO [Subst]
_in attr binding subst _ =
case (buildAttribute attr subst, buildBinding binding subst) of
(Right attr, Right bds) -> pure [subst | attrInBindings attr bds] -- if attrInBindings attr bd then [subst] else []
(_, _) -> pure []
where
-- Check if given attribute is present in given binding
attrInBindings :: Attribute -> [Binding] -> Bool
attrInBindings attr (bd : bds) = attrInBinding attr bd || attrInBindings attr bds
where
attrInBinding :: Attribute -> Binding -> Bool
attrInBinding attr (BiTau battr _) = attr == battr
attrInBinding attr (BiVoid battr) = attr == battr
attrInBinding AtLambda (BiLambda _) = True
attrInBinding AtDelta (BiDelta _) = True
attrInBinding _ _ = False
attrInBindings _ _ = False
_alpha :: Attribute -> Subst -> RuleContext -> IO [Subst]
_alpha (AtAlpha _) subst _ = pure [subst]
_alpha (AtMeta name) (Subst mp) _ = case M.lookup name mp of
Just (MvAttribute (AtAlpha _)) -> pure [Subst mp]
_ -> pure []
_alpha _ _ _ = pure []
_eq :: Y.Comparable -> Y.Comparable -> Subst -> RuleContext -> IO [Subst]
_eq (Y.CmpNum left) (Y.CmpNum right) subst _ = case (numToInt left subst, numToInt right subst) of
(Just left_, Just right_) -> pure [subst | left_ == right_]
(_, _) -> pure []
where
-- Convert Number to Integer
numToInt :: Y.Number -> Subst -> Maybe Integer
numToInt (Y.Ordinal (AtMeta meta)) (Subst mp) = case M.lookup meta mp of
Just (MvAttribute (AtAlpha idx)) -> Just idx
_ -> Nothing
numToInt (Y.Ordinal (AtAlpha idx)) subst = Just idx
numToInt (Y.Length (BiMeta meta)) (Subst mp) = case M.lookup meta mp of
Just (MvBindings bds) -> Just (toInteger (length bds))
_ -> Nothing
numToInt (Y.Literal num) subst = Just num
numToInt _ _ = Nothing
_eq (Y.CmpAttr left) (Y.CmpAttr right) subst _ = pure [subst | compareAttrs left right subst]
where
compareAttrs :: Attribute -> Attribute -> Subst -> Bool
compareAttrs (AtMeta left) (AtMeta right) (Subst mp) = case (M.lookup left mp, M.lookup right mp) of
(Just (MvAttribute left'), Just (MvAttribute right')) -> compareAttrs left' right' (Subst mp)
_ -> False
compareAttrs attr (AtMeta meta) (Subst mp) = case M.lookup meta mp of
Just (MvAttribute found) -> attr == found
_ -> False
compareAttrs (AtMeta meta) attr (Subst mp) = case M.lookup meta mp of
Just (MvAttribute found) -> attr == found
_ -> False
compareAttrs left right _ = right == left
_eq (Y.CmpExpr left) (Y.CmpExpr right) subst _ = pure [subst | compareExprs left right subst]
where
compareExprs :: Expression -> Expression -> Subst -> Bool
compareExprs (ExMeta left) (ExMeta right) (Subst mp) = case (M.lookup left mp, M.lookup right mp) of
(Just (MvExpression left' _), Just (MvExpression right' _)) -> compareExprs left' right' (Subst mp)
_ -> False
compareExprs expr (ExMeta meta) (Subst mp) = case M.lookup meta mp of
Just (MvExpression found _) -> expr == found
_ -> False
compareExprs (ExMeta meta) expr (Subst mp) = case M.lookup meta mp of
Just (MvExpression found _) -> expr == found
_ -> False
compareExprs left right _ = left == right
_eq _ _ _ _ = pure []
_nf :: Expression -> Subst -> RuleContext -> IO [Subst]
_nf (ExMeta meta) (Subst mp) ctx = case M.lookup meta mp of
Just (MvExpression expr _) -> _nf expr (Subst mp) ctx
_ -> pure []
_nf expr subst ctx = pure [subst | isNF expr ctx]
_xi :: Expression -> Subst -> RuleContext -> IO [Subst]
_xi (ExMeta meta) (Subst mp) ctx = case M.lookup meta mp of
Just (MvExpression expr _) -> _xi expr (Subst mp) ctx
_ -> pure []
_xi (ExFormation _) subst _ = pure [subst]
_xi ExThis subst _ = pure []
_xi ExGlobal subst _ = pure [subst]
_xi (ExApplication expr (BiTau attr texpr)) subst ctx = do
onExpr <- _xi expr subst ctx
onTau <- _xi texpr subst ctx
pure [subst | not (null onExpr) && not (null onTau)]
_xi (ExDispatch expr _) subst ctx = _xi expr subst ctx
_matches :: String -> Expression -> Subst -> RuleContext -> IO [Subst]
_matches pat (ExMeta meta) (Subst mp) ctx = case M.lookup meta mp of
Just (MvExpression expr _) -> _matches pat expr (Subst mp) ctx
_ -> pure []
_matches pat expr subst ctx = do
(TeBytes tgt) <- _buildTerm ctx "dataize" [Y.ArgExpression expr] subst
matched <- match (B.pack pat) (B.pack (btsToUnescapedStr tgt))
pure [subst | matched]
_partOf :: Expression -> Binding -> Subst -> RuleContext -> IO [Subst]
_partOf exp bd subst _ = do
(exp', _) <- buildExpressionThrows exp subst
bds <- buildBindingThrows bd subst
pure [subst | partOf exp' bds]
where
partOf :: Expression -> [Binding] -> Bool
partOf expr [] = False
partOf expr (BiTau _ (ExFormation bds) : rest) = expr == ExFormation bds || partOf expr bds || partOf expr rest
partOf expr (BiTau _ expr' : rest) = expr == expr' || partOf expr rest
partOf expr (bd : rest) = partOf expr rest
meetCondition' :: Y.Condition -> Subst -> RuleContext -> IO [Subst]
meetCondition' (Y.Or conds) = _or conds
meetCondition' (Y.And conds) = _and conds
meetCondition' (Y.Not cond) = _not cond
meetCondition' (Y.In attr binding) = _in attr binding
meetCondition' (Y.Alpha attr) = _alpha attr
meetCondition' (Y.Eq left right) = _eq left right
meetCondition' (Y.NF expr) = _nf expr
meetCondition' (Y.XI expr) = _xi expr
meetCondition' (Y.Matches pat expr) = _matches pat expr
meetCondition' (Y.PartOf expr bd) = _partOf expr bd
-- For each substitution check if it meetCondition to given condition
-- If substitution does not meet the condition - it's thrown out
-- and is not used in replacement
meetCondition :: Y.Condition -> [Subst] -> RuleContext -> IO [Subst]
meetCondition _ [] _ = pure []
meetCondition cond (subst : rest) ctx = do
met <- try (meetCondition' cond subst ctx) :: IO (Either SomeException [Subst])
case met of
Right first -> do
next <- meetCondition cond rest ctx
if null first
then pure next
else pure (head first : next)
Left _ -> meetCondition cond rest ctx
meetMaybeCondition :: Maybe Y.Condition -> [Subst] -> RuleContext -> IO [Subst]
meetMaybeCondition Nothing substs _ = pure substs
meetMaybeCondition (Just cond) substs ctx = meetCondition cond substs ctx
-- Extend list of given substitutions with extra substitutions from 'where' yaml rule section
extraSubstitutions :: [Subst] -> Maybe [Y.Extra] -> RuleContext -> IO [Subst]
extraSubstitutions substs extras RuleContext {..} = case extras of
Nothing -> pure substs
Just extras' -> do
logDebug (printf "Building %d sets of extra substitutions.." (length substs))
res <-
sequence
[ foldlM
( \(Just subst') extra -> do
let maybeName = case Y.meta extra of
Y.ArgExpression (ExMeta name) -> Just name
Y.ArgAttribute (AtMeta name) -> Just name
Y.ArgBinding (BiMeta name) -> Just name
Y.ArgBytes (BtMeta name) -> Just name
_ -> Nothing
func = Y.function extra
args = Y.args extra
term <- _buildTerm func args subst'
meta <- case term of
TeExpression expr -> do
logDebug (printf "Function %s() returned expression:\n%s" func (printExpression expr))
pure (MvExpression expr defaultScope)
TeAttribute attr -> do
logDebug (printf "Function %s() returned attribute: %s" func (printAttribute attr))
pure (MvAttribute attr)
TeBytes bytes -> do
logDebug (printf "Function %s() returned bytes: %s" func (printBytes bytes))
pure (MvBytes bytes)
TeBindings bds -> do
logDebug (printf "Function %s return bindings: %s" func (printExpression (ExFormation bds)))
pure (MvBindings bds)
case maybeName of
Just name -> pure (combine (substSingle name meta) subst')
_ -> pure Nothing
)
(Just subst)
extras'
| subst <- substs
]
logDebug "Extra substitutions have been built"
pure (catMaybes res)
-- @todo #432:30min Fix log for not matched pattern. Right now we print
-- the name of the rule if pattern is not matched. It would be better to print
-- the pattern itself. To achieve that we should extend CST so it supports meta
-- attributes, expressions and so on. Don't forget to remove the puzzle
matchProgramWithRule :: Program -> Y.Rule -> RuleContext -> IO [Subst]
matchProgramWithRule program rule ctx =
let ptn = Y.pattern rule
matched = matchProgram ptn program
name = fromMaybe "unknown" (Y.name rule)
in if null matched
then do
logDebug (printf "Pattern from rule '%s' was not matched" name)
pure []
else do
when' <- meetMaybeCondition (Y.when rule) matched ctx
if null when'
then do
logDebug "The 'when' condition wasn't met"
pure []
else do
logDebug (printf "Rule %s" (fromMaybe "unknown" (Y.name rule)))
extended <- extraSubstitutions when' (Y.where_ rule) ctx
if null extended
then do
logDebug "Substitution is empty after enxtending, maybe some metas are duplicated"
pure []
else do
met <- meetMaybeCondition (Y.having rule) extended ctx
when (null met) (logDebug "The 'having' condition wan't met")
pure met