PIconnect


NamePIconnect JSON
Version 0.10.6 PyPI version JSON
download
home_pagehttps://github.com/Hugovdberg/PIconnect
SummaryPython connector to OSIsoft PI SDK
upload_time2023-02-04 18:59:32
maintainer
docs_urlNone
authorHugo Lapré
requires_python>=3.8
licenseMIT license
keywords osisoft pi process information piconnect
VCS
bugtrack_url
requirements cffi clr-loader numpy pandas None pycparser python-dateutil pythonnet pytz six wrapt
Travis-CI No Travis.
coveralls test coverage No coveralls.
            #########
PIconnect
#########

A python connector to the OSISoft PI and PI-AF databases
========================================================

This connector allows access to the OSISoft PI System through their
proprietary SDK. It provides a number of classes, mostly mirroring the AF SDK
structure, but at the same time implementing the cool stuff we use Python for.
Connections to the database are therefore implemented as context managers, to
allow opening a connection using a with statement.

.. image:: https://img.shields.io/pypi/v/PIconnect.svg
    :target: https://pypi.python.org/pypi/PIconnect
    :alt: PIconnect on PyPI

.. image:: https://img.shields.io/conda/vn/conda-forge/piconnect
    :target: https://anaconda.org/conda-forge/piconnect
    :alt: PIconnect on conda-forge

.. image:: https://github.com/Hugovdberg/PIconnect/actions/workflows/ci.yml/badge.svg?branch=develop
    :target: https://github.com/Hugovdberg/PIconnect/actions/workflows/ci.yml
    :alt: Continuous Integration status

.. image:: https://readthedocs.org/projects/piconnect/badge/?version=develop
    :target: https://piconnect.readthedocs.io/en/latest/?badge=develop
    :alt: Documentation Status

.. image:: https://pyup.io/repos/github/Hugovdberg/PIconnect/shield.svg
    :target: https://pyup.io/repos/github/Hugovdberg/PIconnect/
    :alt: Security Updates

.. image:: https://api.codacy.com/project/badge/Grade/568734c85e07467c99e0e791d8eb17b6
    :target: https://www.codacy.com/app/Hugovdberg/PIconnect?utm_source=github.com&utm_medium=referral&utm_content=Hugovdberg/PIconnect&utm_campaign=Badge_Grade
    :alt: Automated code review

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black
    :alt: Code style: black

Python connector to OSIsoft PI SDK


* Free software: MIT license
* Documentation: https://piconnect.readthedocs.io.


Features
--------
Features below are for both: PI Server and PIAF Database:

* Extract recorded values
* Extract interpolated values
* Update a value
* Summarize data before extraction with help of OSIsoft PI SDK
* Filter data before extraction with help of OSIsoft PI SDK

Copyright notice
================
OSIsoft, the OSIsoft logo and logotype, Managed PI, OSIsoft Advanced Services,
OSIsoft Cloud Services, OSIsoft Connected Services, PI ACE, PI Advanced
Computing Engine, PI AF SDK, PI API, PI Asset Framework, PI Audit Viewer, PI
Builder, PI Cloud Connect, PI Connectors, PI Data Archive, PI DataLink, PI
DataLink Server, PI Developer's Club, PI Integrator for Business Analytics, PI
Interfaces, PI JDBC driver, PI Manual Logger, PI Notifications, PI ODBC, PI
OLEDB Enterprise, PI OLEDB Provider, PI OPC HDA Server, PI ProcessBook, PI
SDK, PI Server, PI Square, PI System, PI System Access, PI Vision, PI
Visualization Suite, PI Web API, PI WebParts, PI Web Services, RLINK and
RtReports are all trademarks of OSIsoft, LLC.

Credits
---------

