"""
Copyright (C) 2020 Vanessa Sochat.
This Source Code Form is subject to the terms of the
Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed
with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
"""
import os
import locale
import subprocess
import shlex
import shutil
import tempfile
from .file import read_file
[docs]def get_github_username():
"""Get the github username of the user from git config."""
command = Command("git config user.name")
username, _ = command.execute()
if command.returncode != 0:
raise FileNotFoundError(
"Problem running git config user.name. Please provide GitHub username as argument."
)
return username[0].replace("\n", "")
[docs]class Capturing:
"""capture output from stdout and stderr into capture object.
This is based off of github.com/vsoch/gridtest but modified
to write files. The stderr and stdout are set to temporary files at
the init of the capture, and then they are closed when we exit. This
means expected usage looks like:
with Capturing() as capture:
process = subprocess.Popen(...)
And then the output and error are retrieved from reading the files:
and exposed as properties to the client:
capture.out
capture.err
And cleanup means deleting these files, if they exist.
"""
def __enter__(self):
self.set_stdout()
self.set_stderr()
return self
[docs] def set_stdout(self):
self.stdout = open(tempfile.mkstemp()[1], "w")
[docs] def set_stderr(self):
self.stderr = open(tempfile.mkstemp()[1], "w")
def __exit__(self, *args):
self.stderr.close()
self.stdout.close()
@property
def out(self):
"""Return output stream. Returns empty string if empty or doesn't exist.
Returns (str) : output stream written to file
"""
if os.path.exists(self.stdout.name):
return read_file(self.stdout.name)
return ""
@property
def err(self):
"""Return error stream. Returns empty string if empty or doesn't exist.
Returns (str) : error stream written to file
"""
if os.path.exists(self.stderr.name):
return read_file(self.stderr.name)
return ""
[docs] def cleanup(self):
for filename in [self.stdout.name, self.stderr.name]:
if os.path.exists(filename):
os.remove(filename)
[docs]class Command:
"""Class method to invoke shell commands and retrieve output and error.
This class is inspired and derived from utils functions in
https://github.com/vsoch/scif
"""
def __init__(self, cmd=None):
cmd = cmd or []
self.returncode = None
self.out = []
self.err = []
# If a list isn't provided, split it
if cmd:
self.set_command(cmd)
[docs] def set_command(self, cmd):
"""parse is called when a new command is provided to ensure we have
a list. We don't check that the executable is on the path,
as the initialization might not occur in the runtime environment.
"""
if not isinstance(cmd, list):
cmd = shlex.split(cmd)
self.cmd = cmd
[docs] def execute(self):
"""Execute a system command and return output and error.
:param cmd: shell command to execute
:type cmd: str, required
:return: Output and Error from shell command
:rtype: two str objects
"""
# Reset the output and error records
self.out = []
self.err = []
# The executable must be found, return code 1 if not
executable = shutil.which(self.cmd[0])
if not executable:
self.err = ["%s not found." % self.cmd[0]]
self.returncode = 1
return (self.out, self.err)
# remove the original executable
args = self.cmd[1:]
# Use updated command with executable and remainder (list)
cmd = [executable] + args
# Capturing provides temporary output and error files
with Capturing() as capture:
process = subprocess.Popen(
cmd,
stdout=capture.stdout,
stderr=capture.stderr,
universal_newlines=True,
)
returncode = process.poll()
# Iterate through the output
while returncode is None:
returncode = process.poll()
# Get the remainder of lines, add return code
self.out += ["%s\n" % x for x in self.decode(capture.out) if x]
self.err += ["%s\n" % x for x in self.decode(capture.err) if x]
# Cleanup capture files and save final return code
capture.cleanup()
self.returncode = returncode
return (self.out, self.err)
[docs] def returnCode(self):
"""Returns the return code from shell command
:rtype: int
"""
return self.returncode
[docs] def decode(self, line):
"""Given a line of output (error or regular) decode using the
system default, if appropriate
"""
loc = locale.getdefaultlocale()[1]
try:
line = line.decode(loc)
except:
pass
return line
[docs] def get_output(self):
"""Returns the output from shell command
:rtype: str
"""
return self.out
[docs] def get_error(self):
"""Returns the error from shell command
:rtype: str
"""
return self.err