Nova™

Extensions

Readme

Docker Suite

Dockerfile(+Bash) syntax and Language Server support.

Docker Sidebar for managing containers, contexts and images.

More features to come...

Language Support

  • Enhanced syntax highlighting using tree-sitter:

    • Dockerfile
    • Bash

  • Language Server support including:

    • Autocompletion
    • Documentation
    • Validation
    • Hover
    • Linting

  • Alpha Stand-alone Docker LS Binary (optional)

    • No dependencies.
    • No manual setup.
    • Enable if you want it, or provide your own.

Docker Sidebar

  • Alpha Docker Client Sidebar
    • View Contexts, Containers, Projects and Images
    • Start, Stop, Remove etc...
    • More features to come!

Future roadmap

  • Sidebar for managing Docker Containers and Images. Alpha Phase
    • Add: File explorer
    • Add: Docker Compose LSP
    • Add: Networks and Volumes
    • Various QoL improvements
    • Etc...
  • Docker-Compose language server support. Delayed for Nova update
  • Bundle Language Server to remove need for installation. Alpha Phase

Changelog

Version 1.1.8

Docker Sidebar Updates

  • Added "Toggle Dangling" setting for Images.
  • Condensed header options to settings menu for future options.
    • Trial bases for upcoming options. Feedback desired.

Dockerfile LSP Updates

  • Initial LSP Client & Repo refactoring to improve reuse. (compose)
  • Migration to new LSP repo.
    • New Dockerfile LSP.

More to come.

Version 1.1.7

Docker Sidebar Updates

  • Added "Inspect" functionality for Containers and Images.
  • Added "Tail Logs" functionality for running Containers.
    • Due to limitations in Nova this will open in OS X Terminal.
  • New Container customization options added.
    • Choose label value: Name, Repo:Tag, ID
    • Container Status icons added.
    • Descriptive text options added.
  • Added hover tooltip to Containers.
    • Additional details to be added.
  • Updated some sidebar notifications to include Reload option.

More to come.

Version 1.1.6

Docker Sidebar Updates

  • Notifications if Docker is missing or not running.
  • User notifications for any Sidebar command issues.
  • Settings shortcut added to Sidebar headers.
  • Context status icon customization added.
    • New Context icons added.
    • Original icons available through settings.
  • Context description customization added.
  • Attach in Terminal option should now auto-focus.

More to come.

Version 1.1.5

Docker Sidebar Updates

  • Multi-select support added for:
    • Containers
    • Compose
    • Images

Next few updates still focusing on QoL improvements.

Compose LS to be added to QoL list, despite Nova limitations.

More to come.

Version 1.1.4

Docker Sidebar Updates

  • Live Container and Image updates.

    • The Docker Sidebar now triggers an event listener at launch to automatically update when changes occur to containers and images.
    • If Docker Suite is run prior to Docker/Colima, reloading contexts or using the included command will restart the listener.
    • As further views are added (e.g. Networks & Volumes) automatic reloading will be standard.

  • Open Container session in Terminal ("Attach Terminal")

    • As Nova does not expose its built-in terminal through the API, this option will instead trigger an AppleScript to launch Terminal.app with the session exec.
    • As this is using AppleScript to launch Terminal.app, macOS will prompt for permission.
    • If you, like I, hope to see Nova add support for leveraging the built-in Nova terminal rather than AppleScript hacks, please let them know!

Next few updates will focus on various QoL improvements.

File Explorer planned post QoL.

More to come.

Version 1.1.3

Bug fix for latest Docker Engine release.

  • Updated Sidebar formatting request from deprecated standard to new standard.
  • Major thanks to @gabriel_rinaldi bringing this to my attention!

Live updates are still on track to be released this weekend.

Feel free to report any further issues.

More to come.

Version 1.1.2

Docker Sidebar Updates

  • Retain the collapsed state of projects and images between reloads.
    • Essential for the upcoming live updates functionality, otherwise very frustrating.
  • Minor context label customization. (DockerEndpoint or Name)
    • Additional customization and subtext options for all categories coming.
  • Various backend changes.

Live updates to containers & images coming next update.

More features to come!

Version 1.1.1

Docker Sidebar Updates

  • Docker Compose Start|Stop|Down|Restart support
  • Updated 'Project' name to be subtext
    • Customization planned.
  • Reloading of Containers and Images upon context swap within sidebar

Bug Fixes

  • Corrected an issue where project containers would randomly be treated as an individual container.

More to come.

Version 1.1.0

Alpha release of the Docker Client Sidebar. - View Contexts, Containers and Images - Start, Stop, Remove etc...

More features to come!

Version 1.0.4

Prepping for Docker-Compose language server support. Due to limitations in Nova, release will be delayed until certain updates.

Various syntax enhancements.

Corrected an issue when starting/stopping the experimental binary feature that would not reactivate the path specified ls.

Version 1.0.3

New experimental feature to automatically fetch and configure a stand-alone binary language server. When enabled, this removes the Node.js dependency as well as the manual installation requirements. Enable it from the extension preferences (internet required to fetch the binary). Please give it a try!

An experimental workaround to better detect Dockerfiles that utilize the filename extension to define purpose. Currently limitations exist in Nova for proper detection where the filename is static and extension is dynamic. Current work around attempts to match content per a couple common Dockerfile keywords and syntax comment.

Added a Docker Suite reload command-let.

Various other improvements.

Special congratulations to everyone that worked on Artemis 1! 🚀

Version 1.0.2

Added missing comment-out support.

Experimental automated Language Server inclusion coming this week. Perusing a pre-compiled solution to omit the need for the host to offer both node and the module.

Version 1.0.1

Optional LSP notifications, improved highlighting and minor cleanup

Basic Notifications for LSP

  • Nova Notification if the docker-langserver appears missing at path
  • Nova Notification if the Language Server exits unexpectedly
  • LSP Notifications can be disabled in extension settings

Additional improvements to highlighting

  • More to come

Version 1.0

Initial release

Adding support to Nova for:

  • Dockerfile syntax
  • Bash subsyntax
  • Dockerfile LSP

License

MIT License

Copyright (c) 2022-2023 Jonathan Coole

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Help

Guides and Troubleshooting

Language Server Installation

In order to use all the benefits of LSP, you must have a local Dockerfile Language Server.

Fortunately, Docker Suite provides a stand-alone option that makes this automatic!

For those who wish to provide their own, Docker Suite supports that as well.

Stand-alone LSP (Recommended)

  1. Experimental From within the Docker Suite preferences, enable the stand-alone Docker LS Binary
  2. This will download and configure a stand-alone binary language server.
  3. No extra steps. Thats it!

User provided LSP

If you prefer to provide your own LSP, use the following steps. 1. Install Brew 2. Install Node.js 3. Install Docker Language Server 4. Copy/Paste the full LSP path in the Docker Suite preferences.

Docker Sidebar Dependency

Currently the Docker Sidebar requires the Docker CLI to be installed.

If you don't already, the following steps will show you how: 1. Install Brew 2. Install Docker