quarchpy 2.2.17.dev1__tar.gz

quarchpy-2.2.17.dev1/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include quarchpy *

quarchpy-2.2.17.dev1/PKG-INFO

@@ -0,0 +1,516 @@
+Metadata-Version: 2.4
+Name: quarchpy
+Version: 2.2.17.dev1
+Summary: This packpage offers Python support for Quarch Technology modules.
+Author: Quarch Technology ltd
+Author-email: support@quarch.com
+License: Quarch Technology ltd
+Keywords: quarch quarchpy torridon
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: System
+Classifier: Topic :: System :: Power (UPS)
+Requires-Python: >=3.7
+Description-Content-Type: text/x-rst
+Requires-Dist: zeroconf>=0.23.0
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: requests
+Requires-Dist: packaging
+Requires-Dist: quarchpy-binaries
+Requires-Dist: typing-extensions
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: keywords
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+====================
+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.2.16
+------
+- New QPS 1.50 and QIS 1.52
+
+2.2.15
+------
+- Bugfix for ">" appearing in qis output when streaming at max speed
+
+2.2.14
+------
+- New QPS 1.49 and QIS 1.51
+
+2.2.13
+------
+- New QPS 1.48 and QIS 1.50
+- Lightweight Quarchpy, QPS and QIS now downloaded on first use after install.
+- Minor bug fixes
+
+2.2.12
+------
+- Minor bug fix
+
+2.2.11
+------
+- Minor bug fix
+
+2.2.10
+------
+- Fix for new HDPPM FW discovery over eithernet
+- Minor bug fix
+
+2.2.9
+-----
+- New QPS 1.47 and QIS 1.49
+
+2.2.8
+-----
+- New QPS 1.46 and QIS 1.48
+
+2.2.7
+-----
+- Bug fix for QIS 1.47 missing lib for linux only 
+
+2.2.6
+-----
+- New QPS 1.45 and QIS 1.47
+
+2.2.5
+-----
+- Minor Bug fix and removal of redundant jar
+
+2.2.4
+-----
+- Update to Java libraries to run QPS
+- Removal of depracated libs saveing space
+
+2.2.3
+-----
+- Minor bug fix
+
+2.2.2
+-----
+- New QPS 1.44 and QIS 1.46
+- Added support for automatic creation of default synthetic channels when connecting to module via QIS
+- Minor bug fixes
+
+2.2.1
+-----
+- New QPS v1.43 and QIS v1.45 packaged with java 21 with no need for installed java.
+- Minor bug fixes
+
+2.2.0
+-----
+- New QPS v1.42 and QIS v1.44 packaged with java 21 with no need for installed java.
+- Minor bug fixes
+
+2.1.26
+------
+- minor bugfix
+
+2.1.25
+------
+- New QPS 1.40 and Qis 1.43
+- mdns scanning added to quarchpy
+
+2.1.24
+------
+- Yanked
+
+2.1.23
+------
+- QIS and QPS devices and interfaces can use sendCommand to send comannds to the modules and to the applications uniformly
+- Tidy up of print statments and comments.
+
+2.1.22
+------
+- QIS and QPS patch containing mDNS removal
+
+
+2.1.21
+------
+- New QPS v1.38 and QIS 1.41
+- Minor bug fixes
+
+2.1.20
+------
+- Improved direct IP scanning for quarch modules
+- New QPS v1.37 and QIS v1.40
+
+2.1.19
+------
+- Imporoved QIS streaming 
+- Bug fixes
+- Added zeroconf, numpy and pandas as requirements
+
+2.1.18
+------
+- Minor bug fix
+
+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-2.2.17.dev1/README.md

