Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rcjsuen/dockerfile-language-service
Dockerfile language service for providing an API to create feature-rich Dockerfile editors in JavaScript.
https://github.com/rcjsuen/dockerfile-language-service
api code-completion dockerfile dockerfiles editor formatter language-server-protocol lint validation
Last synced: 3 months ago
JSON representation
Dockerfile language service for providing an API to create feature-rich Dockerfile editors in JavaScript.
- Host: GitHub
- URL: https://github.com/rcjsuen/dockerfile-language-service
- Owner: rcjsuen
- License: mit
- Created: 2018-02-16T22:55:37.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-08-04T18:31:40.000Z (3 months ago)
- Last Synced: 2024-08-05T11:51:36.194Z (3 months ago)
- Topics: api, code-completion, dockerfile, dockerfiles, editor, formatter, language-server-protocol, lint, validation
- Language: TypeScript
- Size: 12.9 MB
- Stars: 16
- Watchers: 3
- Forks: 2
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: License.txt
Awesome Lists containing this project
README
# Dockerfile Language Service
 [](https://coveralls.io/github/rcjsuen/dockerfile-language-service?branch=master) [](https://david-dm.org/rcjsuen/dockerfile-language-service) [](https://opensource.org/licenses/MIT)
This is a language service for Dockerfiles written in TypeScript.
If you are looking for an actual Dockerfile language server that can be used with editors that implement the [language server protocol](http://microsoft.github.com/language-server-protocol), please visit the [rcjsuen/dockerfile-language-server-nodejs repository](https://github.com/rcjsuen/dockerfile-language-server-nodejs).
The purpose of this project is to provide an API for creating a feature-rich Dockerfile editor.
While this language service implements requests from the language server protocol, they are exposed as regular JavaScript functions so you can use them in the browser if you wish.
For a demonstration of this language service's capabilities with Microsoft's [Monaco Editor](https://microsoft.github.io/monaco-editor/), please click [here](https://rcjsuen.github.io/dockerfile-language-service/).
To [install](#installation-instructions) this language service as a dependency into your project, you will need to have [Node.js](https://nodejs.org/en/download/) installed.
**Supported features:**
- code actions
- code completion
- definition
- diagnostics
- document highlight
- document links
- document symbols
- folding
- formatting
- hovers
- rename
- semantic tokens
- signature help
## Development Instructions
If you wish to build and compile this language server, you must first install [Node.js](https://nodejs.org/en/download/) if you have not already done so.
After you have installed Node.js and cloned the repository with Git, you may now proceed to build and compile the language server with the following commands:
```
npm install
npm run build
npm test
```
If you are planning to change the code, use `npm run watch` to get the TypeScript files transpiled on-the-fly as they are modified.
## Installation Instructions
To add this language service into your project, you must add `dockerfile-language-service` as a dependency in your package.json file.
## Browser Example
The `/example/` folder includes an example for using this language service in a browser as a static HTML page with JavaScript.
To build the example, please run the following commands from the root of the project:
```
npm install
cd example
npm install
npm run build
```
As the example naturally relies on the language service, it is necessary to invoke `npm install` on the root folder first before invoking `npm install` in the `/example/` folder.
Once `npm run build` has completed, you can open the `/example/lib/index.html` in a browser to test things out!