ts2famix 1.0.10 → 1.0.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (138) hide show
  1. package/.eslintrc.json +24 -24
  2. package/LICENSE +23 -23
  3. package/README.md +109 -109
  4. package/jest.config-old.ts +199 -199
  5. package/package.json +47 -47
  6. package/src/analyze.ts +94 -94
  7. package/src/analyze_functions/processAccesses.ts +57 -50
  8. package/src/analyze_functions/processFiles.ts +669 -660
  9. package/src/analyze_functions/processImportClauses.ts +77 -77
  10. package/src/analyze_functions/processInheritances.ts +84 -84
  11. package/src/analyze_functions/processInvocations.ts +51 -51
  12. package/src/famix2puml.ts +119 -119
  13. package/src/famix_functions/famix_functions.ts +559 -555
  14. package/src/famix_functions/famix_functions_associations.ts +215 -215
  15. package/src/famix_functions/famix_functions_index.ts +44 -44
  16. package/src/famix_functions/famix_functions_types.ts +105 -100
  17. package/src/generate_uml.sh +16 -16
  18. package/src/lib/famix/License.md +22 -22
  19. package/src/lib/famix/package-lock.json +301 -301
  20. package/src/lib/famix/package.json +27 -27
  21. package/src/lib/famix/readme.md +4 -4
  22. package/src/lib/famix/src/famix_JSON_exporter.ts +56 -56
  23. package/src/lib/famix/src/famix_base_element.ts +18 -18
  24. package/src/lib/famix/src/famix_repository.ts +199 -199
  25. package/src/lib/famix/src/index.ts +8 -8
  26. package/src/lib/famix/src/model/famix/access.ts +53 -53
  27. package/src/lib/famix/src/model/famix/accessor.ts +15 -15
  28. package/src/lib/famix/src/model/famix/alias.ts +41 -41
  29. package/src/lib/famix/src/model/famix/association.ts +44 -44
  30. package/src/lib/famix/src/model/famix/behavioral_entity.ts +107 -107
  31. package/src/lib/famix/src/model/famix/c_source_language.ts +15 -15
  32. package/src/lib/famix/src/model/famix/class.ts +86 -86
  33. package/src/lib/famix/src/model/famix/comment.ts +50 -50
  34. package/src/lib/famix/src/model/famix/container_entity.ts +165 -165
  35. package/src/lib/famix/src/model/famix/custom_source_language.ts +27 -27
  36. package/src/lib/famix/src/model/famix/decorator.ts +39 -39
  37. package/src/lib/famix/src/model/famix/entity.ts +15 -15
  38. package/src/lib/famix/src/model/famix/enum.ts +31 -31
  39. package/src/lib/famix/src/model/famix/enum_value.ts +29 -29
  40. package/src/lib/famix/src/model/famix/function.ts +15 -15
  41. package/src/lib/famix/src/model/famix/implicit_variable.ts +15 -15
  42. package/src/lib/famix/src/model/famix/import_clause.ts +53 -53
  43. package/src/lib/famix/src/model/famix/index.ts +42 -42
  44. package/src/lib/famix/src/model/famix/indexed_file_anchor.ts +49 -49
  45. package/src/lib/famix/src/model/famix/inheritance.ts +42 -42
  46. package/src/lib/famix/src/model/famix/interface.ts +75 -75
  47. package/src/lib/famix/src/model/famix/invocation.ts +68 -68
  48. package/src/lib/famix/src/model/famix/method.ts +96 -96
  49. package/src/lib/famix/src/model/famix/module.ts +31 -31
  50. package/src/lib/famix/src/model/famix/named_entity.ts +98 -98
  51. package/src/lib/famix/src/model/famix/namespace.ts +28 -28
  52. package/src/lib/famix/src/model/famix/parameter.ts +29 -29
  53. package/src/lib/famix/src/model/famix/parameterizable_class.ts +31 -31
  54. package/src/lib/famix/src/model/famix/parameterizable_interface.ts +31 -31
  55. package/src/lib/famix/src/model/famix/parameterized_type.ts +40 -40
  56. package/src/lib/famix/src/model/famix/primitive_type.ts +15 -15
  57. package/src/lib/famix/src/model/famix/property.ts +54 -54
  58. package/src/lib/famix/src/model/famix/reference.ts +42 -42
  59. package/src/lib/famix/src/model/famix/scoping_entity.ts +31 -31
  60. package/src/lib/famix/src/model/famix/script_entity.ts +38 -38
  61. package/src/lib/famix/src/model/famix/source_anchor.ts +31 -31
  62. package/src/lib/famix/src/model/famix/source_language.ts +31 -31
  63. package/src/lib/famix/src/model/famix/sourced_entity.ts +70 -70
  64. package/src/lib/famix/src/model/famix/structural_entity.ts +44 -44
  65. package/src/lib/famix/src/model/famix/text_anchor.ts +49 -49
  66. package/src/lib/famix/src/model/famix/type.ts +88 -88
  67. package/src/lib/famix/src/model/famix/type_parameter.ts +33 -33
  68. package/src/lib/famix/src/model/famix/variable.ts +28 -28
  69. package/src/lib/famix/tsconfig.json +26 -26
  70. package/src/lib/famix/tslint.json +14 -14
  71. package/src/lib/ts-complex/cyclomatic-service.ts +85 -85
  72. package/src/ts2famix-cli.ts +39 -39
  73. package/tsconfig.json +69 -69
  74. package/dist/analyze.js +0 -102
  75. package/dist/analyze_functions/processAccesses.js +0 -47
  76. package/dist/analyze_functions/processFiles.js +0 -540
  77. package/dist/analyze_functions/processImportClauses.js +0 -70
  78. package/dist/analyze_functions/processInheritances.js +0 -73
  79. package/dist/analyze_functions/processInvocations.js +0 -49
  80. package/dist/famix2puml.js +0 -125
  81. package/dist/famix_functions/famix_functions.js +0 -513
  82. package/dist/famix_functions/famix_functions_associations.js +0 -205
  83. package/dist/famix_functions/famix_functions_index.js +0 -62
  84. package/dist/famix_functions/famix_functions_types.js +0 -110
  85. package/dist/fqn.js +0 -126
  86. package/dist/fqp_implementation.js +0 -73
  87. package/dist/lib/famix/src/famix_JSON_exporter.js +0 -54
  88. package/dist/lib/famix/src/famix_base_element.js +0 -13
  89. package/dist/lib/famix/src/famix_repository.js +0 -187
  90. package/dist/lib/famix/src/index.js +0 -30
  91. package/dist/lib/famix/src/model/famix/access.js +0 -39
  92. package/dist/lib/famix/src/model/famix/accessor.js +0 -16
  93. package/dist/lib/famix/src/model/famix/alias.js +0 -32
  94. package/dist/lib/famix/src/model/famix/association.js +0 -36
  95. package/dist/lib/famix/src/model/famix/behavioral_entity.js +0 -81
  96. package/dist/lib/famix/src/model/famix/c_source_language.js +0 -16
  97. package/dist/lib/famix/src/model/famix/class.js +0 -70
  98. package/dist/lib/famix/src/model/famix/comment.js +0 -38
  99. package/dist/lib/famix/src/model/famix/container_entity.js +0 -125
  100. package/dist/lib/famix/src/model/famix/custom_source_language.js +0 -23
  101. package/dist/lib/famix/src/model/famix/decorator.js +0 -31
  102. package/dist/lib/famix/src/model/famix/entity.js +0 -16
  103. package/dist/lib/famix/src/model/famix/enum.js +0 -30
  104. package/dist/lib/famix/src/model/famix/enum_value.js +0 -24
  105. package/dist/lib/famix/src/model/famix/function.js +0 -16
  106. package/dist/lib/famix/src/model/famix/implicit_variable.js +0 -16
  107. package/dist/lib/famix/src/model/famix/import_clause.js +0 -39
  108. package/dist/lib/famix/src/model/famix/index.js +0 -87
  109. package/dist/lib/famix/src/model/famix/indexed_file_anchor.js +0 -37
  110. package/dist/lib/famix/src/model/famix/inheritance.js +0 -32
  111. package/dist/lib/famix/src/model/famix/interface.js +0 -63
  112. package/dist/lib/famix/src/model/famix/invocation.js +0 -53
  113. package/dist/lib/famix/src/model/famix/method.js +0 -66
  114. package/dist/lib/famix/src/model/famix/module.js +0 -30
  115. package/dist/lib/famix/src/model/famix/named_entity.js +0 -77
  116. package/dist/lib/famix/src/model/famix/namespace.js +0 -24
  117. package/dist/lib/famix/src/model/famix/parameter.js +0 -24
  118. package/dist/lib/famix/src/model/famix/parameterizable_class.js +0 -30
  119. package/dist/lib/famix/src/model/famix/parameterizable_interface.js +0 -30
  120. package/dist/lib/famix/src/model/famix/parameterized_type.js +0 -36
  121. package/dist/lib/famix/src/model/famix/primitive_type.js +0 -16
  122. package/dist/lib/famix/src/model/famix/property.js +0 -44
  123. package/dist/lib/famix/src/model/famix/reference.js +0 -32
  124. package/dist/lib/famix/src/model/famix/scoping_entity.js +0 -30
  125. package/dist/lib/famix/src/model/famix/script_entity.js +0 -30
  126. package/dist/lib/famix/src/model/famix/source_anchor.js +0 -26
  127. package/dist/lib/famix/src/model/famix/source_language.js +0 -30
  128. package/dist/lib/famix/src/model/famix/sourced_entity.js +0 -55
  129. package/dist/lib/famix/src/model/famix/structural_entity.js +0 -38
  130. package/dist/lib/famix/src/model/famix/text_anchor.js +0 -37
  131. package/dist/lib/famix/src/model/famix/type.js +0 -71
  132. package/dist/lib/famix/src/model/famix/type_parameter.js +0 -24
  133. package/dist/lib/famix/src/model/famix/variable.js +0 -23
  134. package/dist/lib/ts-complex/cyclomatic-service.js +0 -83
  135. package/dist/ts2famix-cli.js +0 -63
  136. package/dist/ts2famix-tsconfig.js +0 -53
  137. package/metrics.ts +0 -23
  138. package/src/fqp_implementation.ts +0 -66
