feat(angular): add new helper getAngularVersion

Author: Badisi

projects/docs/docs/apis/angular.md

@@ -474,6 +474,23 @@ export default (options: any): Rule =>
 
 ## Helpers
 
+### `getAngularVersion`
+
+Gets the version of Angular currently used in the project.
+
+```ts {6}
+import { getAngularVersion, schematic } from '@hug/ngx-schematics-utilities';
+import { Rule, Tree } from '@angular-devkit/schematics';
+
+export default (options: any): Rule =>
+  (tree: Tree): Rule => {
+    const ngVersion = getAngularVersion();
+    return schematic('my-schematic', [
+      ...
+    ]);
+  };
+```
+
 ### `getProjectOutputPath`
 
 Gets a project output path as defined in the `angular.json` file.

projects/lib/specs/angular.spec.ts

@@ -5,12 +5,12 @@ import { JSONFile } from '@schematics/angular/utility/json-file';
 import { join } from 'path';
 
 import {
-    addAngularJsonAsset, addAngularJsonScript, addAngularJsonStyle, addDeclarationToNgModule, addExportToNgModule, addImportToNgModule,
-    addProviderToBootstrapApplication, addProviderToNgModule, addRouteDeclarationToNgModule, ensureIsAngularApplication,
-    ensureIsAngularLibrary, ensureIsAngularWorkspace, getProjectFromWorkspace, getProjectMainFilePath, getProjectOutputPath,
-    isAngularVersion, isProjectStandalone, removeAngularJsonAsset, removeAngularJsonScript, removeAngularJsonStyle,
-    removeDeclarationFromNgModule, removeExportFromNgModule, removeImportFromNgModule, removeProviderFromBootstrapApplication,
-    removeProviderFromNgModule
+    addAngularJsonAsset, addAngularJsonScript, addAngularJsonStyle, addDeclarationToNgModule, addExportToNgModule,
+    addImportToNgModule, addProviderToBootstrapApplication, addProviderToNgModule, addRouteDeclarationToNgModule,
+    ensureIsAngularApplication, ensureIsAngularLibrary, ensureIsAngularWorkspace, getAngularVersion, getProjectFromWorkspace,
+    getProjectMainFilePath, getProjectOutputPath, isAngularVersion, isProjectStandalone, removeAngularJsonAsset,
+    removeAngularJsonScript, removeAngularJsonStyle, removeDeclarationFromNgModule, removeExportFromNgModule,
+    removeImportFromNgModule, removeProviderFromBootstrapApplication, removeProviderFromNgModule
 } from '../src';
 import { appTest1, appTest2, callRule, getCleanAppTree, libTest } from './common.spec';
 import { customMatchers } from './jasmine.matchers';
@@ -621,6 +621,10 @@ const expectAddToNgModule = async (
                 });
             }
 
+            it('helper: getAngularVersion', () => {
+                expect(getAngularVersion()).toBeDefined();
+            });
+
             it('helper: getProjectOutputPath', () => {
                 expect(getProjectOutputPath(tree, appTest1.name)).toEqual(`dist/${appTest1.name}`);
                 if (useWorkspace) {

projects/lib/src/angular.ts

@@ -1,3 +1,4 @@
+import { VERSION, Version } from '@angular/core';
 import { JsonObject, JsonValue } from '@angular-devkit/core';
 import { noop, Rule, SchematicsException, Tree } from '@angular-devkit/schematics';
 import {
@@ -73,11 +74,9 @@ export const ensureIsAngularLibrary = (projectName: string): Rule =>
  * @returns {Rule}
  */
 export const isAngularVersion = (range: string, rule: Rule): Rule =>
-    async (): Promise<Rule> => {
+    (): Rule => {
         try {
-            const angularPkgJsonPath = require.resolve(join('@angular/core', 'package.json'), { paths: ['.'] });
-            const ngVersion = (await import(angularPkgJsonPath) as { version: string }).version;
-            return (satisfies(ngVersion, range)) ? rule : noop();
+            return (satisfies(getAngularVersion().full, range)) ? rule : noop();
         } catch {
             return noop();
         }
@@ -343,6 +342,14 @@ export const removeProviderFromBootstrapApplication = (filePath: string, provide
         removeProviderFromStandaloneApplication(tree, filePath, providerName);
     };
 
+// --- HELPER(s) ---
+
+/**
+ * Gets the version of Angular currently used in the project.
+ * @returns {Version}
+ */
+export const getAngularVersion = (): Version => VERSION;
+
 /**
  * Gets a project output path as defined in the `angular.json` file.
  * @param {Tree} tree The current schematic's project tree.
@@ -453,8 +460,6 @@ export const ensureProjectIsDefined = (projectName: string | undefined): void =>
     }
 };
 
-// --- HELPER(s) ---
-
 const customizeAngularJsonBuildAndTestSection = (action: 'add' | 'remove', option: string, tree: Tree, value: JsonValue, projectName: string): void => {
     const angularJson = new JSONFile(tree, 'angular.json');
     const architectPath = ['projects', projectName, 'architect'];