clojure-write

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

When

clojure-mcp

tools are available (e.g.,

clojure_eval

clojure_edit

), always use them instead of shell commands like

./bin/mage -repl

. The MCP tools provide:

Only fall back to

./bin/mage

commands when clojure-mcp is not available.

@./../_shared/development-workflow.md @./../_shared/clojure-style-guide.md @./../_shared/clojure-commands.md

当

clojure-mcp

工具可用时（例如

clojure_eval

、

clojure_edit

），请始终使用它们，而非

./bin/mage -repl

这类shell命令。MCP工具具备以下优势：

仅当clojure-mcp不可用时，才退而使用

./bin/mage

命令。

@./../_shared/development-workflow.md @./../_shared/clojure-style-guide.md @./../_shared/clojure-commands.md

Start with small, fundamental functions:
Identify the core features or functionalities required for your task.
Break each feature down into the smallest, most basic functions that can be developed and tested independently.
Write and test in the REPL:
- Write the code for each small function directly in the REPL (Read-Eval-Print Loop).
- Test it thoroughly with a variety of inputs, including typical use cases and relevant edge cases, to ensure it behaves as expected.
Integrate into source code:
- Once a function works correctly in the REPL, move it from the REPL environment into your source code files (e.g., within appropriate namespaces).
Gradually increase complexity:
- Build upon tested, basic functions to create more complex functions or components.
- Compose smaller functions together, testing each new composition in the REPL to verify correctness step by step.
Ensure dependency testing:
- Make sure every function is fully tested in the REPL before it is depended upon by other functions.
- This ensures that each layer of your application is reliable before you build on it.
Use the REPL fully:
- Use the REPL as your primary tool to experiment with different approaches, iterate quickly, and get immediate feedback on your code.
Follow functional programming principles:
- Keep functions small, focused, and composable.
- Use Clojure's functional programming features—like immutability, higher-order functions, and the standard library—to write concise, effective code.

从小型基础函数入手：
明确任务所需的核心特性或功能。
将每个特性拆解为可独立开发和测试的最小粒度基础函数。
在REPL中编写并测试：
- 直接在REPL（读取-求值-打印循环）中编写每个小型函数的代码。
- 使用各种输入（包括典型用例和相关边缘情况）进行全面测试，确保其行为符合预期。
集成到源代码中：
- 当函数在REPL中运行正常后，将其从REPL环境迁移到源代码文件中（例如放入合适的命名空间）。
逐步提升复杂度：
- 基于已测试的基础函数构建更复杂的函数或组件。
- 将小型函数组合在一起，每次新组合都在REPL中测试，逐步验证正确性。
确保依赖测试：
- 确保每个函数在被其他函数依赖前，已在REPL中完成全面测试。
- 这能保证在构建应用的上层逻辑前，每一层都是可靠的。
充分利用REPL：
- 将REPL作为主要工具，尝试不同方法、快速迭代并获取代码的即时反馈。
遵循函数式编程原则：
- 保持函数小巧、聚焦且可组合。
- 利用Clojure的函数式编程特性——如不可变性、高阶函数和标准库——编写简洁高效的代码。

./bin/mage -repl --namespace metabase.app-db.connection

Call functions in the namespace with test inputs, and observe that the outputs are correct Feel free to copy these REPL session trials into actual test cases using
```
deftest
```
and
```
is
```
.
Once you know these functions are good, return to 1, and compose them into the task that you need to build.

./bin/mage -repl --namespace metabase.app-db.connection

Be careful with parentheses counts when editing Clojure code
After EVERY change to Clojure code, verify readability with
```
-check-readable
```
End all files with a newline
When editing tabular code, where the columns line up, try to keep them aligned
Spaces on a line with nothing after it is not allowed