run.tcl
README.md

run.tcl

  • run.tcl
  • Options
    • RunOptions run::RunOptions : Sets options of "Run..." dialogue.
  • Button commands
    • Run run::Run : Runs a command of "Run..." dialogue.
    • Save run::Save : Saves settings of "Run..." dialogue.
    • Cancel run::Cancel : Handles hitting "Cancel" button.
    • Help run::Help : Shows Run's help.
  • GUI
    • InitTex12 run::InitTex12 : Initializes texts & combobox (colors, events, highlighting etc.). tex1 - 1st text's path tex2 - 2nd text's path cbx - compobox's path
    • FillTex1 run::FillTex1 : Fills command content text.
    • FillTex2 run::FillTex2 : Fills "commands before running" text.
    • FillCbx run::FillCbx : Fill the command combobox.
    • GetRUNFEXEC run::GetRUNFEXEC : Gets value of RUNF/EXEC entry.
    • DeleteForcedRun run::DeleteForcedRun : Clears current combobox' value.
    • ValidatePath run::ValidatePath : Validates a path chosen from the file picker.
    • ChbForced run::ChbForced : Checks states & values of widgets.
  • Main
    • _create run::_create : Dialogue to define a command for "Tools/Run".
    • _run run::_run
  • EOF

alited's source

The alited/src directory contains alited's own source files.

Some additional alited's files are also contained in alited/lib/addon directory (alited/lib directory contains all library files).

  • about.tcl - "About alited" dialogue.
  • alited.tcl - The alited's main script to start.
  • bar.tcl - Handles the bar of tabs.
  • check.tcl - "Check Tcl" dialogue and procedures.
  • complete.tcl - Handles auto-completion.
  • edit.tcl - "Edit" menu's procedures.
  • favor.tcl - Handles the favorite and last visited units.
  • favor_ls.tcl - "Saved lists of favorites" dialogue and procedures.
  • file.tcl - "File" menu's procedures.
  • find.tcl - "Find / Replace" dialogue and procedures.
  • format.tcl - "Edit / Formats" menu's procedures.
  • img.tcl - List of images used by alited.
  • indent.tcl - Handles text indentation.
  • info.tcl - Handles the info bar.
  • ini.tcl - Handles initializing alited.
  • keys.tcl - Handles keyboard (mapping etc.).
  • main.tcl - Handles the main form of alited.
  • menu.tcl - Handles alited's menus.
  • msgs.tcl - Localized messages used in several places.
  • paver.tcl - "Tools / Paver" tool.
  • pkgIndex.tcl - Includes README.md text (for Ruff doc generator).
  • pref.tcl - "Preferences" dialogue and procedures.
  • preview.tcl - "Preview (theme, CS)" dialogue called by "Preferences".
  • printer.tcl - "Tools / Project Printer" dialogue and procedures.
  • project.tcl - "Projects" dialogue and procedures.
  • run.tcl - "Tools / Run..." dialogue and procedures.
  • tool.tcl - "Tools" menu's procedures.
  • tree.tcl - Handles the tree of units and files.
  • unit.tcl - Handles the unit tree.
  • unit_tpl.tcl - "Templates" dialogue and procedures.

    • run.tcl
    ###########################################################
# Name:    run.tcl
# Author:  Alex Plotnikov  (aplsimple@gmail.com)
# Date:    01/14/2023
# Brief:   Handles "Tool/Run..." menu item.
# License: MIT.
###########################################################

namespace eval run {
  variable win .alwin.rundlg
  variable vent {}
}

# ________________________ Options _________________________ #

proc run::RunOptions {args} {
  # Sets options of "Run..." dialogue.

  namespace upvar ::alited al al obRun obRun
  set cbx [$obRun CbxfiL]
  set com [string trim [$cbx get]]
  set al(comForce) $com
  set al(comForceLs) [$cbx cget -values]
  set befrun [[$obRun Tex2] get 1.0 end]
  if {$com ne {}} {
    set i [lsearch -exact $al(comForceLs) $com]
    set al(comForceLs) [lreplace $al(comForceLs) $i $i]
  }
  if {[llength $al(comForceLs)]<2} {set al(comForceLs) [list {}]}
  if {$com ne {}} {
    set al(comForceLs) [linsert $al(comForceLs) 1 $com]
  }
  for {set i [llength $al(comForceLs)]} {$i>1} {} {
    incr i -1
    if {[string trim [lindex $al(comForceLs) $i]] eq {}} {
      set al(comForceLs) [lreplace $al(comForceLs) $i $i]
    }
  }
  set al(comForceLs) [lrange $al(comForceLs) 0 $al(prjmaxcoms)]
  set al(prjbeforerun) [::alited::ProcEOL [string trim $befrun] out]
}

