pyosal 0.1.0__tar.gz

pyosal-0.1.0/LICENSE.txt

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) since 2026: pyosal Python Module
+description: python Operating System Abstract Layer
+author:      J. Arrizza   email: cppgent0@gmail.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyosal-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+graft pyosal
+global-exclude *.py[cod]

pyosal-0.1.0/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: pyosal
+Version: 0.1.0
+Summary: python Operating System Abstract Layer
+Author-email: "J. Arrizza" <cppgent0@gmail.com>
+Maintainer-email: "J. Arrizza" <cppgent0@gmail.com>
+License-Expression: MIT
+Project-URL: Website, https://arrizza.com/pyosal
+Project-URL: Source, https://bitbucket.org/arrizza-public/pyosal/src/master
+Project-URL: Download, https://bitbucket.org/arrizza-public/pyosal/get/master.zip
+Keywords: SHOULD-NOT-MATCH,SHOULD-NOT-MATCH,SHOULD-NOT-MATCH
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Topic :: Utilities
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Dynamic: license-file
+
+* website: [Website](https://arrizza.com/TODO.html)
+* installation: [Common Setup](https://arrizza.com/setup-common.html)
+
+## Summary
+
+***Under Construction***

pyosal-0.1.0/README.md

@@ -0,0 +1,6 @@
+* website: [Website](https://arrizza.com/TODO.html)
+* installation: [Common Setup](https://arrizza.com/setup-common.html)
+
+## Summary
+
+***Under Construction***

pyosal-0.1.0/pyproject.toml

@@ -0,0 +1,53 @@
+[project]
+description = 'python Operating System Abstract Layer'
+keywords = ['SHOULD-NOT-MATCH', 'SHOULD-NOT-MATCH', 'SHOULD-NOT-MATCH']
+
+classifiers = [
+    # "Private :: Do Not Upload",   # use to prevent upload
+    # Choose either '3 - Alpha', '4 - Beta' or '5 - Production/Stable'
+    'Development Status :: 3 - Alpha',
+    'Environment :: Console',
+    'Topic :: Utilities',
+    'Intended Audience :: Developers',
+    'Programming Language :: Python :: 3.10',
+    'Programming Language :: Python :: 3.12',
+]
+# additional packages to install
+dependencies = [
+    # 'falcon-logger',
+]
+
+# common values
+name = 'pyosal'
+version = '0.1.0'
+requires-python = '>=3.9'
+authors = [{ name = 'J. Arrizza', email = 'cppgent0@gmail.com' }]
+maintainers = [
+    { name = 'J. Arrizza', email = 'cppgent0@gmail.com' },
+]
+readme = { file = 'README.md', content-type = 'text/markdown' }
+license = 'MIT'
+
+[project.optional-dependencies]
+# None
+[project.scripts]
+# None e.g. spam-cli = "spam:main_cli"
+
+[project.urls]
+'Website' = 'https://arrizza.com/pyosal'
+'Source' = 'https://bitbucket.org/arrizza-public/pyosal/src/master'
+'Download' = 'https://bitbucket.org/arrizza-public/pyosal/get/master.zip'
+# 'Bug Reports' = 'TODO https://github.com/pypa/sampleproject/issues'
+# 'Funding' = 'TODO https://donate.pypi.org'
+# 'Say Thanks!' = 'TODO http://saythanks.io/to/example'
+
+[tool.setuptools.packages.find]
+where = ['src']
+exclude = ['.gitignore']
+
+[tool.setuptools]
+include-package-data = true
+
+[build-system]
+requires = ['setuptools >=61.0']
+build-backend = 'setuptools.build_meta'

pyosal-0.1.0/setup.cfg

@@ -0,0 +1,43 @@
+[metadata]
+description_file = README.md
+
+[pylint.MESSAGES CONTROL]
+max-line-length = 140
+disable = C0114,C0115,C0116,C0415,R0801,R0903,R0912,R0913,R0917,W0511
+
+[pycodestyle]
+max-line-length = 140
+ignore = E266,E402,E731,E203
+statistics = True
+exclude = venv/*, out/*, pf_*, setup.py, debug/*, release/*
+
+[coverage:run]
+omit = 
+	./conftest.py
+	./out/*
+	./ut/*
+	./venv/*
+	./ver/*
+	build_info.py
+branch = true
+
+[coverage:report]
+exclude_lines = 
+	pragma: no cover
+	
+	def __repr__
+	if self\.debug
+	
+	raise NotImplementedError
+	
+	if 0:
+	if __main__ == .__main__:
+ignore_errors = True
+
+[coverage:html]
+directory = ./out/coverage
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

pyosal-0.1.0/src/pyosal/__init__.py

@@ -0,0 +1,3 @@
+from .pyosal import PyOsal
+
+pyosal = PyOsal()

pyosal-0.1.0/src/pyosal/constants.py

@@ -0,0 +1,10 @@
+from dataclasses import dataclass
+
+from .constants_version import ConstantsVersion
+
+
+# -------------------
+## Holds various constants
+@dataclass
+class Constants(ConstantsVersion):  # pylint: disable=too-few-public-methods
+    pass

pyosal-0.1.0/src/pyosal/constants_version.py

@@ -0,0 +1,9 @@
+from dataclasses import dataclass
+
+
+# --------------------
+## holds constants
+@dataclass
+class ConstantsVersion:
+    ## current App version
+    version = '0.1.0'

pyosal-0.1.0/src/pyosal/pyosal.py

@@ -0,0 +1,565 @@
+import getpass
+import os
+import platform
+import re
+import subprocess
+import sys
+import threading
+
+
+# -------------------
+## Meta class for pyosal; ensures it is a singleton
+class _PyOsalMeta(type):
+    ## holds instances of this class (should be 1)
+    _instances = {}
+    ## ensure creation is thread safe
+    _lock = threading.Lock()
+
+    # -------------------
+    ## handle getting the instance of the class.
+    # @param args    the arguments
+    # @param kwargs  the kw arguments
+    def __call__(cls, *args, **kwargs):
+        # Double-checked locking for performance and thread safety
+        if cls not in cls._instances:  # pragma: no cover
+            with cls._lock:
+                if cls not in cls._instances:  # pragma: no cover
+                    # super().__call__ handles object creation AND initialization
+                    instance = super().__call__(*args, **kwargs)
+                    cls._instances[cls] = instance
+        return cls._instances[cls]
+
+
+# -------------------
+## holds OS specific info; there are four recognized OS:
+#    OS      os_name
+#  -------   ----------
+#  Ubuntu  : ubuntu
+#  Mac     : macos
+#  Windows : win (msys2)
+#  Windows : psi (powershell)
+#  RPI     : rpi
+class PyOsal(metaclass=_PyOsalMeta):
+    # -------------------
+    ## initialize
+    def __init__(self):
+        ## holds the OS name
+        self._os_name: str = None
+        ## holds the OS version info
+        self._os_version: str
+        ## holds the python version
+        self._python_version: str = None
+        ## root directory of projects directory
+        # note returns windows format C:/xx/xx
+        self._root_dir: str = None
+        ## root directory of projects directory in msys2 format /c/xx/xx
+        self._root_dir_msys2: str = None
+        ## current userid
+        self._userid: str = None
+        ## hostname of the pc
+        self._hostname: str = None
+        ## list of valid OS
+        self._os_valid = ['ubuntu', 'macos', 'msys2', 'psi', 'rpi']
+
+        # === UT related
+
+        ## used by UTs only
+        self._ut_mode = False
+        ## used by UTs only
+        self.ut_curr_dir = None
+
+        # === initialize
+        self._get_os_name()
+        self._set_all_data()
+
+    # -------------------
+    ## get OS name/tag
+    # @return os_name
+    @property
+    def os_name(self):
+        return self._os_name
+
+    # -------------------
+    ## get OS version info
+    # @return os_version
+    @property
+    def os_version(self):
+        return self._os_version
+
+    # -------------------
+    ## get python version
+    # @return python_version
+    @property
+    def python_version(self):
+        return self._python_version
+
+    # -------------------
+    ## get path for root directory
+    # @return root_dir
+    @property
+    def root_dir(self):
+        return self._root_dir
+
+    # -------------------
+    ## get root directory for msys2 shells
+    # @return root_dir_msys2
+    @property
+    def root_dir_msys2(self):
+        return self._root_dir_msys2
+
+    # -------------------
+    ## get current userid
+    # @return userid
+    @property
+    def userid(self):
+        return self._userid
+
+    # -------------------
+    ## get current PC's hostname
+    # @return hostname
+    @property
+    def hostname(self):
+        return self._hostname
+
+    # -------------------
+    ## get list of recognized valid OS names
+    # @return os_valid
+    @property
+    def os_valid(self):
+        return self._os_valid
+
+    # -------------------
+    ## selects the current platform and sets impl to it
+    #
+    # @return None
+    def _set_all_data(self):
+        if self._os_name == 'rpi':
+            # TODO confirm this is correct
+            self._os_version = f'RPI {platform.system()} {platform.release()}'
+            self._root_dir = '~'
+            self._root_dir_msys2 = self._root_dir
+        elif self._os_name == 'msys2':
+            self._os_version = f'win32 {platform.system()} {platform.release()}'
+            self._root_dir = os.path.expanduser('~')
+            self._root_dir = self._root_dir.replace('\\', '/')
+            self._root_dir_msys2 = '/' + self._root_dir[0].lower() + self._root_dir[2:]
+        elif self._os_name == 'macos':
+            if self._ut_mode:  # pragma: no cover
+                self._os_version = 'macOS 14.5'
+            else:
+                self._os_version = f'macOS {platform.mac_ver()[0]}'  # pragma: no cover
+            self._root_dir = '~'
+            self._root_dir_msys2 = self._root_dir
+        elif self._os_name == 'ubuntu':
+            if self._ut_mode:
+                self._os_version = 'Ubuntu 24.04 noble'
+            else:
+                self._os_version = self._ubuntu_os_version()
+            self._root_dir = '~'
+            self._root_dir_msys2 = self._root_dir
+        else:
+            self.abort(f'PyOsal: unrecognized OS: "{sys.platform}"')
+
+        ## holds python version e.g. "Python 3.10"
+        self._python_version = f'Python {sys.version_info.major}.{sys.version_info.minor}'
+
+        self._hostname = platform.uname().node
+        self._hostname = self._hostname.lower().replace('.local', '')
+
+        self._userid = getpass.getuser()
+
+    # -------------------
+    ## get the current OS tag
+    # @return None
+    def _get_os_name(self):  # pragma: no cover
+        if os.path.isfile('/sys/firmware/devicetree/base/model'):
+            self._os_name = 'rpi'
+        elif sys.platform == 'win32':
+            # TODO check if it's a cygwin?
+            if 'MSYSTEM' in os.environ:
+                self._os_name = 'msys2'
+            elif 'PSModulePath' in os.environ or 'POWERSHELL_DISTRIBUTION_CHANNEL' in os.environ:
+                self._os_name = 'psi'
+            else:
+                self._os_name = 'win-unknown'
+        elif sys.platform == 'darwin':
+            self._os_name = 'macos'
+        elif sys.platform == 'linux':
+            self._os_name = 'ubuntu'
+        else:
+            self._os_name = 'unknown'
+
+    # -------------------
+    ## holds OS information for Ubuntu
+    #
+    # @return string indicating OS info
+    def _ubuntu_os_version(self):
+        proc = subprocess.Popen(  # pylint: disable=consider-using-with
+            ['lsb_release', '-a'],
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+        )
+        (out, _) = proc.communicate()
+        out = out.decode('utf-8')
+
+        version = 'notset'
+        codename = 'notset'
+        for line in out.split('\n'):
+            # sys.stdout.write(f'line: "{line}"')
+            args = line.split('\t')
+            if args[0] == 'Release:':
+                version = args[1]
+            elif args[0] == 'Codename:':
+                codename = args[1]
+        return f'Ubuntu {version} {codename}'
+
+    # === cmd invocation from here on
+
+    ## exception keywords
+    _excp_keywords = [
+        'Traceback (most recent call last):',
+        'Error:',
+        'Permission denied',
+        'command not found',
+    ]
+
+    # -------------------
+    ## run a command in a subprocess
+    #
+    # @param cmd           the command to run
+    # @param working_dir   the working directory to run the command in; default is '.'
+    # @param use_raw_log   no prefix on line
+    # @param log_file      the log_file to write the lines to
+    # @param print_cb      callback function used to print output; default is None
+    # @param env           the environment variables to use
+    # @param quiet         if True, do not write to stdout
+    # @return rc - return code, lines - the output as a list of lines
+    def run_cmd(  # pylint: disable=too-many-branches,too-many-statements
+        self,
+        cmd,
+        working_dir='.',
+        use_raw_log=False,
+        log_file=None,
+        print_cb=None,
+        env=None,
+        quiet=False,
+    ):  # pylint: disable=too-many-locals
+        if not isinstance(cmd, list):
+            self.abort('PyOsal: cmd must be a list')
+
+        ## os_name: see above
+        if self._os_name == 'msys2':
+            # need to invokve msys2 bash
+            pfx = ['c:/msys64/usr/bin/bash', '-c']
+            # the current cmd is a single string at the end
+            pfx.append(' '.join(cmd))
+            cmd = pfx
+
+            # msys2 can cause truncations and wrapping of text if the lines are long
+            if env is None:
+                env = os.environ.copy()
+
+        fp = None
+        if log_file is not None:
+            fp = open(log_file, 'w', encoding='utf-8', newline='\n')  # pylint: disable=consider-using-with
+
+        # TODO set to 127 and then set specifically to rc == 0 below
+        rc = 0
+        lineno = 0
+        lines = []
+
+        # ensure all output is printed, so any stdin done by the cmd is visible in the right order
+        self.stdout_flush()
+        try:
+            proc = subprocess.Popen(  # pylint: disable=consider-using-with
+                cmd,
+                cwd=working_dir,
+                bufsize=0,
+                universal_newlines=True,
+                errors='replace',
+                text=True,
+                stdin=subprocess.DEVNULL,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.STDOUT,
+                env=env,
+            )
+        except Exception as excp:  # pylint: disable=broad-exception-caught
+            err_type = excp.__class__.__name__
+            line = f'EXCP pyosal.run_cmd: {err_type}: {excp}'
+            self._save_line(line, lineno, lines, fp, print_cb, use_raw_log, quiet)
+            return rc, lines
+
+        buffer = ''
+        while True:
+            chunk = os.read(proc.stdout.fileno(), 256)
+            if not chunk:
+                break
+            chunk_str = chunk.decode('utf-8', errors='surrogateescape')
+            chunk_str = chunk_str.replace('\r', '')
+
+            # for char in chunk:
+            #     sys.stdout.write(f"'{char!r}': 0x{ord(char):02x}")
+
+            buffer += chunk_str
+            if '\n' not in buffer:
+                continue
+
+            buff_lines = buffer.split('\n')
+            buffer = buff_lines.pop()
+
+            for line in buff_lines:
+                # if not line.isprintable():
+                #     sys.stdout.write('has hex: ', ascii(line), '\n')
+
+                # check for exceptions and other script failures
+                if any(keyword in line for keyword in self._excp_keywords):
+                    excp_msg = '@@>>@@ Exception detected'
+                    if excp_msg in line:
+                        rc += 1
+                        continue
+                    sys.stdout.write(f'  -- {excp_msg}: "{line}"\n')
+                    rc += 1
+
+                if 'DEPRECATE' in line:
+                    dep_msg = '@@>>@@ Deprecation detected'
+                    if dep_msg in line:
+                        rc += 1
+                        continue
+                    rc += 1
+                    sys.stdout.write(f'  -- {dep_msg} {rc}: "{line}"\n')
+
+                if self._skip_line(line):
+                    line2 = line.encode('utf-8', errors='ignore')
+                    sys.stdout.write(f'@@>>@@ line skipped: {line2}' + '\n')
+                    continue
+
+                # it has text, so add it to the buffer and do the callback if defined
+                lineno += 1
+                self._save_line(line, lineno, lines, fp, print_cb, use_raw_log, quiet)
+
+        # at this point: chunk was empty
+        if len(buffer) > 0:
+            buff_lines = buffer.split('\n')
+            for line in buff_lines:
+                lineno += 1
+                self._save_line(line, lineno, lines, fp, print_cb, use_raw_log, quiet)
+
+        if fp:
+            fp.flush()
+            fp.close()
+
+        rc += proc.wait()
+
+        if proc.stdout:
+            self.stdout_flush()
+            proc.stdout.close()
+        if proc.stderr:
+            self.stderr_flush()
+            proc.stderr.close()
+
+        return rc, lines
+
+    # -------------------
+    ## skip lines with ansi escape sequeces, etc.
+    # @param line   the line to check
+    # @return True if line should be skipped, False otherwise
+    def _skip_line(self, line: str) -> bool:
+        if line == '\x1b[?25l':  # hide mouse cursor
+            return True
+        if line == '\x1b[?25h':  # hide mouse cursor
+            return True
+        if re.search(r'^\x1b.*\d+%', line):  # skip percent lines
+            return True
+
+        if re.search(r'[\u2580-\u259F]', line):
+            return True
+
+        # Catch carriage returns (common in curl/wget across Linux/macOS/MSYS2)
+        if '\r' in line:
+            return True
+
+        # catch ANSI Escape Sequences (used for colors/moving cursors in bash/ps1)
+        # This strips \x1b[..., \033[..., etc.
+        # ansi_escape = re.compile(r'\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])')
+        # cleaned_line = ansi_escape.sub('', line)
+
+        # TODO fix; causes problems with coverage reports that has % in them
+        # e.g.  functions: 100.0% (2 out of 2)
+        # Match progress percentages (e.g., 10%, 10.5%)
+        # if re.search(r'\d+(?:\.\d+)?%', cleaned_line):
+        #     return True
+
+        # # Match interactive spinners (\ | / -)
+        # if re.search(r'(?:[\s\[\(\]{}]|^)([\\/|-]+)(?:[\s\]\)\}{}]|$)', cleaned_line):
+        #     return True
+
+        return False
+
+    # -------------------
+    ## save the current line (if it's not empty)
+    # @param line          the line to save
+    # @param lineno        the line#
+    # @param lines         the current list of lines
+    # @param fp            file pointer to write line to; default is None
+    # @param print_cb      callback function used to print output; default is None
+    # @param use_raw_log   no prefix on line
+    # @param quiet         if True, don't print to stdout, but still add to returned line
+    # @return None
+    def _save_line(self, line, lineno, lines, fp, print_cb, use_raw_log, quiet):
+        if not line:
+            # skip empty lines
+            return
+
+        # always save the line
+        lines.append(line)
+
+        if quiet:
+            # caller doesn't want it to stdout, fp or print_cb
+            return
+
+        if use_raw_log:
+            line_to_save = line
+        else:
+            line_to_save = f'  -- {line}'
+        line_to_save = line_to_save.replace('←', '\x1b')
+        sys.stdout.write(line_to_save + '\n')
+        self.stdout_flush()
+
+        if fp:
+            fp.write(line_to_save)
+            fp.write('\n')
+
+        if print_cb:
+            print_cb(lineno, line)
+
+    # --------------------
+    ## flush for stdout
+    # @param force   (optional) if True, do the buffer flush even if not msys2
+    def stdout_flush(self, force=False):
+        sys.stdout.flush()
+        if force or self._os_name == 'msys2':
+            if hasattr(sys.stdout, 'buffer'):
+                sys.stdout.buffer.flush()
+
+    # --------------------
+    ## flush for stderr
+    # @param force   (optional) if True, do the buffer flush even if not msys2
+    def stderr_flush(self, force=False):
+        sys.stderr.flush()
+        if force or self._os_name == 'msys2':
+            if hasattr(sys.stderr, 'buffer'):
+                sys.stderr.buffer.flush()
+
+    # --------------------
+    ## convert a windows path to posix i.e. forward slashes
+    # @param path    the path to fix
+    # @param force   force the conversion no matter what the OS is
+    # @return the unfixed path
+    def xlat_to_win(self, path, force=False):
+        path = os.path.expanduser(path)
+        if force or self._os_name == 'msys2':
+            # assumes there is only one character and it is for a drive letter
+            # can only be done at the start of the path
+            m = re.search(r'^/(.)/(.*)', path)
+            if m:
+                drive = m.group(1).upper()
+                path = f'{drive}:/{m.group(2)}'
+        path = path.replace('/', '\\')
+        path = path.replace('//', '\\')
+        return path
+
+    # --------------------
+    ## convert a windows path to posix i.e. forward slashes
+    # @param path    the path to fix
+    # @param force   force the conversion no matter what the OS is
+    # @return the unfixed path
+    def xlat_to_posix(self, path, force=False):
+        path = os.path.expanduser(path)
+        if force or self._os_name == 'msys2':
+            m = re.search(r'^(.):(.*)', path)
+            if m:
+                drive = m.group(1).lower()
+                path = f'/{drive}{m.group(2)}'
+        path = path.replace('\\', '/')
+        path = path.replace('//', '/')
+        return path
+
+    # -------------------
+    ## convert a path to relative to home
+    # @param path    the path to fix
+    # @return the relative path
+    def xlat_dir_to_relative(self, path):
+        path = self.xlat_to_posix(path)
+        path = path.replace(self.xlat_to_posix(os.path.expanduser('~')), '~')
+        path = path.replace('\\', '/')
+        return path
+
+    # -------------------
+    ## current repo directory converted to posix
+    # @return the repo dir path
+    @property
+    def curr_repo_dir(self):
+        if self.ut_curr_dir is None:
+            repo_dir = os.getcwd()
+            repo_dir = repo_dir.replace('\\', '/')
+            repo_dir = repo_dir.replace('//', '/')
+        else:
+            repo_dir = self.ut_curr_dir
+        return repo_dir
+
+    # -------------------
+    ## current repo name
+    # @return the repo name
+    @property
+    def curr_repo_name(self):
+        return os.path.basename(os.path.normpath(os.getcwd()))
+
+    # --------------------
+    ## abort the current script.
+    # Note: do not use logging here since it may fail to write correctly
+    #
+    # @param msg  (optional) message to display
+    # @return does not return
+    def abort(self, msg='abort occurred, exiting'):
+        sys.stdout.write('\n')
+        sys.stdout.write(f'ABRT {msg}')
+        self.stdout_flush()
+        self.stderr_flush()
+        sys.exit(1)
+
+    # # -------------------
+    # class ExcpAbort(Exception):
+    #     def __init__(self, message):
+    #         super().__init__(message)
+    #         self.level = 'line'
+    #         self.detail = None
+
+    # def abort(self, msg='ABRT session aborted', level='line'):
+    #     excp = ExcpAbort(msg)
+    #     excp.level = level
+    #     raise excp
+
+    # === UT functions
+
+    # -------------------
+    ## get ut_mode
+    # @return ut_mode (true/false)
+    @property
+    def ut_mode(self):
+        return self._ut_mode
+
+    # -------------------
+    ## set for ut_mode
+    # @param  val   new value to use
+    # @return None
+    @ut_mode.setter
+    def ut_mode(self, val):
+        self._ut_mode = val
+
+    # -------------------
+    ## get set os_name
+    # @param ut_os_name new value to use
+    # @return ut_mode (true/false)
+    def ut_info(self, ut_os_name):
+        self._os_name = ut_os_name
+        self._set_all_data()

pyosal-0.1.0/src/pyosal.egg-info/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: pyosal
+Version: 0.1.0
+Summary: python Operating System Abstract Layer
+Author-email: "J. Arrizza" <cppgent0@gmail.com>
+Maintainer-email: "J. Arrizza" <cppgent0@gmail.com>
+License-Expression: MIT
+Project-URL: Website, https://arrizza.com/pyosal
+Project-URL: Source, https://bitbucket.org/arrizza-public/pyosal/src/master
+Project-URL: Download, https://bitbucket.org/arrizza-public/pyosal/get/master.zip
+Keywords: SHOULD-NOT-MATCH,SHOULD-NOT-MATCH,SHOULD-NOT-MATCH
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Topic :: Utilities
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Dynamic: license-file
+
+* website: [Website](https://arrizza.com/TODO.html)
+* installation: [Common Setup](https://arrizza.com/setup-common.html)
+
+## Summary
+
+***Under Construction***

pyosal-0.1.0/src/pyosal.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE.txt
+MANIFEST.in
+README.md
+pyproject.toml
+setup.cfg
+src/pyosal/__init__.py
+src/pyosal/constants.py
+src/pyosal/constants_version.py
+src/pyosal/pyosal.py
+src/pyosal.egg-info/PKG-INFO
+src/pyosal.egg-info/SOURCES.txt
+src/pyosal.egg-info/dependency_links.txt
+src/pyosal.egg-info/top_level.txt

pyosal-0.1.0/src/pyosal.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pyosal-0.1.0/src/pyosal.egg-info/top_level.txt

@@ -0,0 +1 @@
+pyosal