{"id":22362703,"url":"https://github.com/pragmagic/vscode-nim","last_synced_at":"2025-09-14T23:33:13.202Z","repository":{"id":47219383,"uuid":"51753808","full_name":"pragmagic/vscode-nim","owner":"pragmagic","description":"An extension for VS Code which provides support for the Nim language.","archived":false,"fork":false,"pushed_at":"2023-12-14T10:42:13.000Z","size":364,"stargazers_count":234,"open_issues_count":74,"forks_count":38,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-01-01T13:06:26.660Z","etag":null,"topics":["ide","nim","vscode"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pragmagic.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2016-02-15T12:24:14.000Z","updated_at":"2024-10-27T20:53:19.000Z","dependencies_parsed_at":"2024-12-04T17:11:15.770Z","dependency_job_id":"ad88b554-f4c1-414d-986a-d85174e3ba6a","html_url":"https://github.com/pragmagic/vscode-nim","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pragmagic%2Fvscode-nim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pragmagic%2Fvscode-nim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pragmagic%2Fvscode-nim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pragmagic%2Fvscode-nim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pragmagic","download_url":"https://codeload.github.com/pragmagic/vscode-nim/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233042927,"owners_count":18616105,"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","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":["ide","nim","vscode"],"created_at":"2024-12-04T17:11:05.467Z","updated_at":"2025-01-08T14:33:20.846Z","avatar_url":"https://github.com/pragmagic.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nim for Visual Studio Code\n\n[![Version](https://vsmarketplacebadge.apphb.com/version/kosz78.nim.svg)](https://marketplace.visualstudio.com/items?itemName=kosz78.nim)\n[![Installs](https://vsmarketplacebadge.apphb.com/installs/kosz78.nim.svg)](https://marketplace.visualstudio.com/items?itemName=kosz78.nim)\n[![Ratings](https://vsmarketplacebadge.apphb.com/rating/kosz78.nim.svg)](https://vsmarketplacebadge.apphb.com/rating/kosz78.nim.svg)\n[![Build Status](https://travis-ci.org/pragmagic/vscode-nim.svg?branch=master)](https://travis-ci.org/pragmagic/vscode-nim)\n\nThis extension adds language support for the Nim language to VS Code, including:\n\n- Syntax Highlight (nim, nimble, nim.cfg)\n- Code Completion\n- Signature Help\n- Goto Definition\n- Find References\n- File outline\n- Build-on-save\n- Workspace symbol search\n- Quick info\n- Nim check result reported in `Nim` output channel (great for macro development).\n\n![output channel demo](images/nim_vscode_output_demo.gif)\n\n## Using\n\nFirst, you will need to install Visual Studio Code `0.10`.\nIn the command palette (`cmd-shift-p`) select `Install Extension` and choose `Nim`.\n\nThe following tools are required for the extension:\n* Nim compiler - http://nim-lang.org\n\n_Note_: It is recommended to turn `Auto Save` on in Visual Studio Code (`File -\u003e Auto Save`) when using this extension.\n\n### Options\n\nThe following Visual Studio Code settings are available for the Nim extension.  These can be set in user preferences (`cmd+,`) or workspace settings (`.vscode/settings.json`).\n* `nim.buildOnSave` - perform build task from `tasks.json` file, to use this options you need declare build task according to [Tasks Documentation](https://code.visualstudio.com/docs/editor/tasks), for example:\n\t```json\n\t{\n\t   \"taskName\": \"Run module.nim\",\n\t   \"command\": \"nim\",\n\t   \"args\": [\"c\", \"-o:bin/${fileBasenameNoExtension}\", \"-r\", \"${fileBasename}\"],\n\t   \"options\": {\n\t      \"cwd\": \"${workspaceRoot}\"\n\t   },\n\t   \"type\": \"shell\",\n\t   \"group\": {\n\t      \"kind\": \"build\",\n\t      \"isDefault\": true\n\t   }\n\t}\n\t```\n* `nim.lintOnSave` - perform the project check for errors on save\n* `nim.project` - optional array of projects file, if nim.project is not defined then all nim files will be used as separate project\n* `nim.licenseString` - optional license text that will be inserted on nim file creation\n\n\n#### Example\n\n```json\n{\n\t\"nim.buildOnSave\": false,\n\t\"nim.buildCommand\": \"c\",\n\t\"nim.lintOnSave\": true,\n\t\"nim.project\": [\"project.nim\", \"project2.nim\"],\n\t\"nim.licenseString\": \"# Copyright 2017.\\n\\n\"\n}\n```\n\n### Commands\nThe following commands are provided by the extension:\n\n* `Nim: Run selected file` - compile and run selected file, it uses `c` compiler by default, but you can specify `cpp` in `nim.buildCommand` config parameter.\nThis command available from file context menu or by `F6` keyboard shortcut.\n\n## TODO\n\n* Rename support\n* Debug support\n\n## ChangeLog\n\nChangeLog is located [here](https://github.com/pragmagic/vscode-nim/blob/master/CHANGELOG.md)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpragmagic%2Fvscode-nim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpragmagic%2Fvscode-nim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpragmagic%2Fvscode-nim/lists"}