sf-afmt 0.7.1

An Salesforce Apex lang formatter
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

# Config afmt in VSCode

At the moment there is no dedicated plugin in VSCode for `afmt`, but we can
usage the built-in `tasks` feature to invoke `afmt` from VSCode.

VSCode supports running tasks via `tasks.json`, which allows running shell commands on files.

To configure VSCode to run `afmt` against the currently opened file, follow these steps:

## Define a Custom Task

1. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P on Mac).
1. Search for and select "Tasks: Configure Task".
1. Choose "Create tasks.json file from template".
1. Select "Others".

## Add the Task Configuration

In the tasks.json file, use this content below.
Make sure the "command" section points to your `afmt` binary.

```
{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Run afmt on current file",
            "type": "shell",
            "command": "~/afmt -w ${file}", // assume afmt binary is on the ~ path
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "presentation": {
                "echo": true,           // Echo the command
                "reveal": "never",      // Do not show the terminal
                "focus": false,         // Do not focus on the terminal
                "panel": "dedicated",   // Use a dedicated terminal (optional)
                "clear": false          // Do not clear the terminal before execution
            },
            "background": true,         // Marks the task as running in the background
            "problemMatcher": [],
            "detail": "Runs afmt against the currently opened file"
        }
    ]
}
```

## Run the Task

1. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P on Mac).
2. Search for "Tasks: Run Task".
3. Select "Run afmt on current file" (i.e. the name of the custom task you defined above).
4. You should see that `afmt` formats the Apex file.
5. If nothing happens, open a terminal and run the same to diagonize, such as run: `> ~/afmt -w path/to/valid_apex_file.cls`

## Assign a Keybinding (Optional)

If you want to quickly trigger the task with a shortcut:

1. Open the Command Palette and search for "Preferences: Open Keyboard Shortcuts".
2. Search for `workbench.action.tasks.runTask`.
3. Add a custom keybinding in `keybindings.json`:

```
{
    "key": "ctrl+alt+r", // Choose your preferred shortcut
    "command": "workbench.action.tasks.runTask",
    "args": "Run afmt on current file"
}
```