全限定名称

一个名称不能通过定义进一步分解：它是一个原始符号 — 路德维希·维特根斯坦

由 tree-sitter 驱动，fully-qualified-names 允许您从用JavaScript、TypeScript、Python或Java编写的代码中提取简单和全限定名称。这些名称进一步分为声明和用法，这为静态分析提供了对更复杂AST的方便简化。

如何使用

该软件包提供Rust和基于WASM的JS API。要在Rust中从Python代码片段中获取名称，您可以使用以下类似的方法。

use fully-qualified-names::Python;

let code = r#"class Person:
  def __init__(self, name):
    self.name = name

  def hello(self):
    return f"Hello, {self.name}"
"#;

let names = Python::find_names(code).unwrap();
println!("{names:?}");

在JS中，它会看起来像这样。

import { Python } from '@aws/fully-qualified-names';

const code = `class Person:
  def __init__(self, name):
    self.name = name

  def hello(self):
    return f"Hello, {self.name}"
`;

const names = await Python.findNames(code);
console.log(JSON.stringify(names));

背景

在编程中，标识符用于引用值、类型和代码段。

名称

它们都有简单的名称，这些名称是上下文特定的，以及全限定名称（以下简称FQN），这些名称在项目间是无歧义且唯一的。

例如，以下Rust代码片段。

let list = std::vec::Vec::new();

这里我们有几个简单的名称（list、std、vec、Vec、new），包括变量（list）、模块（std、vec）、类型（Vec）和方法（new）名称。