From 881fe6c9e7a955ecb1c5b31f4e26ea454de0b873 Mon Sep 17 00:00:00 2001 From: Fredrik Averpil Date: Sat, 29 Jun 2024 14:13:08 +0200 Subject: [PATCH] docs: general cleanups --- README.md | 62 +++++++++++++++++-------------------------------------- 1 file changed, 19 insertions(+), 43 deletions(-) diff --git a/README.md b/README.md index 11c7b0db..e379918b 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # neotest-golang -A Neotest adapter for running Go tests. +Reliable Neotest adapter for running Go tests in Neovim. neotest-golang @@ -17,54 +17,30 @@ A Neotest adapter for running Go tests. - Supports table tests (relies on treesitter AST detection). - Supports nested test functions. -## 🚧 Work in progress +## 🤔 Why a second Neotest adapter for Go? -This Neotest adapter is under heavy development and I'm dogfooding myself with -this project on a daily basis, as full-time Go developer. +While using [neotest-go](https://github.com/nvim-neotest/neotest-go) I have +stumbled upon many problems which seem difficult to solve in the neotest-go +codebase. -My next focus areas: - -- [ ] Refactoring, polish and the addition of tests. -- [ ] Documentation around expanding new syntax support for table tests via AST - parsing. -- [ ] Add debug logging: - [neotest#422](https://github.com/nvim-neotest/neotest/discussions/422) -- [ ] Investigate ways to speed up test execution when executing tests in a - file. - -## 🏓 Background - -I've been using Neovim and Neotest with -[neotest-go](https://github.com/nvim-neotest/neotest-go) but I have stumbled -upon many problems which seem difficult to solve in the neotest-go codebase. - -I have full respect for the time and efforts put in by the developer(s) of -neotest-go. I do not aim in any way to diminish their needs or efforts. +> [!NOTE] I have full respect for the time and efforts put in by the +> developer(s) of neotest-go. I do not aim in any way to diminish their needs or +> efforts. However, I would like to see if, by building a Go adapter for Neotest from scratch, if I can mitigate the issues I have found with neotest-go. -### Neotest-go issues mitigated in neotest-golang - -- Test Output in JSON, making it difficult to read: - [neotest-go#52](https://github.com/nvim-neotest/neotest-go/issues/52) -- "Run nearest" runs all tests: - [neotest-go#83](https://github.com/nvim-neotest/neotest-go/issues/83) -- Running test suite doesn't work: - [neotest-go#89](https://github.com/nvim-neotest/neotest-go/issues/89) -- Diagnostics for table tests on the line of failure: - [neotest-go#75](https://github.com/nvim-neotest/neotest-go/issues/75) -- Support for Nested Subtests: - [neotest-go#74](https://github.com/nvim-neotest/neotest-go/issues/74) -- DAP support: - [neotest-go#12](https://github.com/nvim-neotest/neotest-go/issues/12) - -### Upstream/dependency issues found during development - -- Test output is printed undesirably: - [neotest#391](https://github.com/nvim-neotest/neotest/issues/391). This is - currently mitigated in neotest-golang by reading the neotest-written test - output file on disk, parsing it and then erasing its contents. +Below is a table outlining the issues present in neotest-go which are not an +issue in neotest-golang: + +| Mitigated issues | Issue URL | +| -------------------------------------------------- | --------------------------------------------------------------------- | +| Test Output in JSON, making it difficult to read | [neotest-go#52](https://github.com/nvim-neotest/neotest-go/issues/52) | +| "Run nearest" runs all tests | [neotest-go#83](https://github.com/nvim-neotest/neotest-go/issues/83) | +| Running test suite doesn't work | [neotest-go#89](https://github.com/nvim-neotest/neotest-go/issues/89) | +| Diagnostics for table tests on the line of failure | [neotest-go#75](https://github.com/nvim-neotest/neotest-go/issues/75) | +| Support for Nested Subtests | [neotest-go#74](https://github.com/nvim-neotest/neotest-go/issues/74) | +| DAP support | [neotest-go#12](https://github.com/nvim-neotest/neotest-go/issues/12) | ## 🥸 Installation