Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/asmaloney/gactar-vscode
VS Code plugin for gactar
https://github.com/asmaloney/gactar-vscode
hacktoberfest syntax-highlighting vscode-extension vscode-snippets
Last synced: about 2 months ago
JSON representation
VS Code plugin for gactar
- Host: GitHub
- URL: https://github.com/asmaloney/gactar-vscode
- Owner: asmaloney
- License: mit
- Created: 2022-05-17T20:39:06.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-01-23T16:11:44.000Z (12 months ago)
- Last Synced: 2024-05-01T21:03:20.588Z (8 months ago)
- Topics: hacktoberfest, syntax-highlighting, vscode-extension, vscode-snippets
- Language: TypeScript
- Homepage:
- Size: 757 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://marketplace.visualstudio.com/items?itemName=asmaloney.gactar) [](LICENSE)
#  gactar-vscode
_gactar-vscode_ is a plugin for VS Code for working with [gactar](https://github.com/asmaloney/gactar)'s [amod files](https://github.com/asmaloney/gactar#gactar-models).
It implements syntax highlighting, provides snippets to quickly create an amod file or add productions, and allows you to run gactar directly through VS Code.
In order to run amod files, gactar needs to be [installed](https://github.com/asmaloney/gactar#installation) and you will need to add the path to the installation in your VS Code gactar settings (see "Installation Folder" in the [Configuration section](#configuration) below).
## Features
### Syntax highlighting
Provides syntax highlighting for .amod files.
### Snippets
Provides snippets when editing amod files:
- Typing _amod_ will show a snippet to **Insert basic amod template (full file)**. This will fill in a complete, empty amod file.
- Type _prod_ will show a snippet to **Insert blank amod Production**. This will add an empty production like this:
```
{
description: ''
match {
goal []
}
do {
}
}
```
#### All Available Snippets
| Prefix | Name |
| ------ | -------------------------------------- |
| amod | Insert basic amod template (full file) |
| ~~m | Insert amod model section |
| ~~c | Insert amod config section |
| ~~i | Insert amod init section |
| ~~p | Insert amod productions section |
| prod | Insert blank amod Production |
### Run Code Through gactar
If you have gactar installed, you can point VS Code at your installation and run your amod files through gactar from VS Code. You can access the command through VS Code's [Command Palette](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette):
If an example is selected in the editor, it will be used as the initial goal.
The results will show up in VSCode's Output Panel.
### Restart The Server
If you need to restart the gactar server, you can run the command `gactar: Restart Server`.
### Highlight Problems
After running amod files, any errors will be reported in the Problems Panel and they will be highlighted in the code.
## Configuration
You can set your configuration using the VS Code Settings window:
Or you can set them directly in your `settings.json` file:
- `"gactar.installationFolder"` (required to run gactar) - Path to your gactar installation (folder containing the gactar executable).
- `"gactar.framework"` - Which framework to run. Allowed: `ccm`, `pyactr`, `vanilla`, or `all`.
- `"gactar.intermediateFolder"` - Path to store intermediate files (the generated code for each framework) when running models. If empty, it will create a folder called 'gactar-temp' in your gactar installation.
## gactar Reference
I wrote up a technical note about [gactar](https://github.com/asmaloney/gactar) which includes more information about the amod format. It may be found on [ResearchGate](https://www.researchgate.net/).
**Title:** gactar: A Tool For Exploring ACT-R Modelling
**DOI:** [10.13140/RG.2.2.25387.36642](https://dx.doi.org/10.13140/RG.2.2.25387.36642)