Simple app to start "sbt console" or "sbt consoleQuick" (or GHCI) in different directories.
SBT is a Scala build tool,
"sbt console" or "sbt consoleQuick" starts the Scala REPL,
using additional information supplied by the SBT build system.
Windows only, but can be used with the WSL.
The app changes the Clipboard-content!
Can be used to start any programm/app in a selectable directory.
("sbt console" needs a "build.sbt"-file in the running directory
and the file "project\build.properties" with the SBT version information).
Sbt_console_select destroys the clipboard content!
- Usable, but work in progress!
Portable, run from any directory, but running from a subdirectory of the windows programm-directories
(C:\Program Files, C:\Program Files (x86) etc.)
requires admin-rights and is not recommended!
Via Updater (preferred method):
Download Updater from Github to the previously created directory:
updater.exe 64bit
or
updater.exe 32bit
Viruscheck see Updater repository
or single files:
64 bit:
sbt_console_select.exe
or
32 bit:
sbt_console_select32.exe
and:
sbt_console_select.ini
sbt_console_select.txt
sbt_console_select_shortcuts.txt
- sbt_console_select.exe runs in the background after start! Use the hotkey [ALT] + [t] to show the app-window
- SBT should be be installed to use it.
- The *.default-files are used by the Updater.
- Make sure that the names in the Command-file are exclusive, i.e. no other open window has it as a title not even as a part of it's title!
Names should NOT contain spaces! (Using the Rest-API names are part of an url and spaces must be replaced by "%20" then!) - Default Installation-directory that is suggested by "Updater" is "C:\jvrde\sbt_console_select",
but any writable directory can be used.
| Version (>=) | Change |
|---|---|
| 0.233 | Changed the way the console title is set |
| 0.232 | Changed the temporary filenames to "replPart1.hs" / "replPart2.hs" (to be usable with GHCI) |
| 0.230 | A32 version removed |
| 0.229 | Title of WSL tabs |
| 0.228 | replcommandsHotkey removed, replaced by auto load |
| 0.228 | "[replcommands]"-section replaced by the simple CSV value "config" - > "replcommands=:reset, etc. ..." |
| 0.225 | Please delete your "sbt_console_select.ini"-file, a new one (modified) will be created |
| 0.220 | Bugfixes, open cmd-window mechanism changed |
| 0.219 | Bugfixes: open/close with curl |
| 0.218 | "// useImports=FILENAME" changed to: "/** useImports=FILENAME */" [importsFileName= and useImports= removed!] |
| 0.217 | Given some extra time to close an already open shell-window |
| 0.216 | importsFileName=FILENAME changed to useImports=FILENAME |
| 0.215 | imports mechanism changed |
| 0.214 | WSL support enhanced |
| 0.211 | "switch back to editor" is set to [CTRL]-key again, not using the [ALT]-key anymore |
*1) send to console after "title", example: additionalCommand=chcp 65001
| Issue / Bug | Type | fixed in version |
|---|---|---|
| Soft ":reset" does not reenable imports (--load imports--) | bug | 0.200 |
| Ctrl + E copies old contents | bug | 0.179 |
| Blanks in entry-names not allowed | issue | 0.167 |
- Start sbt_console_select by a doubleclick onto the file "sbt_console_select.exe".
or - drag the "sbt_console_select.exe" to the taskbar.
or - create a shortcut of "sbt_console_select.exe" in the windows-autostart folder ("shell:startup")
and add "hidewindow" as a parameter.
Two powershell scripts included:
"create_sbt_console_select_exe_link_hidewindow_in_autostartfolder.bat" or
to be used with the project startdelayed:
"create_sbt_console_select_exe_link_hidewindow.bat"
or manually:
-> "sbt_console_select - Shortcut.lnk" -> rightclick -> properties -> target -> add "hidewindow" as a parameter,
(and optional the Command-file and Config-file path),
then start with the hotkey.
Click an entry in the list to start the command as defined in the Command-file: "sbt_console_select.txt".
Overview of all default Hotkeys used by my Autohotkey "tools"
The default Config-file is: "sbt_console_select.ini".
Hotkeys are defined in the "[config]"-section of the Config-file:
- menuhotkey: [ALT] + [t] -> open menu,
- exitHotkey: [SHIFT] + [ALT] + [t] -> sends [CTRL] + [d] and "exit",
Hotkeys to be used in a text-editor:
-
replLoadHotkey: [ALT] + [e]
execute the code (as part 1) of the editor-page in the SBT-console-REPL. -
replLoadSelectedHotkey: [CTRL] + [e]
execute the seleted part of the code (as part 1) from the editor-page in the SBT-console-REPL. -
replSelectLoadPart2Hotkey: [SHIFT] + [ALT] + [e]
save the code as code part 2 or delete it (if nothing is seleted).
- [CTRL] -> open filemanager,
Start a sbt-console window by selecting an entry.
Then open your text-editor with the code to execute in the SBT-console-REPL.
Press the replLoadHotkey, the code is executed in the SBT-console-REPL.
Press the [CTRL]-key to switch back to your editor.
Holding down the [CTRL]-key other commands can be emitted first, i.e. killing the REPL ([CTRL] + [c]), copy text etc., auto-switching back afterwards.
If your code execution needs two parts (if using a companion object),
append the code part 2 surrounded by the comment (pseudocode) "/* code part 2 section" ... "/"
to your code:
code part 1
...
/** code part 2 section
code part 2
*/
(Saves the 2nd part also, position of code part 2 section doesn't matter).
If you want to execute only the selected part of the code, press the replLoadSelectedHotkey (default: [CTRL] + [e]).
To always execute a second part besides a seleted part, mark the second part (i.e. code part 2)
and press the replSelectLoadPart2Hotkey: [SHIFT] + [ALT] + [e] once.
The second part is saved, so you must not always mark the code part 2 too.
(Cleaned by the reset-hotkey (default is: [CTRL] + r)).
The Config-file section "[config]" contains the definiton of the replcommands="..." as a CSV list.
The replcommands are executed from left to right.
There are 2 "pseudo"-commands defined internally:
>--load the code part 1--
and
>--load the code part 2--
Pressing the replLoadHotkey or the replLoadSelectedHotkey, the code is saved to the temporary file "replPart1.hs".
Pressing the replSelectLoadPart2Hotkey, the code is saved to the temporary file "replPart2.hs".
(Both inside the "sbt_console_select"-directory).
If the command "--load the code part 1-- " is reached, the SBT-console-REPL ":load "sbt_console_select"-directory\replPart1.hs"
is executed, likewise "--load the code part 2--" -> ":load "sbt_console_select"-directory\replPart2.hs"
You can mix the "pseudo"-commands with other SBT-console-REPL-commands,
Example:
The "replcommands" default value is:
replcommands=":reset,--load imports--,--load the code part 1--,--load the code part 2--"
File "imports.scsc" (in the running directory):
// imports.scsc
import scala.language.postfixOps
import scala.sys.process._
File "printHelper.scsc" (in the "running"-directory):
// printHelper.scsc
object PrintHelper {
implicit class Pr(val s: String | Int){
def pr = {
print(s)
s
}
}
implicit class Prl(val s: String | Int){
def prl = {
println(s)
s
}
}
}
import PrintHelper._
File "code.scsc" (in the "running"-directory):
@main def run(): Unit = {
enum color {
case red(alpha: Int)
case green(alpha: Int)
case blue(alpha: Int)
}
val a = color.red(128)
a.toString.prl
val green = color.green
green.toString.prl
}
/** code part 2 section
run()
*/
// red(128)
// green
Drawback of the load mechanism: Code is inserted as a block, you cannot reverse-navigate thru each line afterwards.
Besides changing the config-file,
you can create a file "replcommands.txt" in the running directory (NOT the "sbt_console_select.exe"-directory).
Example file "replcommands.txt" content (a CSV list) is:
:reset,--load imports--,--load the code part 1--,--load the code part 2--,:imports
The content of the "replcommands.txt" will be used instead of the config-file -> replcommands="...". definition,
so after running the code all defined imports will be listed.
The "replcommands.txt" content is NOT copied to the config-file!
To load an import-file insert a comment like "/** useImports=FILENAME */" into your code,
example: /** useImports=imports1.scsc */
Upon reaching the "replcommandN=--load imports--" command, the file is loaded, i.e.
:load FILENAME
is executed.
// imports.scsc
import cats.effect.{IO, IOApp}
import cats.effect.unsafe.implicits._
import scala.concurrent.duration._
// code (Scala 3 syntax!):
object Main extends IOApp.Simple:
val run = IO.println("Hello") >> IO.println("World")
end Main
/** code part 2 section
Main.run.unsafeRunSync()
*/
Use Selja and Selsca to set the approbiate versions.
Using SBT:
Scala-version: SBT uses the definition in the file "build.sbt"
- Last opened (by sbt_console_select) Console-Window is peferred over other Console-Windows running.
- Can be used not only to start sbt, but many other tools, starts a %comspec% shell if command-field is emtpy.
- REPL Past mode:
-
- Just prepend code with :paste, mark the code and press a replLoadHotkey.
-
- No Ctrl+D is needed, past-mode ends when the file-end is reached.
- Do not use "Aottext" to hold the code to execute.
Aottext aggressively grabs the focus so the command-windows does not get the focus!
- Click on [Edit] -> [Edit Command-file], edit the last line ", sbt -sbt-version 1.5.4 consoleQuick,graalvm11_203", replace "graalvm11_203" with your just configured Java/JDK name, save, close editor
(-sbt-version 1.5.4 is added because there is not "project/build.properties"-file yet (is created then),
the path is not set, so using the actual path of the "sbt_console_select.exe")
(SBT must be installed!)
- Using included files "build.sbt" and "scalafxTest2.sc" which is based on https://github.com/scalafx/scalafx/blob/main/scalafx-demos/src/main/scala/scalafx/ColorfulCircles.scala
- Type [Alt] + [t] to reopen sbt_console_select
- Click on the last entry, sbt consoleQuick is started
- It takes a moment to start the REPL, (using included file "built.sbt")
- Type ":load scalafxTest2.sc"
- After closing the demo, type [Shift] + [Alt] + [t] to close the REPL (sends [Ctrl] + [D] and "exit")
- For ScalaFX us [Ctrl] + [D] then [Arrow Up] then ":load scalafxTest2.sc" to restart
- "sbt_console_select.exe"
- "sbt_console_select.exe" <Command-file> <Config-file> <hidewindow> <remove>
<Command-file>, <Config-file> see below <hidewindow> = the word "hidewindow" <remove> = the word "remove" , remove app from memory (to compile a new one)
Any command can have additional command-parameter, separated by a "#".
Command-parameter text is send to the console-window using the clipboard and a [Shift-right] click.
The A messagebox is shown before sending.
There are hardcoded Command-parameter with special functionality:
- "+close+" : send "[CTRL + D]" and "exit"
- Config-file, default is "sbt_console_select.ini",
contains name=value pairs,
divided by different [sections]. Currently:
- Hotkey definitions
- Path to Notepad++, emailapp and filemanager.
The Config-file must have the extension *.ini
Only simple Hotkey modifications are reflected in the menu.
(Parsing is limited to [CTRL], [ALT], [WIN], [SHIFT]).
| Startparameter | action |
|---|---|
| hidewindow | start app in the background |
| Command-number: 1 or 2 ... N | autostart this command (app stays in the background afterwards) |
| Config-file | must have extension ".ini" |
| Command-file | must have extension ".txt" |
| remove | removes app from memory |
Seleting an entry via the commandline (besides manual selection) takes time because the app must be restarted.
From version 0.188 the app is listening on port scsRestPort (Config-file -> [setup], 65505 is default), path: "scs".
Known commands:
- open=[entryname]
- close=[entryname]
Check if the port is not used by another application (my use NetStat.exe).
Example using "curl",
do NOT run it from the command-line, the title will be changed, including "(testareaQuick)",
so it will open itself, use the batch-file "test_curl_open.bat" etc.:
curl http://localhost:65505/scs?open=(testareaQuick)
Starts the entry named "(testareaQuick)".
Instead off curl any browser is usable too.
curl http://localhost:65505/scs?close=(testareaQuick) Sends Ctrl-D (closes the REPL) and "exit" to the console window named (title contains with) "testareaQuick".
To stop sbt_console_select from listening to the port the command-line parameter "restapioff" may be used,
or an entry in the Config-file -> [setup] -> restapioff=1.
Instead of a Windows-console window, a WSL shell can be openend (if WSL is installed!).
If the name (first clumn) contains "$WSL$" at any position, WSL is used.
The path in the Command-file should be kept in Windows-format,
the file "replcommands.txt" is read from the Windows-side
Changes made to make the usage of Haskell GHCI possible are:
- the filename-extension of the temporary files changed from ".tmp", to ".hs",
SBT doesn't care about the changed temporary filenames. - a specialized "replcommands.txt"-file must be used, containing only commands known by GHCI:
-
- "--load the code part 1--" -> :load ...replPart1.hs
-
- "--load the code part 2--" -> :load ...replPart2.hs
-
- "--load imports--" -> not yet tested, I'm completely new to Haskell at the moment (2023/08)!
Sbt-console-select does not convert the temporary files to Linux line endings in case of using WSL,
but neither SBT nor GHCI had a problem with the Windows line endings.
Sourcecode: Autohotkey format
- "sbt_console_select.ahk".
- Windows 10 or later only.
- Installed SBT
- Portable app, nothing to install.
Github URL github.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sub-license, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANT-ABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Copyright (c) 2020/2021 J. v. Roos
Virusscan at Virustotal, sbt_console_select.exe 64bit-exe, Check here
Virusscan at Virustotal, sbt_console_select32.exe 32bit-exe, Check here
Use [CTRL] + Click to open in a new window!
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent