Changes in trunk/python/env.py [1848:1859]

File:

• trunk/python/env.py (modified) (4 diffs)

trunk/python/env.py

@@ -1 @@
-__all__ = ["is_casapy", "is_ipython", "setup_env", "get_revision"]
+"""This module has various functions for environment specific setings.
+"""
+__all__ = ["is_casapy", "is_ipython", "setup_env", "get_revision",
+           "is_asap_cli"]
 
 import sys
@@ -7 +10 @@
 
 def is_casapy():
+    """Are we running inside casapy?"""
     try:
         from taskinit import casalog
@@ -14 +18 @@
 
 def is_ipython():
+    """Are we running inside IPython?"""
     return 'IPython' in sys.modules.keys()
 
+def is_asap_cli():
+    """Are we running inside asap ipython (but not casapy)"""
+    return is_ipython() and not is_casapy()
+
 def setup_env():
+    """Set-up environment variables for casa and initialise ~/.asap on first
+    use.
+    """
     # Set up CASAPATH and first time use of asap i.e. ~/.asap/*
     plf = None
@@ -59 +71 @@
 
 def get_revision():
+    """Get the revision of the software. Only useful within casapy."""
     if not is_casapy:
         return ' unknown '