{"id":22980587,"url":"https://github.com/dinau/nimv","last_synced_at":"2025-04-09T16:18:16.552Z","repository":{"id":65237655,"uuid":"577324699","full_name":"dinau/nimv","owner":"dinau","description":"Simple CUI wrapper for choosenim","archived":false,"fork":false,"pushed_at":"2025-04-05T04:25:48.000Z","size":377,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-09T16:18:07.229Z","etag":null,"topics":["choosenim","cli","cui","nim","nim-lang","version","version-manager","wrapper"],"latest_commit_sha":null,"homepage":"","language":"Nim","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/dinau.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-12T13:43:00.000Z","updated_at":"2025-04-05T04:25:52.000Z","dependencies_parsed_at":"2025-04-05T05:23:01.808Z","dependency_job_id":"b6fd6ae7-8d92-4908-bb71-09976984eaeb","html_url":"https://github.com/dinau/nimv","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dinau%2Fnimv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dinau%2Fnimv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dinau%2Fnimv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dinau%2Fnimv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dinau","download_url":"https://codeload.github.com/dinau/nimv/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248065280,"owners_count":21041872,"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":["choosenim","cli","cui","nim","nim-lang","version","version-manager","wrapper"],"created_at":"2024-12-15T01:44:16.671Z","updated_at":"2025-04-09T16:18:16.546Z","avatar_url":"https://github.com/dinau.png","language":"Nim","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n- [Nimv : Simple CUI wrapper for Choosenim command](#nimv--simple-cui-wrapper-for-choosenim-command)\n  - [Install](#install)\n  - [Key operation](#key-operation)\n    - [Top menu](#top-menu)\n    - [Selecting other Nim version](#selecting-other-nim-version)\n    - [Install other Nim versions](#install-other-nim-versions)\n    - [Remove nim versions](#remove-nim-versions)\n    - [Other key operation](#other-key-operation)\n    - [Selecting a version on command line](#selecting-a-version-on-command-line)\n    - [Transparently throwing commands to Choosenim](#transparently-throwing-commands-to-choosenim)\n    - [Debug mode](#debug-mode)\n  - [[Optional]:  Setup config file '.nimv.json'](#optional--setup-config-file-nimvjson)\n    - [Place config file to your home folder](#place-config-file-to-your-home-folder)\n    - [Set choosenimDir and nimbleDir option](#set-choosenimdir-and-nimbledir-option)\n    - [Addition of installable versions to menu](#addition-of-installable-versions-to-menu)\n    - [Uninstall Nimv](#uninstall-nimv)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n# Nimv : Simple CUI wrapper for Choosenim command\n\n![alt](img/topMenu.png)\n\n## Install\n\n---\n\n1. First install **choosenim** command  \n   Refer to [https://github.com/dom96/choosenim](https://github.com/dom96/choosenim)\n1. Confirm nim version\n\n   ```bash\n   $ choosenim stable\n          Info: C:\\Users\\mi\\.choosenim\\downloads\\dlls.zip already downloaded\n     Extracting dlls.zip\n          Info: Version 1.6.10 already selected\n    ```\n\n1. Install anyway other Nim version,\n\n   ```bash\n   choosenim 1.6.8\n   ```\n\n1. Install **Nimv** command,\n   - Release version\n\n      ```bash\n      nimble install https://github.com/dinau/nimv\n      ```\n\n   - Bleeding edge version (may be same as release version)\n\n      ```bash\n      nimble install https://github.com/dinau/nimv@#head\n      ```\n\n1. Run **Nimv** command in MS-DOS/PowerShell Window or terminal window etc,\n\n   ```bash\n   nimv\n   ```\n\n## Key operation\n\n### Top menu\n\n---\n\n![alt](img/topMenu.png)\n\n### Selecting other Nim version\n\n---\n\nPress `'1'`(one) key to select **nim-1.6.10**.\n\n![alt](img/selected1.png)\n\nActivated **nim-1.6.10**.\n\n### Install other Nim versions\n\n---\n\n1. Press `'L'` key to list up installable nim versions.\n\n   ![alt](img/listMenu.png)\n\n1. You can **install other nim version** by pressing key `'0' or '1' or '2'`  \n    at above situation.\n1. You can then go back to top menu by pressing key `'M' or 'R'`.\n\n### Remove nim versions\n\n---\n\n1. Press `'R'` key on top menu to remove nim version.\n\n   ![alt](img/removeMenu.png)\n\n1. You can remove **nim-1.6.8** by pressing key `'0'`(zero).\n\n### Other key operation\n\n---\n\n![alt](img/uAndpMenu.png)  \n- Press `'U'` key to update to **stable** version.\n- Press `'P'` key to install/update **devel** version (**nim-#devel**).\n\n### Selecting a version on command line\n\n---\n\n1. Start Nimv and get the number `'1'` of **nim-1.6.10** then **exit** Nimv.\n  ![alt](img/sel1OnCommandline.png)\n1. You can select **nim-1.6.10** by specifying the number `'1'` on command line as follows,\n\n   ```bash\n   nimv 1\n   ```\n1. You can specify from `0` up to max `9`.\n\n### Transparently throwing commands to Choosenim\n\n---\n\nFor instance on command line,\n\n```bash\nnimv 1.4.0\nnimv versions\nnimv show\nnimv remove 1.6.8\nsnip\n```\n\nare same as\n\n```bash\nchoosenim 1.4.0\nchoosenim versions\nchoosenim show\nchoosenim remove 1.6.8\nsnip\n```\n\nexcept `nimv --version`,\n\n```bash\n$ nimv --version\nnimv 1.3.0 (2023/01): Simple CUI wrapper for Choosenim command.\n              from 2021/10 by audin\nUsage:\n    nimv [option]\n       option:\n            None : Show simple CUI for Choosenim.\n            -h, /?, /h, -v, --version: Show this page.\n            -d: Start nimv with debug mode. Shown choosenim command.\n    .nimv.json: List of old nim versions and configration to nimv.\n                It can be set show/hide to list up the specified nim version.\n                This file can be placed in user home folder.``\n```\n\n### Debug mode\n\n---\n\nStart with `-d` option.\nIt will show debug info while running.\n\n```bash\nnimv -d\n```\n\n## [Optional]:  Setup config file '.nimv.json'\n\n### Place config file to your home folder\n\n---\n\n- Home folder generally is \n   - Windows OS:  `c:\\Users\\[UserName]\\`\n   - Linux OS:  `~/` or `/home/[UserName]` etc\n\n1. Copy [.nimv.json](https://github.com/dinau/nimv/blob/main/.nimv.json) to your home folder\nand restart Nimv.  \n   ![alt](img/jsonPlace.png)\n1. `.nimv.json` file correctly loaded.   \n   ![alt](img/jsonLoaded.png)\n\n### Set choosenimDir and nimbleDir option\n\n---\n\nThese options correspond to `--choosenimDir` and `--nimblemDir`.\n\nYou can set them in `.nimv.json` for instance,\n\n- Windows OS\n\n   ```json\n   \"choosenimDir\":\"c:\\\\foo\\\\mychDir\",\n   \"nimbleDir\":\"c:\\\\bar\\\\mynbDir\",\n   snip\n   ```\n\n- Linux OS\n\n   ```json\n   \"choosenimDir\":\"~/foo/mychDir\",\n   \"nimbleDir\":\"~/bar/mynbDir\",\n   snip\n   ```\n\n### Addition of installable versions to menu \n\n---\n\nSet value of `\"1\"` to `\"enable:\"` in `.nimv.json` for instance,\n\nfrom\n\n```json\nsnip\n\"oldVers\":[\n  {\"enable\":1, \"ver\":\"1.6.10\", \"date\":\"2022-11-21\", \"comment\":\"\"},\n  {\"enable\":1, \"ver\":\"1.6.8\", \"date\":\"2022-09-27\", \"comment\":\"\"},\n  {\"enable\":0, \"ver\":\"1.6.6\", \"date\":\"2022-05-05\", \"comment\":\"\"},\n  {\"enable\":0, \"ver\":\"1.6.4\", \"date\":\"2022-02-09\", \"comment\":\"\"},\n  {\"enable\":0, \"ver\":\"1.6.2\", \"date\":\"2021-12-17\", \"comment\":\"\"},\nsnip\n```\n\nto\n\n```json\nsnip\n\"oldVers\":[\n  {\"enable\":1, \"ver\":\"1.6.10\", \"date\":\"2022-11-21\", \"comment\":\"\"},\n  {\"enable\":1, \"ver\":\"1.6.8\", \"date\":\"2022-09-27\", \"comment\":\"\"},\n  {\"enable\":1, \"ver\":\"1.6.6\", \"date\":\"2022-05-05\", \"comment\":\"\"},\n  {\"enable\":1, \"ver\":\"1.6.4\", \"date\":\"2022-02-09\", \"comment\":\"\"},\n  {\"enable\":1, \"ver\":\"1.6.2\", \"date\":\"2021-12-17\", \"comment\":\"\"},\nsnip\n```\n\nresult in\n\n   ![alt](img/addingVersMenu.png)\n\nYou can enable up to **max 20** versions.\n\n### Uninstall Nimv\n\n---\n\n```bash\nnimble uninstall nimv\n```\n\nBye.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdinau%2Fnimv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdinau%2Fnimv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdinau%2Fnimv/lists"}