{-# language CPP #-}
module Nix.String.Coerce where
import Nix.Prelude
import Control.Monad.Catch ( MonadThrow )
import GHC.Exception ( ErrorCall(ErrorCall) )
import qualified Data.HashMap.Lazy as M
import Nix.Atoms
import Nix.Expr.Types ( VarName )
import Nix.Effects
import Nix.Frames
import Nix.String
import Nix.Value
import Nix.Value.Monad
#ifdef MIN_VERSION_ghc_datasize
import GHC.DataSize
#endif
data CoercionLevel
= CoerceStringlike
| CoerceAny
deriving (CoercionLevel -> CoercionLevel -> Bool
(CoercionLevel -> CoercionLevel -> Bool)
-> (CoercionLevel -> CoercionLevel -> Bool) -> Eq CoercionLevel
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: CoercionLevel -> CoercionLevel -> Bool
$c/= :: CoercionLevel -> CoercionLevel -> Bool
== :: CoercionLevel -> CoercionLevel -> Bool
$c== :: CoercionLevel -> CoercionLevel -> Bool
Eq,Eq CoercionLevel
Eq CoercionLevel
-> (CoercionLevel -> CoercionLevel -> Ordering)
-> (CoercionLevel -> CoercionLevel -> Bool)
-> (CoercionLevel -> CoercionLevel -> Bool)
-> (CoercionLevel -> CoercionLevel -> Bool)
-> (CoercionLevel -> CoercionLevel -> Bool)
-> (CoercionLevel -> CoercionLevel -> CoercionLevel)
-> (CoercionLevel -> CoercionLevel -> CoercionLevel)
-> Ord CoercionLevel
CoercionLevel -> CoercionLevel -> Bool
CoercionLevel -> CoercionLevel -> Ordering
CoercionLevel -> CoercionLevel -> CoercionLevel
forall a.
Eq a
-> (a -> a -> Ordering)
-> (a -> a -> Bool)
-> (a -> a -> Bool)
-> (a -> a -> Bool)
-> (a -> a -> Bool)
-> (a -> a -> a)
-> (a -> a -> a)
-> Ord a
min :: CoercionLevel -> CoercionLevel -> CoercionLevel
$cmin :: CoercionLevel -> CoercionLevel -> CoercionLevel
max :: CoercionLevel -> CoercionLevel -> CoercionLevel
$cmax :: CoercionLevel -> CoercionLevel -> CoercionLevel
>= :: CoercionLevel -> CoercionLevel -> Bool
$c>= :: CoercionLevel -> CoercionLevel -> Bool
> :: CoercionLevel -> CoercionLevel -> Bool
$c> :: CoercionLevel -> CoercionLevel -> Bool
<= :: CoercionLevel -> CoercionLevel -> Bool
$c<= :: CoercionLevel -> CoercionLevel -> Bool
< :: CoercionLevel -> CoercionLevel -> Bool
$c< :: CoercionLevel -> CoercionLevel -> Bool
compare :: CoercionLevel -> CoercionLevel -> Ordering
$ccompare :: CoercionLevel -> CoercionLevel -> Ordering
$cp1Ord :: Eq CoercionLevel
Ord,Int -> CoercionLevel
CoercionLevel -> Int
CoercionLevel -> [CoercionLevel]
CoercionLevel -> CoercionLevel
CoercionLevel -> CoercionLevel -> [CoercionLevel]
CoercionLevel -> CoercionLevel -> CoercionLevel -> [CoercionLevel]
(CoercionLevel -> CoercionLevel)
-> (CoercionLevel -> CoercionLevel)
-> (Int -> CoercionLevel)
-> (CoercionLevel -> Int)
-> (CoercionLevel -> [CoercionLevel])
-> (CoercionLevel -> CoercionLevel -> [CoercionLevel])
-> (CoercionLevel -> CoercionLevel -> [CoercionLevel])
-> (CoercionLevel
-> CoercionLevel -> CoercionLevel -> [CoercionLevel])
-> Enum CoercionLevel
forall a.
(a -> a)
-> (a -> a)
-> (Int -> a)
-> (a -> Int)
-> (a -> [a])
-> (a -> a -> [a])
-> (a -> a -> [a])
-> (a -> a -> a -> [a])
-> Enum a
enumFromThenTo :: CoercionLevel -> CoercionLevel -> CoercionLevel -> [CoercionLevel]
$cenumFromThenTo :: CoercionLevel -> CoercionLevel -> CoercionLevel -> [CoercionLevel]
enumFromTo :: CoercionLevel -> CoercionLevel -> [CoercionLevel]
$cenumFromTo :: CoercionLevel -> CoercionLevel -> [CoercionLevel]
enumFromThen :: CoercionLevel -> CoercionLevel -> [CoercionLevel]
$cenumFromThen :: CoercionLevel -> CoercionLevel -> [CoercionLevel]
enumFrom :: CoercionLevel -> [CoercionLevel]
$cenumFrom :: CoercionLevel -> [CoercionLevel]
fromEnum :: CoercionLevel -> Int
$cfromEnum :: CoercionLevel -> Int
toEnum :: Int -> CoercionLevel
$ctoEnum :: Int -> CoercionLevel
pred :: CoercionLevel -> CoercionLevel
$cpred :: CoercionLevel -> CoercionLevel
succ :: CoercionLevel -> CoercionLevel
$csucc :: CoercionLevel -> CoercionLevel
Enum,CoercionLevel
CoercionLevel -> CoercionLevel -> Bounded CoercionLevel
forall a. a -> a -> Bounded a
maxBound :: CoercionLevel
$cmaxBound :: CoercionLevel
minBound :: CoercionLevel
$cminBound :: CoercionLevel
Bounded)
data CopyToStoreMode
= CopyToStore
| DontCopyToStore
deriving (CopyToStoreMode -> CopyToStoreMode -> Bool
(CopyToStoreMode -> CopyToStoreMode -> Bool)
-> (CopyToStoreMode -> CopyToStoreMode -> Bool)
-> Eq CopyToStoreMode
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: CopyToStoreMode -> CopyToStoreMode -> Bool
$c/= :: CopyToStoreMode -> CopyToStoreMode -> Bool
== :: CopyToStoreMode -> CopyToStoreMode -> Bool
$c== :: CopyToStoreMode -> CopyToStoreMode -> Bool
Eq,Eq CopyToStoreMode
Eq CopyToStoreMode
-> (CopyToStoreMode -> CopyToStoreMode -> Ordering)
-> (CopyToStoreMode -> CopyToStoreMode -> Bool)
-> (CopyToStoreMode -> CopyToStoreMode -> Bool)
-> (CopyToStoreMode -> CopyToStoreMode -> Bool)
-> (CopyToStoreMode -> CopyToStoreMode -> Bool)
-> (CopyToStoreMode -> CopyToStoreMode -> CopyToStoreMode)
-> (CopyToStoreMode -> CopyToStoreMode -> CopyToStoreMode)
-> Ord CopyToStoreMode
CopyToStoreMode -> CopyToStoreMode -> Bool
CopyToStoreMode -> CopyToStoreMode -> Ordering
CopyToStoreMode -> CopyToStoreMode -> CopyToStoreMode
forall a.
Eq a
-> (a -> a -> Ordering)
-> (a -> a -> Bool)
-> (a -> a -> Bool)
-> (a -> a -> Bool)
-> (a -> a -> Bool)
-> (a -> a -> a)
-> (a -> a -> a)
-> Ord a
min :: CopyToStoreMode -> CopyToStoreMode -> CopyToStoreMode
$cmin :: CopyToStoreMode -> CopyToStoreMode -> CopyToStoreMode
max :: CopyToStoreMode -> CopyToStoreMode -> CopyToStoreMode
$cmax :: CopyToStoreMode -> CopyToStoreMode -> CopyToStoreMode
>= :: CopyToStoreMode -> CopyToStoreMode -> Bool
$c>= :: CopyToStoreMode -> CopyToStoreMode -> Bool
> :: CopyToStoreMode -> CopyToStoreMode -> Bool
$c> :: CopyToStoreMode -> CopyToStoreMode -> Bool
<= :: CopyToStoreMode -> CopyToStoreMode -> Bool
$c<= :: CopyToStoreMode -> CopyToStoreMode -> Bool
< :: CopyToStoreMode -> CopyToStoreMode -> Bool
$c< :: CopyToStoreMode -> CopyToStoreMode -> Bool
compare :: CopyToStoreMode -> CopyToStoreMode -> Ordering
$ccompare :: CopyToStoreMode -> CopyToStoreMode -> Ordering
$cp1Ord :: Eq CopyToStoreMode
Ord,Int -> CopyToStoreMode
CopyToStoreMode -> Int
CopyToStoreMode -> [CopyToStoreMode]
CopyToStoreMode -> CopyToStoreMode
CopyToStoreMode -> CopyToStoreMode -> [CopyToStoreMode]
CopyToStoreMode
-> CopyToStoreMode -> CopyToStoreMode -> [CopyToStoreMode]
(CopyToStoreMode -> CopyToStoreMode)
-> (CopyToStoreMode -> CopyToStoreMode)
-> (Int -> CopyToStoreMode)
-> (CopyToStoreMode -> Int)
-> (CopyToStoreMode -> [CopyToStoreMode])
-> (CopyToStoreMode -> CopyToStoreMode -> [CopyToStoreMode])
-> (CopyToStoreMode -> CopyToStoreMode -> [CopyToStoreMode])
-> (CopyToStoreMode
-> CopyToStoreMode -> CopyToStoreMode -> [CopyToStoreMode])
-> Enum CopyToStoreMode
forall a.
(a -> a)
-> (a -> a)
-> (Int -> a)
-> (a -> Int)
-> (a -> [a])
-> (a -> a -> [a])
-> (a -> a -> [a])
-> (a -> a -> a -> [a])
-> Enum a
enumFromThenTo :: CopyToStoreMode
-> CopyToStoreMode -> CopyToStoreMode -> [CopyToStoreMode]
$cenumFromThenTo :: CopyToStoreMode
-> CopyToStoreMode -> CopyToStoreMode -> [CopyToStoreMode]
enumFromTo :: CopyToStoreMode -> CopyToStoreMode -> [CopyToStoreMode]
$cenumFromTo :: CopyToStoreMode -> CopyToStoreMode -> [CopyToStoreMode]
enumFromThen :: CopyToStoreMode -> CopyToStoreMode -> [CopyToStoreMode]
$cenumFromThen :: CopyToStoreMode -> CopyToStoreMode -> [CopyToStoreMode]
enumFrom :: CopyToStoreMode -> [CopyToStoreMode]
$cenumFrom :: CopyToStoreMode -> [CopyToStoreMode]
fromEnum :: CopyToStoreMode -> Int
$cfromEnum :: CopyToStoreMode -> Int
toEnum :: Int -> CopyToStoreMode
$ctoEnum :: Int -> CopyToStoreMode
pred :: CopyToStoreMode -> CopyToStoreMode
$cpred :: CopyToStoreMode -> CopyToStoreMode
succ :: CopyToStoreMode -> CopyToStoreMode
$csucc :: CopyToStoreMode -> CopyToStoreMode
Enum,CopyToStoreMode
CopyToStoreMode -> CopyToStoreMode -> Bounded CopyToStoreMode
forall a. a -> a -> Bounded a
maxBound :: CopyToStoreMode
$cmaxBound :: CopyToStoreMode
minBound :: CopyToStoreMode
$cminBound :: CopyToStoreMode
Bounded)
coerceToString
:: forall e t f m
. ( Framed e m
, MonadStore m
, MonadThrow m
, MonadDataErrorContext t f m
, MonadValue (NValue t f m) m
)
=> (NValue t f m -> NValue t f m -> m (NValue t f m))
-> CopyToStoreMode
-> CoercionLevel
-> NValue t f m
-> m NixString
coerceToString :: (NValue t f m -> NValue t f m -> m (NValue t f m))
-> CopyToStoreMode -> CoercionLevel -> NValue t f m -> m NixString
coerceToString NValue t f m -> NValue t f m -> m (NValue t f m)
call CopyToStoreMode
ctsm CoercionLevel
clevel =
(NValue t f m -> m NixString)
-> (NValue t f m -> m NixString)
-> Bool
-> NValue t f m
-> m NixString
forall a. a -> a -> Bool -> a
bool
((NValue t f m -> NValue t f m -> m (NValue t f m))
-> CopyToStoreMode -> NValue t f m -> m NixString
forall e t (f :: * -> *) (m :: * -> *).
(Framed e m, MonadStore m, MonadThrow m,
MonadDataErrorContext t f m, MonadValue (NValue t f m) m) =>
(NValue t f m -> NValue t f m -> m (NValue t f m))
-> CopyToStoreMode -> NValue t f m -> m NixString
coerceAnyToNixString NValue t f m -> NValue t f m -> m (NValue t f m)
call CopyToStoreMode
ctsm)
(CopyToStoreMode -> NValue t f m -> m NixString
forall e t (f :: * -> *) (m :: * -> *).
(Framed e m, MonadStore m, MonadThrow m,
MonadDataErrorContext t f m, MonadValue (NValue t f m) m) =>
CopyToStoreMode -> NValue t f m -> m NixString
coerceStringlikeToNixString CopyToStoreMode
ctsm)
(CoercionLevel
clevel CoercionLevel -> CoercionLevel -> Bool
forall a. Eq a => a -> a -> Bool
== CoercionLevel
CoerceStringlike)
coerceAnyToNixString
:: forall e t f m
. ( Framed e m
, MonadStore m
, MonadThrow m
, MonadDataErrorContext t f m
, MonadValue (NValue t f m) m
)
=> (NValue t f m -> NValue t f m -> m (NValue t f m))
-> CopyToStoreMode
-> NValue t f m
-> m NixString
coerceAnyToNixString :: (NValue t f m -> NValue t f m -> m (NValue t f m))
-> CopyToStoreMode -> NValue t f m -> m NixString
coerceAnyToNixString NValue t f m -> NValue t f m -> m (NValue t f m)
call CopyToStoreMode
ctsm = NValue t f m -> m NixString
go
where
go :: NValue t f m -> m NixString
go :: NValue t f m -> m NixString
go NValue t f m
x =
NValue t f m -> m NixString
coerceAny (NValue t f m -> m NixString) -> m (NValue t f m) -> m NixString
forall (m :: * -> *) a b. Monad m => (a -> m b) -> m a -> m b
=<< NValue t f m -> m (NValue t f m)
forall v (m :: * -> *). MonadValue v m => v -> m v
demand NValue t f m
x
where
coerceAny :: NValue t f m -> m NixString
coerceAny :: NValue t f m -> m NixString
coerceAny =
\case
NVConstant (NBool Bool
b) ->
Text -> m NixString
castToNixString (Text -> m NixString) -> Text -> m NixString
forall a b. (a -> b) -> a -> b
$ Text
"1" Text -> Bool -> Text
forall a. Monoid a => a -> Bool -> a
`whenTrue` Bool
b
NVConstant (NInt Integer
n) ->
Text -> m NixString
castToNixString (Text -> m NixString) -> Text -> m NixString
forall a b. (a -> b) -> a -> b
$ Integer -> Text
forall b a. (Show a, IsString b) => a -> b
show Integer
n
NVConstant (NFloat Float
n) ->
Text -> m NixString
castToNixString (Text -> m NixString) -> Text -> m NixString
forall a b. (a -> b) -> a -> b
$ Float -> Text
forall b a. (Show a, IsString b) => a -> b
show Float
n
NVConstant NAtom
NNull ->
Text -> m NixString
castToNixString Text
forall a. Monoid a => a
mempty
NVList [NValue t f m]
l ->
[NixString] -> NixString
nixStringUnwords ([NixString] -> NixString) -> m [NixString] -> m NixString
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
<$> (NValue t f m -> m NixString) -> [NValue t f m] -> m [NixString]
forall (t :: * -> *) (f :: * -> *) a b.
(Traversable t, Applicative f) =>
(a -> f b) -> t a -> f (t b)
traverse NValue t f m -> m NixString
go [NValue t f m]
l
v :: NValue t f m
v@(NVSet PositionSet
_ AttrSet (NValue t f m)
s) ->
m NixString -> Maybe (m NixString) -> m NixString
forall a. a -> Maybe a -> a
fromMaybe
(NValue t f m -> m NixString
forall e (m :: * -> *) a a.
(MonadReader e m, Has e Frames, MonadThrow m, Show a) =>
a -> m a
err NValue t f m
v)
(Maybe (m NixString) -> m NixString)
-> Maybe (m NixString) -> m NixString
forall a b. (a -> b) -> a -> b
$ (NValue t f m -> m (NValue t f m))
-> VarName -> Maybe (m NixString)
continueOnKey (NValue t f m -> NValue t f m -> m (NValue t f m)
`call` NValue t f m
v) VarName
"__toString"
Maybe (m NixString) -> Maybe (m NixString) -> Maybe (m NixString)
forall (f :: * -> *) a. Alternative f => f a -> f a -> f a
<|> (NValue t f m -> m (NValue t f m))
-> VarName -> Maybe (m NixString)
continueOnKey NValue t f m -> m (NValue t f m)
forall (f :: * -> *) a. Applicative f => a -> f a
pure VarName
"outPath"
where
continueOnKey :: (NValue t f m -> m (NValue t f m)) -> VarName -> Maybe (m NixString)
continueOnKey :: (NValue t f m -> m (NValue t f m))
-> VarName -> Maybe (m NixString)
continueOnKey NValue t f m -> m (NValue t f m)
f = (NValue t f m -> m NixString)
-> Maybe (NValue t f m) -> Maybe (m NixString)
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
fmap (NValue t f m -> m NixString
go (NValue t f m -> m NixString)
-> (NValue t f m -> m (NValue t f m))
-> NValue t f m
-> m NixString
forall (m :: * -> *) b c a.
Monad m =>
(b -> m c) -> (a -> m b) -> a -> m c
<=< NValue t f m -> m (NValue t f m)
f) (Maybe (NValue t f m) -> Maybe (m NixString))
-> (VarName -> Maybe (NValue t f m))
-> VarName
-> Maybe (m NixString)
forall b c a. (b -> c) -> (a -> b) -> a -> c
. (VarName -> AttrSet (NValue t f m) -> Maybe (NValue t f m)
forall k v. (Eq k, Hashable k) => k -> HashMap k v -> Maybe v
`M.lookup` AttrSet (NValue t f m)
s)
err :: a -> m a
err a
v' = ErrorCall -> m a
forall s e (m :: * -> *) a.
(Framed e m, Exception s, MonadThrow m) =>
s -> m a
throwError (ErrorCall -> m a) -> ErrorCall -> m a
forall a b. (a -> b) -> a -> b
$ String -> ErrorCall
ErrorCall (String -> ErrorCall) -> String -> ErrorCall
forall a b. (a -> b) -> a -> b
$ String
"Expected a Set that has `__toString` or `outpath`, but saw: " String -> String -> String
forall a. Semigroup a => a -> a -> a
<> a -> String
forall b a. (Show a, IsString b) => a -> b
show a
v'
NValue t f m
v -> NValue t f m -> m NixString
coerceStringlike NValue t f m
v
where
castToNixString :: Text -> m NixString
castToNixString = NixString -> m NixString
forall (f :: * -> *) a. Applicative f => a -> f a
pure (NixString -> m NixString)
-> (Text -> NixString) -> Text -> m NixString
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Text -> NixString
mkNixStringWithoutContext
nixStringUnwords :: [NixString] -> NixString
nixStringUnwords = NixString -> [NixString] -> NixString
intercalateNixString (NixString -> [NixString] -> NixString)
-> NixString -> [NixString] -> NixString
forall a b. (a -> b) -> a -> b
$ Text -> NixString
mkNixStringWithoutContext Text
" "
coerceStringlike :: NValue t f m -> m NixString
coerceStringlike :: NValue t f m -> m NixString
coerceStringlike = CopyToStoreMode -> NValue t f m -> m NixString
forall e t (f :: * -> *) (m :: * -> *).
(Framed e m, MonadStore m, MonadThrow m,
MonadDataErrorContext t f m, MonadValue (NValue t f m) m) =>
CopyToStoreMode -> NValue t f m -> m NixString
coerceStringlikeToNixString CopyToStoreMode
ctsm
coerceStringlikeToNixString
:: forall e t f m
. ( Framed e m
, MonadStore m
, MonadThrow m
, MonadDataErrorContext t f m
, MonadValue (NValue t f m) m
)
=> CopyToStoreMode
-> NValue t f m
-> m NixString
coerceStringlikeToNixString :: CopyToStoreMode -> NValue t f m -> m NixString
coerceStringlikeToNixString CopyToStoreMode
ctsm =
(\case
NVStr NixString
ns -> NixString -> m NixString
forall (f :: * -> *) a. Applicative f => a -> f a
pure NixString
ns
NVPath Path
p -> CopyToStoreMode -> Path -> m NixString
forall (m :: * -> *) e.
(MonadStore m, Framed e m) =>
CopyToStoreMode -> Path -> m NixString
coercePathToNixString CopyToStoreMode
ctsm Path
p
NValue t f m
v -> ErrorCall -> m NixString
forall s e (m :: * -> *) a.
(Framed e m, Exception s, MonadThrow m) =>
s -> m a
throwError (ErrorCall -> m NixString) -> ErrorCall -> m NixString
forall a b. (a -> b) -> a -> b
$ String -> ErrorCall
ErrorCall (String -> ErrorCall) -> String -> ErrorCall
forall a b. (a -> b) -> a -> b
$ String
"Expected a path or string, but saw: " String -> String -> String
forall a. Semigroup a => a -> a -> a
<> NValue t f m -> String
forall b a. (Show a, IsString b) => a -> b
show NValue t f m
v
) (NValue t f m -> m NixString)
-> (NValue t f m -> m (NValue t f m))
-> NValue t f m
-> m NixString
forall (m :: * -> *) b c a.
Monad m =>
(b -> m c) -> (a -> m b) -> a -> m c
<=< NValue t f m -> m (NValue t f m)
forall v (m :: * -> *). MonadValue v m => v -> m v
demand
coercePathToNixString :: (MonadStore m, Framed e m) => CopyToStoreMode -> Path -> m NixString
coercePathToNixString :: CopyToStoreMode -> Path -> m NixString
coercePathToNixString =
(Path -> m NixString)
-> (Path -> m NixString) -> Bool -> Path -> m NixString
forall a. a -> a -> Bool -> a
bool
(NixString -> m NixString
forall (f :: * -> *) a. Applicative f => a -> f a
pure (NixString -> m NixString)
-> (Path -> NixString) -> Path -> m NixString
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Text -> NixString
mkNixStringWithoutContext (Text -> NixString) -> (Path -> Text) -> Path -> NixString
forall b c a. (b -> c) -> (a -> b) -> a -> c
. String -> Text
forall a. IsString a => String -> a
fromString (String -> Text) -> (Path -> String) -> Path -> Text
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Path -> String
coerce)
((StorePath -> NixString
storePathToNixString (StorePath -> NixString) -> m StorePath -> m NixString
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
<$>) (m StorePath -> m NixString)
-> (Path -> m StorePath) -> Path -> m NixString
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Path -> m StorePath
forall e (m :: * -> *).
(Framed e m, MonadStore m) =>
Path -> m StorePath
addPath)
(Bool -> Path -> m NixString)
-> (CopyToStoreMode -> Bool)
-> CopyToStoreMode
-> Path
-> m NixString
forall b c a. (b -> c) -> (a -> b) -> a -> c
. (CopyToStoreMode
CopyToStore CopyToStoreMode -> CopyToStoreMode -> Bool
forall a. Eq a => a -> a -> Bool
==)
where
storePathToNixString :: StorePath -> NixString
storePathToNixString :: StorePath -> NixString
storePathToNixString (String -> VarName
forall a. IsString a => String -> a
fromString (String -> VarName)
-> (StorePath -> String) -> StorePath -> VarName
forall b c a. (b -> c) -> (a -> b) -> a -> c
. StorePath -> String
coerce -> VarName
sp) =
(StringContext -> VarName -> NixString
mkNixStringWithSingletonContext (StringContext -> VarName -> NixString)
-> (VarName -> StringContext) -> VarName -> VarName -> NixString
forall b c a. (b -> c) -> (a -> b) -> a -> c
. ContextFlavor -> VarName -> StringContext
StringContext ContextFlavor
DirectPath) VarName
sp VarName
sp