@eui/cli 21.0.0-alpha.4 → 21.0.0-alpha.40

package/lib/cli.js

@@ -0,0 +1,140 @@
+const inquirer = require('inquirer');
+
+const defaultConfig = {
+  appName: 'my-app',
+  appScope: '@app',
+  appType: 'angular',
+  appOptions: [],
+  appOptionsEclTheme: 'ecl-ec',
+  appFeatures: [],
+  groupId: 'ec.europa.digit',
+  artifactId: 'myapp',
+  packageManager: 'yarn',
+  npmInstall: true,
+  appStart: true,
+};
+
+module.exports.start = (options) => {
+
+  // if inputConfig is provided, we merge it with defaultConfig and return without CLI interactions
+  if (options.inputConfig) {
+    return {
+      ...defaultConfig,
+      ...options.inputConfig
+    };
+  }
+
+  // CLI interactions
+  return inquirer.prompt([
+    {
+      type: 'list',
+      name: 'appType',
+      message: 'Select an application type :',
+      choices: [
+        { name: 'eUI Angular - Desktop', value: 'angular' },
+        { name: 'eUI Angular - Mobile Ionic', value: 'mobile' },
+        { name: 'eUI Angular + Spring Boot web module - JDK + Maven required !!!', value: 'web-spring-boot' },
+        { name: 'eUI Angular + Maven web module (JEE Spring maven web module) - JDK + Maven required !!!', value: 'web-maven' },
+      ],
+      default: 0,
+      validate: function (value) {
+        if (value.length) {
+          return true;
+        }
+      }
+    },
+    {
+      name: 'groupId',
+      type: 'input',
+      message: 'Enter the groupId :',
+      default: defaultConfig.groupId,
+      validate: function (value) {
+        if (value.length) {
+          return true;
+        }
+      },
+      when: function (answers) {
+        return (answers.appType === 'web-spring-boot');
+      }
+    },
+    {
+      name: 'artifactId',
+      type: 'input',
+      message: 'Enter the artifactId :',
+      default: defaultConfig.artifactId,
+      validate: function (value) {
+        if (value.length) {
+          return true;
+        }
+      },
+      when: function (answers) {
+        return (answers.appType === 'web-spring-boot');
+      }
+    },
+    {
+      type: 'checkbox',
+      name: 'appOptions',
+      default: defaultConfig.appOptions,
+      message: 'Select one or more additional configuration options :',
+      choices: [
+        { name: 'eUI ECL app-shell template and configuration - for ec.europa.eu apps', value: 'ecl' },
+      ],
+      when: function (answers) {
+        return (answers.appType !== 'mobile');
+      }
+    },
+
+    {
+      type: 'list',
+      name: 'appOptionsEclTheme',
+      default: defaultConfig.appOptionsEclTheme,
+      message: 'Select which eUI ECL theme flavor you need :',
+      choices: [
+        { name: 'eUI ECL - EC theme', value: 'ecl-ec' },
+        { name: 'eUI ECL - EU theme', value: 'ecl-eu' },
+      ],
+      when: function (answers) {
+        return (answers.appOptions && answers.appOptions.includes('ecl') && answers.appType !== 'mobile');
+      }
+    },
+
+    {
+      name: 'npmInstall',
+      type: 'confirm',
+      message: 'Install dependencies when the app is generated :',
+      default: defaultConfig.npmInstall
+    },
+
+    {
+      type: 'list',
+      name: 'packageManager',
+      message: 'Package manager for installation :',
+      choices: [
+        { name: 'Yarn 1.x (default)', value: 'yarn' },
+        { name: 'Pnpm - experimental', value: 'pnpm' },
+      ],
+      default: 0,
+      when: function (answers) {
+        return (answers.npmInstall);
+      },      
+      validate: function (value) {
+        if (value.length) {
+          return true;
+        }
+      }
+    },    
+  ])
+    .then((answers) => {
+      let outputConfig;
+      outputConfig = {
+        ...defaultConfig,
+        ...answers
+      };
+      console.log('--provided config : \n', outputConfig);
+      return outputConfig;
+    })
+    .catch((e) => {
+      throw e;
+    })
+}
+

package/lib/config.js