package/.eslintrc.json CHANGED
@@ -1,24 +1,24 @@
1
- {
2
- "env": {
3
- "browser": true,
4
- "es2021": true
5
- },
6
- "extends": [
7
- "eslint:recommended",
8
- "plugin:@typescript-eslint/recommended"
9
- ],
10
- "overrides": [
11
- ],
12
- "parser": "@typescript-eslint/parser",
13
- "parserOptions": {
14
- "ecmaVersion": "latest",
15
- "sourceType": "module"
16
- },
17
- "plugins": [
18
- "@typescript-eslint"
19
- ],
20
- "rules": {
21
- "@typescript-eslint/no-namespace": "off",
22
- "semi": [1, "always"]
23
- }
24
- }
1
+ {
2
+ "env": {
3
+ "browser": true,
4
+ "es2021": true
5
+ },
6
+ "extends": [
7
+ "eslint:recommended",
8
+ "plugin:@typescript-eslint/recommended"
9
+ ],
10
+ "overrides": [
11
+ ],
12
+ "parser": "@typescript-eslint/parser",
13
+ "parserOptions": {
14
+ "ecmaVersion": "latest",
15
+ "sourceType": "module"
16
+ },
17
+ "plugins": [
18
+ "@typescript-eslint"
19
+ ],
20
+ "rules": {
21
+ "@typescript-eslint/no-namespace": "off",
22
+ "semi": [1, "always"]
23
+ }
24
+ }
package/LICENSE CHANGED
@@ -1,23 +1,23 @@
1
- MIT License
2
-
3
- Copyright (c) 2021 Arezoo Nasrollah Zadeh
4
- Copyright (c) 2021 Christopher Fuhrman
5
- Copyright (c) 2023 Maël Paul
6
-
7
- Permission is hereby granted, free of charge, to any person obtaining a copy
8
- of this software and associated documentation files (the "Software"), to deal
9
- in the Software without restriction, including without limitation the rights
10
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11
- copies of the Software, and to permit persons to whom the Software is
12
- furnished to do so, subject to the following conditions:
13
-
14
- The above copyright notice and this permission notice shall be included in all
15
- copies or substantial portions of the Software.
16
-
17
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2021 Arezoo Nasrollah Zadeh
4
+ Copyright (c) 2021 Christopher Fuhrman
5
+ Copyright (c) 2023 Maël Paul
6
+
7
+ Permission is hereby granted, free of charge, to any person obtaining a copy
8
+ of this software and associated documentation files (the "Software"), to deal
9
+ in the Software without restriction, including without limitation the rights
10
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11
+ copies of the Software, and to permit persons to whom the Software is
12
+ furnished to do so, subject to the following conditions:
13
+
14
+ The above copyright notice and this permission notice shall be included in all
15
+ copies or substantial portions of the Software.
16
+
17
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23
+ SOFTWARE.
package/README.md CHANGED
@@ -1,109 +1,109 @@
1
- # FamixTypeScriptImporter
2
-
3
- [![Node.js CI](https://github.com/maelpaul/FamixTypeScriptImporter/actions/workflows/node.js.yml/badge.svg)](https://github.com/maelpaul/FamixTypeScriptImporter/actions/workflows/node.js.yml)
4
-
5
- Create a [FamixTypeScript](https://github.com/fuhrmanator/FamixTypeScript) model in JSON of TypeScript files.
6
-
7
- ## Installation
8
-
9
- ```sh
10
- npm install ts2famix
11
- ```
12
-
13
- ## Usage
14
-
15
- Instructions for using the command-line importer:
16
-
17
- ```sh
18
- ts2famix --help
19
- ```
20
-
21
- ## Parse a full project
22
-
23
- ```sh
24
- ts2famix -i ../path/to/project/tsconfig.json -o JSONModels/projectName.json
25
- ```
26
- or
27
- ```sh
28
- ts2famix -i "../path/to/project/**/*.ts" -o JSONModels/projectName.json
29
- ```
30
-
31
- ## Import the JSON model into Moose 🫎
32
-
33
- You need to copy the "```JSONModels/projectName.json```" into your "```Pharo/images/[imageName]```" directory.
34
-
35
- For a Moose Suite 10 (stable) user with the Pharo directory in the root directory, do :
36
- ```sh
37
- cp JSONModels/projectName.json ~/Pharo/images/Moose\ Suite\ 10\ \(stable\)/.
38
- ```
39
-
40
- Then, in a Moose Playground, do :
41
- ```st
42
- Metacello new
43
- githubUser: 'fuhrmanator' project: 'FamixTypeScript' commitish: 'master' path: 'src';
44
- baseline: 'FamixTypeScript';
45
- load
46
- ```
47
-
48
- This command installs the TypeScript metamodel into Moose.
49
-
50
- Then, generate the metamodel with :
51
- ```Library > Famix > Manage metamodels > Regenerate all metamodels```
52
-
53
- Then, in a Moose Playground, do :
54
- ```st
55
- 'projectName.json' asFileReference readStreamDo:
56
- [ :stream | model := FamixTypeScriptModel new
57
- importFromJSONStream: stream. model install ].
58
- ```
59
-
60
- This command imports the JSON model into Moose.
61
-
62
- ## Developer info
63
-
64
- Run tests :
65
- ```sh
66
- npm test
67
- ```
68
-
69
- Generate coverage :
70
- ```sh
71
- npm run coverage
72
- ```
73
-
74
- Then, open "```coverage/lcov-report/index.html```" with your favorite browser :
75
- ```sh
76
- firefox coverage/lcov-report/index.html &
77
- ```
78
-
79
- Generate documentation :
80
- ```sh
81
- npm run doc
82
- ```
83
-
84
- Then, open "```docs/index.html```" with your favorite browser :
85
- ```sh
86
- firefox docs/index.html &
87
- ```
88
-
89
- Generate plantuml and svg of the metamodel :
90
- ```sh
91
- npm run uml
92
- ```
93
-
94
- Then, open "```doc-uml/metamodel.svg```" with your favorite image viewer :
95
- ```sh
96
- eog doc-uml/metamodel.svg &
97
- ```
98
-
99
- ## Generate an object diagram of the JSON model
100
-
101
- ```sh
102
- ts-node src/famix2puml.ts -i JSONModels/projectName.json -o PUMLModels/projectName.puml
103
- ```
104
-
105
- ## TypeScript Metamodel API documentation (visualization)
106
-
107
- The following was generated by CI using [tplant](https://github.com/bafolts/tplant), in a similar fashion described [here](https://modularmoose.org/2021/07/19/automatic-metamodel-documentation-generation.html).
108
-
109
- ![FamixTypeScript API Metamodel](https://raw.githubusercontent.com/maelpaul/FamixTypeScriptImporter/v1/doc/metamodel.svg)
1
+ # FamixTypeScriptImporter
2
+
3
+ [![Node.js CI](https://github.com/maelpaul/FamixTypeScriptImporter/actions/workflows/node.js.yml/badge.svg)](https://github.com/maelpaul/FamixTypeScriptImporter/actions/workflows/node.js.yml)
4
+
5
+ Create a [FamixTypeScript](https://github.com/fuhrmanator/FamixTypeScript) model in JSON of TypeScript files.
6
+
7
+ ## Installation
8
+
9
+ ```sh
10
+ npm install ts2famix
11
+ ```
12
+
13
+ ## Usage
14
+
15
+ Instructions for using the command-line importer:
16
+
17
+ ```sh
18
+ ts2famix --help
19
+ ```
20
+
21
+ ## Parse a full project
22
+
23
+ ```sh
24
+ ts2famix -i ../path/to/project/tsconfig.json -o JSONModels/projectName.json
25
+ ```
26
+ or
27
+ ```sh
28
+ ts2famix -i "../path/to/project/**/*.ts" -o JSONModels/projectName.json
29
+ ```
30
+
31
+ ## Import the JSON model into Moose 🫎
32
+
33
+ You need to copy the "```JSONModels/projectName.json```" into your "```Pharo/images/[imageName]```" directory.
34
+
35
+ For a Moose Suite 10 (stable) user with the Pharo directory in the root directory, do :
36
+ ```sh
37
+ cp JSONModels/projectName.json ~/Pharo/images/Moose\ Suite\ 10\ \(stable\)/.
38
+ ```
39
+
40
+ Then, in a Moose Playground, do :
41
+ ```st
42
+ Metacello new
43
+ githubUser: 'fuhrmanator' project: 'FamixTypeScript' commitish: 'master' path: 'src';
44
+ baseline: 'FamixTypeScript';
45
+ load
46
+ ```
47
+
48
+ This command installs the TypeScript metamodel into Moose.
49
+
50
+ Then, generate the metamodel with :
51
+ ```Library > Famix > Manage metamodels > Regenerate all metamodels```
52
+
53
+ Then, in a Moose Playground, do :
54
+ ```st
55
+ 'projectName.json' asFileReference readStreamDo:
56
+ [ :stream | model := FamixTypeScriptModel new
57
+ importFromJSONStream: stream. model install ].
58
+ ```
59
+
60
+ This command imports the JSON model into Moose.
61
+
62
+ ## Developer info
63
+
64
+ Run tests :
65
+ ```sh
66
+ npm test
67
+ ```
68
+
69
+ Generate coverage :
70
+ ```sh
71
+ npm run coverage
72
+ ```
73
+
74
+ Then, open "```coverage/lcov-report/index.html```" with your favorite browser :
75
+ ```sh
76
+ firefox coverage/lcov-report/index.html &
77
+ ```
78
+
79
+ Generate documentation :
80
+ ```sh
81
+ npm run doc
82
+ ```
83
+
84
+ Then, open "```docs/index.html```" with your favorite browser :
85
+ ```sh
86
+ firefox docs/index.html &
87
+ ```
88
+
89
+ Generate plantuml and svg of the metamodel :
90
+ ```sh
91
+ npm run uml
92
+ ```
93
+
94
+ Then, open "```doc-uml/metamodel.svg```" with your favorite image viewer :
95
+ ```sh
96
+ eog doc-uml/metamodel.svg &
97
+ ```
98
+
99
+ ## Generate an object diagram of the JSON model
100
+
101
+ ```sh
102
+ ts-node src/famix2puml.ts -i JSONModels/projectName.json -o PUMLModels/projectName.puml
103
+ ```
104
+
105
+ ## TypeScript Metamodel API documentation (visualization)
106
+
107
+ The following was generated by CI using [tplant](https://github.com/bafolts/tplant), in a similar fashion described [here](https://modularmoose.org/2021/07/19/automatic-metamodel-documentation-generation.html).
108
+
109
+ ![FamixTypeScript API Metamodel](https://raw.githubusercontent.com/maelpaul/FamixTypeScriptImporter/v1/doc/metamodel.svg)