=================================
``grail.ip.core`` Module
=================================
.. include:: ../../version.h

.. contents:: Table of Contents
   :backlinks: top


--------
Overview
--------

Provides some core functionality for a MineSightŪ-Interactive Planner
(MS-IP) scripts.

This module is mainly concerned with operations that interact with the
underlying operating system.


---------
Functions
---------

:df:`vSysSpawn(program, argument)` 
   Executes the :a:`program` with the given :a:`argument` in a
   separate process. Both the :a:`program` and :a:`argument` are
   strings.

   The program is a valid program that is found on the operating
   system's PATH environment variable, and the single argument is
   applied to that program. 

   The program will start within a new process that will inherit the
   current processes environment variable settings.

   This is particularly useful if you want to start :file:`notepad.exe`
   with a report file. For example, 

   .. Python::

     from grail.ip import core
      
     f = open("report.dat")
     f.write("This is a sample line in a report.\n")
     f.close()

     core.vSysSpawn("notepad.exe", "report.dat")