quarchpy 2.1.20.dev3__py2.py3-none-any.whl → 2.1.22__py2.py3-none-any.whl

quarchpy/docs/CHANGES.rst.bak

@@ -1,364 +0,0 @@
-====================
-Changelog (Quarchpy)
-====================
-Quarchpy
---------
-*QuarchPy is a python package designed to provide an easy-to-use API which will work seamlessly over any connection option: USB, Serial and LAN. With it, you can create your own scripts for controlling Quarch devices - without having to worry about the low-level code involved with communication.*
-
-*The package contains all prerequisites needed as a single PyPI project, which can be installed from the python online repository using PIP. This makes it easy to install and update, while also providing you with full access to the source code if you want to make changes or additions.*
-
-*QuarchPy can also communicate to the device via QIS (Quarch Instrument Server), QPS (Quarch Power Studio), or simply using Python scripts.  Both QIS and QPS are included with the QuarchPy Package - they are ready to use (Java and drivers may also be needed).*
-
-
-Change Log
-----------
-
-2.1.19
-------
-- Imporoved QIS streaming 
-- Bug fixes
-- Added zeroconf, numpy and pandas as requirements
-
-2.1.17
-------
-- Improved QIS QPS launching on Linux sytems
-- System debug for linux systems
-
-2.1.16
-------
-- FIO mb/s parsing
-- Improved QIS QPS launching
-
-2.1.15
-------
-- minor bug fix
-
-2.1.14
-------
-- minor bug fixes and logging improvements.
-
-2.1.13
-------
-- New QPS v1.36
-- New QIS v1.39
-- minor bug fixes and logging improvements.
-
-2.1.12
-------
-- New QPS v1.35
-- New QIS v1.38
-- minor bug fixes and removal of depracated code.
-
-2.1.11
-------
-- New QPS v1.32
-- New QIS v1.37
-- quarchpy.run module_debug added for checking state of module and DUT
-
-2.1.10
-------
-- New QPS v1.29
-- New QIS v1.33
-
-2.1.8
------
-- New QPS v1.28
-
-2.1.7
------
-- New QPS v1.27
-- New QIS v1.32
-
-2.1.6
------
-- New QPS v1.26
-- New QIS v1.31
-
-2.1.5
------
-- New QPS v1.24
-
-2.1.4
------
-- New QPS v1.23
-- New QIS v1.29
-
-2.1.3
------
-- New QPS v1.22
-- modules on the network can now be connected to using conType:QTLNumber eg. TCP:QTL1999-02-001. 
-- fixed QIS not closing with QPS when launch with by QPS
-- closeConnection added to QIS api
-- display table formats multiline items and handles empty cells
-
-2.1.2
------
-- QPS v1.20
-- QIS v1.19
-
-2.1.1
------
-- Seperation of QIS module scan and QIS select device
-- Added getQuarchDevice which is a wrapper around quarchDevice that allows connections to sub-devices in array controllers over all connection types
-- Version compare updated to use __version__ rather than pkg_resources
-- Seperated the SystenTest (debug_info) into seperate parts with flags to allow the user to skip certain parts. This allows the test to be run without user interaction of selecting a module.
-
-
-2.1.0
------
-- logging improvements
-- usb locked devices fix for CentOS, Ubuntu, and Fedora
-
-2.0.22
-------
-- Calibration and QCS removed from quarchpy and are not in their own packages
-- New command "python -m quarchpy.run debug -usbfix" sets USB rules to fix quarch modules appearing as locked devices on Linux OS
-
-2.0.21
-------
-- new QIS v1.23
-
-2.0.20
-------
-- New modules added to calibration, wiring prompt added, logging improvements
-- Fixes for PAM streaming using QIS
-- Added Quarchpy.run list_drives 
-- Improved communication for connection_QPS
-- Improved QCS debugging
-- Reworked QCS drive detection for upcoming custom drive detection
-- "quarchpy.run list_drives" command added
-
-
-2.0.19
-------
-- QPS v1.17
-- Quarchpy run terminal runs the simple python terminal to talk to modules
-- Scan Specific IP address for Quarch module via QIS/QPS added
-- Updated performance class for new QCS tests
-- Fixed Centos QCS drive selection bug
-- Improved QCS connection classes
-- Improved features for QCS 
-- Minor bug fixes
-
-2.0.18
-------
-- QPS 1.13
-- Iomenter drive location bugfix
-- Units added to stats export from QPS
-- Changed QCS tests to work off of a python format
-- Updated drive detection in QCS
-- Updated communication to TLS 
-
-2.0.16
-------
-- QPS 1.11
-
-2.0.15
-------
-- QIS v1.19.03 and QPS 1.10.12
-- Updated debug info test
-- Snapshots and stats from QPS functions added
-- Calibration updates
-
-2.0.14
-------
-- QPS annotations through quarchpy improvements
-
-2.0.13
-------
-- Python2 bug fixes 
-- UI tidy up
-- New custom annotations and comments QPS API
-
-2.0.12
-------
-- Fixed issue with array module scan over UDP outside of subnet
-- Bug fix for HD connection via USB in linux
-- Added headless launch of QIS
-- Added Shinx auto documentation
-- Fixed issue with USB command response timeout in longer QCS tests
-- Fixed issue where UDP locate parser was using the legacy header, not the quarch fields
-- Improved qurchpy.run oarsing and help generation
-- Fixed syntax warnings for string literal comparisons
-- Calibration wait for specific module uptime and report file updates
-
-2.0.11
-------
-- Improved list selection for devices
-- Fixed bug when scanning for devices within an Array
-- Module detection fixes for QCS and PAM/Rev-B HD
-- Clean up of calibration switchbox code and user logging
-
-2.0.10
-------
-- QCS server logging cleaned up
-- Additional platform tests added to debug_info test
-- Cleaned up print() statements and replaced with logging calls
-- Help message added to quarchpy.run command
-- Module detection fixes for QCS
-- Improved calibration prompts
-- Added initial calibration stubs for the PAM
-- QCS improvements to linux drive enumeration tests
-
-2.0.9
------
-- Significant QCS additions including power testing
-- Added remote switchbox to calibration utility
-- Various minor bug fixes and improvements to calibration utility
-
-2.0.8
------
-- Added readme.md for PyPi description
-- Fixed bug in QIS when checking if QIS is running
-- Various minor additions for QCS
-
-2.0.7
------
-- Changes since 2.0.2
-- Minor bug fixes
-- Calibration Changes
-- QIS folder gone, QIS now in QPS only
-- Run package added
-- Update quarchpy added
-- SystemTest improvements
-- UI changes, input validation, smart port select
-
-2.0.2 
------
-- UI Package added 
-- Connection over TCP for python added
-- Logging on devices
-- Drive test core added
-
-2.0.0
------
-- Major folder restructure
-- Added test center support
-- Detected streaming devices
-- Added latest qps1.09 and qis
-- Minor bug fixes
-
-1.8.0
------
-
-- Tab to white space convert
-- Updated __init__ file to co-allign with python practices
-- Updated project structure 
-- Added documents for changes and Script Locations
-- Disk selection update
-- Compatibility with Python 3 and Linux Improved!
-
-1.7.6
------
-
-- Fixes bug with usb connection
-
-1.7.5
------
-- Fixed USB DLL Compatibility 
-- Fixed potential path issues with Qis and Qps open
-
-1.7.4
------
-
-- Updated to QPS 1.08
-
-1.7.3
------
-
-- Additional Bug Fixes
-
-1.7.2
------
-
-- Bug fixing timings for QIS (LINUX + WINDOWS)
-
-1.7.1
------
-
-- Updated FIO for use with Linux and to allow arguments without values 
-- Fixes path problem on Linux
-- Fixes FIO on Linux
-
-1.7.0
------
-
-- Improved compatability with Windows and Ubuntu 
-
-1.6.1
-------
-
-- Updating USB Scan
-- Adding functionality to specify OS bit architecture (windows)
-
-1.6.0
------
-- custom $scan IP
-- fixes QIS detection
-- implements custom separator for stream files
-- Bug fix - QIS Load
-
-1.5.4
------
-
-- Updating README and LICENSE
-
-1.5.2
------
-
-- Bug Fix - Case sensitivity issue with devices 
-
-1.5.1
------
-
-- Additional Bug Fixes
-
-1.5.0
------
-
-- Integration with FIO 
-- Additional QPS functionality
-- Added device search timeout
-
-1.4.1
------
-
-- Fixed the wmi error when importing quarchpy.
-
-1.4.0
----
-
-- Integration with QPS
-- supports Iometer testing
-- Additional fixes for wait times
-
-1.3.4
------
-
-- Implemented resampling and a better way to launch QIS from the script.
-
-1.3.3
------
-
-- Implements isQisRunning
-- Implements qisInterface
-- Changes startLocalQIS to startLocalQis
-- Fixes a bug in QIS interface listDevices that didn't allow it to work with Python 3
-
-1.3.2
------
-
-- Bug Fix running QIS locally
-
-1.3.1
------
-
-- Implements startLocalQIS
-- Packs QIS v1.6 - fixes the bugs with QIS >v1.6 and multiple modules
-- Updates quarchPPM (connection_specific)
-- Compatible with x6 PPM QIS stream.
-
-1.2.0
------
-
-- Changes to object model

