Add feature for internal tester, and update version/changelog for new release

Author: tomweber-sas

CHANGELOG.md

@@ -1,6 +1,31 @@
 # Changelog
 
 
+## [5.104.0] - 2025-10-30
+
+### Added
+
+-   `Enhancement` A minor tweak to allow ODS output to be left 'asis' for internal testers here at SAS.
+Since SASPy started, the returned ODS Document from SAS has been tweakd to get it to render in Jupyter
+better than it looks by default. This new key in the `SAS_output_options` configuration option allows for this.
+
+   'asis'   :  False         # defaults to how this has always worked
+
+
+### Changed
+
+-   `None` Nothing Changed
+
+### Fixed
+
+-   `None` Nothing Changed
+
+### Removed
+
+-   `None` Nothing removed
+
+
+
 ## [5.103.2] - 2025-07-11
 
 ### Added
@@ -39,7 +64,7 @@ the http request calls that didn't have it, to handle unexpected failures better
 
 ### Fixed
 
--   ` None` Nothing Fixed
+-   `None` Nothing Fixed
 
 ### Removed
 
@@ -67,7 +92,7 @@ as the code finishes.
 
 ### Fixed
 
--   ` None` Nothing Fixed
+-   `None` Nothing Fixed
 
 ### Removed
 

saspy/doc/source/configuration.rst

@@ -210,13 +210,15 @@ Here's an example showing these (I have one in the saspy install dir, current di
 
 sascfg_personal.py details
 ==========================
-There are three main parts to this configuration file.
+There are three main parts to this configuration file. Actually, there is a 4th non-required one too, which isn't needed normally.
 
         1) SAS_config_names
         2) SAS_config_options  # this dictionary isn't required unless you want to change a default
-        3) Configuration definitions
+        3) Configuration Definitions
 
-In reverse order, the configuration definitions are Python dictionaries. Each dictionary
+        4) SAS_output_options  # this is available for adjusting some ODS settings. See it documented in the sascfg.py example file.
+
+In reverse order, the Configuration Definitions are Python dictionaries. Each dictionary
 has the settings for one connection method (STDIO, SSH, IOM, and so on) to a SAS session.
 These values are defined in the following sections.
 
@@ -256,13 +258,6 @@ For example, if you had SAS installed on your Linux system, your sascfg_personal
 
     SAS_config_names   = ['mycfg']
 
-    # this is actually optional, you only have to have it to change the defaults
-    #SAS_config_options = {'lock_down': False,
-    #                      'verbose'  : True,
-    #                      'prompt'   : True,
-    #                      'style'    : 'HTMLBlue'
-    #                     }
-
     mycfg              = {'saspath'  : '/opt/sasinside/SASHome/SASFoundation/9.4/bin/sas_u8'
                          }
 

saspy/sasbase.py

@@ -155,8 +155,10 @@ def __init__(self, **kwargs):
         try:
            outopts       = getattr(SAScfg, "SAS_output_options")
            self.odsstyle = outopts.get('style', 'HTMLBlue')
+           self.odsasis  = outopts.get('asis', False)
         except:
            self.odsstyle = 'HTMLBlue'
+           self.odsasis  = False
 
         # See if we don't want to allow prompting in this environment
         prompt = self.cfgopts.get('prompt', True)

saspy/sascfg.py

@@ -59,14 +59,20 @@
 # properly with HTML 5.0 so it can also be set to HTML 4.0 instead (using "ods html" statement). This option will only work when using IOM
 # in local mode. Note that HTML 4.0 will generate images separately which clutters the workspace and if you download the notebook as HTML,
 # the HTML file will need to be put in the same folder as the images for them to appear.
+#
+# Note that this configuration option (SAS_output_options) is NOT required unless changing any of the defaultd
+#
 # valid keys are:
 #
 # 'output' = ['html5', 'html']
 # 'style'  = any valid style   # this will be the default for SASsession.HTML_Style, which you can also change dynamically in your code
+# 'asis'   = True              # don't tweak the html document (as has always been done) to get it to display better in Jupyter; leave it as is
 #
 #
-SAS_output_options = {'output' : 'html5',       # not required unless changing any of the default
-                      'style'  : 'HTMLBlue'}
+SAS_output_options = {'output' : 'html5',       # change the ODS output destination; not suggested, only for special use case
+                      'style'  : 'HTMLBlue',    # defaults to SAS's default
+                      'asis'   :  False         # defaults to how this has always worked
+                     }
 
 
 # Configuration Definitions

saspy/sasiocom.py

@@ -497,7 +497,8 @@ def submit(self, code: str, results: str='html', prompt: dict=None, **kwargs) ->
                except UnicodeDecodeError:
                   lstf = lstf.decode(errors='replace')
 
-            listing = lstf \
+            listing = lstf if self._sb.sascfg.odsasis else \
+                      lstf \
                 .replace(chr(12), chr(10)) \
                 .replace('<body class="c body">', '<body class="l body">') \
                 .replace('font-size: x-small;', 'font-size: normal;')

saspy/sasiohttp.py

@@ -1053,7 +1053,8 @@ def _getlst(self, jobid=None):
          i += 1
       conn.close()
 
-      lstd = htm.replace(chr(12), chr(10)).replace('<body class="c body">',
+      lstd = htm if self._sb.sascfg.odsasis else \
+             htm.replace(chr(12), chr(10)).replace('<body class="c body">',
                                                    '<body class="l body">').replace("font-size: x-small;",
                                                                                     "font-size:  normal;")
       return lstd

saspy/sasioiom.py

@@ -1081,9 +1081,10 @@ def submit(self, code: str, results: str ="html", prompt: dict = None, **kwargs)
       if len(trip[1]) > 0 and len(trip[2]) < 200:
          lstf = ''
 
-      lstd = lstf.replace(chr(12), chr(10)).replace('<body class="c body">',
-                                                    '<body class="l body">').replace("font-size: x-small;",
-                                                                                     "font-size:  normal;")
+      lstd = lstf if self._sb.sascfg.odsasis else \
+             lstf.replace(chr(12), chr(10)).replace('<body class="c body">',
+                                                   '<body class="l body">').replace("font-size: x-small;",
+                                                                                    "font-size:  normal;")
       logf = logf.decode(errors='replace').replace(chr(12), chr(20))
       self._log += logf
       final = logf.partition(logcodei)

saspy/sasiostdio.py

@@ -1111,7 +1111,8 @@ def submit(self, code: str, results: str ="html", prompt: dict = None, **kwargs)
       zz = z[0].rpartition("E3969440A681A24088859985" + prev)
       logd = zz[2].replace(mj.decode(self.sascfg.encoding), '').replace(chr(12), chr(10))
 
-      lstd = lstf.replace(chr(12), chr(10)).replace('<body class="c body">',
+      lstd = lstf  if self._sb.sascfg.odsasis else \
+             lstf.replace(chr(12), chr(10)).replace('<body class="c body">',
                                                     '<body class="l body">').replace("font-size: x-small;",
                                                                                      "font-size:  normal;")
       if self._checkLogForError(logd):

saspy/version.py

@@ -1 +1 @@
-__version__ = '5.103.2'
+__version__ = '5.104.0'