Environment Variables plugin: Difference between revisions

From Code::Blocks
Alpha (talk | contribs)
m Added "See also".
Add scripting documentation
 
(2 intermediate revisions by one other user not shown)
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 EnvVars plugin offers an option to projects (within project setup) to apply a certain EnvVar set to activate (and use during compilation).
'''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 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.
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==
==See also==
* [[Code::Blocks variable types synthesis]]
* [[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%

See also