This package was created with Cookiecutter_ and the
`audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage

History
=======

0.9.1 (2021-08-11)
------------------

* Fixes the Exception type to swallow (related to #580)
* Fixes missing dependency in wheel (#595)

0.9.0 (2021-08-10)
------------------

.. warning:: This is the final version to support python 2.7

* Added support to write values to the databases (#573)
* Added support for extracting Event frames from PI-AF (#587)
* Added methods to extract a single historic value from both `PIPoint` and `PIAFAttribute` objects. (#523)
* Added options to login to the PI Server using provided credentials (#522)
* Added option to set the connection timeout for data extraction (#572)
* Better loading of the configured servers (#580)
* All data extracting functions now support both extraction using strings and `datetime` objects. (#574)

0.8.0 (2020-03-03)
------------------

* Added option to configure the timezone for the returned index. Changed default from Europe/Amsterdam to UTC! Adds `pytz` as new dependency(#499)
* More robust detection of the default PI AF server (#496, #501)
* Removed `pytest-runner` dependency unless explicitly requested (#503)
* Exiting the context manager for a `PIAFDatabase` no longer explicitly disconnects from the server, but leaves it up to SDK. (#487)
* Various updates of the package dependencies

0.7.1 (2019-08-16)
------------------

* Improved documentation
* Changed `PIData.PISeriesContainer` to an Abstract Base Class

0.7.0 (2018-11-14)
------------------

* Add `summary`, `summaries`, and `filtered_summaries` methods to `PIPoint`
    and `PIAFAttribute`

0.6.0 (2018-07-05)
------------------

0.5.1 (2017-11-25)
------------------


0.4.0 (2017-11-25)
------------------

* First release on PyPI.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/Hugovdberg/PIconnect",
    "name": "PIconnect",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "OSIsoft,PI,Process Information,PIconnect",
    "author": "Hugo Lapr\u00e9",
    "author_email": "hugo.lapre@brabantwater.nl",
    "download_url": "https://files.pythonhosted.org/packages/05/63/88a875049a7a6d4acf174e9fb3e41e8173981d265a48b902291076e5cf21/PIconnect-0.10.6.tar.gz",
    "platform": "any",
    "description": "#########\r\nPIconnect\r\n#########\r\n\r\nA python connector to the OSISoft PI and PI-AF databases\r\n========================================================\r\n\r\nThis connector allows access to the OSISoft PI System through their\r\nproprietary SDK. It provides a number of classes, mostly mirroring the AF SDK\r\nstructure, but at the same time implementing the cool stuff we use Python for.\r\nConnections to the database are therefore implemented as context managers, to\r\nallow opening a connection using a with statement.\r\n\r\n.. image:: https://img.shields.io/pypi/v/PIconnect.svg\r\n    :target: https://pypi.python.org/pypi/PIconnect\r\n    :alt: PIconnect on PyPI\r\n\r\n.. image:: https://img.shields.io/conda/vn/conda-forge/piconnect\r\n    :target: https://anaconda.org/conda-forge/piconnect\r\n    :alt: PIconnect on conda-forge\r\n\r\n.. image:: https://github.com/Hugovdberg/PIconnect/actions/workflows/ci.yml/badge.svg?branch=develop\r\n    :target: https://github.com/Hugovdberg/PIconnect/actions/workflows/ci.yml\r\n    :alt: Continuous Integration status\r\n\r\n.. image:: https://readthedocs.org/projects/piconnect/badge/?version=develop\r\n    :target: https://piconnect.readthedocs.io/en/latest/?badge=develop\r\n    :alt: Documentation Status\r\n\r\n.. image:: https://pyup.io/repos/github/Hugovdberg/PIconnect/shield.svg\r\n    :target: https://pyup.io/repos/github/Hugovdberg/PIconnect/\r\n    :alt: Security Updates\r\n\r\n.. image:: https://api.codacy.com/project/badge/Grade/568734c85e07467c99e0e791d8eb17b6\r\n    :target: https://www.codacy.com/app/Hugovdberg/PIconnect?utm_source=github.com&utm_medium=referral&utm_content=Hugovdberg/PIconnect&utm_campaign=Badge_Grade\r\n    :alt: Automated code review\r\n\r\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\r\n    :target: https://github.com/psf/black\r\n    :alt: Code style: black\r\n\r\nPython connector to OSIsoft PI SDK\r\n\r\n\r\n* Free software: MIT license\r\n* Documentation: https://piconnect.readthedocs.io.\r\n\r\n\r\nFeatures\r\n--------\r\nFeatures below are for both: PI Server and PIAF Database:\r\n\r\n* Extract recorded values\r\n* Extract interpolated values\r\n* Update a value\r\n* Summarize data before extraction with help of OSIsoft PI SDK\r\n* Filter data before extraction with help of OSIsoft PI SDK\r\n\r\nCopyright notice\r\n================\r\nOSIsoft, the OSIsoft logo and logotype, Managed PI, OSIsoft Advanced Services,\r\nOSIsoft Cloud Services, OSIsoft Connected Services, PI ACE, PI Advanced\r\nComputing Engine, PI AF SDK, PI API, PI Asset Framework, PI Audit Viewer, PI\r\nBuilder, PI Cloud Connect, PI Connectors, PI Data Archive, PI DataLink, PI\r\nDataLink Server, PI Developer's Club, PI Integrator for Business Analytics, PI\r\nInterfaces, PI JDBC driver, PI Manual Logger, PI Notifications, PI ODBC, PI\r\nOLEDB Enterprise, PI OLEDB Provider, PI OPC HDA Server, PI ProcessBook, PI\r\nSDK, PI Server, PI Square, PI System, PI System Access, PI Vision, PI\r\nVisualization Suite, PI Web API, PI WebParts, PI Web Services, RLINK and\r\nRtReports are all trademarks of OSIsoft, LLC.\r\n\r\nCredits\r\n---------\r\n\r\nThis package was created with Cookiecutter_ and the\r\n`audreyr/cookiecutter-pypackage`_ project template.\r\n\r\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\r\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\r\n\r\nHistory\r\n=======\r\n\r\n0.9.1 (2021-08-11)\r\n------------------\r\n\r\n* Fixes the Exception type to swallow (related to #580)\r\n* Fixes missing dependency in wheel (#595)\r\n\r\n0.9.0 (2021-08-10)\r\n------------------\r\n\r\n.. warning:: This is the final version to support python 2.7\r\n\r\n* Added support to write values to the databases (#573)\r\n* Added support for extracting Event frames from PI-AF (#587)\r\n* Added methods to extract a single historic value from both `PIPoint` and `PIAFAttribute` objects. (#523)\r\n* Added options to login to the PI Server using provided credentials (#522)\r\n* Added option to set the connection timeout for data extraction (#572)\r\n* Better loading of the configured servers (#580)\r\n* All data extracting functions now support both extraction using strings and `datetime` objects. (#574)\r\n\r\n0.8.0 (2020-03-03)\r\n------------------\r\n\r\n* Added option to configure the timezone for the returned index. Changed default from Europe/Amsterdam to UTC! Adds `pytz` as new dependency(#499)\r\n* More robust detection of the default PI AF server (#496, #501)\r\n* Removed `pytest-runner` dependency unless explicitly requested (#503)\r\n* Exiting the context manager for a `PIAFDatabase` no longer explicitly disconnects from the server, but leaves it up to SDK. (#487)\r\n* Various updates of the package dependencies\r\n\r\n0.7.1 (2019-08-16)\r\n------------------\r\n\r\n* Improved documentation\r\n* Changed `PIData.PISeriesContainer` to an Abstract Base Class\r\n\r\n0.7.0 (2018-11-14)\r\n------------------\r\n\r\n* Add `summary`, `summaries`, and `filtered_summaries` methods to `PIPoint`\r\n    and `PIAFAttribute`\r\n\r\n0.6.0 (2018-07-05)\r\n------------------\r\n\r\n0.5.1 (2017-11-25)\r\n------------------\r\n\r\n\r\n0.4.0 (2017-11-25)\r\n------------------\r\n\r\n* First release on PyPI.\r\n",
    "bugtrack_url": null,
    "license": "MIT license",
    "summary": "Python connector to OSIsoft PI SDK",
    "version": "0.10.6",
    "split_keywords": [
        "osisoft",
        "pi",
        "process information",
        "piconnect"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "fa29f57b59680f8a0f46a7256e9e40691c801b92cf413ab3a8a9c3bd2c4ff7ab",
                "md5": "bea12f0a32a0477a779c31d68148f179",
                "sha256": "6ce3b5c424f4783dae9d386de496e0ff0f591b3494d90829c544bfa46f59a60b"
            },
            "downloads": -1,
            "filename": "PIconnect-0.10.6-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "bea12f0a32a0477a779c31d68148f179",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.8",
            "size": 31526,
            "upload_time": "2023-02-04T18:59:30",
            "upload_time_iso_8601": "2023-02-04T18:59:30.630245Z",
            "url": "https://files.pythonhosted.org/packages/fa/29/f57b59680f8a0f46a7256e9e40691c801b92cf413ab3a8a9c3bd2c4ff7ab/PIconnect-0.10.6-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "056388a875049a7a6d4acf174e9fb3e41e8173981d265a48b902291076e5cf21",
                "md5": "1e3481c9dbeafc8c67d7f8cde5f4848d",
                "sha256": "a910d5ad79598a95106d7202f062cf6ee0d9b87d6a6e0a937c2fdf1b10ba46f7"
            },
            "downloads": -1,
            "filename": "PIconnect-0.10.6.tar.gz",
            "has_sig": false,
            "md5_digest": "1e3481c9dbeafc8c67d7f8cde5f4848d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 44733,
            "upload_time": "2023-02-04T18:59:32",
            "upload_time_iso_8601": "2023-02-04T18:59:32.395915Z",
            "url": "https://files.pythonhosted.org/packages/05/63/88a875049a7a6d4acf174e9fb3e41e8173981d265a48b902291076e5cf21/PIconnect-0.10.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-02-04 18:59:32",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "Hugovdberg",
    "github_project": "PIconnect",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "cffi",
            "specs": [
                [
                    "==",
                    "1.15.1"
                ]
            ]
        },
        {
            "name": "clr-loader",
            "specs": [
                [
                    "==",
                    "0.2.5"
                ]
            ]
        },
        {
            "name": "numpy",
            "specs": [
                [
                    "==",
                    "1.24.1"
                ]
            ]
        },
        {
            "name": "pandas",
            "specs": [
                [
                    "==",
                    "1.5.2"
                ]
            ]
        },
        {
            "name": null,
            "specs": []
        },
        {
            "name": "pycparser",
            "specs": [
                [
                    "==",
                    "2.21"
                ]
            ]
        },
        {
            "name": "python-dateutil",
            "specs": [
                [
                    "==",
                    "2.8.2"
                ]
            ]
        },
        {
            "name": "pythonnet",
            "specs": [
                [
                    "==",
                    "3.0.1"
                ]
            ]
        },
        {
            "name": "pytz",
            "specs": [
                [
                    "==",
                    "2022.7.1"
                ]
            ]
        },
        {
            "name": "six",
            "specs": [
                [
                    "==",
                    "1.16.0"
                ]
            ]
        },
        {
            "name": "wrapt",
            "specs": [
                [
                    "==",
                    "1.14.1"
                ]
            ]
        }
    ],
    "lcname": "piconnect"
}
        
Elapsed time: 0.03822s