angular-docs-cn/dev-infra/ts-circular-dependencies
Paul Gschwendtner 762e057e85 build: update to rules_nodejs v4.0.0-beta.0 (#42760)
Updates the Bazel NodeJS rules to v4.0.0-beta.0. This is necessary
so that the Angular components repo can update, and it's generally
good to stay as up-to-date as possible with the Bazel rules as it's
easy to fall behind, and updating early allows us to discover issues
affecting our tooling earlier (where they are easier to address due to
e.g. potential breaking change policy).

PR Close #42760
2021-07-09 14:50:15 -07:00
..
BUILD.bazel build: update to rules_nodejs v4.0.0-beta.0 (#42760) 2021-07-09 14:50:15 -07:00
README.md docs(dev-infra): document limitation in ts-circular-deps tool (#36659) 2020-04-17 16:25:00 -04:00
analyzer.ts build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
config.ts style(dev-infra): correct tslint failures in dev-infra directory (#37233) 2020-06-04 12:44:46 -07:00
example-graph.png docs(dev-infra): document limitation in ts-circular-deps tool (#36659) 2020-04-17 16:25:00 -04:00
file_system.ts build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
golden.ts build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
index.ts fix(dev-infra): exclude node_modules from circular dependency checks (#41407) 2021-04-02 15:47:33 -07:00
parser.ts build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00

README.md

ts-circular-dependencies

This tool requires a test configuration that declares a set of source files which should be checked for cyclic dependencies. e.g.

yarn ts-circular-deps --config ./test-config.js <check|approve>

Limitations

In order to detect cycles, the tool currently visits each source file and runs depth first search. If the DFS comes across any node that is part of the current DFS path, then a cycle has been detected and the tool will capture it.

This algorithm has limitations. For example, consider the following graph:

Example graph

Depending on which source file is considered first, the output of the circular dependency tool will be different. This is because the tool does not recursively find all possible cycles. This would be too inefficient for large graphs (especially in the angular/angular repository).

In this concrete example, the tool will visit r3_test_bed first. Then the first neighbour (based on the import in the source file) will be visited. This is test_bed. Once done, the tool will visit the first neighbour of test_bed. This is r3_test_bed again. The node has already been visited, and also is part of the current DFS path. The tool captures this as cycle.

As no more nodes can be visited within that path, the tool continues (as per DFS algorithm) with visiting the remaining neighbours of r3_test_bed. It will visit test_bed_common and then come across test_bed. The tool only knows that test_bed has already been visited, but it does not know that it would close a cycle. The tool certainly could know this by recursively checking neighbours of test_bed again, but this is inefficient and will cause the algorithm to eventually degenerate into brute-force.

In summary, the tool is unable to capture all elementary cycles in the graph. This does not mean though that the tool is incorrectly suggesting that there are no cycles in a graph. The tool is still able to correctly detect whether there are any cycles in a graph or not. For example, if edge from r3_test_bed to test_bed is removed, then the tool will be able to capture at least one of the other cycles. The golden will change in an unexpected way, but it's expected given the trade-off we take for an acceptable running time.

Other algorithms exist which are proven to print out all the elementary cycles in a directed graph. For example:

Experiments with these algorithms unveiled that usual source file graphs we have in Angular repositories are too large to be processed in acceptable time. At the time of writing, the source file graph of angular/angular consists of 3350 nodes and 8730 edges.

Algorithms like the one from Donald B. Johnson, which first split the graph into strongly connected components, and then search for elementary cycles in all components with at least two vertices, are too inefficient for the source files graphs we have. Time complexity for such algorithms is described to be O((n + e)(c + 1)) where c is the number of elementary circuits. Donald B. Johnson describes the number of elementary circuits the followed:

Thus the number of elementary circuits in a directed graph can grow faster with n than the exponential 2"

This shows quite well that these algorithms become quickly inefficient the more vertices, edges and simple cycles a graph has. Finding elementary cycles of arbitrary length seems NP-complete as finding a Hamiltonian cycle with length of n is NP-complete too. Below is a quote from a paper describing a randomized algorithm for finding simple cycles of a fixed length that seems to confirm this hypothesis:

It is well known that finding the longest cycle in a graph is a hard problem, since finding a hamiltonian cycle is NP-complete. Hence finding a simple cycle of length k, for an arbitrary k, is NP-complete.

Other tools like madge or dpdm have the same limitations.

Resources: