Metadata-Version: 2.1
Name: PIconnect
Version: 0.10.3
Summary: Python connector to OSIsoft PI SDK
Home-page: https://github.com/Hugovdberg/PIconnect
Author: Hugo Lapré
Author-email: hugo.lapre@brabantwater.nl
License: MIT license
Project-URL: Bug Tracker, https://github.com/Hugovdberg/PIconnect/issues
Project-URL: Documentation, https://piconnect.readthedocs.io/en/stable/
Keywords: OSIsoft,PI,Process Information,PIconnect
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Database
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.8
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS.rst

#########
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&amp;utm_medium=referral&amp;utm_content=Hugovdberg/PIconnect&amp;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.