@@ -0,0 +1,59 @@
+const path = require('path');
+
+const skeletonsPath = path.join(__dirname, 'skeletons');
+const version = require(path.join(__dirname, '../package.json')).version;
+
+module.exports.targetPath = path.resolve(process.cwd());
+module.exports.skeletonsPath = skeletonsPath;
+
+module.exports.angularBasePath = path.join(skeletonsPath, '_angular/base');
+module.exports.angularBaseMobilePath = path.join(skeletonsPath, '_angular/base-mobile');
+
+module.exports.webMavenPath = path.join(skeletonsPath, 'web-maven');
+module.exports.webSpringBootPath = path.join(skeletonsPath, 'web-spring-boot');
+
+module.exports.webPhpStarterRepo = 'webgate.ec.europa.eu/CITnet/stash/scm/csdr/eui-php-starter.git'
+module.exports.webSymfonyPath = path.join(skeletonsPath, 'web-symfony');
+
+module.exports.optionsPath = {
+    "ecl-ec": path.join(skeletonsPath, '_angular/options/ecl-ec'),
+    "ecl-eu": path.join(skeletonsPath, '_angular/options/ecl-eu'),
+};
+module.exports.pnpmOptionPath = path.join(skeletonsPath, '_angular/options/pnpm');
+
+module.exports.version = version;
+
+// f.e. :
+//  eui-cli --config appType:angular,npmInstall:false --targetPath eui-angular
+//  eui-cli --config appType:angular,appOptions:ecl,npmInstall:false --targetPath eui-angular-ecl-ec
+
+module.exports.parseInputConfig = (inputConfig) => {
+
+  if (!inputConfig) {
+    return;
+  }
+
+  const configArray = inputConfig.split(',').map(item => {
+    const x = item.split(':');
+
+    const propName = x[0];
+    let value = x[1];
+
+    // treating text to boolean values : f.e. : npmInstall=true
+    if (value === 'true') {
+      value = true;
+    }
+    if (value === 'false') {
+      value = false;
+    }
+
+    // treating string array values : f.e. : appOptions=ecl_something
+    if (propName === 'appOptions') {
+      value = value.split('_');
+    }
+
+    return { [propName]: value };
+  });
+
+  return Object.assign({}, ...configArray);
+}

package/lib/generators.js

@@ -0,0 +1,72 @@
+const childProcess = require('child_process');
+const execSync = childProcess.execSync;
+const cli = require('./cli');
+const build = require('./build');
+const postBuild = require('./post-build');
+const install = require('./install');
+const path = require('path');
+const utils = require('./utils');
+
+const appGenerate = (options) => {
+  if (options.inputConfig) {
+    utils.logInfo('Creating your project - automated mode : \n');
+  } else {
+    utils.logInfo('Configuring your project : please answer the following : \n');
+  }
+
+  // Query the questions
+  // -------------------
+  return Promise.resolve()
+    .then(() => {
+      return cli.start(options);
+    })
+    .then((config) => {
+      // Storing config
+      // --------------
+      const cliConfig = config;
+      // Building the file structure
+      // ---------------------------
+      return build.start({
+        config: config,
+        targetPath: options.targetPath
+      })
+      // Post build operations
+      // ---------------------
+      .then(() => {
+        return postBuild.start({
+          config: cliConfig,
+          targetPath: options.targetPath
+        });
+      })
+      // Install dependencies
+      // --------------------
+      .then(() => {
+        return install.start({
+          config: cliConfig,
+          targetPath: options.targetPath,
+        });
+      })
+      // starting app
+      .then(() => {
+        if (!cliConfig.appStart || typeof cliConfig.npmInstall !== 'boolean' || !cliConfig.npmInstall) {
+          return;
+        }
+        utils.logInfo('*****************************************************************');
+        utils.logInfo(' Starting eUI app... browser will open soon on localhost:4200');
+        utils.logInfo('*****************************************************************');
+
+        const wd = path.resolve(utils.getAngularPath(options.targetPath, cliConfig.appName, cliConfig.appType, cliConfig.artifactId));
+        return execSync("npm start", { cwd: wd, stdio: "inherit" });
+      })
+    })
+    .catch((e) => {
+      console.error(e);
+      process.exitCode = 1;
+    })
+    .finally(() => process.exit())
+}
+
+
+module.exports = {
+  appGenerate,
+};

package/lib/install.js

@@ -0,0 +1,45 @@
+const childProcess = require('child_process');
+const execSync = childProcess.execSync;
+const path = require('path');
+const utils = require('./utils');
+
+module.exports.start = (options) => {
+
+  if (typeof options.config.npmInstall !== 'boolean' || !options.config.npmInstall) {
+    return;
+  }
+
+  return Promise.resolve()
+    .then(() => {
+      return install(options.config, options.targetPath)
+    })
+    .catch((e) => {
+      throw e;
+    })
+}
+
+const install = (cliConfig, targetPath) => {
+
+  const wd = path.resolve(utils.getAngularPath(targetPath, cliConfig.appName, cliConfig.appType, cliConfig.artifactId));
+
+  console.log('');
+  console.log('');
+  console.log('*****************************************************');
+  console.log(' Installing app dependencies... PLEASE WAIT....');
+  console.log('*****************************************************');
+
+  return Promise.resolve()
+    .then(() => {
+      if (cliConfig.packageManager === 'pnpm') {
+        return execSync("pnpm install", { cwd: wd, stdio: "inherit" });
+        
+      } else {
+        return execSync("yarn", { cwd: wd, stdio: "inherit" });
+      }
+    })
+
+    .catch((e) => {
+      throw e;
+    })
+}
+

