« Project bashj : a bash mutant with java support » : différence entre les versions

De Lillois Fractale Wiki
Aller à la navigation Aller à la recherche
Contenu ajouté Contenu supprimé
Aucun résumé des modifications
Aucun résumé des modifications
Ligne 63 : Ligne 63 :
*no embedded invocations of java methods 
*no embedded invocations of java methods 
*These greek characters <span style="font-size:larger;">φ&nbsp;χ&nbsp;ψ&nbsp;τ</span>&nbsp;have specific usage within bashj and may not be used in bashj sources
*These greek characters <span style="font-size:larger;">φ&nbsp;χ&nbsp;ψ&nbsp;τ</span>&nbsp;have specific usage within bashj and may not be used in bashj sources



== Installation ==
== Installation ==


Follow carefully these steps (commands in a terminal window)
Follow carefully these steps (commands in a terminal window)
<div style="background: rgb(238, 238, 238); border: 1px solid rgb(204, 204, 204); padding: 5px 10px; margin-left: 40px;"><span style="font-family:courier new,courier,monospace;">sudo&nbsp;mkdir -m=755&nbsp;/var/lib/bashj/&nbsp; &nbsp; &nbsp;# create the installation directory&nbsp;&nbsp;<br/> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; # download from&nbsp;&nbsp;sourceForge&nbsp;the bashjInstall-<version>.jar installation file&nbsp;<br/> cd&nbsp;/var/lib/bashj/&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; # go to the installation directory<br/> mv <*>/bashjInstall-<''version''>.jar . &nbsp; # move the downloaded file to this directory<br/> jar xf bashjInstall-<''version''>.jar&nbsp; &nbsp; &nbsp;# extract the content of the install jar<br/> chmod +x&nbsp;bashj bashj.wrk&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; # allow to execute bashj (and the last installation step)<br/> sudo ./bashj -install&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;# run the installation script</span></div>
<div style="background: rgb(238, 238, 238); border: 1px solid rgb(204, 204, 204); padding: 5px 10px; margin-left: 40px;"><span style="font-family:courier new,courier,monospace;">sudo&nbsp;mkdir -m=755&nbsp;/opt/bashj/&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;# create the installation directory&nbsp;&nbsp;<br/> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; # download from&nbsp;&nbsp;sourceForge&nbsp;the bashjInstall-<version>.jar installation file&nbsp;<br/> cd&nbsp;/opt/bashj/&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; # go to the installation directory<br/> mv <*>/bashjInstall-<''version''>.jar . &nbsp; # move the downloaded file to this directory<br/> jar xf bashjInstall-<''version''>.jar&nbsp; &nbsp; &nbsp;# extract the content of the install jar<br/> chmod +x&nbsp;bashj bashj.wrk&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; # allow to execute bashj (and the last installation step)<br/> sudo ./bashj -install&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;# run the installation script</span></div>
For the uninstallation:
For the uninstallation:
<div style="background: rgb(238, 238, 238); border: 1px solid rgb(204, 204, 204); padding: 5px 10px; margin-left: 40px;"><span style="font-family:courier new,courier,monospace;">cd</span>&nbsp;;&nbsp;<span style="font-family:courier new,courier,monospace;">sudo /var/lib/bashj/bashj -uninstall&nbsp;</span></div>
<div style="background: rgb(238, 238, 238); border: 1px solid rgb(204, 204, 204); padding: 5px 10px; margin-left: 40px;"><span style="font-family:courier new,courier,monospace;">cd</span>&nbsp;;&nbsp;<span style="font-family:courier new,courier,monospace;">sudo /opt/bashj/bashj -uninstall&nbsp;</span></div>

== Check, try and test ==
== Check, try and test ==



Version du 26 juin 2018 à 09:07

What ?                   

The bashj project is hosted on sourceForgebashj is an extended bash allowing to use java libraries, methods and source code from bash scripts.

The bashj code combines

  • java performance and readability
  • bash power and versatility

-> Current version 0.995 (june 2018) is still a beta release... Release 1.0 expected july 2018 !

This page is an introduction to bashj, with general notes and installation guide.

There is also a bashj programming guide page.

To bash developers, bashj brings

  • Readability in the java section (OO style coding)
  • JVM efficiency for CPU intensive components
  • modular extensibility using java packages
  • floating point (double) values variable and evaluation functions
  • Math tools
  • Swing UI tools
  • Inter process tools between multiple bash process (and java process)
  • Host registry
  • ...

Why ?

Java and bash are often partners in software projects.

Personnally I used both of them widely. Being rather lazy, I tried to minimize the number of necessary techonologies in my projects. These two covered 99% of my needs together. Java is perfect to translate concepts into software. But bash is necessary for various OS level tasks, like process control, deployment ... In fact I was frequently disappointed by the incapacity to reuse java results and expertise within scripts (this was only possible with heavy java process launching, and main() entry points). I was also frustrated by the strange and numerous coding conventions necessary to perform simple bash tasks. So I decided to set up and use this bashj tool.

Since bashj appeared to offer significant benefits, I decided to make it publicly available.