quarchpy/qps/qpsFuncs.py.bak

@@ -1,231 +0,0 @@
-import os, sys
-import datetime
-import time, platform
-from quarchpy.qis import isQisRunning, startLocalQis
-from quarchpy.connection_specific.connection_QIS import QisInterface
-from quarchpy.connection_specific.connection_QPS import QpsInterface
-from quarchpy.user_interface import *
-import subprocess
-import logging
-
-
-def isQpsRunning(host='127.0.0.1', port=9822, timeout=0):
-    '''
-    This func will return true if QPS is running with a working QIS connection. This is becuase
-    '''
-    myQps=None
-    logging.debug("Checking if QPS is running")
-    start = time.time()
-    while True:
-        try:
-            myQps = QpsInterface(host, port)
-            break
-        except Exception as e:
-            logging.debug("Error when making QPS interface. QPS may not be running.")
-            logging.debug(e)
-            if (time.time() - start) > timeout:
-                break
-    if myQps is None:
-        logging.debug("QPS is not running")
-        return False
-
-    logging.debug("Checking if QPS reports a QIS connection") # "$qis status" returns connected if it has ever had a QIS connection.
-    answer=0
-    counter=0
-    while True:
-        answer = myQps.sendCmdVerbose(cmd="$qis status")
-        if answer.lower()=="connected":
-            logging.debug("QPS Running With QIS Connected")
-            break
-        else:
-            logging.debug("QPS Running QIS NOT found. Waiting and retrying.")
-            time.sleep(0.5)
-            counter += 1
-            if counter > 5:
-                logging.debug("QPS Running QIS NOT found after "+str(counter)+" attempts.")
-                return False
-
-    logging.debug("Checking if QPS/QIS comms are running")
-    start = time.time()
-    while True:
-        try:
-            answer = myQps.sendCmdVerbose(cmd="$list")
-            break
-        except:
-            pass
-        if (time.time() - start) > timeout:
-            break
-
-    # check for a 1 showing the first module to be displayed, or a no module/device error message.
-    if answer[0] == "1" or "no device" in str(answer).lower() or "no module" in str(answer).lower():
-        logging.debug("QPS and QIS are running and responding with valid $list info")
-        return True
-    else:
-        logging.debug("QPS did not return expected output from $list")
-        logging.debug("$list: " + str(answer))
-        return False
-
-
-def startLocalQps(keepQisRunning=False, args=[]):
-    if keepQisRunning:
-        if not isQisRunning():
-            startLocalQis()
-    temp =""
-    args = temp.join(args)
-
-    QpsPath = os.path.dirname(os.path.abspath(__file__))
-    QpsPath, junk = os.path.split(QpsPath)
-    QpsPath = os.path.join(QpsPath, "connection_specific", "QPS", "qps.jar")
-
-    current_direc = os.getcwd()
-
-    os.chdir(os.path.dirname(QpsPath))
-
-    command = "-jar \"" + QpsPath + "\""
-
-    currentOs = platform.system()
-
-    if currentOs in "Windows":
-        if "-logging=ON" not in str(args):
-            command = "start /high /b javaw -Djava.awt.headless=true " + command + " " + str(args)
-        else:
-            command = "java " + command + " " + str(args)
-            # command = "start /high /b javaw -Djava.awt.headless=true " + command + " " + str(args) # Running application with this method seems to prevent QPS from logging to terminal
-        # command = command + " -ccs=HIDE"  # note: multiple -ccs options ignored
-        os.system(command)
-    elif currentOs in "Linux":
-        command = command + "-ccs=HIDE"
-        if sys.version_info[0] < 3:
-            os.popen2("java " + command + " 2>&1")
-        else:
-            os.popen("java " + command + " 2>&1")
-    else:  # default to Windows
-        command = "start /high /b javaw -Djava.awt.headless=true " + command + " " + str(args)
-        command = command + " -ccs=HIDE"
-        os.system(command)
-
-    while not isQpsRunning():
-        time.sleep(0.3)
-        pass
-
-    os.chdir(current_direc)
-
-
-def closeQps(host='127.0.0.1', port=9822):
-    myQps = QpsInterface(host, port)
-    myQps.sendCmdVerbose("$shutdown")
-    del myQps
-    time.sleep(1) #needed as calling "isQpsRunning()" will throw an error if it ties to connect while shutdown is in progress.
-
-def GetQpsModuleSelection(QpsConnection, favouriteOnly=True, additionalOptions=['rescan', 'all con types', 'ip scan'], scan=True):
-    favourite = favouriteOnly
-    ip_address = None
-    while True:
-        printText("QPS scanning for devices")
-        tableHeaders = ["Module"]
-        # Request a list of all USB and LAN accessible power modules
-        if ip_address == None:
-            devList = QpsConnection.getDeviceList(scan=scan)
-        else:
-            devList = QpsConnection.getDeviceList(scan=scan, ipAddress=ip_address)
-        if "no device" in devList[0].lower() or "no module" in devList[0].lower():
-            favourite = False  # If no device found conPref wont match and will bugout
-
-        # Removes rest devices
-        devList = [x for x in devList if "rest" not in x]
-        message = "Select a quarch module"
-
-        if (favourite):
-            index = 0
-            sortedDevList = []
-            conPref = ["USB", "TCP", "SERIAL", "REST", "TELNET"]
-            while len(sortedDevList) != len(devList):
-                for device in devList:
-                    if conPref[index] in device.upper():
-                        sortedDevList.append(device)
-                index += 1
-            devList = sortedDevList
-
-            # new dictionary only containing one favourite connection to each device.
-            favConDevList = []
-            index = 0
-            for device in sortedDevList:
-                if (favConDevList == [] or not device.split("::")[1] in str(favConDevList)):
-                    favConDevList.append(device)
-            devList = favConDevList
-
-        if User_interface.instance != None and User_interface.instance.selectedInterface == "testcenter":
-            tempString = ""
-            for module in devList:
-                tempString+=module+"="+module+","
-            devList = tempString[0:-1]
-
-
-        myDeviceID = listSelection(title=message, message=message, selectionList=devList,
-                                   additionalOptions=additionalOptions, nice=True, tableHeaders=tableHeaders, indexReq=True)
-
-        if myDeviceID in 'rescan':
-            ip_address = None
-            favourite = True
-            continue
-        elif myDeviceID in 'all con types':
-            printText('Displaying all conection types...')
-            favourite = False
-            continue
-        elif myDeviceID in 'ip scan':
-            ip_address = requestDialog("Please input IP Address of the module you would like to connect to: ")
-            favourite = False
-            continue
-        else:
-            return myDeviceID
-
-
-
-
-'''
-Legacy function to handle old scripts which call an adjustTime function to get QPS format time.
-This is now done in the QPS module level, so this function returns a integer linux millisecond value
-as per the old one
-'''
-
-
-def legacyAdjustTime(timestamp):
-    return timestamp
-
-
-'''
-Simple function to convert a timestamp or Python datetime object into QPS format time
-QPS requires time in mS with no decimal point, so this is converted here
-'''
-
-
-def toQpsTimeStamp(timestamp):
-    """
-    DEPRICATED - QPS expects time passed as a sring and error hadling is done in QPS.
-    Returns the parameter passed as a valid qps timestamp
-    Assumes
-
-    # 1620817118182 - ACCEPTED value for QPS    - Milliseconds, 13 chars
-
-    # 1620817126    - time.time() Value         - Seconds
-
-    :param int/float/datetime: Timestamp, mS
-    :return: int             : QPS valid time, mS
-    """
-
-    # Python datetime object
-    if (type(timestamp) is datetime):
-        newTime = time.mktime(timestamp.timetuple())
-        return int(newTime * 1000)
-    # If numeric, assume standard unix time in milliseconds
-    elif (type(timestamp) is float or type(timestamp) is int):
-        return int(timestamp)
-    else:
-        # Try if its a numeric value string first (assumed to be milliseconds)
-        try:
-            timestamp = float(timestamp)
-            return int(timestamp)
-        # Fall back to assuming a standard format time string
-        except:
-            newTime = time.mktime(datetime.datetime.strptime(timestamp, "%Y-%m-%d %H:%M:%S:%f").timetuple())
-            return int(newTime * 1000)