#&| &argParm01|="commandStr" &|
#&| &articlesList|="155,174,190,211,215" &|
#&| &byAuthor|="D@CC" &|
#&| &classesList|="none" &|
#&| &codeNumber|="04" &|
#&| &dateToday|="2024CMar12" &|
#&| &emailAuthor|="David@ColeCanada.com" &|
#&| &file01|="/home/pi/Desktop/PiR2/files/commandResult.txt" &|
#&| &funcName|="commandOS" &|
#&| &funcVersion|="none" &|
#&| &funcFor|="PiR2 Area Controller and MakPiADC" &|
#&| &globalsList|="g_fileArray" &|
#&| &imports|="    from subprocess import call
    #import os
    from os import system, name, remove
    from time import sleep" &|

#&| &inRepository|="ix_all.py Function Library" &|
#&| &purpose|="to issue a system command and return the result" &|
#&| &pythonVersion|="3" &|
#&| &resultList|="commandResultStr" &|
#&| &sourceURL|="https://ephotocaption.com/a/215/215.html" &|
#&| &sourceDesc|="www</a> na on 20xxZmmm##" &|
#&| &SSD_or_uSD|="_KIOXIA_GTLL" &|
#&| &summary|="executes an OS command, saves results, returns results" &|
#&| &textColsCnt|="40" &|
#&| &textRowsCnt|="5" &|

executes an OS command, saves results, returns results
# end of entity definitions
#begin macro of Function Description

#&funcName|_selectCode_macroUse.py.txt
<ol>
<li> <b>&funcName|()</b> <br>


<!-- button before select code -->
<button onclick="myFunction&codeNumber|()">selectCode &codeNumber|</button><br>
<textarea id="multiliner&codeNumber|" name="multiliner&codeNumber|" rows="&textRowsCnt|" cols="&textColsCnt|">
def &funcName|(&argParm01|):
    # by: &byAuthor|
    # date: &dateToday|
    # used by: PiR2
    # version: &funcVersion|
    # aka: osCommand()  one should be deprecated
    # articles: &articlesList|
    # SSD/uSD:  &SSD_or_uSD|
    # @Purpose: &purpose|
    # @param1:  str &argParm01|       eg: "vcgencmd measure_temp"
    # @returns: str &resultName| eg: "temp=36.9'C"
    # example: strReturn=&funcName|("vcgencmd measure_temp")
    # uses: system
    #       name
    #       remove
    #       time
    #       sleep
    #       file: "&file01|"
    
    &imports|


    #print("&funcName| received &argParm01|:"+&argParm01|)
    &resultName|="none"

    global &globalsList|

    #commandRFileName=g_fileArray[2]    #future code
    commandRFileName="&file01|"
    # name is not a function, but a special variable (for Pico or WiotT?)
    if name == 'nt':
        _ =system('cls')
    else:
        if (&argParm01|=="clear"):

            print("before clear")
            _= system("clear")
            print("after clear")
        else:
            if (False):
                # in case no file exists, appending something will create it
                # for sure
                fh=open(commandRFileName, "a")
                fh.write("any")
                fh.close()
                # now remove it ???
                remove(commandRFileName)
            #endif

            # save result in txt file
            saveOutputStr=" >"+commandRFileName
            revisedCommandStr=&argParm01|+saveOutputStr
            #print("revisedCommandStr:"+revisedCommandStr)

            #invoke system command
            _= system(revisedCommandStr)
            fh=open(commandRFileName, "r")
            # read the result of the command
            &resultList|=fh.readline()
            fh.close()
        #end if
    return &resultList|
    #end if
#end &funcName|.txt
</textArea>
<br>
<!-- script after selectCode -->
<script>
function myFunction&codeNumber|() {
  var copyText = document.getElementById("multiliner&codeNumber|");
  copyText.select();
  copyText.setSelectionRange(0, 99999)
  document.execCommand("copy");
}
</script>
-- end of &funcName|.py program in &codeNumber|<br><br>


	Purpose:    &purpose|<br>
	Form:       &funcName|(strCmd) -> strResult<br>
	Reason:     permit code to execute OS command and use results<br>
	Summary:    &summary|<br>
        By:         &byAuthor|
        Date:       &dateToday|
	Example:    strD=&funcName|("dir") will return list of dir contents<br>
	Help:       type &funcName|("-h") for help<br>
	Warning 1:  Parm1 must be a str containing an OS command<br>
	Note 1:     error checking prevents system errors.<br>
	Requires:<br>
	<blockquote>
		from: ix_all import &funcName|<br>
		Python Verson: &pythonVersion|<br>
		Globals: &globalsList|<br>
		External Functions: <br>
		Imports: &importssList|<br>
		Classes: &classesList|<br>
		Files: &file01|<br>
	</blockquote>
	Version: &funcVersion|<br>
	For: &funcFor|<br>
	Repository: &inRepository|<br>
	Author: &byAuthor| ( &emailAuthor| )<br>
	Date Created : &dateToday|<br>
	Date Tested &nbsp; : &dateToday|<br>
	Date Modified: &dateToday|<br>
	Source: <a href="&sourceURL|">&sourceDesc|<br>
	Code: <a href="&funcName|_txt.html"> &funcName|() </a> by &byAuthor| (&emailAuthor|)<br><br> </li>
</ol>
# E:\E\2022\DevE\MyPagesE\Globat\ePhotoCaption.com\a\215\commandOS_selectCode_macroUse.py.txt
#/commandOS_selectCode_macroDef.py.txt