# ________________________ Button commands _________________________ #

proc run::Run {} {
  # Runs a command of "Run..." dialogue.

  namespace upvar ::alited al al
  variable win
  wm attributes $win -topmost 0  ;# let Run dialogue be hidden
  RunOptions
  if {![alited::file::IsTcl [alited::bar::FileName]]} {
    set in {}
  } elseif {$al(prjincons)==1} {
    set in terminal
  } elseif {$al(prjincons)==2} {
    set in {as is}
  } else {
    set in tkcon
  }
  alited::tool::_run {} $in -doit yes
}
#_______________________

proc run::Save {} {
  # Saves settings of "Run..." dialogue.

  namespace upvar ::alited al al obRun obRun
  variable win
  set al(runGeometry) [wm geometry $win]
  RunOptions
  alited::SaveRunOptions
  alited::ini::SaveIniPrj
  alited::main::UpdateProjectInfo
  catch {$obRun res $win 1}
}
#_______________________

proc run::Cancel {args} {
  # Handles hitting "Cancel" button.

  namespace upvar ::alited al al obRun obRun
  variable win
  alited::RestoreRunOptions
  catch {
    set al(runGeometry) [wm geometry $win]
    $obRun res $win 0
  }
}
#_______________________

proc run::Help {} {
  # Shows Run's help.

  variable win
  alited::Help $win
}

# ________________________ GUI _________________________ #


proc run::InitTex12 {tex1 tex2 cbx} {
  # Initializes texts & combobox (colors, events, highlighting etc.).
  #   tex1 - 1st text's path
  #   tex2 - 2nd text's path
  #   cbx - compobox's path

  namespace upvar ::alited al al obRun obRun
  ::hl_tcl::hl_init $tex1 -dark [$obRun csDark] -plaintext 1 \
    -cmd ::alited::run::FillCbx -cmdpos ::alited::run::FillCbx -font $al(FONT)
  ::hl_tcl::hl_text $tex1
  ::hl_tcl::hl_init $tex2 -dark [$obRun csDark] -plaintext 1 \
    -font $al(FONT) -cmdpos ::apave::None
  ::hl_tcl::hl_text $tex2
  bind $tex1 <FocusIn> {set ::alited::al(run_checkmaxcomms) 1}
  bind $cbx <FocusOut> alited::run::FillTex1
  bind $cbx <<ComboboxSelected>> alited::run::FillTex1
  ChbForced
}
#_______________________

proc run::FillTex1 {args} {
  # Fills command content text.

  namespace upvar ::alited al al obRun obRun
  set tex1 [$::alited::obRun Tex1]
  set tex2 [$::alited::obRun Tex2]
  set cbx [$obRun CbxfiL]
  if {$al(_startRunDialogue)} {
    set al(_startRunDialogue) no
    InitTex12 $tex1 $tex2 $cbx
  }
  if {!$al(comForceCh)} {
    $obRun displayText $tex1 [[$::alited::obRun Ent] get]
    return
  }
  if {[focus] eq $tex1} return
  set com [$cbx get]
  set coms {}
  set l1 0
  foreach c [$cbx cget -values] {
    incr l
    set c [string trim $c]
    if {$c eq $com && !$l1} {set l1 $l}
    if {$c ne {}} {
      append coms $c\n\n
    }
  }
  if {$l1} {
    catch {::tk::TextSetCursor $tex1 $l1.0}
  } else {
    set coms $com\n\n$coms
  }
  $obRun displayText $tex1 $coms
}
#_______________________

