1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
// slang-artifact-util.h
#ifndef SLANG_ARTIFACT_UTIL_H
#define SLANG_ARTIFACT_UTIL_H
#include "slang-artifact-associated.h"
#include "slang-artifact-representation.h"
#include "slang-artifact.h"
#include "slang-com-ptr.h"
namespace Slang
{
struct ArtifactUtil
{
typedef bool (*FindFunc)(IArtifact* artifact, void* data);
enum class FindStyle : uint8_t
{
Self, ///< Just on self
SelfOrChildren, ///< Self, or if container just the children
Recursive, ///< On self plus any children recursively
Children, ///< Only on children
ChildrenRecursive, ///< Only on children recursively
};
/// Find an artifact that matches desc allowing derivations. Flags is ignored
static IArtifact* findArtifactByDerivedDesc(
IArtifact* artifact,
FindStyle findStyle,
const ArtifactDesc& desc);
/// Find an artifact that predicate matches
static IArtifact* findArtifactByPredicate(
IArtifact* artifact,
FindStyle findStyle,
FindFunc func,
void* data);
/// Find by name
static IArtifact* findArtifactByName(
IArtifact* artifact,
FindStyle findStyle,
const char* name);
/// Find by desc exactly
static IArtifact* findArtifactByDesc(
IArtifact* artifact,
FindStyle findStyle,
const ArtifactDesc& desc);
/// Creates an empty artifact for a type
static ComPtr<IArtifact> createArtifactForCompileTarget(SlangCompileTarget target);
/// Create an artifact
static ComPtr<IArtifact> createArtifact(const ArtifactDesc& desc, const char* name);
static ComPtr<IArtifact> createArtifact(const ArtifactDesc& desc);
/// True if is significant
static bool isSignificant(IArtifact* artifact);
/// True if is significant
static bool isSignificant(const ArtifactDesc& desc);
/// Returns true if an artifact is 'significant'.
/// The data parameter is unused and just used to make work as FindFunc
static bool isSignificant(IArtifact* artifact, void* data);
/// Find a significant artifact
static IArtifact* findSignificant(IArtifact* artifact);
/// Find the path/name associated with the artifact.
/// The path is *not* necessarily the path on the file system. The order of search is
/// * If the artifact has a name return that
/// * If the artifact has a IPathFileArtifactRepresentation (that isn't temporary) return it's
/// path
/// * If not found return an empty slice
static UnownedStringSlice findPath(IArtifact* artifact);
/// Find a name
static UnownedStringSlice findName(IArtifact* artifact);
/// Sometimes we have artifacts that don't specify a payload type - perhaps because they can be
/// interpretted in different ways This function uses the associated name and file
/// representations to infer a extension. If none is found returns an empty slice.
static UnownedStringSlice inferExtension(IArtifact* artifact);
/// Given a desc and a basePath returns a suitable path for a entity of specified desc
static SlangResult calcPath(
IArtifact* artifact,
const UnownedStringSlice& basePath,
StringBuilder& outPath);
/// Given a desc and a baseName works out the the output file name
static SlangResult calcName(
IArtifact* artifact,
const UnownedStringSlice& baseName,
StringBuilder& outName);
/// Convenience function that adds metadata to artifact. If metadata is nullptr nothing is
/// added.
static void addAssociated(IArtifact* artifact, IArtifactPostEmitMetadata* metadata);
/// Convenience function that adds diagnostics to artifact. If diagnostics is nullptr nothing is
/// added.
static void addAssociated(IArtifact* artifact, IArtifactDiagnostics* diagnostics);
};
} // namespace Slang
#endif
|