In terms of genetics, consider bashj as a bash mutant, whose genome has been loaded with wide portions of the java genome. 

Their possible interactions are numerous but limited in terms of integration.

With this project, any script is given the capacity to quickly and directly call java methods without creating new OS processes.

How ?

Bashj flows.png

A bashj server (a java background process)  communicates with bash scripts (considered as clients).

Dedicated functions are internally defined, and used from bash script clients to request server actions.

The communication uses mainly TCP connections.

This may be also be seen as a kind of bash preprocessor : bash itself is called by the bashj process.

Requirements and limitations

  • bash scripts only (version.4.*+)
  • Linux only (kernel 4.*+)
  • java JDK (9+) (JRE is not enough)
  • no interactive input (no stdin operation, like readline)
  • only public static methods (and public static fields) may be called 
  • only methods with primitive types (including String) as parameters and return value (neither array, nor collections). Varargs are supported by bashj.
  • no embedded invocations of java methods 
  • These greek characters φ χ ψ τ have specific usage within bashj and may not be used in bashj sources


Installation

Follow carefully these steps (commands in a terminal window)

sudo mkdir -m=755 /opt/bashj/         # create the installation directory  
                                      # download from  sourceForge the bashjInstall-<version>.jar installation file 
cd /opt/bashj/                        # go to the installation directory
mv <*>/bashjInstall-<version>.jar .   # move the downloaded file to this directory
jar xf bashjInstall-<version>.jar     # extract the content of the install jar
chmod +x bashj bashj.wrk              # allow to execute bashj (and the last installation step)
sudo ./bashj -install                 # run the installation script

For the uninstallation:

cd ; sudo /opt/bashj/bashj -uninstall 

Check, try and test

Various bashj scripts examples are in /var/lib/bashj/example/.Open a bash terminal window and type the following commands to discover bashj's elementary actions.

bashj -help
bashj "Math.cos(1.0)"               # check that the bashj interpreter operates
cd /var/lib/bashj/example/          # going to the example directory
ls                                  # view list of examples
cat javaLang                        # having a look at the code
./javaLang                          # running the code
cat check
./check
bashj +PP factorial                 # understanding how bashj works internally
./all                               # run all examples - shows execution speed

The same may be realized for all example scripts.

It is suggested to try, copy, adapt these examples scripts.

Configuration

No configuration is necessary.

However it is possible for the user to put various jar files under the jarlib/ directory.

All public static methods and all public static fields defined in these classes will be available in the bashj interpreter.

They should be called as indicated in the programming guide..

Annexes

Support

Please contact fil@gonze.org for support, remarks, suggestions,...

bashj interactive commands

The bashj script may be called as interpreter, or interactively for various actions. Use bashj -help to see this:

[bashj] Possible interactive command arguments are:
 -help
 -install
 -uninstall
 -status : server status
 -stop : stops the server
 -restart : restart server
 -out : show server stdOut
 -err : show server stdErr
 +classes <filter> : lists classes accessible to bashj clients
 +methods <filter> : lists methods accessible to bashj clients
 +fields  <filter> : lists fields  accessible to bashj clients
 +status : server status
 +info : server line status
 +ex <example> : run and check example bashj script
 +eval <expression> : call the double eval method
 +pp <bashj file> : preprocessor output
 +PP <bashj file> : preprocessor analysis
 +uDoc : view documentation of u methods libraries
 + <call() expression(s)> : verbosely evaluate java call(argument)
            example:  bashj + "Math.hypot(3.0,4.0)" "Math.PI" "u.classes()" 
 <simple function expression> : evaluates java call(argument)
            example:    bashj "Math.hypot(3.0,4.0)"

Installed files

The files are installed under /opt/bashj/, and include:

  • bashjInstall.jar (a jar containing all bashj required files)
  • bashj (the central script, including the command interpreter - a link is created in /usr/bin)
  • bashj.wrk (auxiliary script)
  • bashjServer.jar (a jar containing the compiled java class bashj.server.class)
  • README (a readme file - short intro to this wiki page)
  • example/ (a subdirectory with various example scripts (executable files))

Working transient files are dynamically created in /dev/shm/bashj, with the following subdirectories

  • classes/ The dynamically created java classes
  • jarlib/ (a subdirectory with the jars choosen by the user to make the involved classes available  to bashj)
  • srv/ server related data (pid, stdout, stderr)

 

Speed notes

The execution time of bashj  is excellent due to several factors:

  • TCP efficiency
  • in-memory dynamic java compiling
  • cache-based java class loading
  • JVM global efficiciency

Simple tests (on a 2018 average machine) indicate that a basic java method call requires around 1 msec. This probable depends on TCP config parameters.

The startup time for a bashj script hosting java methods is around 8 msec.

For calls involving heavy CPU load, the execution delay is exactly the same as in a direct JVM.

For the minimal "Hellow world" program, the minimal and median exexution times are roughly:

  minimum (msec) median (msec)
bash 2 6
bashj 7 11
java 72 80

Future Improvements

  • ? Create a installable package for debian distribs.
  • ? Organize the bashj server as a Linux service