https://github.com/sakryukov/vscode-macroscope
VSCode Editor Macro Engine
https://github.com/sakryukov/vscode-macroscope
javascript macro rule-based rule-engine script text-editor vscode vscode-extension
Last synced: 6 months ago
JSON representation
VSCode Editor Macro Engine
- Host: GitHub
- URL: https://github.com/sakryukov/vscode-macroscope
- Owner: SAKryukov
- License: mit
- Created: 2023-12-03T21:08:15.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-26T21:40:20.000Z (9 months ago)
- Last Synced: 2025-04-26T22:25:24.132Z (9 months ago)
- Topics: javascript, macro, rule-based, rule-engine, script, text-editor, vscode, vscode-extension
- Language: JavaScript
- Homepage: https://www.SAKryukov.org
- Size: 147 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Macroscope
Macroscope, a VSCode Macro Engine, is a Visual Studio Code Extension used to create, manage, and play editor macros.
### Commands:
* Macroscope: Macro Editor
* Macroscope: Play Macro
### Features:
* Simple rule-based macro definition language
* Macro definition language is self-documented via a Macro Editor
* 56 operations, most of which are parametrized
* Macro operations can be edited manually or with a Macro Editor
* Macro script compilation with clear error diagnostics
* A last macro script persists the same way as all other persistent workspace data
* The operations `return` and `pause` help to debug a macro script
* The state of the execution is shown as the title of the Play Macro command on the status bar
* No external dependencies
### Examples:
[Available macro script samples](https://github.com/SAKryukov/vscode-macroscope/tree/main/test)
This simple script cleans the lines off trailing whitespace characters:
~~~
move end-line
move end-trimmed-line select
delete
move down
~~~
This script converts human-readable lines of text into a definition set with values, taken from these lines.
It trims off trailing whitespace characters only on the right, to include left indentation spaces in the constants:
~~~
move match-in-line-forward [ ] 1
move end-line
move end-trimmed-line select
delete
push-line
select-line
camel-case
select-line
push-line
select-line
delete
[public const string ]
pop-text
[ = "]
pop-text
[";]
move down
~~~
This macro script can be used to convert Markdown lines with references into an HTML list. It moves down through the original text if activated repeatedly. It will work even if the lines with references are interlaced with unrelated or empty lines and are indented in an arbitrary manner:
~~~
move match-in-line-forward [](] 1 select
delete
push-position
move end-trimmed-line
move backward 1 select
delete
pop-position
move end-trimmed-line select
push-selection
delete
move start-trimmed-line
move forward 1 select
delete
[
move end-trimmed-line
[
~~~
***Spoiler:*** The Markdown example is just an example. Don't do it!
Instead, use highly comprehensive [Extensible Markdown](https://marketplace.visualstudio.com/items?itemName=sakryukov.extensible-markdown).
### Installation
[Macroscope On Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=sakryukov.macroscope)