Updating experimantal feature branch

.editorconfig

@@ -8,7 +8,7 @@ end_of_line = LF
 
 [*]
 indent_style = space
-indent_size = 2
+indent_size = 4
 trim_trailing_whitespace = true
 insert_final_newline = true
 max_line_length = 80

.git-blame-ignore-revs

@@ -0,0 +1,2 @@
+# Apply erlfmt to the entire codebase (#1297)
+c19fb7239ef6766aa7e583d1c010ac38588a3de3

.github/workflows/build.yml

@@ -12,7 +12,7 @@ jobs:
     strategy:
       matrix:
         platform: [ubuntu-latest]
-        otp-version: [21, 22, 23, 24]
+        otp-version: [24, 25, 26, 27]
     runs-on: ${{ matrix.platform }}
     container:
       image: erlang:${{ matrix.otp-version }}
@@ -37,31 +37,28 @@ jobs:
       run: rebar3 compile
     - name: Escriptize LSP Server
       run: rebar3 escriptize
-    - name: Store LSP Server Escript
-      uses: actions/upload-artifact@v2
-      with:
-        name: erlang_ls
-        path: _build/default/bin/erlang_ls
-    - name: Escriptize DAP Server
-      run: rebar3 as dap escriptize
-    - name: Store DAP Server Escript
-      uses: actions/upload-artifact@v2
-      with:
-        name: els_dap
-        path: _build/dap/bin/els_dap
+    # - name: Store LSP Server Escript
+    #   uses: actions/upload-artifact@v4
+    #   with:
+    #     name: erlang_ls
+    #     path: _build/default/bin/erlang_ls
+    #     overwrite: true
+    - name: Check formatting
+      run: rebar3 fmt -c
     - name: Lint
       run: rebar3 lint
     - name: Generate Dialyzer PLT for usage in CT Tests
-      run: dialyzer --build_plt --apps erts kernel stdlib
+      run: dialyzer --build_plt --apps erts kernel stdlib compiler crypto parsetools
     - name: Start epmd as daemon
       run: epmd -daemon
     - name: Run CT Tests
       run: rebar3 ct
-    - name: Store CT Logs
-      uses: actions/upload-artifact@v2
-      with:
-        name: ct-logs
-        path: _build/test/logs
+    # - name: Store CT Logs
+    #   uses: actions/upload-artifact@v4
+    #   with:
+    #     name: ct-logs
+    #     path: _build/test/logs
+    #     overwrite: true
     - name: Run PropEr Tests
       run: rebar3 proper --cover --constraint_tries 100
     - name: Run Checks
@@ -70,43 +67,71 @@ jobs:
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       run: rebar3 do cover, coveralls send
-    - name: Produce Documentation
-      run: rebar3 edoc
-    - name: Publish Documentation
-      uses: actions/upload-artifact@v2
-      with:
-        name: edoc
-        path: |
-          apps/els_core/doc
-          apps/els_lsp/doc
-          apps/els_dap/doc
+      if: matrix.otp-version == '27'
+    # - name: Produce Documentation
+    #   run: rebar3 edoc
+    #   if: ${{ matrix.otp-version == '24' }}
+    # - name: Publish Documentation
+    #   uses: actions/upload-artifact@v4
+    #   with:
+    #     name: edoc
+    #     path: |
+    #       apps/els_core/doc
+    #       apps/els_lsp/doc
+    #     overwrite: true
   windows:
-    runs-on: windows-latest
+    strategy:
+      matrix:
+        platform: [windows-latest]
+        otp-version: [26.2.5.3]
+    runs-on: ${{ matrix.platform }}
     steps:
     - name: Checkout
       uses: actions/checkout@v2
     - name: Install Erlang
-      run: choco install -y erlang --version 22.3
+      run: choco install -y erlang --version ${{ matrix.otp-version }}
     - name: Install rebar3
-      run: choco install -y rebar3 --version 3.13.1
+      run: choco install -y rebar3 --version 3.23.0
     - name: Compile
       run: rebar3 compile
     - name: Lint
       run: rebar3 lint
     - name: Generate Dialyzer PLT for usage in CT Tests
-      run: dialyzer --build_plt --apps erts kernel stdlib
+      run: dialyzer --build_plt --apps erts kernel stdlib crypto compiler parsetools
     - name: Start epmd as daemon
       run: erl -sname a -noinput -eval "halt(0)."
     - name: Run CT Tests
       run: rebar3 ct
-    - name: Store CT Logs
-      uses: actions/upload-artifact@v2
-      with:
-        name: ct-logs
-        path: _build/test/logs
+    # - name: Store CT Logs
+    #   uses: actions/upload-artifact@v4
+    #   with:
+    #     name: ct-logs
+    #     path: _build/test/logs
+    #     overwrite: true
     - name: Run PropEr Tests
       run: rebar3 proper --cover --constraint_tries 100
     - name: Run Checks
       run: rebar3 do dialyzer, xref
     - name: Produce Documentation
       run: rebar3 edoc
