History

Pete Bacon Darwin eef07539a6 feat(ngcc): pause async ngcc processing if another process has the lockfile (#35131 )

ngcc uses a lockfile to prevent two ngcc instances from executing at the
same time. Previously, if a lockfile was found the current process would
error and exit.

Now, when in async mode, the current process is able to wait for the previous
process to release the lockfile before continuing itself.

PR Close #35131

2020-02-18 17:20:41 -08:00

src

refactor(compiler-cli): add invalidateCaches to CachedFileSystem (#35131 )

2020-02-18 17:20:41 -08:00

test

feat(ngcc): pause async ngcc processing if another process has the lockfile (#35131 )

2020-02-18 17:20:41 -08:00

testing

refactor(compiler-cli): add removeDir() to FileSystem (#35079 )

2020-01-31 17:02:44 -08:00

BUILD.bazel

refactor(compiler-cli): add removeDir() to FileSystem (#35079 )

2020-01-31 17:02:44 -08:00

index.ts

perf(ivy): ngcc - add a cache to the FileSystem (#30525 )

2019-07-09 09:40:46 -07:00

README.md

refactor(ivy): implement a virtual file-system layer in ngtsc + ngcc (#30921 )

2019-06-25 16:25:24 -07:00

README.md

Virtual file-system layer

To improve cross platform support, all file access (and path manipulation) is now done through a well known interface (FileSystem).

For testing a number of MockFileSystem implementations are supplied. These provide an in-memory file-system which emulates operating systems like OS/X, Unix and Windows.

The current file system is always available via the helper method, getFileSystem(). This is also used by a number of helper methods to avoid having to pass FileSystem objects around all the time. The result of this is that one must be careful to ensure that the file-system has been initialized before using any of these helper methods. To prevent this happening accidentally the current file system always starts out as an instance of InvalidFileSystem, which will throw an error if any of its methods are called.

You can set the current file-system by calling setFileSystem(). During testing you can call the helper function initMockFileSystem(os) which takes a string name of the OS to emulate, and will also monkey-patch aspects of the TypeScript library to ensure that TS is also using the current file-system.

Finally there is the NgtscCompilerHost to be used for any TypeScript compilation, which uses a given file-system.

All tests that interact with the file-system should be tested against each of the mock file-systems. A series of helpers have been provided to support such tests:

runInEachFileSystem() - wrap your tests in this helper to run all the wrapped tests in each of the mock file-systems, it calls initMockFileSystem() for each OS to emulate.
loadTestFiles() - use this to add files and their contents to the mock file system for testing.
loadStandardTestFiles() - use this to load a mirror image of files on disk into the in-memory mock file-system.
loadFakeCore() - use this to load a fake version of @angular/core into the mock file-system.

All ngcc and ngtsc source and tests now use this virtual file-system setup.