Skip to content

Commit

Permalink
Updated README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
BeardyKing committed Dec 3, 2023
1 parent c39fe91 commit 28ec8c8
Show file tree
Hide file tree
Showing 2 changed files with 36 additions and 27 deletions.
63 changes: 36 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,44 +1,53 @@
# better_command_line_args
# Better command line arguments *(CLion Plugin)*

![Build](https://github.com/BeardyKing/better_command_line_args/workflows/Build/badge.svg)
[![Version](https://img.shields.io/jetbrains/plugin/v/PLUGIN_ID.svg)](https://plugins.jetbrains.com/plugin/PLUGIN_ID)
[![Downloads](https://img.shields.io/jetbrains/plugin/d/PLUGIN_ID.svg)](https://plugins.jetbrains.com/plugin/PLUGIN_ID)

## Template ToDo list
- [x] Create a new [IntelliJ Platform Plugin Template][template] project.
- [ ] Get familiar with the [template documentation][template].
- [ ] Adjust the [pluginGroup](./gradle.properties), [plugin ID](./src/main/resources/META-INF/plugin.xml) and [sources package](./src/main/kotlin).
- [ ] Adjust the plugin description in `README` (see [Tips][docs:plugin-description])
- [ ] Review the [Legal Agreements](https://plugins.jetbrains.com/docs/marketplace/legal-agreements.html?from=IJPluginTemplate).
- [ ] [Publish a plugin manually](https://plugins.jetbrains.com/docs/intellij/publishing-plugin.html?from=IJPluginTemplate) for the first time.
- [ ] Set the `PLUGIN_ID` in the above README badges.
- [ ] Set the [Plugin Signing](https://plugins.jetbrains.com/docs/intellij/plugin-signing.html?from=IJPluginTemplate) related [secrets](https://github.com/JetBrains/intellij-platform-plugin-template#environment-variables).
- [ ] Set the [Deployment Token](https://plugins.jetbrains.com/docs/marketplace/plugin-upload.html?from=IJPluginTemplate).
- [ ] Click the <kbd>Watch</kbd> button on the top of the [IntelliJ Platform Plugin Template][template] to be notified about releases containing new features and fixes.
### Info:
Better command line arguments is a small plugin that manages CLion "program arguments" as a tree structures, This plugin is highly inspired by the Visual Studio plugin [SmartCommandlineArgs](https://github.com/MBulli/SmartCommandlineArgs)

<!-- Plugin description -->
This Fancy IntelliJ Platform Plugin is going to be your implementation of the brilliant ideas that you have.
### Warning:
This plugin will write raw command line text to `workspace.xml` which is used by CLion to manage Configurations, be sure to validate that your `.idea` folder is ignored from public repositories.

This specific section is a source for the [plugin.xml](/src/main/resources/META-INF/plugin.xml) file which will be extracted by the [Gradle](/build.gradle.kts) during the build process.
The `CLArgs.json` file saves your current CLArg tree, but doesn't doesn't store raw environment variables data, instead it stores the environment variable name i.e. `<OS>` this could potentially resolve to `Windows_NT` and can be viewed in the command line argument preview at the bottom of the plugin.

### Preview:
![res/clarg_tree_screenshot.png](example CLArg tree)

### Roadmap:
Better command line arguments in its current form are presented in a state of a minimal viable plugin. I've written this plugin to match a simple workflow that I use on a daily basis. This plugin doesn't match all the features the visual studio plugin has but maybe in the future, I have provided a list of various features that this plugin would benefit from having.

If there are any features you would like feel free to open a pull request.

- [ ] Rebindable shortcuts
- [ ] View CLion program argument macros in CL Vars tab
- [ ] Toggle hide environment variable preview
- [ ] Folder conditions ( *i.e. toggles based on config settings* )
- [ ] Undo/Redo last action

#### Shortcuts:

| keybind | use |
| ------------ | --------------------------------------------------------- |
| "Insert" | Add CLArg to current selected folder |
| "Delete" | Remove all currently selected CLArgs |
| "Home" | Add all currently selected CLArgs to new Folder |
| "Space" | Toggle all currently selected CLArgs on/off |
| "Alt + Up" | Move all currently selected CLArgs up in current folder |
| "Alt + Down" | Move all currently selected CLArgs down in current folder |
| "Ctrl + R" | Manually parse CLArgs and save to workspace.xml |
| "Ctrl + V" | Add CLArg with text from the clipboard in current folder |

To keep everything working, do not remove `<!-- ... -->` sections.
<!-- Plugin description end -->

## Installation

- Using the IDE built-in plugin system:
<kbd>Settings/Preferences</kbd> > <kbd>Plugins</kbd> > <kbd>Marketplace</kbd> > <kbd>Search for "better_command_line_args"</kbd> >

<kbd>Settings/Preferences</kbd> > <kbd>Plugins</kbd> > <kbd>Marketplace</kbd> > <kbd>Search for "Better command line arguments"</kbd> >
<kbd>Install</kbd>

- Manually:

Download the [latest release](https://github.com/BeardyKing/better_command_line_args/releases/latest) and install it manually using
<kbd>Settings/Preferences</kbd> > <kbd>Plugins</kbd> > <kbd>⚙️</kbd> > <kbd>Install plugin from disk...</kbd>


---
Plugin based on the [IntelliJ Platform Plugin Template][template].

[template]: https://github.com/JetBrains/intellij-platform-plugin-template
[docs:plugin-description]: https://plugins.jetbrains.com/docs/intellij/plugin-user-experience.html#plugin-description-and-presentation
Binary file added res/clarg_tree_screenshot.png.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 28ec8c8

Please sign in to comment.