@@ -0,0 +1,82 @@
+# QuarchPy
+
+QuarchPy is a Python API for the automation of Quarch hardware modules and software. It enables robust, scriptable control over Quarch modules, making it straightforward to build reproducible test and automation workflows.
+
+- Project repo: [QuarchTechnologyLtd/QuarchPy](https://github.com/QuarchTechnologyLtd/QuarchPy)
+- License: See [LICENSE](./quarchpy/LICENSE.rst)
+
+## Table of Contents
+
+- [Features](#features)
+- [Getting Started](#getting-started)
+  - [Requirements](#requirements)
+  - [Installation](#installation)
+- [Application Notes](#application-notes)
+- [Contributing](#contributing)
+- [Support](#support)
+
+## Features
+
+- High-level Python interface to Quarch modules and software.
+- Device discovery and connection via common transports (USB, TCP/IP/LAN, serial).
+- Acquisition of measurements (voltage, current, power), streaming and logging.
+- Scripting-friendly design.
+- Structured error handling and timeouts for robust automation.
+- Cross-platform support (Windows, Linux; macOS where supported by drivers).
+
+## Getting Started
+
+### Requirements
+
+- Python 3.8+
+- Access to Quarch modules
+- Appropriate drivers or connectivity (USB, LAN, or serial) as required by your hardware
+- Network or OS permissions to access the device
+
+### Installation
+
+Install the package from PyPI (if published):
+
+```bash
+pip install quarchpy
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/QuarchTechnologyLtd/QuarchPy.git
+cd QuarchPy
+pip install -e .
+```
+
+## Application Notes
+
+For worked examples and detailed guides, check out our GitHub Application Notes repository:
+
+- [Quarch Application Notes GitHub](https://github.com/QuarchTechnologyLtd/quarchpy-appnotes)
+
+**Getting Started:**  
+We recommend beginning with  
+[AN-006 Python Control of Quarch Modules](https://github.com/QuarchTechnologyLtd/quarchpy-appnotes/tree/main/Application_Notes/AN-006_Python_Control_of_Quarch_Modules)  
+which provides step-by-step instructions and sample Python code for controlling Quarch modules.
+
+These resources will help you set up and script Quarch hardware with Python quickly and effectively.
+
+## Contributing
+
+Contributions are welcome! Please:
+- Open an issue describing the problem or requested feature.
+- Discuss design via issues or pull requests.
+- Follow existing code style and add tests where applicable.
+- Ensure changes are documented in this README or docstrings.
+- See [CONTRIBUTING](./CONTRIBUTING.md)
+
+## Support
+
+- For hardware setup and official documentation, contact Quarch Technology or visit official product docs.
+- For bugs or feature requests in this library, open an issue on the GitHub repository.
+- For commercial support, reach out to Quarch via your support contract or sales contact.
+
+---
+
+© Quarch Technology Ltd. All rights reserved.

quarchpy-2.2.17.dev1/quarchpy/LICENSE.rst

@@ -0,0 +1,89 @@
+********
+LICENSES
+********
+
+################
+QUARCHPY Package
+################
+
+Copyright (C) 2018-2020 Quarch Technology Ltd. All Rights Reserved.
+
+The QuarchPy library is free to use and modify, provided it is being used with Quarch Technology products.
+
+
+######
+PYUSB
+######
+
+Copyright (C) 2009-2017 Wander Lairson Costa. All Rights Reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+3. The name of the author may not be used to endorse or promote products
+   derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED
+WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
+EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
+OF SUCH DAMAGE.
+
+########
+PYSERIAL
+########
+
+Copyright (c) 2001-2016 Chris Liechti <cliechti@gmx.net>
+All Rights Reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+  * Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+  * Redistributions in binary form must reproduce the above
+    copyright notice, this list of conditions and the following
+    disclaimer in the documentation and/or other materials provided
+    with the distribution.
+
+  * Neither the name of the copyright holder nor the names of its
+    contributors may be used to endorse or promote products derived
+    from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---------------------------------------------------------------------------
+Note:
+Individual files contain the following tag instead of the full license text.
+
+    SPDX-License-Identifier:    BSD-3-Clause
+
+This enables machine processing of license information based on the SPDX
+License Identifiers that are here available: http://spdx.org/licenses/
+
+