Metadata-Version: 2.1
Name: APC-Temp-fetch
Version: 0.0.0
Summary: APC/Schneider UPS current temperature fetchers
Home-page: https://github.com/YZITE/APC_Temp_fetch
Author: zseri
Author-email: zseri@ytrizja.de
License: Apache-2.0
Description: # APC_Temp_fetch
        
        This python package provides an unified interface to several UPS
        network adapters with different firmware versions. It does not
        support guessing which interface to use; that wasn't necessary yet.
        
        It supports the following interfaces:
        | `kind` | `description` |
        |--------|---------------|
        | `old`  | Simple interface using HTTP basic auth, information gets extracted from `upsstat.htm`, by finding the line mentioning `Internal Temperature` |
        | `frmnc` | Requires 2 HTTP requests, main characteristics are that the login form is named `frmLogin` in HTML, and the data is presented in a `<div>`-table, but parsable line-by-line |
        | `gden-nt07` | Similar to `frmnc`; with 3 HTTP requests, but the login form is named `HashForm1` instead, and the data representation is more complex, so a more full-blown HTML-parser is used; data structured via `<span>` items |
        | `cs141` | Simple JSON API (and the imo best interface of these); with 3 HTTP requests, characteristic is the the data is located at `/api/devices/ups/report` |
        
        The description provides some guidance which `kind` an interface is.
        You may also just try out each `kind` and check if any returns useful results,
        but (although unlikely) it may "brick" the network adapter until it is reset;
        usually seen when (thru some bug) the script isn't able to properly logout
        after a successful login, because many of these network adapters limit the
        number of concurrent logins, often to even just 1 user at a time.
        
        This package has 2 entry points:
        * `APC_Tempf [--verbose] <kind> <host> <user> <password> [--timeout <timeout>]`
          `kind` is the one of these mentioned above.
          `host`, `user` and `password` should be self-explanatory.
          `timeout` is an optional per-request timeout.
          This is the primary, "simple" interface.
        
        * `APC_Tempstfe [--verbose] <apclist>`
          allows querying multiple UPS devices sequentially, and is used to
          amortize the python script startup time.
          The file should contain lines of the format `<kind> <host> <user> <password>[ <timeout>]`
          (all without the `<>` brackets).
          After the timeout, a comment may be given, or a comment can be alternatively placed
          at the begging of a line, prefixed with a `# `; empty lines are ignored.
        
        Results are formatted as `<host>\t<temperature>` (`<>` brackets aren't part of the output,
        `\t` is replaced with an ASCII TAB character).
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Requires-Python: >=3.6
Description-Content-Type: text/markdown
