def run_stata(paths, program, **kwargs):
""".. Run Stata script using system command.
Runs script ``program`` using system command, with script specified
in the form of ``script.do``. Status messages are appended to file ``makelog``.
Parameters
----------
paths : dict
Dictionary of paths. Dictionary should contain values for all keys listed below.
program : str
Path of script to run.
Path Keys
---------
makelog : str
Path of makelog.
Note
----
We recommend leaving all other parameters to their defaults.
Note
----
When a do-file contains a space in its name, different version of Stata save the
corresponding log file with different names. Some versions of Stata truncate the
name to everything before the first space of the do-file name.
Other Parameters
----------------
osname : str, optional
Name of OS. Used to determine syntax of system command. Defaults to ``os.name``.
shell : `bool`, optional
See `here <https://docs.python.org/3/library/subprocess.html#frequently-used-arguments>`_.
Defaults to ``True``.
log : str, optional
Path of program log. Program log is only written if specified.
Defaults to ``''`` (i.e., not written).
executable : str, optional
Executable to use for system command.
Defaults to executable specified in :ref:`default settings<default settings>`.
option : str, optional
Options for system command. Defaults to options specified in :ref:`default settings<default settings>`.
args : str, optional
Not applicable.
Returns
-------
None
Example
-------
.. code-block:: python
run_stata(paths, program = 'script.do')
"""
try:
makelog = get_path(paths, 'makelog')
direct = ProgramDirective(application='stata',
program=program,
makelog=makelog,
**kwargs)
# Get program output (partial)
program_name = direct.program.split(" ")[0]
program_name = os.path.split(program_name)[-1]
program_name = os.path.splitext(program_name)[0]
program_log_partial = os.path.join(os.getcwd(), program_name + '.log')
# Get program output (full)
program_log_full = os.path.join(os.getcwd(),
direct.program_name + '.log')
# Sanitize program
if direct.osname == "posix":
direct.program = re.escape(direct.program)
# Execute
command = metadata.commands[direct.osname]['stata'] % (
direct.executable, direct.option, direct.program)
exit_code, stderr = direct.execute_command(command)
if exit_code != 0:
error_message = 'Stata program executed with errors. Traceback can be found below.'
error_message = format_message(error_message)
raise_from(ProgramError(error_message, stderr), None)
try:
output = direct.move_program_output(program_log_partial,
direct.log)
except:
output = direct.move_program_output(program_log_full, direct.log)
_check_stata_output(output)
except ProgramError:
raise
except:
error_message = 'Error with `run_stata`. Traceback can be found below.'
error_message = format_message(error_message)
write_to_makelog(paths,
error_message + '\n\n' + traceback.format_exc())
raise_from(ColoredError(error_message, traceback.format_exc()), None)
def run_stat_transfer(paths, program, **kwargs):
""".. Run StatTransfer script using system command.
Runs script ``program`` using system command, with script specified
in the form of ``script.stc`` or ``script.stcmd``.
Status messages are appended to file ``makelog``.
Parameters
----------
paths : dict
Dictionary of paths. Dictionary should contain values for all keys listed below.
program : str
Path of script to run.
Path Keys
---------
makelog : str
Path of makelog.
Note
----
We recommend leaving all other parameters to their defaults.
Other Parameters
----------------
osname : str, optional
Name of OS. Used to determine syntax of system command. Defaults to ``os.name``.
shell : `bool`, optional
See `here <https://docs.python.org/3/library/subprocess.html#frequently-used-arguments>`_.
Defaults to ``True``.
log : str, optional
Path of program log. Program log is only written if specified.
Defaults to ``''`` (i.e., not written).
executable : str, optional
Executable to use for system command.
Defaults to executable specified in :ref:`default settings<default settings>`.
option : str, optional
Options for system command. Defaults to options specified in :ref:`default settings<default settings>`.
args : str, optional
Not applicable.
Returns
-------
None
Example
-------
.. code-block:: python
run_stat_transfer(paths, program = 'script.stc')
"""
try:
makelog = get_path(paths, 'makelog')
direct = ProgramDirective(application='st',
program=program,
makelog=makelog,
**kwargs)
# Execute
command = metadata.commands[direct.osname][direct.application] % (
direct.executable, direct.program)
exit_code, stderr = direct.execute_command(command)
direct.write_log()
if exit_code != 0:
error_message = 'StatTransfer program executed with errors. Traceback can be found below.'
error_message = format_message(error_message)
raise_from(ProgramError(error_message, stderr), None)
except ProgramError:
raise
except:
error_message = 'Error with `run_stat_transfer`. Traceback can be found below.'
error_message = format_message(error_message)
write_to_makelog(paths,
error_message + '\n\n' + traceback.format_exc())
raise_from(ColoredError(error_message, traceback.format_exc()), None)