Skip to content
This repository has been archived by the owner on Mar 6, 2023. It is now read-only.
/ intellij-hcl Public archive

HCL language support for IntelliJ platform based IDEs

License

Notifications You must be signed in to change notification settings

VladRassokhin/intellij-hcl

Repository files navigation

DEPRECATION NOTICE

This project contains the original source code of the intellij-hcl plugin. The code in this repository is kept static and can be used for historical reference only: no pull requests will be accepted.

Please create new issues (feature requests and bug reports) in IntelliJ IDEA tracker.

New sources can be found in JetBrains/intellij-plugins repository under terraform directory.

You can still download the new versions of the free plugin from JetBrains from the JetBrains plugin repository.

IntelliJ-HCL plugin

Provides HCL language and Terraform configuration files (.tf) support for IntelliJ Platform-based IDEs

The HCL format is used for Nomad(.nomad files).

Plugin page in IntelliJ platform plugin repository.

Note from Plugin Author

I'd been developing this plugin for four years in my free time before last year, when it became obvious that due to lack of free time I could not keep up with the newest Terraform features.

Meanwhile, IaaC and especially Terraform is becoming more and more popular, so I decided to transfer the plugin ownership to JetBrains. I believe that JetBrains has the resources to improve the plugin over time and provide efficient user support.

I'd like to thank all users, contributors, people who spotted and reported bugs, and everyone who promoted the plugin all those years.

As part of the transition, the source code was moved to the main IntelliJ repository which is private. The JetBrains plugin is free. The main plugin features will be compatible with JetBrains' free IDEs ([IntelliJ IDEA, PyCharm]x[Community, Education] Editions) as well as Google's Android Studio. Note that the main features include but are not limited to the features below.

Features:

For both .hcl and .tf file formats:
  • Syntax highlighting
  • Structure outline in the 'Structure' tool window
  • Code formatter with the 'Reformat code' action available
  • Code folding
  • Comment/Uncomment action

Terraform configs (.tf) files

  • Interpolations syntax highlighting
  • (WIP) Properties validation (according to the properties required for resource/provider, type checking)
  • (WIP) Go to definition from resource to provider

Terraform configs Interpolation Language

  • Syntax highlighting
  • Autocompletion for predefined methods
  • (WIP) Go to declaration on resources, providers, properties, etc.

Planned features:

Terraform configs (.tf) files

  • Find usages for resources, providers, variables

Terraform configs Interpolation Language

Terraform External Metadata

Starting from version 0.6.14 it's possible to use external source of Terraform model. Previously plugins updates were necessary once something was updated in Terraform itself or providers.

Plugin reads metadata from specially-formatted json files located at (in order):

  • TERRAFORM_GLOBAL_DIR/schemas (intended for schemas for your custom providers/provisioners) and
  • TERRAFORM_GLOBAL_DIR/metadata-repo/terraform/model (semi-automatically updated schemas) and
  • Plugin itself

Here TERRAFORM_GLOBAL_DIR stands for $HOME/.terraform.d on Linux/macOS and %APPDATA%/terraform.d on Windows.

ℹ️ Recommended approach is to clone special repo as TERRAFORM_GLOBAL_DIR/metadata-repo and later update it from time to time.

⚠️ As of plugin version 0.6.14 IntelliJ restart is required once metadata is updated on disk

Linux/macOS user may use commands like:

# To initial clone
mkdir -p "$HOME/.terraform.d/"
git clone https://github.com/VladRassokhin/terraform-metadata "$HOME/.terraform.d/metadata-repo"

# To update metadata
git -C "$HOME/.terraform.d/metadata-repo" pull
# Don't forget to restart IntelliJ after that