nx/docs/generated/devkit/ProjectGraphBuilder.md

Class: ProjectGraphBuilder

A class which builds up a project graph

Deprecated

The ProjectGraphProcessor has been deprecated. Use a CreateNodes and/or a CreateDependencies instead. This will be removed in Nx 18.

Table of contents

Constructors

• constructor

Properties

• graph: ProjectGraph
• nonProjectFiles: FileData[]
• projectFileMap: ProjectFileMap
• removedEdges: Object

Methods

• addDependency
• addDynamicDependency
• addExplicitDependency
• addExternalNode
• addImplicitDependency
• addNode
• addStaticDependency
• calculateAlreadySetTargetDeps
• calculateTargetDepsFromFiles
• getUpdatedProjectGraph
• mergeProjectGraph
• removeDependenciesWithNode
• removeDependency
• removeNode
• setVersion

Constructors

constructor

• new ProjectGraphBuilder(graph?, projectFileMap?, nonProjectFiles?)

Parameters

Name	Type
graph?	ProjectGraph
projectFileMap?	ProjectFileMap
nonProjectFiles?	FileData[]

Properties

graph

• Readonly graph: ProjectGraph

---

nonProjectFiles

• Private Readonly nonProjectFiles: FileData[]

---

projectFileMap

• Private Readonly projectFileMap: ProjectFileMap

---

removedEdges

• Readonly removedEdges: Object = {}

Index signature

▪ [source: string]: Set<string>

Methods

addDependency

▸ addDependency(source, target, type, sourceFile?): void

Parameters

Name	Type
source	string
target	string
type	DependencyType
sourceFile?	string

Returns

void

---

addDynamicDependency

▸ addDynamicDependency(sourceProjectName, targetProjectName, sourceProjectFile): void

Adds dynamic dependency from source project to target project

Parameters

Name	Type
sourceProjectName	string
targetProjectName	string
sourceProjectFile	string

Returns

void

---

addExplicitDependency

▸ addExplicitDependency(sourceProjectName, sourceProjectFile, targetProjectName): void

Add an explicit dependency from a file in source project to target project

Deprecated

this method will be removed in v17. Use addStaticDependency or addDynamicDependency instead

Parameters

Name	Type
sourceProjectName	string
sourceProjectFile	string
targetProjectName	string

Returns

void

---

addExternalNode

▸ addExternalNode(node): void

Adds a external node to the project graph

Parameters

Name	Type
node	ProjectGraphExternalNode

Returns

void

---

addImplicitDependency

▸ addImplicitDependency(sourceProjectName, targetProjectName): void

Adds implicit dependency from source project to target project

Parameters

Name	Type
sourceProjectName	string
targetProjectName	string

Returns

void

---

addNode

▸ addNode(node): void

Adds a project node to the project graph

Parameters

Name	Type
node	ProjectGraphProjectNode

Returns

void

---

addStaticDependency

▸ addStaticDependency(sourceProjectName, targetProjectName, sourceProjectFile?): void

Adds static dependency from source project to target project

Parameters

Name	Type
sourceProjectName	string
targetProjectName	string
sourceProjectFile?	string

Returns

void

---

calculateAlreadySetTargetDeps

▸ Private calculateAlreadySetTargetDeps(sourceProject): Map<string, Map<string, ProjectGraphDependency>>

Parameters

Name	Type
sourceProject	string

Returns

Map<string, Map<string, ProjectGraphDependency>>

---

calculateTargetDepsFromFiles

▸ Private calculateTargetDepsFromFiles(sourceProject): Map<string, Set<string>>

Parameters

Name	Type
sourceProject	string

Returns

Map<string, Set<string>>

---

getUpdatedProjectGraph

▸ getUpdatedProjectGraph(): ProjectGraph

Returns

ProjectGraph

---

mergeProjectGraph

▸ mergeProjectGraph(p): void

Merges the nodes and dependencies of p into the built project graph.

Parameters

Name	Type
p	ProjectGraph

Returns

void

---

removeDependenciesWithNode

▸ Private removeDependenciesWithNode(name): void

Parameters

Name	Type
name	string

Returns

void

---

removeDependency

▸ removeDependency(sourceProjectName, targetProjectName): void

Removes a dependency from source project to target project

Parameters

Name	Type
sourceProjectName	string
targetProjectName	string

Returns

void

---

removeNode

▸ removeNode(name): void

Removes a node and all of its dependency edges from the graph

Parameters

Name	Type
name	string

Returns

void

---

setVersion

▸ setVersion(version): void

Set version of the project graph

Parameters

Name	Type
version	string

Returns

void