Environment Variables plugin: Difference between revisions
From Code::Blocks
MortenMacFly (talk | contribs) Explain new features as of 0.9.7 |
Bluehazzard (talk | contribs) Add scripting documentation |
||
| (6 intermediate revisions by 3 users not shown) | |||
| Line 2: | Line 2: | ||
{{Infobox_Plugin| | {{Infobox_Plugin| | ||
name = Environment Variables Editor | | name = Environment Variables Editor | | ||
logo = [[ | logo = [[File:Envvars.png]] | | ||
developer = [[User:MortenMacFly|MortenMacFly]] | | developer = [[User:MortenMacFly|MortenMacFly]] | | ||
maintainer = MortenMacFly | | maintainer = MortenMacFly | | ||
| Line 8: | Line 8: | ||
}} | }} | ||
'''Environment variables editor''' plugin allows setting environment variables in the focus of Code::Blocks. A user can have several sets that contain 1..n environment variables. A user can switch between these sets within the environment variables configuration dialog. In addition the | '''Environment variables editor''' plugin allows for the setting of system environment variables in the focus of Code::Blocks. A user can have several sets that contain 1..n environment variables. A user can switch between these sets within the environment variables configuration dialog. In addition the EnvVars plugin offers an option to projects (within project setup) to apply a certain EnvVar set to activate (and use during compilation). | ||
The dialog for editing the sets is located in Settings->Environment->Environment variables.<br/> | |||
The dialog for choosing the active set for the current project is located in Project->Properties->EnvVar options. | |||
==Script binding== | |||
This plugin provides its functionality through a squirrel binding: | |||
{| border="1" cellpadding="3" cellspacing="0" style="border: 1px solid gray; border-collapse: collapse;" | |||
|- style="background: #ececec; border: 0px solid gray" | |||
!Return value | |||
!Name | |||
!Arguments | |||
!Remarks | |||
|- | |||
|- | |||
| wxArrayString|| EnvvarGetEnvvarSetNames|| || Returns all envvars sets available | |||
|- | |||
|- | |||
| wxString|| EnvvarGetActiveSetName|| || Returns the name of the currently active set (from config, /active_set) | |||
|- | |||
|- | |||
| wxArrayString|| EnvVarGetEnvvarsBySetPath|| const wxString set_name || Returns the envvars of an envvars set path in the config | |||
|- | |||
|- | |||
| bool|| EnvvarSetExists|| const wxString set_name || Verifies if an envvars set really exists in the config | |||
|- | |||
|- | |||
| bool|| EnvvarSetApply|| const wxString& set_name, bool even_if_active || Applies a specific envvar set from the config (without UI interaction) | |||
|- | |||
|- | |||
| void || EnvvarSetDiscard|| const wxString || Discards a specific envvar set from the config (without UI interaction) | |||
|- | |||
|- | |||
| bool|| EnvvarApply|| const wxString key, const wxString value|| Applies a specific envvar | |||
|- | |||
|- | |||
| bool|| EnvvarDiscard|| const wxString key|| Discards an envvar | |||
|- | |||
|} | |||
'''NOTE:''' The value arguments are automatically expanded from macros. You do not have to call <code>ReplaceMacros()</code> on them | |||
=== Example === | |||
On windows in the post or pre build steps: | |||
<source lang="c"> | |||
[[EnvvarApply(_("test"),_("testValue"));]] | |||
echo %test% | |||
</source> | |||
==See also== | |||
* [[Code::Blocks variable types synthesis]] | |||
Latest revision as of 20:06, 16 September 2019
Environment Variables Editor
| Developer(s): | MortenMacFly |
| Maintainer(s): | MortenMacFly |
| Version: | 0.97 |
Environment variables editor plugin allows for the setting of system environment variables in the focus of Code::Blocks. A user can have several sets that contain 1..n environment variables. A user can switch between these sets within the environment variables configuration dialog. In addition the EnvVars plugin offers an option to projects (within project setup) to apply a certain EnvVar set to activate (and use during compilation).
The dialog for editing the sets is located in Settings->Environment->Environment variables.
The dialog for choosing the active set for the current project is located in Project->Properties->EnvVar options.
Script binding
This plugin provides its functionality through a squirrel binding:
| Return value | Name | Arguments | Remarks |
|---|---|---|---|
| wxArrayString | EnvvarGetEnvvarSetNames | Returns all envvars sets available | |
| wxString | EnvvarGetActiveSetName | Returns the name of the currently active set (from config, /active_set) | |
| wxArrayString | EnvVarGetEnvvarsBySetPath | const wxString set_name | Returns the envvars of an envvars set path in the config |
| bool | EnvvarSetExists | const wxString set_name | Verifies if an envvars set really exists in the config |
| bool | EnvvarSetApply | const wxString& set_name, bool even_if_active | Applies a specific envvar set from the config (without UI interaction) |
| void | EnvvarSetDiscard | const wxString | Discards a specific envvar set from the config (without UI interaction) |
| bool | EnvvarApply | const wxString key, const wxString value | Applies a specific envvar |
| bool | EnvvarDiscard | const wxString key | Discards an envvar |
NOTE: The value arguments are automatically expanded from macros. You do not have to call ReplaceMacros() on them
Example
On windows in the post or pre build steps:
[[EnvvarApply(_("test"),_("testValue"));]]
echo %test%
