原子 npm 包装器

Atom是应用程序的新型中间代表,也是由Atom提供动力的独立工具 陈 图书馆。 中间代表(一个有节点和链接的网络)是用于应用分析和机器学习的典型操作的最优化的,包括: 切开 和传入.

这个包包包了原子Java可分配,并通过npm包注册提供. 确保 Java 21 在 PATH 中可用 .

使用量

npm install @appthreat/atom

对于更广泛的语言支持,也安装 @appthreat/atom-parsetools。 。 。 .

npm install -g @appthreat/atom-parsetools

支助语文

• 页:1
• H(仅C/C++ 标题和已预处理的.i文件)
• Java (需要汇编)
• 贾
• Android APK(要求Android SDK. 设置环境变量 ANDROID_HOME 或使用容器图像。 )
• Java 脚本
• 流动
• 类型脚本
• Python( 支持 3. x 至 3. 14)
• PHP( 需要 PHP QQ 7.4. 支持 PHP 7. 0 到 8.5, 有限支持 PHP 5. x)
• Ruby( 需要Ruby 运行时间 ) rbastgen 生成器; 语法由 功能,而不是运行时的版本,所以Ruby 1.8 - 4.0.x 语法在任意一个语法上得到支持 支持运行时间)
• 斯卡拉(WIP)

CLI 使用量

Usage: atom [parsedeps|data-flow|usages|reachables] [options] [input]

  input                    source file or directory
  -o, --output <value>     output filename. Default app.⚛ or app.atom in windows
  -s, --slice-outfile <value>
                           export intra-procedural slices as json
  -l, --language <value>   source language
  --with-data-deps         generate the atom with data-dependencies - defaults to `false`
  --remove-atom            do not persist the atom file - defaults to `false`
  --reuse-atom             reuse existing atom file - defaults to `false`
  -x, --export-atom        export the atom file with data-dependencies to graphml - defaults to `false`
  --export-dir <value>     export directory. Default: atom-exports
  --file-filter <value>    the name of the source file to generate slices from. Uses regex.
  --method-name-filter <value>
                           filters in slices that go through specific methods by names. Uses regex.
  --method-parameter-filter <value>
                           filters in slices that go through methods with specific types on the method parameters. Uses regex.
  --method-annotation-filter <value>
                           filters in slices that go through methods with specific annotations on the methods. Uses regex.
  --max-num-def <value>    maximum number of definitions in per-method data flow calculation - defaults to 2000
Command: parsedeps
Extract dependencies from the build file and imports
Command: data-flow [options]
Extract backward data-flow slices
  --slice-depth <value>    the max depth to traverse the DDG for the data-flow slice - defaults to 7.
  --sink-filter <value>    filters on the sink's `code` property. Uses regex.
Command: usages [options]
Extract local variable and parameter usages
  --min-num-calls <value>  the minimum number of calls required for a usage slice - defaults to 1.
  --include-source         includes method source code in the slices - defaults to false.
  --extract-endpoints      extract http endpoints and convert to openapi format using atom-tools - defaults to false.
Command: reachables [options]
Extract reachable data-flow slices based on automated framework tags
  --source-tag <value>     source tag - defaults to framework-input. Comma-separated values allowed.
  --sink-tag <value>       sink tag - defaults to framework-output. Comma-separated values allowed.
  --include-crypto         includes crypto library flows - defaults to false.
  --help                   display this help message

请求样本

生成一个原子

# Compile java project
atom -o app.atom -l java .

atom -o app.atom -l jar <jar file>

export ANDROID_HOME=<path to android sdk>
atom -o app.atom -l apk <apk file>

为 Java 项目创建可达切片 .

cd <path to repo>
cdxgen -t java --deep -o bom.json .
atom reachables -o app.atom -s reachables.json -l java .

通过辩论 --reuse-atom 以已存在的原子文件为基础切换.

atom reachables --reuse-atom -o app.atom -s reachables.json -l java .

环境变量

解决问题

大型工程的原子文件不完整

astgen可能需要大量大型JavaScript项目,尤其是流项目的大量内存. 使用环境变量 NODE_OPTIONS 用于增加可用的内存.

export NODE_OPTIONS="--expose-gc --max-old-space-size=16288"

对于React 19等大型项目,astgen需要超过80GB的堆积内存! 使用环境变量 CHEN_ASTGEN_OUT 要制作原子和正则,请重新使用含有 astgen 生成的 json 和 typemap 文件的现有目录.

为进一步提高准确性,将源代码从 node_modules 设置目录 ASTGEN_INCLUDE_NODE_MODULES_BUNDLES。 。 。 .

export ASTGEN_INCLUDE_NODE_MODULES_BUNDLES=true
export ASTGEN_IGNORE_DIRS=""

许可证

麻省理工学院