package/lib/maven-build/build.xml

@@ -0,0 +1,115 @@
+<?xml version="1.0"?>
+<project name="eUI-build" basedir=".">
+
+    <taskdef resource="net/sf/antcontrib/antlib.xml">
+        <classpath>
+            <fileset dir="lib" includes="ant-contrib-*.jar"/>
+        </classpath>
+    </taskdef>
+
+    <scriptdef language="javascript" name="lower">
+        <attribute name="string" />
+        <attribute name="to" />
+
+        project.setProperty( attributes.get( "to" ),
+                             attributes.get( "string" ).toLowerCase() );
+    </scriptdef>
+
+    <scriptdef language="javascript" name="ucfirst">
+        <attribute name="string" />
+        <attribute name="to" />
+
+        var the_string = attributes.get( "string" );
+        project.setProperty( attributes.get( "to" ),
+                    the_string.substr(0,1).toUpperCase() + the_string.substr(1) );
+    </scriptdef>
+
+    <scriptdef name="camelCaseString" language="javascript">
+        <attribute name="text" />
+        <attribute name="separator" />
+        <attribute name="property" />
+        <attribute name="first" />
+        <![CDATA[
+            var string = attributes.get("text");
+            var stringArray = string.split(attributes.get("separator"));
+            var result = "";
+            var s;
+
+            for (var i=0; i<stringArray.length;i++) {
+                s = stringArray[i];
+                if (i == 0) {
+                    if (attributes.get("first") == 'true') {
+                        result += s.substring(0,1).toUpperCase() + s.substr(1);
+                    } else {
+                        result += s;
+                    }
+                } else {
+                    result += s.substring(0,1).toUpperCase() + s.substr(1);
+                }
+            }
+
+            project.setProperty(attributes.get("property"), result);
+        ]]>
+    </scriptdef>
+
+
+    <macrodef name="replaceAll" taskname="@{taskname}">
+        <attribute name="src" />
+        <attribute name="dest" default="" />
+        <attribute name="replace" default="" />
+        <attribute name="with" default="" />
+        <sequential>
+            <loadresource property="@{dest}">
+                <propertyresource name="@{src}" />
+                <filterchain>
+                    <tokenfilter>
+                        <filetokenizer/>
+                        <replacestring from="@{replace}" to="@{with}"/>
+                    </tokenfilter>
+                </filterchain>
+            </loadresource>
+        </sequential>
+    </macrodef>
+
+
+
+    <!--======================================================================-->
+    <!--                     TOKEN FILTERS                                    -->
+    <!--======================================================================-->
+
+    <!--application files replacement-->
+    <filter token="app.name" value="${app.artifact.id}"/>
+    <filter token="app.name.display" value="${app.artifact.id}"/>
+    <filter token="app.group.id" value="${app.group.id}"/>
+
+    <target name="generate.web-spring-boot">
+        <echo></echo>
+        <echo>TARGET : ${target.path}</echo>
+        <echo></echo>
+        <echo>app.name: ${app.name}</echo>
+        <echo>app.artifact.id: ${app.artifact.id}</echo>
+        <echo>app.group.id: ${app.group.id}</echo>
+        <echo></echo>
+
+         <copy todir="${target.path}" filtering="true" overwrite="true">
+            <fileset dir="${src.path}"/>
+         </copy>
+
+         <!--REPLACE MODULE NAMES DIRECTORIES-->
+         <move toFile="${target.path}/${app.artifact.id}-web-rest"
+               file="${target.path}/myapp-web-rest"/>
+         <move toFile="${target.path}/${app.artifact.id}-web"
+               file="${target.path}/myapp-web"/>
+
+        <!--RENAMING JAVA SOURCES TARGET by custom app group id provided-->
+
+        <replaceAll src="app.group.id" dest="app.group.id.dir" replace="." with="/"/>
+
+        <move tofile="${target.path}/${app.name}-web-rest/src/main/java/${app.group.id.dir}/${app.name}"
+              file="${target.path}/${app.name}-web-rest/src/main/java/myapp"/>
+        <mkdir dir="${target.path}/${app.name}-web-rest/src/test/java/${app.group.id.dir}/${app.name}"/>
+
+    </target>
+
+</project>
+

package/lib/maven-build/pom.xml

