mirror of
https://github.com/github/semantic.git
synced 2024-11-28 10:15:55 +03:00
202 lines
7.9 KiB
Haskell
202 lines
7.9 KiB
Haskell
{-# LANGUAGE DataKinds, FlexibleContexts #-}
|
|
{-# OPTIONS_GHC -fno-warn-orphans #-}
|
|
|
|
module SpecHelpers
|
|
( module X
|
|
, runBuilder
|
|
, diffFilePaths
|
|
, parseFilePath
|
|
, readFilePathPair
|
|
, runTaskOrDie
|
|
, runParseWithConfig
|
|
, TaskSession(..)
|
|
, testEvaluating
|
|
, toList
|
|
, Config
|
|
, LogQueue
|
|
, StatQueue
|
|
, lookupDeclaration
|
|
, lookupMembers
|
|
, EdgeLabel(..)
|
|
, TestEvaluatingResult
|
|
, TestEvaluatingState
|
|
, evaluateProject
|
|
) where
|
|
|
|
import Control.Abstract
|
|
import Control.Carrier.Parse.Simple
|
|
import Control.Effect.Lift
|
|
import Control.Effect.Trace as X (runTraceByIgnoring, runTraceByReturning)
|
|
import Control.Exception (displayException)
|
|
import Control.Monad ((>=>))
|
|
import Control.Monad as X
|
|
import Data.Abstract.Address.Precise as X
|
|
import Data.Abstract.Evaluatable
|
|
import Data.Abstract.FreeVariables as X
|
|
import qualified Data.Abstract.Heap as Heap
|
|
import Data.Abstract.Module as X
|
|
import Data.Abstract.ModuleTable as X hiding (lookup)
|
|
import Data.Abstract.Name as X
|
|
import Data.Abstract.ScopeGraph (EdgeLabel(..))
|
|
import qualified Data.Abstract.ScopeGraph as ScopeGraph
|
|
import Data.Abstract.Value.Concrete (Value(..), ValueError, runValueError)
|
|
import Data.Blob as X
|
|
import Data.Blob.IO as X
|
|
import Data.ByteString as X (ByteString)
|
|
import Data.ByteString.Builder (Builder, toLazyByteString)
|
|
import Data.ByteString.Lazy (toStrict)
|
|
import Data.Edit as X
|
|
import Data.Foldable (toList)
|
|
import Data.Functor.Listable as X
|
|
import Data.Language as X hiding (Precise)
|
|
import Data.List.NonEmpty as X (NonEmpty(..))
|
|
import Data.Maybe as X
|
|
import Data.Monoid as X (Monoid(..), First(..), Last(..))
|
|
import Data.Project as X
|
|
import Data.Proxy as X
|
|
import Data.Semigroup as X (Semigroup(..))
|
|
import Data.Semilattice.Lower as X
|
|
import Data.String
|
|
import Data.Sum as Sum
|
|
import Data.Term as X
|
|
import Data.Traversable as X (for)
|
|
import Debug.Trace as X (traceShowM, traceM)
|
|
import Parsing.Parser as X
|
|
import Semantic.Api hiding (File, Blob, BlobPair)
|
|
import Semantic.Config (Config(..), optionsLogLevel)
|
|
import Semantic.Graph (analysisParsers, runHeap, runScopeGraph)
|
|
import Semantic.Task as X
|
|
import Semantic.Telemetry (LogQueue, StatQueue)
|
|
import Semantic.Util as X
|
|
import Source.Range as X hiding (start, end, point)
|
|
import Source.Source as X (Source)
|
|
import Source.Span as X hiding (HasSpan(..), start, end, point)
|
|
import System.Exit (die)
|
|
import qualified System.Path as Path
|
|
import Test.Hspec as X (Spec, SpecWith, context, describe, it, xit, parallel, pendingWith, around, runIO)
|
|
import Test.Hspec.Expectations as X
|
|
import Test.Hspec.LeanCheck as X
|
|
import Test.LeanCheck as X
|
|
import Unsafe.Coerce (unsafeCoerce)
|
|
|
|
runBuilder :: Builder -> ByteString
|
|
runBuilder = toStrict . toLazyByteString
|
|
|
|
-- | This orphan instance is so we don't have to insert @name@ calls
|
|
-- in dozens and dozens of environment specs.
|
|
instance IsString Name where
|
|
fromString = X.name . fromString
|
|
|
|
-- | Returns an s-expression formatted diff for the specified FilePath pair.
|
|
diffFilePaths :: TaskSession -> Path.RelFile -> Path.RelFile -> IO ByteString
|
|
diffFilePaths session p1 p2 = do
|
|
blobs <- readFilePathPair p1 p2
|
|
builder <- runTask session (runParse (configTreeSitterParseTimeout (config session)) (parseDiffBuilder DiffSExpression [ blobs ]))
|
|
either (die . displayException) (pure . runBuilder) builder
|
|
|
|
-- | Returns an s-expression parse tree for the specified path.
|
|
parseFilePath :: TaskSession -> Path.RelFile -> IO (Either SomeException ByteString)
|
|
parseFilePath session path = do
|
|
blob <- readBlobFromFile (fileForTypedPath path)
|
|
res <- runTask session . runParse (configTreeSitterParseTimeout (config session)) . runReader defaultLanguageModes $ parseTermBuilder TermSExpression (toList blob)
|
|
pure (runBuilder <$> res)
|
|
|
|
runParseWithConfig :: (Carrier sig m, Member (Reader Config) sig) => ParseC m a -> m a
|
|
runParseWithConfig task = asks configTreeSitterParseTimeout >>= \ timeout -> runParse timeout task
|
|
|
|
-- | Read two files to a BlobPair.
|
|
readFilePathPair :: Path.RelFile -> Path.RelFile -> IO BlobPair
|
|
readFilePathPair p1 p2 = readFilePair (fileForTypedPath p1) (fileForTypedPath p2)
|
|
|
|
-- Run a Task and call `die` if it returns an Exception.
|
|
runTaskOrDie :: ParseC TaskC a -> IO a
|
|
runTaskOrDie task = runTaskWithOptions defaultOptions { optionsLogLevel = Nothing } (runParseWithConfig task) >>= either (die . displayException) pure
|
|
|
|
type TestEvaluatingC term
|
|
= ResumableC (BaseError (AddressError Precise (Val term)))
|
|
( ResumableC (BaseError (ValueError term Precise))
|
|
( ResumableC (BaseError ResolutionError)
|
|
( ResumableC (BaseError (EvalError term Precise (Val term)))
|
|
( ResumableC (BaseError (HeapError Precise))
|
|
( ResumableC (BaseError (ScopeError Precise))
|
|
( ResumableC (BaseError (UnspecializedError Precise (Val term)))
|
|
( ResumableC (BaseError (LoadError Precise (Val term)))
|
|
( StateC (Heap Precise Precise (Val term))
|
|
( StateC (ScopeGraph Precise)
|
|
( FreshC
|
|
( TraceByIgnoringC
|
|
( LiftC IO))))))))))))
|
|
type TestEvaluatingErrors term
|
|
= '[ BaseError (AddressError Precise (Val term))
|
|
, BaseError (ValueError term Precise)
|
|
, BaseError ResolutionError
|
|
, BaseError (EvalError term Precise (Val term))
|
|
, BaseError (HeapError Precise)
|
|
, BaseError (ScopeError Precise)
|
|
, BaseError (UnspecializedError Precise (Val term))
|
|
, BaseError (LoadError Precise (Val term))
|
|
]
|
|
type TestEvaluatingState term a
|
|
= ( ScopeGraph Precise
|
|
, ( Heap Precise Precise (Val term)
|
|
, Either (SomeError (Sum.Sum (TestEvaluatingErrors term))) a
|
|
)
|
|
)
|
|
type TestEvaluatingResult term = ModuleTable (Module (ModuleResult Precise (Val term)))
|
|
testEvaluating :: Evaluator term Precise (Val term) (TestEvaluatingC term) a
|
|
-> IO (TestEvaluatingState term a)
|
|
testEvaluating
|
|
= runM
|
|
. runTraceByIgnoring
|
|
. runFresh
|
|
. runEvaluator
|
|
. runScopeGraph
|
|
. runHeap
|
|
. fmap reassociate
|
|
. runLoadError
|
|
. runUnspecialized
|
|
. runScopeError
|
|
. runHeapError
|
|
. runEvalError
|
|
. runResolutionError
|
|
. runValueError
|
|
. runAddressError
|
|
|
|
type Val term = Value term Precise
|
|
|
|
evaluateProject :: (HasPrelude lang, SLanguage lang) => TaskSession -> Proxy lang -> [FilePath] -> IO (TestEvaluatingState term (TestEvaluatingResult term))
|
|
evaluateProject session proxy = case parserForLanguage analysisParsers lang of
|
|
Just (SomeParser parser) -> unsafeCoerce . testEvaluating <=< evaluateProject' session proxy parser
|
|
_ -> error $ "analysis not supported for " <> show lang
|
|
where lang = reflect proxy
|
|
|
|
|
|
members :: EdgeLabel
|
|
-> Heap Precise Precise (Value term Precise)
|
|
-> ScopeGraph Precise
|
|
-> Value term Precise
|
|
-> Maybe [Name]
|
|
members edgeLabel heap scopeGraph (Data.Abstract.Value.Concrete.Object frame) = frameNames [ edgeLabel ] heap scopeGraph frame
|
|
members edgeLabel heap scopeGraph (Class _ _ frame) = frameNames [ edgeLabel ] heap scopeGraph frame
|
|
members _ _ _ _ = Nothing
|
|
|
|
frameNames :: [ EdgeLabel ]
|
|
-> Heap Precise Precise (Value term Precise)
|
|
-> ScopeGraph Precise
|
|
-> Precise
|
|
-> Maybe [ Name ]
|
|
frameNames edge heap scopeGraph frame = do
|
|
scopeAddress <- Heap.scopeLookup frame heap
|
|
scope <- ScopeGraph.lookupScope scopeAddress scopeGraph
|
|
pure (unDeclaration <$> toList (ScopeGraph.declarationNames edge scope scopeGraph))
|
|
|
|
lookupMembers :: Name -> EdgeLabel -> (Precise, Precise) -> Heap Precise Precise (Value term Precise) -> ScopeGraph Precise -> Maybe [ Name ]
|
|
lookupMembers name edgeLabel scopeAndFrame heap scopeGraph =
|
|
(lookupDeclaration name scopeAndFrame heap scopeGraph >>= members edgeLabel heap scopeGraph . Prelude.head)
|
|
|
|
lookupDeclaration :: Name -> (Precise, Precise) -> Heap Precise Precise (Value term Precise) -> ScopeGraph Precise -> Maybe [ Value term Precise ]
|
|
lookupDeclaration name (currentScope, currentFrame) heap scopeGraph = do
|
|
path <- ScopeGraph.lookupScopePath name currentScope scopeGraph
|
|
frameAddress <- Heap.lookupFrameAddress path currentFrame heap
|
|
toList <$> Heap.getSlotValue (Slot frameAddress (Heap.pathPosition path)) heap
|