summary refs log tree commit diff stats
path: root/doc/tools.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/tools.md')
-rw-r--r--doc/tools.md45
1 files changed, 45 insertions, 0 deletions
diff --git a/doc/tools.md b/doc/tools.md
new file mode 100644
index 000000000..baf7ce386
--- /dev/null
+++ b/doc/tools.md
@@ -0,0 +1,45 @@
+========================
+Tools available with Nim
+========================
+
+.. default-role:: code
+.. include:: rstcommon.rst
+
+The standard distribution ships with the following tools:
+
+- | [atlas](atlas.html)
+  | `atlas`:cmd: is a simple package cloner tool. It manages an isolated workspace that
+    contains projects and dependencies.
+
+- | [Hot code reloading](hcr.html)
+  | The "Hot code reloading" feature is built into the compiler but has its own
+    document explaining how it works.
+
+- | [Documentation generator](docgen.html)
+  | The builtin document generator `nim doc`:cmd: generates HTML documentation
+    from ``.nim`` source files.
+
+- | [Nimsuggest for IDE support](nimsuggest.html)
+  | Through the `nimsuggest`:cmd: tool, any IDE can query a ``.nim`` source file
+    and obtain useful information like the definition of symbols or suggestions for
+    completion.
+
+- | [C2nim](https://github.com/nim-lang/c2nim/blob/master/doc/c2nim.rst)
+  | C to Nim source converter. Translates C header files to Nim.
+
+- | [niminst](niminst.html)
+  | niminst is a tool to generate an installer for a Nim program.
+
+- | [nimgrep](nimgrep.html)
+  | Nim search and replace utility.
+
+- | nimpretty
+  | `nimpretty`:cmd: is a Nim source code beautifier,
+    to format code according to the official style guide.
+
+- | [testament](testament.html)
+  | `testament`:cmd: is an advanced automatic *unittests runner* for Nim tests,
+    is used for the development of Nim itself, offers process isolation for your tests,
+    it can generate statistics about test cases, supports multiple targets (C, JS, etc),
+    has logging, can generate HTML reports, skip tests from a file, and more,
+    so can be useful to run your tests, even the most complex ones.