@@ -0,0 +1,64 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
+                             http://maven.apache.org/maven-v4_0_0.xsd">
+
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>eu.europa.ec.digit.eui</groupId>
+    <artifactId>eui-cli-build</artifactId>
+    <version>0.1.0</version>
+    <packaging>pom</packaging>
+
+    <name>eUI CLI app generator</name>
+
+    <properties>
+        <src.path></src.path>
+        <target.path></target.path>
+        <app.group.id></app.group.id>
+        <app.artifact.id></app.artifact.id>
+    </properties>
+
+    <profiles>
+        <profile>
+            <id>build-web-spring-boot</id>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-antrun-plugin</artifactId>
+                        <version>1.7</version>
+                        <executions>
+                        <execution>
+                            <id>pre-install</id>
+                            <phase>generate-sources</phase>
+                            <configuration>
+
+                            <target>
+                                <ant dir="${basedir}" target="generate.web-spring-boot">
+                                     <property name="src.path" value="${src.path}"/>
+                                     <property name="target.path" value="${target.path}"/>
+                                     <property name="app.group.id" value="${app.group.id}"/>
+                                     <property name="app.artifact.id" value="${app.artifact.id}"/>
+                                     <property name="app.name" value="${app.artifact.id}"/>
+                                </ant>
+                            </target>
+
+                            </configuration>
+                            <goals>
+                            <goal>run</goal>
+                            </goals>
+                        </execution>
+                        </executions>
+                    </plugin>
+
+                </plugins>
+
+            </build>
+        </profile>
+    </profiles>
+
+</project>
+
+
+
+

package/lib/post-build.js

@@ -0,0 +1,31 @@
+const path = require('path');
+const utils = require('./utils');
+
+module.exports.start = (options) => {
+  return Promise.resolve()
+    .then(() => {
+      return postBuild(options.config, options.targetPath,)
+    })
+    .catch((e) => {
+      throw e;
+    })
+}
+
+const postBuild = (cliConfig, targetPath) => {
+  const appName = cliConfig.appName;
+  const appType = cliConfig.appType;
+  const artifactId = cliConfig.artifactId;
+
+  console.log(`Post build`);
+
+  return Promise.resolve()
+    .then(() => {
+      console.log('--renaming .gitignore');
+      const angularPath = utils.getAngularPath(targetPath, appName, appType, artifactId);
+      return utils.move(path.join(angularPath, 'gitignore_TO_REPLACE'), path.join(angularPath, '.gitignore'));
+    })
+
+    .catch((e) => {
+      throw e;
+    })
+}

package/lib/skeletons/_angular/base/.browserslistrc

@@ -0,0 +1,16 @@
+# This file is used by the build system to adjust CSS and JS output to support the specified browsers below.
+# For additional information regarding the format and rule options, please see:
+# https://github.com/browserslist/browserslist#queries
+
+# For the full list of supported browsers by the Angular framework, please see:
+# https://angular.io/guide/browser-support
+
+# You can see what browsers were selected by your queries by running:
+#   npx browserslist
+
+last 1 Chrome version
+last 1 Firefox version
+last 2 Edge major versions
+last 2 Safari major versions
+last 2 iOS major versions
+Firefox ESR

package/lib/skeletons/_angular/base/.editorconfig

@@ -0,0 +1,16 @@
+# Editor configuration, see http://editorconfig.org
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 4
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.scss]
+indent_size = 4
+
+[*.md]
+max_line_length = off
+trim_trailing_whitespace = false

package/lib/skeletons/_angular/base/README.md

@@ -0,0 +1,26 @@
+# eUI starter app
+
+## Development server
+
+````npm start```` to start the angular project with node-express proxy mock server
+
+````npm run start-proxy```` to start the angular project with real backend proxy server deployed
+
+````npm run build```` to build, lint and test your project for DEV
+
+````npm run build-prod```` to build, lint and test your project for PROD
+
+````npm run build-prod-skip-test```` to build and lint your project for PROD - Unit test skipped - to be used on Bamboo plans
+
+````npm run build-prod-stats```` to build, lint and test your project for PROD - with stats.json file generated for webpack-bundle-analyzer input
+
+* check package.json for more info on executable scripts provided
+
+## Further help
+
+- https://eui.ecdevops.eu
+
+- register on [MS Teams](https://teams.microsoft.com/l/team/19%3a2f5bb6b7d1e24c4aabaa62229d3e1955%40thread.tacv2/conversations?groupId=fb6def72-c57b-4e8f-a82e-49be65d6e1f5&tenantId=b24c8b06-522c-46fe-9080-70926f8dddb1) with your EC mail account, for extra-muros please send a mail to DIGIT-EUI-SUPPORT@ec.europa.eu
+
+- For bugs / request new features : Drop us an email at : DIGIT-EUI-SUPPORT@ec.europa.eu
+