{"id":16667485,"url":"https://github.com/bryphe/merlin-language-server","last_synced_at":"2025-03-23T14:31:31.391Z","repository":{"id":100512980,"uuid":"160955074","full_name":"bryphe/merlin-language-server","owner":"bryphe","description":"Minimal cross-platform LSP wrapper for merlin","archived":false,"fork":false,"pushed_at":"2019-03-03T21:26:20.000Z","size":136,"stargazers_count":28,"open_issues_count":5,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-18T21:16:01.683Z","etag":null,"topics":["lsp","lsp-server","merlin","merlin-language-server","ocaml","reason"],"latest_commit_sha":null,"homepage":"","language":"OCaml","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/bryphe.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":"2018-12-08T16:02:08.000Z","updated_at":"2020-06-10T21:42:15.000Z","dependencies_parsed_at":"2023-05-15T14:30:35.429Z","dependency_job_id":null,"html_url":"https://github.com/bryphe/merlin-language-server","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryphe%2Fmerlin-language-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryphe%2Fmerlin-language-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryphe%2Fmerlin-language-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryphe%2Fmerlin-language-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bryphe","download_url":"https://codeload.github.com/bryphe/merlin-language-server/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245115877,"owners_count":20563252,"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":["lsp","lsp-server","merlin","merlin-language-server","ocaml","reason"],"created_at":"2024-10-12T11:14:18.967Z","updated_at":"2025-03-23T14:31:31.374Z","avatar_url":"https://github.com/bryphe.png","language":"OCaml","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://bryphe.visualstudio.com/merlin-language-server/_apis/build/status/bryphe.merlin-language-server?branchName=master)](https://bryphe.visualstudio.com/merlin-language-server/_build/latest?definitionId=16?branchName=master)\n\n# merlin-language-server\n### Simple LSP protocol wrapper for [`merlin`](https://github.com/ocaml/merlin), written in [reason](https://reasonml.github.io/)\n\n:warning: Alpha quality\n\n### Overview\n\n`merlin-language-server` is a thin wrapper over the excellent [`merlin`](https://github.com/ocaml/merlin) tooling - implementing the LSP protocol on-top of [`merlin`'s protocol](https://github.com/ocaml/merlin/blob/master/doc/dev/PROTOCOL.md). \n\nAs with `ocaml-language-server`, this is not intended as a replacement for any existing Reason / OCaml tooling, but to make it more accessible across editors.\n\n### Why?\n\nThere are already two excellent language server implementations - [`reason-language-server`](https://github.com/jaredly/reason-language-server) and [`ocaml-language-server`](https://github.com/freebroccolo/ocaml-language-server) - why another one?\n\nThe current language-server landspace could be summarized with this table:\n\n| __Language Server__ | Uses `merlin` | Implemented in `reason` | Supports Windows |\n| --- | --- | --- | --- |\n| `ocaml-language-server` | :white_check_mark: | :x: | :x: (1) |\n| `reason-language-server` | :x: | :white_check_mark: | :x: (2) |\n| `merlin-language-server` | :white_check_mark: | :white_check_mark: | :white_check_mark: |\n\n\u003e __NOTE (1):__ I believe `ocaml-language-server` may support Windows, but I was not able to get it working.\n\n\u003e __NOTE (2):__ `reason-language-server` mentions Windows support as a goal, but again, it did not work for me. I contributed several fixes towards this (PRs [#36](https://github.com/jaredly/reason-language-server/pull/36), [#130](https://github.com/jaredly/reason-language-server/pull/130), [#199](https://github.com/jaredly/reason-language-server/pull/199)), but there is still significant investment required to get support on parity with `merlin` on Windows.\n\nThe primary issue for me being that there was not a language server implementation that worked well for me on Windows. It turns out that `merlin` works great on Windows - so having a native-reason LSP implementation that uses `merlin` is a natural choice. \n\nIn the future, perhaps we could integrate this more fully into `merlin` at some point, or incorporate `merlin` as a library that we call directly.\n\n### Building\n\n#### Prerequisites\n\n- You will need [`esy`](https://esy.sh) to build - `npm install -g esy`\n- For running tests, you will need `node`.\n\n#### Build\n\n- `git clone https://github.com/bryphe/merlin-language-server`\n- `esy install`\n- `esy build`\n\n#### Tests\n- Unit tests: `esy x TestRunner.exe`\n- E2E tests: \n    - `cd test-e2e`\n    - `npm install`\n    - `npm test`\n\n### Roadmap\n\n- Distribution\n    - [ ] First-class Oni integration\n    - [ ] VSCode Plugin\n    - [ ] NPM package with pre-built binaries\n- Features\n    - Text synchronization\n        - [x] `textDocument/didOpen`\n        - [x] `textDocument/didChange`\n        - [x] Full document sync\n        - [ ] Incremental document sync\n    - Language Features\n        - [x] `completion`\n        - [x] `hover`\n        - [ ] `definition`\n        - [ ] `implementation`\n        - [ ] `references`\n        - [ ] `signatureHelp`\n        - [ ] `codeAction`?\n        - [ ] `codeLens`\n        - [ ] `formatting`\n        - [ ] `rangeFormatting`\n        - [ ] `onTypeFormatting`\n\n### Contributions\n\nContributions \u0026 PRs are welcome! Please ensure that test coverage is added for any new functionality - either in the form of unit tests or E2E tests.\n\n### License\n\n[MIT License](LICENSE)\n\nCopyright 2018 Bryan Phelps\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbryphe%2Fmerlin-language-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbryphe%2Fmerlin-language-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbryphe%2Fmerlin-language-server/lists"}