Split core codes into detailed steps(parser, constructor, generator) (#…

…229)

This change splits core codes into detailed steps in high-level.
  - parser: The parser module is responsible for webidl parsing using
    the webidl2 parser internally. In this step, should create a unique
    type map(key: definition type name, value: AST) as an output.
  - constructor: The constructor module is responsible for constructing
    definition object to generate binding code in generate module.
  - generator: The generator module is responsible for generating actual
    native binding codes.

ISSUE=#207

core/constructor/index.ts

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) 2018 The Bacardi Authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as types from 'core/types';
+
+export async function construct(typeMap: types.IDLTypeMap) {
+  // Not implemented yet
+  return [];
+}

core/generator/index.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2018 The Bacardi Authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as types from 'core/types';
+
+export async function build(definitions: types.IRDefinition[]): Promise<void> {
+  // Not implemented yet
+}

core/index.ts

@@ -14,28 +14,16 @@
  * limitations under the License.
  */
 
-import {IDLTypeMap} from 'core/parser/idl_type_map';
-import {DefinitionInfo} from 'core/parser/idl_types';
-import {Parser} from 'core/parser/parser';
-import * as file from 'generator/base/file';
-
-async function readAndParse(idlFilePath: string): Promise<void> {
-  const idlFragment: string = await file.read(idlFilePath);
-  const idlDefinitionInfos: DefinitionInfo[] = await Parser.parse(idlFragment);
-  IDLTypeMap.update(idlDefinitionInfos);
-}
-
-async function buildIDLTypeMap(idlFilePaths: string[]): Promise<void> {
-  const tasks: Promise<void>[] = [];
-  idlFilePaths.forEach((idlFilePath) => {
-    tasks.push(readAndParse(idlFilePath));
-  });
-
-  await Promise.all(tasks);
-}
+import * as constructor from 'core/constructor';
+import * as generator from 'core/generator';
+import * as parser from 'core/parser';
+import * as types from 'core/types';
 
 export async function run(idlFilePaths: string[]): Promise<number> {
-  await buildIDLTypeMap(idlFilePaths);
+  const typeMap: types.IDLTypeMap = await parser.parse(idlFilePaths);
+  const definitions: types.IRDefinition[] =
+      await constructor.construct(typeMap);
+  await generator.build(definitions);
 
   return 0;
 }

core/parser/index.ts

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) 2018 The Bacardi Authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {Parser} from 'core/parser/parser';
+import * as types from 'core/types';
+
+export async function parse(idlFilePaths: string[]): Promise<types.IDLTypeMap> {
+  return Parser.parse(idlFilePaths);
+}

core/parser/parser.ts

@@ -14,14 +14,32 @@
  * limitations under the License.
  */
 
-import {DefinitionInfo} from 'core/parser/idl_types';
+import * as types from 'core/types';
+import * as file from 'generator/base/file';
 import * as webidl from 'webidl2';
 
+async function readAndParse(idlFilePath: string): Promise<void> {
+  const idlFragment: string = await file.read(idlFilePath);
+  const idlDefinitionInfos: types.DefinitionInfo[] = webidl.parse(idlFragment);
+  types.IDLTypeMap.update(idlDefinitionInfos);
+}
+
+async function buildIDLTypeMap(idlFilePaths: string[]): Promise<void> {
+  const tasks: Promise<void>[] = [];
+  idlFilePaths.forEach((idlFilePath) => {
+    tasks.push(readAndParse(idlFilePath));
+  });
+
+  await Promise.all(tasks);
+}
+
 /**
  * WebIDL Parser
  */
 export class Parser {
-  public static async parse(idlFragment: string): Promise<DefinitionInfo[]> {
-    return webidl.parse(idlFragment);
+  public static async parse(idlFilePaths: string[]): Promise<types.IDLTypeMap> {
+    await buildIDLTypeMap(idlFilePaths);
+
+    return types.IDLTypeMap;
   }
 }

core/parser/idl_type_map.ts → core/types/idl_type_map.ts

@@ -16,7 +16,7 @@
 
 import {
     DefinitionInfo, DictionaryInfo, EnumInfo, InterfaceInfo
-  } from 'core/parser/idl_types';
+  } from 'core/types/idl_types';
 
 interface DefinitionInfoStore {
   [index: string]: DefinitionInfo;

core/types/index.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2018 The Bacardi Authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export {IDLTypeMap} from 'core/types/idl_type_map';
+export {DefinitionInfo} from 'core/types/idl_types';
+export {IRDefinition} from 'core/types/ir_definition';

core/types/ir_definition.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2018 The Bacardi Authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export class IRDefinition {
+}