7186f9c016
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 provided. 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 static method, `FileSystem.getFileSystem()`. This is also used by a number of static methods on `AbsoluteFsPath` and `PathSegment`, 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 static 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 `FileSystem.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. * `addTestFilesToFileSystem()` - use this to add files and their contents to the mock file system for testing. * `loadTestFilesFromDisk()` - 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. PR Close #30921
65 lines
2.2 KiB
TypeScript
65 lines
2.2 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright Google Inc. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
* found in the LICENSE file at https://angular.io/license
|
|
*/
|
|
|
|
import {BoundTarget, CssSelector, ParseTemplateOptions, R3TargetBinder, SelectorMatcher, parseTemplate} from '@angular/compiler';
|
|
import * as ts from 'typescript';
|
|
import {AbsoluteFsPath, absoluteFrom} from '../../file_system';
|
|
import {Reference} from '../../imports';
|
|
import {DirectiveMeta} from '../../metadata';
|
|
import {ClassDeclaration} from '../../reflection';
|
|
import {getDeclaration, makeProgram} from '../../testing';
|
|
|
|
/** Dummy file URL */
|
|
export function getTestFilePath(): AbsoluteFsPath {
|
|
return absoluteFrom('/TEST_FILE.ts');
|
|
}
|
|
|
|
/**
|
|
* Creates a class declaration from a component source code.
|
|
*/
|
|
export function getComponentDeclaration(componentStr: string, className: string): ClassDeclaration {
|
|
const program = makeProgram([{name: getTestFilePath(), contents: componentStr}]);
|
|
|
|
return getDeclaration(
|
|
program.program, getTestFilePath(), className,
|
|
(value: ts.Declaration): value is ClassDeclaration => ts.isClassDeclaration(value));
|
|
}
|
|
|
|
/**
|
|
* Parses a template source code and returns a template-bound target, optionally with information
|
|
* about used components.
|
|
*
|
|
* @param template template to parse
|
|
* @param options extra template parsing options
|
|
* @param components components to bind to the template target
|
|
*/
|
|
export function getBoundTemplate(
|
|
template: string, options: ParseTemplateOptions = {},
|
|
components: Array<{selector: string, declaration: ClassDeclaration}> =
|
|
[]): BoundTarget<DirectiveMeta> {
|
|
const matcher = new SelectorMatcher<DirectiveMeta>();
|
|
components.forEach(({selector, declaration}) => {
|
|
matcher.addSelectables(CssSelector.parse(selector), {
|
|
ref: new Reference(declaration),
|
|
selector,
|
|
queries: [],
|
|
ngTemplateGuards: [],
|
|
hasNgTemplateContextGuard: false,
|
|
baseClass: null,
|
|
name: declaration.name.getText(),
|
|
isComponent: true,
|
|
inputs: {},
|
|
outputs: {},
|
|
exportAs: null,
|
|
});
|
|
});
|
|
const binder = new R3TargetBinder(matcher);
|
|
|
|
return binder.bind({template: parseTemplate(template, getTestFilePath(), options).nodes});
|
|
}
|