{"id":18689685,"url":"https://github.com/mrseanryan/test-doc","last_synced_at":"2025-10-13T02:43:23.273Z","repository":{"id":96810088,"uuid":"576423457","full_name":"mrseanryan/test-doc","owner":"mrseanryan","description":"Generate a **markdown summary of your C# unit tests** via a simple C# script (CSX script executed via CSI).","archived":false,"fork":false,"pushed_at":"2022-12-09T21:07:57.000Z","size":4,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-13T02:43:19.272Z","etag":null,"topics":["csx","documentation-generator","documentation-tool","dotnet-script","unit-tests","unit-tests-documentation"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrseanryan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-12-09T20:29:47.000Z","updated_at":"2024-11-19T23:27:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"49ab3ebb-0b8d-49ef-9d9d-eae5b974b41a","html_url":"https://github.com/mrseanryan/test-doc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mrseanryan/test-doc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrseanryan%2Ftest-doc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrseanryan%2Ftest-doc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrseanryan%2Ftest-doc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrseanryan%2Ftest-doc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrseanryan","download_url":"https://codeload.github.com/mrseanryan/test-doc/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrseanryan%2Ftest-doc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279014017,"owners_count":26085346,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csx","documentation-generator","documentation-tool","dotnet-script","unit-tests","unit-tests-documentation"],"created_at":"2024-11-07T10:44:40.776Z","updated_at":"2025-10-13T02:43:23.256Z","avatar_url":"https://github.com/mrseanryan.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# test-doc README\r\n\r\nGenerate a **markdown summary of your C# unit tests** via a simple C# script (CSX script executed via dotnet script or CSI.exe).\r\n\r\n- currently supports **NUnit based tests**\r\n\r\n## Usage\r\n\r\n**test-doc** is a CSX script (C# script). There are two main ways to execute a CSX script:\r\n\r\n- via dotnet script (.NET Core 6 or 7)\r\n- via CSI.exe (installed with Microsoft Visual Studio)\r\n\r\n### Usage - via dotnet script\r\n\r\n1. Check that .NET Core 6 or 7 is installed:\r\n\r\n`dotnet --version`\r\n\r\n2. Install the 'script' tool of dotnet\r\n\r\n`dotnet tool install -g dotnet-script`\r\n\r\n3. Build your unit tests and note the path to the assembly (the DLL file).\r\n\r\n4. Open a command prompt.\r\n\r\n5. CD to this directory\r\n\r\n6. Execute the C# script via `dotnet script`:\r\n\r\n`dotnet script test-doc.csx \u003cpath to the unit tests DLL\u003e`\r\n\r\nThis outputs a summary of all unit tests in markdown format.\r\n\r\n### Usage - via CSI.exe (installed with Microsoft Visual Studio)\r\n\r\n1. Build your unit tests and note the path to the assembly (the DLL file).\r\n\r\n2. Open a `Developer Command Prompt`. This is installed with **Microsoft Visual Studio** and you can search for it via `Windows-Key + Q`. OR if you have .NET Core 5 or 6 installed then `csi` may be available.\r\n\r\n3. CD to this directory\r\n\r\n4. Execute the C# script via CSI:\r\n\r\n`csi test-doc.csx \u003cpath to the unit tests DLL\u003e`\r\n\r\nThis outputs a summary of all unit tests in markdown format.\r\n\r\n## Example output\r\n\r\n```\r\n# Tests in MyCompany.Project1.MyApp.CoreTests\r\n\r\n## Test class NumberParsingTests\r\n- It_should_parse_a_number\r\n- It_should_not_parse_a_date\r\n\r\n## Test class InterestCalculator\r\n- It_should_calculate_interest_for_one_year_at_10_percent\r\n- It_should_calculate_interest_for_5_years_at_15_percent\r\n```\r\n\r\n## Dependencies\r\n\r\nThe C# script requires tooling to execute the CSX script.\r\n\r\nThere are 2 options:\r\n\r\n1. [recommended] [dotnet core](https://dotnet.microsoft.com/en-us/download/dotnet) and [dotnet script](https://github.com/dotnet-script/dotnet-script)\r\n\r\nOR\r\n\r\n2. [CSI](https://learn.microsoft.com/en-us/archive/msdn-magazine/2016/january/essential-net-csharp-scripting) to execute.\r\n\r\nThis is installed as part of **Microsoft Visual Studio**.\r\n\r\n## Compatibility\r\n\r\nTested with:\r\n- dotnet script (dotnet version 6.0.400)\r\n- Microsoft (R) Visual C# Interactive Compiler version 4.3.0-3.22401.3\r\n\r\nThe version of the tool (`dotnet script` or else `CSI.exe`) determines which .NET framework will be used to execute. This limits which .NET assemblies (DLL files) can be loaded for analysis.\r\n\r\nSo for example, if the CSI tool is .NET Core based, then it might not be able to load Windows specific .NET assemblies. In that case, it is beter to use `dotnet script`.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrseanryan%2Ftest-doc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrseanryan%2Ftest-doc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrseanryan%2Ftest-doc/lists"}