Lib.rs

#+TITLE: 包 sdml-generate #+AUTHOR: Simon Johnston #+EMAIL: [email protected] #+LANGUAGE: en #+STARTUP: overview hidestars inlineimages entitiespretty #+OPTIONS: author:nil created:nil creator:nil date:nil email:nil num:3 toc:nil

Rust库，用于从简单领域建模语言（SDML）生成工件。

[https://crates.io/crates/sdml_generate] [https://docs.rs/sdml_generate]

该包是Rust SDML项目的一部分，并专门定义了SDML模块的模型到其他生成器。项目的目标是提供内存模型、解析器、生成器和CLI工具的惯用实现。

以下图展示了该包在更广泛的项目背景中的情况。

#+CAPTION: 包组织 #+BEGIN_EXAMPLE ╭───────╮ │ CLI │ ╔══ │ crate │ ══╗ ║ ╰───────╯ ║ ┌╌╌╌╌╌╌╌╌┐ V V ┆ ┆ ╭───────╮ ╭──────────╮ 格式化源代码 ┆ 文件 ┆ ══> │ parse │ ══> │ generate │ ══> RDF表示 ┆ ┆ │ ╰───────╯ ╰──────────╯ │ 图表 └╌╌╌╌╌╌╌╌┘ │ core/errors crate │ ╰──────────────────────────────────╯ ┌───────┐ ⋀ │ other │ ║ │ tools │ ════════════════╝ └───────┘ #+END_EXAMPLE

• 变更

版本 0.2.13

• 特性：添加了新的命令 =doc-book=，用于为模块集合创建更复杂的文档输出。
  • 重构：添加了更多用于文档生成的特质，允许现有的 =doc= 代码被 =doc-book= 重用。
  • 重构：添加了一个 =common= 模块，用于低级格式化特质。
• 构建：将 =sdml-errors= 和 =sdml-core= 的版本升级。

版本 0.2.12

• 构建：将依赖项从 =sdml_error= 更新为 =sdml-errors=。
• 构建：将 =sdml-core= 的版本升级。

版本 0.2.11

• 特性：添加了 =DiagramContentFilter= 的初始实现。
  • 添加：模块和成员导入过滤器。
  • 添加：局部定义过滤器。
  • 添加：关联过滤器。

此版本尚未使用内容过滤器，旨在征求对提供的过滤器的反馈。

版本 0.2.10

• 构建：将 =sdml_core= 升级到版本 =0.2.14= 和新的 =ModelStore= 特质。

版本 0.2.9

• 修复：视图命令的注释格式化有问题。

版本 0.2.8

• 特性：核心中适应了新的 =HeaderValue= 类型。

版本 0.2.7

• 特性：org-mode 的文档生成现在包括模块的 RDF 版本和依赖图。
• 修复：之前 trait 函数 =write_to_string_in_format= 调用的是 =write=，而不是 =write_in_format=。
• 修复：为 =convert::source= 的 Rustdoc 修复以关闭颜色化。
• 构建：使用 core =0.2.10= 用于新的 stdlib 名称。

版本 0.2.6

• 特性：为 RDF 源生成添加颜色输出。
  1. 将模块 =console= 重命名为 =color=。
  2. 添加新的 =color::rdf= 模块以提供辅助函数。
  3. 重写 =convert::rdf= 以输出彩色列表。
• 特性：将版本 URL 添加到依赖树测试用例中。
• 特性：从 Cargo.toml 中删除间接依赖。

版本 0.2.5

• 特性：将 =ModuleCache= 添加为 =GenerateToFile= 和 =GenerateToWriter= 特性方法的参数。
• 特性：添加新的 =source= 生成器以显示文件源，包括省略的版本。
• 特性：完成依赖生成 逻辑 – API 的相关工作。
  • 修复：依赖生成深度测试应用不正确。
  • 修复：处理未在缓存中存在的模块依赖的逻辑正确。
  • 修复：GraphViz 错误，边定义为 =-->= 应为 =->=。
  • 添加：彩色输出，使用新的 =console= 模块来管理全局颜色标志。
  • 添加：添加节点输出的版本 URI。
• 特性：将 RDF 定义输出添加到 s-expression 生成器中。
• 特性：将 RDF 定义的基本输出添加到 RDF 生成器中。
• 特性：将更多输出添加到 RDF 生成器中。
• 测试：使用依赖树生成器启动新的测试套件。
  • 添加来自 =sdml_parse= 的所有测试示例的副本。
  • 调整 =test_examples.rs= 文件，以便宏可以接受多个生成器进行测试。
  • 为所有 =import_*= 测试用例添加 =generate_dependency_tree=。

版本 0.2.4

• 特性：添加具有标准布局的新 stdlib 模块。
• 特性：缓存和加载的轻微重构。

版本 0.2.3

• 特性：更新到最新的版本 URI 和 RDF 定义语法。
  • 在模块上添加对基本 URI 的支持。
  • 在模块上添加对版本信息和 URI 的支持。
  • 在模块导入上添加对版本 URI 的支持。
  • 解析类和属性的 RDF 定义。

版本 0.2.2

• 特性：删除成员组。

版本 0.2.1

• 修复：将 =-"= 替换为 =__"= 作为合格标识符的替换。

版本 0.2.0

• 特性：更新到最新的语法。
  • 删除 =ValueVariant= 的数值。
  • 更新正式约束。
  • 添加类型类。

版本 0.1.8

• 特性：将映射类型添加到 s-expr 和 UML 生成器。
• 构建：更新到最新的 =tree-sitter-sdml= 以获取高亮显示的更改。
• 构建：更新到最新的 =sdml-core= 以获取 =Cardinality::to_uml_string= 的更改。

版本 0.1.7

• 构建：更新以包含最近模型更改和修复。
• 修复：清理 UML 输出。

版本 0.1.6

• 特性：更新 org-mode 和 UML 生成器，包括来自 sdml-core 的多个模型更改。

版本 0.1.5

• 特性：更新，包括来自 sdml-core 的多个模型更改。

版本 0.1.4

之前是单个 crate 的一部分 [[https://crates.io/crates/sdml][sdml]]。