proc run::FillTex2 {args} {
  # Fills "commands before running" text.

  namespace upvar ::alited al al obRun obRun
  set tex2 [$::alited::obRun Tex2]
  $obRun displayText $tex2 [::alited::ProcEOL [string trim $al(prjbeforerun)] in]
}
#_______________________

proc run::FillCbx {args} {
  # Fill the command combobox.

  namespace upvar ::alited al al obRun obRun
  if {!$al(comForceCh)} return
  set tex1 [$::alited::obRun Tex1]
  if {!$al(comForceCh) || [focus] ne $tex1} return
  set cbx [$obRun CbxfiL]
  set lst [list]
  set curline {}
  set l1 [expr {int([$tex1 index insert])}]
  foreach line [split [$tex1 get 1.0 end] \n] {
    incr l
    if {$l==1 || [set line [string trim $line]] ne {}} {
      lappend lst $line
    }
    if {$l==$l1} {
      set curline $line
    }
  }
  set llen [llength $lst]
  if {$llen<$al(prjmaxcoms)} {
    alited::Message {}
  } else {
    if {[info exists al(run_checkmaxcomms)] && $al(run_checkmaxcomms)} {
      set mm 4 ;# bell + red message
    } else {
      set mm 6 ;# only red message
    }
    set al(run_checkmaxcomms) 0
    set msg [msgcat::mc {Maximum commands reached: %n, current: %i (see Project/Options)}]
    alited::Message [string map [list %i $llen %n $al(prjmaxcoms)] $msg] $mm
  }
  if {[lindex $lst 0] ne {}} {set lst [linsert $lst 0 {}]}
  $cbx configure -values $lst
  set curline [string trim $curline]
  if {$curline ne {}} {
    $cbx set $curline
    selection clear -displayof $cbx
    $cbx selection range 0 end
  }
  RunOptions
  ValidatePath
}
#_______________________

proc run::GetRUNFEXEC {} {
  # Gets value of RUNF/EXEC entry.

  variable vent
  lassign [alited::tool::RunArgs] ar rf ex
  set vent "$ar$rf$ex"
}
#_______________________

proc run::DeleteForcedRun {} {
  # Clears current combobox' value.

  namespace upvar ::alited al al obRun obRun
  set cbx [$obRun CbxfiL]
  if {[set val [string trim [$cbx get]]] eq {}} return
  set values [$cbx cget -values]
  if {[set i [lsearch -exact $values $val]]>-1} {
    set al(comForceLs) [lreplace $values $i $i]
    $cbx configure -values $al(comForceLs)
  }
  $cbx set {}
}
#_______________________

proc run::ValidatePath {} {
  # Validates a path chosen from the file picker.

  namespace upvar ::alited al al obRun obRun
  set cbx [$obRun CbxfiL]
  set com [string trim [$cbx get]]
  if {[file exists $com]} {
    if {[llength [split $com]]>1} {
      set com "\"$com\""
    }
    $cbx set [file nativename $com]
  }
  return 1
}
#_______________________

proc run::ChbForced {} {
  # Checks states & values of widgets.

  namespace upvar ::alited al al obRun obRun
  set cbx [$obRun CbxfiL]
  set but [string map {.cbx .btT} $cbx] ;# path to combobox' button
  set tex [$obRun Tex1]
  $obRun readonlyWidget $tex no
  GetRUNFEXEC
  FillTex1
  ValidatePath
  if {$al(comForceCh)} {
    set state normal
  } else {
    $obRun readonlyWidget $tex yes
    set state disabled
  }
  $cbx configure -state $state
  $but configure -state $state
}
# ________________________ Main _________________________ #

