FAQ - de-jcup/eclipse-bash-editor GitHub Wiki

How can I use the debugger?

Please see Debugger

I have got problems to launch my script with debugger

Please see Debugger trouble shooting

I am using an older eclipse version and some features are not working

Bash editor can be at least started with Eclipse >= NEON (4.6) but maybe some features (e.g. hyperlinking across files) will not work. Sometimes we have to use new features to get things working - sorry. So: Please try to use always the newest eclipse version…​ Normally you can always download a new eclipse package from https://www.eclipse.org/downloads/packages/ and just unpack it - no installation needed, just a JRE must be available.

How to apply default dark theme colours?

Please go to Window→Preferences→Bash Editor→Syntax coloring and klick on Button "Restore Defaults for Dark Theme" and then "Apply and close" (or "OK" on eclipse older than oxygen)

Syntax color preferences

Do I need cygwin etc. on windows?

No. The editor has not such dependencies.

Why is bash editor not automatically associated with other script file types?

It seems it’s possible to edit fish shell scripts (see https://github.com/de-jcup/eclipse-bash-editor/issues/85) also with bash editor. But the bash editor is for bash scripts designed. If it works with other shell script languages too this is very nice, but those script languages will not be official supported. The bash editor is written for bash scripts.

Anyway, if you want to associate other script files with bash editor you can do this the standard way, by Window→Preferences→"file"→Add→*.fish as shown in next picture:

Create new file association

Then add associated editor:

Associate with bash editor

How can I execute shell scripts with bash editor?

This was implemented with https://github.com/de-jcup/eclipse-bash-editor/issues/174 (please look into issue for more details). Next picture show how to launch bash scripts. If you want to customize execution commands you can do this is in debugger configuration.

run as bash script

Will create a launch configuration which can be modified

bash script launchconfiguration

How can I install bash editor automated?

On a linux docker image you can easily install the plugin automatically by using p2 director with following command:

/opt/eclipse/eclipse -application org.eclipse.equinox.p2.director -noSplash -repository 'https://dl.bintray.com/de-jcup/basheditor' -installIU 'de.jcup.basheditor'

see https://github.com/de-jcup/eclipse-bash-editor/issues/99

How can I install bash editor offline?

Normally the Eclipse Marketplace should be the preferred way to install. But if absolutely necessary, you can use a local update site. An example zip file of an update site for bash editor in version 1.5.3 is available at https://github.com/de-jcup/eclipse-bash-editor/issues/110. It’s designed as a template and also describes howto install the plugin by the local site and also how to setup/integrate newer bash editor versions into the template.

Newer files can be directly downloaded from https://bintray.com/de-jcup/basheditor/update-site/ - just click at your wanted version and then inspect files.

Install fails with "Unable to read repository at …​"

The plugin update site is hosted at https://bintray.com which is a very wellknown provider - e.g. complete JCenter repository is also located here. The certificates are directly maintained by JFrog and should always be valid - otherwise many maven and npm repositories would have big problems…​

So output messages containing error messages with PKIX path or trustanchor normally have their problem in usage of an JRE were certificate store is too old - or you are a victim of security attack (man in the middle). Details and suggestions how to fix (when no security attack…​) can be found inside https://github.com/de-jcup/eclipse-bash-editor/issues/147

Some examples:

Unable to read repository at https://dl.bintray.com/de-jcup/basheditor/content.xml.
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
Unable to read repository at https://dl.bintray.com/de-jcup/basheditor/content.xml.
Unexpected error: java.security.InvalidAlgorithmParameterException: the trustAnchors parameter must be non-empty"

How can I auto format my bash scripts?

There is no auto formatter implemented inside the plugin itself, but you can use external formatting tools for safe actions. For example: You could use beautysh which is already configured as a default in preferences (but not enabled).

preference dialog for save actions with beatysh as default command

Just enable the checkbox, install beautysh (or use another formatter tool) and your code will be automatically formatted on each file safe.

How can I get more information about problems?

If you want to create an issue for the plugin it’s recommended to add error log information. Please follow the next steps to obtain more information:

Check eclipse error view

Please do Window→Show View→Other…​ and enter error inside upcoming dialog:

select eclipse error log view

Select the error log view and search inside the log view for problems with Bash Editor plugin (e.g. it cannot start because of some problems etc).

If there were errors inside opened logview: Please copy the stacktrace and paste it to this issue

Describe your System

Please open Help→ About Eclipse IDE again and select the tab Configuration.

describe

Select `Copy to clipboard`and attach the information to this issue

Check eclipse log

⚠️ **GitHub.com Fallback** ⚠️