SQL Formatter 项目教程

1. 项目目录结构及介绍

在 sql-formatter 开源项目中，主要的目录结构如下：

.
├── build                 # 构建相关的脚本和配置
├── core                  # 核心格式化代码
│   ├── src               # 源代码
│   └── test              # 单元测试
├── distribution          # 包含不同平台的可执行文件
├── examples              # 示例 SQL 查询
├── lib                    # 第三方库
├── scripts                # 辅助脚本
├── src                     # 主要源代码目录
└── test-data              # 测试数据

• build：包含了构建项目使用的Gradle脚本和其他配置。
• core：存储了SQL格式化的核心逻辑，包括Java源码和单元测试。
• distribution：存放已编译好的二进制可执行文件，适合不同操作系统。
• examples：提供了一些示例SQL查询供测试使用。
• lib：外部依赖库，用于支持项目运行。
• scripts：辅助脚本，例如自动化测试或打包操作。
• src：主要的Java源代码，实现SQL格式化功能。
• test-data：用于测试的各种输入和预期输出SQL查询。

2. 项目的启动文件介绍

该项目是用Java语言编写的，因此主要通过Java JAR文件来执行。你可以找到JAR包在distribution目录下。例如，对于命令行接口（CLI）的使用，你需要执行以下命令：

java -jar path/to/distro/sql-formatter.jar [options] <sql-input-file> [output-file]

这里的[options]指的是可选参数，如设置格式化风格，<sql-input-file>是待格式化的SQL文件路径，[output-file]是格式化后SQL的保存位置（默认为标准输出）。

3. 项目的配置文件介绍

尽管该项目本身并不直接使用配置文件来运行，但你可以在调用时传递一些参数来定制格式化行为。这些选项通常包括缩进风格（空格还是Tab），每行的最大字符数等。例如，你可以使用--indent-spaces参数来指定缩进的空格数量。

你还可以通过编程方式，如Java API，将这些配置整合到你的应用中，以自定义SQL格式化的行为。具体API用法可以参考项目文档或源代码中的示例。

请注意，如果你想要进行更高级的集成，例如在IDE或脚本中自动格式化SQL，可能需要查阅项目提供的API文档或示例代码，以便进行定制配置和集成。