proc run::_create {} {
  # Dialogue to define a command for "Tools/Run".

  namespace upvar ::alited al al obRun obRun
  variable win
  alited::SaveRunOptions
  set al(_startRunDialogue) yes
  if {[catch {
    if {[lindex $al(comForceLs) 0] eq {-}} {
      set al(comForceLs) [lreplace $al(comForceLs) 0 0]  ;# legacy
    }
    if {[lindex $al(comForceLs) 0] ne {}} {
      set i [lsearch $al(comForceLs) {}]
      set al(comForceLs) [lreplace $al(comForceLs) $i $i]
      set al(comForceLs) [linsert $al(comForceLs) 0 {}]  ;# to allow blank value
    }
  }]} {
    set al(comForceLs) [list]
  }
  set fname [alited::bar::FileName]
  if {![llength $al(comForceLs)] && $fname ne $al(MC,nofile)} {
    set al(comForceLs) [list {} $fname]
  }
  GetRUNFEXEC
  set run [::alited::ProcEOL $al(prjbeforerun) in]
  $obRun makeWindow $win.fra $al(MC,run)
  $obRun paveWindow $win.fra {
    {h_ - - 1 5}
    {lab T + 1 1 {-st e -pady 5 -padx 8} {-t Run:}}
    {fraIn + L 1 4 {-st ew}}
    {.Rad1 - - 1 1 {pack -side left} {-tvar ::alited::al(MC,inconsole) -value 1 -var ::alited::al(prjincons)}}
    {.rad0 + L 1 1 {pack -side left -expand 1} {-tvar ::alited::al(MC,intkcon) -value 0 -var ::alited::al(prjincons)}}
    {.Rad2 + L 1 1 {pack -side left} {-tvar ::alited::al(MC,asis) -value 2 -var ::alited::al(prjincons)}}
    {.h_ - - 1 1 {pack -side left -expand 1}}
    {seh1 lab T 1 5 {-pady 5}}
    {rad3 + T 1 1 {-st w -padx 8} {-t {By #RUNF: / #EXEC:} -value 0 -var ::alited::al(comForceCh) -com alited::run::ChbForced}}
    {Ent + L 1 4 {-st ew -pady 5} {-state disabled -tip {-BALTIP ! -COMMAND {[$::alited::obRun Ent] get} -UNDER 2 -PER10 0} -tvar ::alited::run::vent}}
    {rad4 rad3 T 1 1 {-st w -padx 8} {-t {By command:} -value 1 -var ::alited::al(comForceCh) -com alited::run::ChbForced}}
    {fiL + L 1 4 {-st ew} {-h 12 -cbxsel "$al(comForce)" -clearcom alited::run::DeleteForcedRun -values "$al(comForceLs)" -validate focus -validatecommand alited::run::ValidatePath}}
    {fra1 rad4 T 1 5 {-st nsew -cw 1 -rw 1}}
    {.Tex1 - - - - {pack -side left -fill both -expand 1} {-w 50 -h 9 -afteridle alited::run::FillTex1 -tabnext *tex2}}
    {.sbv + L - - {pack -side left}}
    {seh3 fra1 T 1 5 {-pady 5}}
    {lab2 + T 1 5 {} {-t { OS or Tcl commands to be run before running a current file:}}}
    {fra2 + T 1 5 {-st nsew}}
    {.Tex2 - - - - {pack -side left -fill both -expand 1} {-w 50 -h 4 -afteridle alited::run::FillTex2 -tabnext *butRun}}
    {.sbv + L - - {pack -side left}}
    {seh2 fra2 T 1 5 {-pady 5}}
    {butHelp + T 1 1 {-st w -padx 2} {-t Help -com alited::run::Help}}
    {h_2 + L 1 2 {-st ew}}
    {fra3 + L 1 2 {-st e}}
    {.butRun - - 1 1 {-padx 2} {-t Run -com alited::run::Run}}
    {.butSave + L 1 1 {} {-t Save -com alited::run::Save}}
    {.butCancel + L 1 1 {-padx 2} {-t Cancel -com alited::run::Cancel}}
  }
  ValidatePath
  bind $win <F1> alited::run::Help
  bind $win <F5> alited::run::Run
  set geo $al(runGeometry)
  if {$geo ne {}} {set geo "-geometry $geo"}
  $obRun showModal $win -modal no -waitvar yes -onclose alited::run::Cancel -resizable 1 -focus [$obRun Rad1] -decor 1 -minsize {400 300} {*}$geo -ontop 0
  catch {destroy $win}
  ::apave::deiconify $al(WIN)
}
#_______________________

proc run::_run {} {

  variable win
  if {[winfo exists $win]} {
    ::apave::withdraw $win
    ::apave::deiconify $win
  } else {
    _create
  }
}

# ________________________ EOF _________________________ #
    run.tcl