+  macos:
+    # Smaller job for MacOS to avoid excessive billing
+    strategy:
+      matrix:
+        platform: [macos-latest]
+        otp-version: [27]
+    runs-on: ${{ matrix.platform }}
+    steps:
+    - uses: actions/checkout@v2
+    - name: Install Erlang
+      run: brew install erlang@${{ matrix.otp-version }}
+    - name: Install Rebar3
+      run: brew install rebar3
+    - name: Compile
+      run: rebar3 compile
+    - name: Generate Dialyzer PLT for usage in CT Tests
+      run: dialyzer --build_plt --apps erts kernel stdlib compiler crypto parsetools
+    - name: Start epmd as daemon
+      run: epmd -daemon
+    - name: Run CT Tests
+      run: rebar3 ct

.github/workflows/release.yml

@@ -0,0 +1,197 @@
+name: Release
+on:
+  release:
+    types:
+      - created
+
+# Test trigger. Uncomment to test basic flow.
+#   NOTE: it will fail on trying to get the release url
+# on:
+#   push:
+#     branches:
+#       - '*'
+
+jobs:
+  linux:
+    strategy:
+      matrix:
+        platform: [ubuntu-latest]
+        otp-version: [24, 25, 26, 27]
+    runs-on: ${{ matrix.platform }}
+    container:
+      image: erlang:${{ matrix.otp-version }}
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+    - name: Cache Hex packages
+      uses: actions/cache@v1
+      with:
+        path: ~/.cache/rebar3/hex/hexpm/packages
+        key: ${{ runner.os }}-hex-${{ hashFiles(format('{0}{1}', github.workspace, '/rebar.lock')) }}
+        restore-keys: |
+          ${{ runner.os }}-hex-
+    - name: Cache Dialyzer PLTs
+      uses: actions/cache@v1
+      with:
+        path: ~/.cache/rebar3/rebar3_*_plt
+        key: ${{ runner.os }}-dialyzer-${{ hashFiles(format('{0}{1}', github.workspace, '/rebar.config')) }}
+        restore-keys: |
+          ${{ runner.os }}-dialyzer-
+    - name: Compile
+      run: rebar3 compile
+    - name: Escriptize LSP Server
+      run: rebar3 escriptize
+    # - name: Store LSP Server Escript
+    #   uses: actions/upload-artifact@v4
+    #   with:
+    #     name: erlang_ls
+    #     path: _build/default/bin/erlang_ls
+    #     overwrite: true
+    - name: Check formatting
+      run: rebar3 fmt -c
+    - name: Lint
+      run: rebar3 lint
+    - name: Generate Dialyzer PLT for usage in CT Tests
+      run: dialyzer --build_plt --apps erts kernel stdlib crypto compiler parsetools
+    - name: Start epmd as daemon
+      run: epmd -daemon
+    - name: Run CT Tests
+      run: rebar3 ct
+    # - name: Store CT Logs
+    #   uses: actions/upload-artifact@v4
+    #   with:
+    #     name: ct-logs
+    #     path: _build/test/logs
+    #     overwrite: true
+    - name: Run PropEr Tests
+      run: rebar3 proper --cover --constraint_tries 100
+    - name: Run Checks
+      run: rebar3 do dialyzer, xref
+    - name: Create Cover Reports
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: rebar3 do cover, coveralls send
+    - name: Produce Documentation
+      run: rebar3 edoc
+      if: ${{ matrix.otp-version == '24' }}
+    # - name: Publish Documentation
+    #   uses: actions/upload-artifact@v4
+    #   with:
+    #     name: edoc
+    #     path: |
+    #       apps/els_core/doc
+    #       apps/els_lsp/doc
+    #     overwrite: true
+
+    # Make release artifacts : erlang_ls
+    - name: Make erlang_ls-linux-${{ matrix.otp-version }}.tar.gz
+      run: 'tar -zcvf erlang_ls-linux-${{ matrix.otp-version }}.tar.gz -C _build/default/bin/ erlang_ls'
+    - env:
+        GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
+      id: get_release_url
+      name: Get release url
+      uses: "bruceadams/get-release@v1.3.2"
+    - env:
+        GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
+      name: Upload release erlang_ls-linux-${{ matrix.otp-version }}.tar.gz
+      uses: "actions/upload-release-asset@v1.0.2"
+      with:
+        asset_content_type: application/octet-stream
+        asset_name: "erlang_ls-linux-${{ matrix.otp-version }}.tar.gz"
+        asset_path: "erlang_ls-linux-${{ matrix.otp-version }}.tar.gz"
+        upload_url: "${{ steps.get_release_url.outputs.upload_url }}"
+  windows:
+    strategy:
+      matrix:
+        platform: [windows-latest]
+        otp-version: [26.2.5.3]
+    runs-on: ${{ matrix.platform }}
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+    - name: Install Erlang
+      run: choco install -y erlang --version ${{ matrix.otp-version }}
+    - name: Install rebar3
+      run: choco install -y rebar3 --version 3.23.0
+    - name: Compile
+      run: rebar3 compile
+    - name: Escriptize LSP Server
+      run: rebar3 escriptize
+    # - name: Store LSP Server Escript
+    #   uses: actions/upload-artifact@v4
+    #   with:
+    #     name: erlang_ls
+    #     path: _build/default/bin/erlang_ls
+    #     overwrite: true
+    - name: Lint
+      run: rebar3 lint
+    - name: Generate Dialyzer PLT for usage in CT Tests
+      run: dialyzer --build_plt --apps erts kernel stdlib crypto compiler parsetools
+    - name: Start epmd as daemon
+      run: erl -sname a -noinput -eval "halt(0)."
+    - name: Run CT Tests
+      run: rebar3 ct
+    # - name: Store CT Logs
+    #   uses: actions/upload-artifact@v4
+    #   with:
+    #     name: ct-logs
+    #     path: _build/test/logs
+    #     overwrite: true
+    - name: Run PropEr Tests
+      run: rebar3 proper --cover --constraint_tries 100
+    - name: Run Checks
+      run: rebar3 do dialyzer, xref
+    - name: Produce Documentation
+      run: rebar3 edoc
+
+    # Make release artifacts : erlang_ls
+    - name: Make erlang_ls-windows-${{ matrix.otp-version }}.tar.gz
+      run: 'tar -zcvf erlang_ls-windows-${{ matrix.otp-version }}.tar.gz -C _build/default/bin/ erlang_ls'
+    - env:
+        GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
+      id: get_release_url
+      name: Get release url
+      uses: "bruceadams/get-release@v1.3.2"
+    - env:
+        GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
+      name: Upload release erlang_ls-windows-${{ matrix.otp-version }}.tar.gz
+      uses: "actions/upload-release-asset@v1.0.2"
+      with:
+        asset_content_type: application/octet-stream
+        asset_name: erlang_ls-windows-${{ matrix.otp-version }}.tar.gz
+        asset_path: erlang_ls-windows-${{ matrix.otp-version }}.tar.gz
+        upload_url: "${{ steps.get_release_url.outputs.upload_url }}"
+  macos:
+    # Smaller job for MacOS to avoid excessive billing
+    strategy:
+      matrix:
+        platform: [macos-latest]
+        otp-version: [24, 25, 26, 27]
+    runs-on: ${{ matrix.platform }}
+    steps:
+    - uses: actions/checkout@v2
+    - name: Install Erlang
+      run: brew install erlang@${{ matrix.otp-version }}
+    - name: Install Rebar3
+      run: brew install rebar3
+    - name: Compile
+      run: rebar3 compile
+    - name: Escriptize LSP Server
+      run: rebar3 escriptize
+    # Make release artifacts : erlang_ls
+    - name: Make erlang_ls-macos-${{ matrix.otp-version }}.tar.gz
+      run: 'tar -zcvf erlang_ls-macos-${{ matrix.otp-version }}.tar.gz -C _build/default/bin/ erlang_ls'
+    - env:
+        GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
+      id: get_release_url
+      name: Get release url
+      uses: "bruceadams/get-release@v1.3.2"
+    - env:
+        GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
+      name: Upload release erlang_ls-macos-${{ matrix.otp-version }}.tar.gz
+      uses: "actions/upload-release-asset@v1.0.2"
+      with:
+        asset_content_type: application/octet-stream
+        asset_name: erlang_ls-macos-${{ matrix.otp-version }}.tar.gz
+        asset_path: erlang_ls-macos-${{ matrix.otp-version }}.tar.gz
+        upload_url: "${{ steps.get_release_url.outputs.upload_url }}"

DEVELOPERS-README.md

@@ -0,0 +1,14 @@
+# Developers README
+
+## Release Process
+
+To create a new release:
+
+* Access the [releases](https://github.com/erlang-ls/erlang_ls/releases) page
+* Click on "Draft a new release"
+* Click on the "Choose a tag" dropdown and enter a new tag (use semantic versioning)
+* Click on "Generate release notes"
+* Optionally amend the generated notes with highlights or other important information
+* Click on "Publish Release"
+
+To publish a new version of the VS Code extension, please refer to the [DEVELOPERS-README.md file in the erlang-ls/vscode repository](https://github.com/erlang-ls/vscode/blob/main/DEVELOPERS-README.md).

Makefile

@@ -1,14 +1,16 @@
 .PHONY: all
 
+PREFIX ?= '/usr/local'
+
 all:
 	@ echo "Building escript..."
 	@ rebar3 escriptize
-	@ rebar3 as dap escriptize
 
+.PHONY: install
 install: all
 	@ echo "Installing escript..."
-	@ cp _build/default/bin/erlang_ls /usr/local/bin
-	@ cp _build/dap/bin/els_dap /usr/local/bin
+	@ mkdir -p '${PREFIX}/bin'
+	@ cp _build/default/bin/erlang_ls ${PREFIX}/bin
 
 .PHONY: clean
 clean: