robotframework-prometheus 0.6.1__tar.gz

robotframework-prometheus-0.6.1/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.1
+Name: robotframework-prometheus
+Version: 0.6.1
+Summary: Additional Robot Framework keywords
+Home-page: https://github.com/test-fullautomation/robotframework-prometheus
+Author: Holger Queckenstedt
+Author-email: Holger.Queckenstedt@de.bosch.com
+License: UNKNOWN
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development
+Requires-Python: >=3.0
+Description-Content-Type: text/markdown
+
+Package Description
+===================
+
+The interface library **prometheus\_interface** provides Robot Framework
+keywords to communicate with the monitoring system **Prometheus**.
+
+Currently this library is under development. We work on it. But what is
+available up to now, is not ready for being used in productive systems
+(but hopefully will be in near future).
+
+Package Documentation
+---------------------
+
+A (growing) detailed documentation of the **prometheus\_interface** can
+be found here:
+
+[PrometheusInterface.pdf](https://github.com/test-fullautomation/robotframework-prometheus/blob/develop/PrometheusInterface/PrometheusInterface.pdf)
+
+Feedback
+--------
+
+To give us a feedback, you can send an email to [Thomas
+Pollerspöck](mailto:Thomas.Pollerspoeck@de.bosch.com)
+
+In case you want to report a bug or request any interesting feature,
+please don\'t hesitate to raise a ticket.
+
+Maintainers
+-----------
+
+[Holger Queckenstedt](mailto:Holger.Queckenstedt@de.bosch.com)
+
+[Thomas Pollerspöck](mailto:Thomas.Pollerspoeck@de.bosch.com)
+
+Contributors
+------------
+
+[Holger Queckenstedt](mailto:Holger.Queckenstedt@de.bosch.com)
+
+[Thomas Pollerspöck](mailto:Thomas.Pollerspoeck@de.bosch.com)
+
+License
+-------
+
+Copyright 2020-2024 Robert Bosch GmbH
+
+Licensed under the Apache License, Version 2.0 (the \"License\"); you
+may not use this file except in compliance with the License. You may
+obtain a copy of the License at
+
+> [![License: Apache
+> v2](https://img.shields.io/pypi/l/robotframework.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an \"AS IS\" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+

robotframework-prometheus-0.6.1/PrometheusInterface/__init__.py

@@ -0,0 +1,13 @@
+#  Copyright 2020-2024 Robert Bosch GmbH
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.

robotframework-prometheus-0.6.1/PrometheusInterface/prometheus_interface.py

@@ -0,0 +1,697 @@
+#  Copyright 2020-2024 Robert Bosch GmbH
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+# XC-HWP/ESW3-Queckenstedt
+
+# -- import standard Python modules
+import pickle, os, time, random
+import dotdict
+
+# -- import Prometheus interface
+from prometheus_client import start_http_server, Gauge, Counter, Info
+
+# -- import Robotframework API
+from robot.api.deco import keyword, library # required when using @keyword, @library decorators
+from robot.libraries.BuiltIn import BuiltIn
+
+# -- import some helpers
+from PythonExtensionsCollection.String.CString import CString
+from PythonExtensionsCollection.Utils.CUtils import *
+
+# --------------------------------------------------------------------------------------------------------------
+# this interface library
+#
+LIBRARY_VERSION      = "0.6.1"
+LIBRARY_VERSION_DATE = "17.06.2024"
+#
+THISMODULENAME = "prometheus_interface.py"
+THISMODULE     = f"{THISMODULENAME} v. {LIBRARY_VERSION} / {LIBRARY_VERSION_DATE}"
+#
+DEFAULT_PORT = 8000
+#
+DEFAULT_MESSAGE_LEVEL = "INFO"
+#
+# --------------------------------------------------------------------------------------------------------------
+# 
+@library
+class prometheus_interface():
+   """The class 'prometheus_interface' provides to communicate with the monitoring system Prometheus.
+For this purpose the 'Prometheus Python client library' is used.
+   """
+
+   ROBOT_AUTO_KEYWORDS   = False # only decorated methods are keywords
+   ROBOT_LIBRARY_VERSION = LIBRARY_VERSION
+   ROBOT_LIBRARY_SCOPE   = 'GLOBAL'
+
+   # --------------------------------------------------------------------------------------------------------------
+   #TM***
+
+   def __init__(self, port_number=DEFAULT_PORT, message_level=DEFAULT_MESSAGE_LEVEL):
+      self.__sMessageLevel = message_level
+      self.__port_number   = port_number
+
+      # prometheus metric types
+      self.__dictCounter = {}
+      self.__dictGauges  = {}
+      self.__dictInfos   = {}
+
+      start_http_server(self.__port_number)
+
+      # default info metric about this interface library
+      oInfo = Info("Prometheus_interface", "Prometheus interface info")
+      dictInfo = {}
+      dictInfo['file name'] = THISMODULENAME
+      dictInfo['version']   = LIBRARY_VERSION
+      dictInfo['date']      = LIBRARY_VERSION_DATE
+      dictInfo['location']  = self.where_am_i()
+      oInfo.info(dictInfo)
+
+
+   def __del__(self):
+      del self.__dictCounter
+      del self.__dictGauges
+      del self.__dictInfos
+
+   # --------------------------------------------------------------------------------------------------------------
+   # -- library informations
+   # --------------------------------------------------------------------------------------------------------------
+   #TM***
+
+   @keyword
+   def get_version(self):
+      """Returns the version of this interface library
+      """
+      return LIBRARY_VERSION
+
+   @keyword
+   def who_am_i(self):
+      """Returns the full name of this interface library
+      """
+      return THISMODULE
+
+   @keyword
+   def where_am_i(self):
+      """Returns path to this interface library
+      """
+      location = CString.NormalizePath(os.path.dirname(os.path.abspath(__file__)))
+      return location
+
+   @keyword
+   def get_port_number(self):
+      """Returns the port number assigned to this instance of the library
+      """
+      return self.__port_number
+
+
+   # --------------------------------------------------------------------------------------------------------------
+   # -- prometheus metric type 'Info'
+   # --------------------------------------------------------------------------------------------------------------
+   #TM***
+
+   @keyword
+   def add_info(self, name=None, description=None, labels=None):
+      """add_info
+      """
+      success = False
+      result  = "UNKNOWN"
+      if name is None:
+         result = "Parameter 'name' not defined"
+         return success, result
+      if description is None:
+         result = "Parameter 'description' not defined"
+         return success, result
+      if name in self.__dictInfos:
+         result = f"An info with name '{name}' is already defined"
+         return success, result
+      oInfo = None
+      if labels is None:
+         oInfo = Info(name, description)
+      else:
+         labellist = labels.split(';')
+         listLabelNames = []
+         for label in labellist:
+            label = label.strip()
+            listLabelNames.append(label)
+         oInfo = Info(name, description, listLabelNames)
+      self.__dictInfos[name] = oInfo
+      success = True
+      listResults = []
+      listResults.append(f"Info '{name}' added")
+      if labels is not None:
+         listResults.append(f"with labels: '{labels}'")
+      result = " ".join(listResults)
+      return success, result
+
+   @keyword
+   def set_info(self, name=None, info=None, labels=None):
+      """set_info
+      """
+      success = False
+      result  = "UNKNOWN"
+      if name is None:
+         result = "Parameter 'name' not defined"
+         return success, result
+      if info is None:
+         result = "Parameter 'info' not defined"
+         return success, result
+      if name not in self.__dictInfos:
+         result = f"Info '{name}' not defined"
+         return success, result
+      dictInfo = {}
+      list_splitparts = info.split(';')
+      for splitpart in list_splitparts:
+         splitpart = splitpart.strip()
+         list_splitparts2 = splitpart.split(':')
+         if len(list_splitparts2) != 2:
+            success = False
+            result  = "Syntax error in parameter 'info' of '{name}': missing delimiter"
+            return success, result
+         param_name = list_splitparts2[0].strip()
+         if param_name == "":
+            success = False
+            result  = "Syntax error in parameter 'info' of '{name}': parameter name is empty"
+            return success, result
+         param_value = list_splitparts2[1].strip()
+         if param_value == "":
+            success = False
+            result  = "Syntax error in parameter 'info' of '{name}': parameter value is empty"
+            return success, result
+         dictInfo[param_name] = str(param_value)
+      oInfo = self.__dictInfos[name]
+      if labels is None:
+         oInfo.info(dictInfo)
+      else:
+         labellist = labels.split(';')
+         listLabelValues = []
+         for label in labellist:
+            label = label.strip()
+            listLabelValues.append(label)
+         oInfo.labels(*listLabelValues).info(dictInfo)
+      success = True
+      listResults = []
+      listResults.append(f"Info '{name}' set to'{info}'")
+      if labels is not None:
+         listResults.append(f"with labels: '{labels}'")
+      result = " ".join(listResults)
+      return success, result
+
+
+# TODO lighting reaktivieren (as example)
+
+   # # @keyword
+   # # def add_lighting(self):
+      # # """add_lighting (experimental only)
+      # # """
+      # # self.__oLighting = Info('lighting', ': kind of lighting')
+
+   # # @keyword
+   # # def set_daylight(self):
+      # # """set_daylight (experimental only)
+      # # """
+      # # self.__oLighting.info({'lighting' : 'daylight'})
+
+   # # @keyword
+   # # def set_nightlight(self):
+      # # """set_nightlight (experimental only)
+      # # """
+      # # self.__oLighting.info({'lighting' : 'nightlight'})
+
+
+   # --------------------------------------------------------------------------------------------------------------
+   # -- prometheus metric type 'Counter'
+   # --------------------------------------------------------------------------------------------------------------
+   #TM***
+
+   @keyword
+   def add_counter(self, name=None, description=None, labels=None):
+      """This keyword adds a new counter. The values of existing counters can be changed with ``inc_counter``.
+
+**Arguments:**
+
+* ``name``
+
+  The name of the new counter
+
+  / *Condition*: required / *Type*: str /
+
+* ``description``
+
+  The description of the new counter
+
+  / *Condition*: required / *Type*: str /
+
+* ``labels``
+
+  A semicolon separated list of label names assigned to the new counter
+
+  / *Condition*: optional / *Type*: str  / *Default*: None /
+
+**Returns:**
+
+* ``success``
+
+  / *Type*: bool /
+
+  Indicates if the computation of the keyword was successful or not
+
+* ``result``
+
+  / *Type*: str /
+
+  The result of the computation of the keyword
+      """
+      success = False
+      result  = "UNKNOWN"
+      if name is None:
+         result = "Parameter 'name' not defined"
+         return success, result
+      if description is None:
+         result = "Parameter 'description' not defined"
+         return success, result
+      if name in self.__dictCounter:
+         result = f"A counter with name '{name}' is already defined"
+         return success, result
+      oCounter = None
+      if labels is None:
+         oCounter = Counter(name, description)
+      else:
+         labellist = labels.split(';')
+         listLabelNames = []
+         for label in labellist:
+            label = label.strip()
+            listLabelNames.append(label)
+         oCounter = Counter(name, description, listLabelNames)
+      self.__dictCounter[name] = oCounter
+      success = True
+      listResults = []
+      listResults.append(f"Counter '{name}' added")
+      if labels is not None:
+         listResults.append(f"with labels: '{labels}'")
+      result = " ".join(listResults)
+      return success, result
+   # eof def add_counter(...):
+
+   @keyword
+   def inc_counter(self, name=None, value=None, labels=None):
+      """This keyword increments a counter. The counter has to be added with '``add_counter``' before.
+
+**Arguments:**
+
+* ``name``
+
+  The name of the counter
+
+  / *Condition*: required / *Type*: str /
+
+* ``value``
+
+  The value of increment. If not given, the value of the counter is incremented by value 1.
+
+  / *Condition*: optional / *Type*: int  / *Default*: None /
+
+* ``labels``
+
+  A semicolon separated list of labels assigned to the counter. The order of labels must fit to the order of label names like defined in ``add_counter``.
+
+  / *Condition*: optional / *Type*: str  / *Default*: None /
+
+**Returns:**
+
+* ``success``
+
+  / *Type*: bool /
+
+  Indicates if the computation of the keyword was successful or not
+
+* ``result``
+
+  / *Type*: str /
+
+  The result of the computation of the keyword
+      """
+      success = False
+      result  = "UNKNOWN"
+      if name is None:
+         result = "Parameter 'name' not defined"
+         return success, result
+      if name not in self.__dictCounter:
+         result = f"Counter '{name}' not defined"
+         return success, result
+      if value is not None:
+         try:
+            value = int(value)
+         except Exception as ex:
+            success = False
+            result  = str(ex)
+            return success, result
+      oCounter = self.__dictCounter[name]
+      if labels is None:
+         if value is None:
+            oCounter.inc()
+         else:
+            oCounter.inc(value)
+      else:
+         labellist = labels.split(';')
+         listLabelValues = []
+         for label in labellist:
+            label = label.strip()
+            listLabelValues.append(label)
+         if value is None:
+            oCounter.labels(*listLabelValues).inc()
+         else:
+            oCounter.labels(*listLabelValues).inc(value)
+      success = True
+      listResults = []
+      listResults.append(f"Counter '{name}' incremented")
+      if value is not None:
+         listResults.append(f"by value '{value}'")
+      if labels is not None:
+         listResults.append(f"with labels: '{labels}'")
+      result = " ".join(listResults)
+      return success, result
+   # eof def inc_counter(...):
+
+
+   # --------------------------------------------------------------------------------------------------------------
+   # -- prometheus metric type 'Gauge'
+   # --------------------------------------------------------------------------------------------------------------
+   #TM***
+
+   @keyword
+   def add_gauge(self, name=None, description=None, labels=None):
+      """This keyword adds a new gauge. The values of existing gauges can be changed with ``set_gauge``, ``inc_gauge`` and ``dec_gauge``.
+
+**Arguments:**
+
+* ``name``
+
+  The name of the new gauge
+
+  / *Condition*: required / *Type*: str /
+
+* ``description``
+
+  The description of the new gauge
+
+  / *Condition*: required / *Type*: str /
+
+* ``labels``
+
+  A semicolon separated list of label names assigned to the new gauge
+
+  / *Condition*: optional / *Type*: str  / *Default*: None /
+
+**Returns:**
+
+* ``success``
+
+  / *Type*: bool /
+
+  Indicates if the computation of the keyword was successful or not
+
+* ``result``
+
+  / *Type*: str /
+
+  The result of the computation of the keyword
+      """
+      success = False
+      result  = "UNKNOWN"
+      if name is None:
+         result = "Parameter 'name' not defined"
+         return success, result
+      if description is None:
+         result = "Parameter 'description' not defined"
+         return success, result
+      if name in self.__dictGauges:
+         result = f"A gauge with name '{name}' is already defined"
+         return success, result
+      oGauge = None
+      if labels is None:
+         oGauge = Gauge(name, description)
+      else:
+         labellist = labels.split(';')
+         listLabelNames = []
+         for label in labellist:
+            label = label.strip()
+            listLabelNames.append(label)
+         oGauge = Gauge(name, description, listLabelNames)
+      self.__dictGauges[name] = oGauge
+      success = True
+      listResults = []
+      listResults.append(f"Gauge '{name}' added")
+      if labels is not None:
+         listResults.append(f"with labels: '{labels}'")
+      result = " ".join(listResults)
+      return success, result
+   # eof def add_gauge(...):
+
+   @keyword
+   def set_gauge(self, name=None, value=None, labels=None):
+      """This keyword sets the value for a gauge. The gauge has to be added with '``add_gauge``' before.
+
+**Arguments:**
+
+* ``name``
+
+  The name of the gauge
+
+  / *Condition*: required / *Type*: str /
+
+* ``value``
+
+  The new value of the gauge.
+
+  / *Condition*: optional / *Type*: int  / *Default*: None /
+
+* ``labels``
+
+  A semicolon separated list of labels assigned to the gauge. The order of labels must fit to the order of label names like defined in ``add_gauge``.
+
+  / *Condition*: optional / *Type*: str  / *Default*: None /
+
+**Returns:**
+
+* ``success``
+
+  / *Type*: bool /
+
+  Indicates if the computation of the keyword was successful or not
+
+* ``result``
+
+  / *Type*: str /
+
+  The result of the computation of the keyword
+      """
+      success = False
+      result  = "UNKNOWN"
+      if name is None:
+         result = "Parameter 'name' not defined"
+         return success, result
+      if name not in self.__dictGauges:
+         result = f"Gauge '{name}' not defined"
+         return success, result
+      if value is None:
+         result = "Parameter 'value' not defined"
+         return success, result
+      else:
+         try:
+            value = int(value)
+         except Exception as ex:
+            success = False
+            result  = str(ex)
+            return success, result
+      oGauge = self.__dictGauges[name]
+      if labels is None:
+         oGauge.set(value)
+      else:
+         labellist = labels.split(';')
+         listLabelValues = []
+         for label in labellist:
+            label = label.strip()
+            listLabelValues.append(label)
+         oGauge.labels(*listLabelValues).set(value)
+      success = True
+      listResults = []
+      listResults.append(f"Gauge '{name}' set to value '{value}'")
+      if labels is not None:
+         listResults.append(f"with labels: '{labels}'")
+      result = " ".join(listResults)
+      return success, result
+   # eof def set_gauge(...):
+
+   @keyword
+   def inc_gauge(self, name=None, value=None, labels=None):
+      """This keyword increments a gauge. The gauge has to be added with '``add_gauge``' before.
+
+**Arguments:**
+
+* ``name``
+
+  The name of the gauge
+
+  / *Condition*: required / *Type*: str /
+
+* ``value``
+
+  The value of increment. If not given, the value of the gauge is incremented by value 1.
+
+  / *Condition*: optional / *Type*: int  / *Default*: None /
+
+* ``labels``
+
+  A semicolon separated list of labels assigned to the gauge. The order of labels must fit to the order of label names like defined in ``add_gauge``.
+
+  / *Condition*: optional / *Type*: str  / *Default*: None /
+
+**Returns:**
+
+* ``success``
+
+  / *Type*: bool /
+
+  Indicates if the computation of the keyword was successful or not
+
+* ``result``
+
+  / *Type*: str /
+
+  The result of the computation of the keyword
+      """
+      success = False
+      result  = "UNKNOWN"
+      if name is None:
+         result = "Parameter 'name' not defined"
+         return success, result
+      if name not in self.__dictGauges:
+         result = f"Gauge '{name}' not defined"
+         return success, result
+      if value is not None:
+         try:
+            value = int(value)
+         except Exception as ex:
+            success = False
+            result  = str(ex)
+            return success, result
+      oGauge = self.__dictGauges[name]
+      if labels is None:
+         if value is None:
+            oGauge.inc()
+         else:
+            oGauge.inc(value)
+      else:
+         labellist = labels.split(';')
+         listLabelValues = []
+         for label in labellist:
+            label = label.strip()
+            listLabelValues.append(label)
+         if value is None:
+            oGauge.labels(*listLabelValues).inc()
+         else:
+            oGauge.labels(*listLabelValues).inc(value)
+      success = True
+      listResults = []
+      listResults.append(f"Gauge '{name}' incremented")
+      if value is not None:
+         listResults.append(f"by value '{value}'")
+      if labels is not None:
+         listResults.append(f"with labels: '{labels}'")
+      result = " ".join(listResults)
+      return success, result
+   # eof def inc_gauge(...):
+
+   @keyword
+   def dec_gauge(self, name=None, value=None, labels=None):
+      """This keyword decrements a gauge. The gauge has to be added with '``add_gauge``' before.
+
+**Arguments:**
+
+* ``name``
+
+  The name of the gauge
+
+  / *Condition*: required / *Type*: str /
+
+* ``value``
+
+  The value of decrement. If not given, the value of the gauge is decremented by value 1.
+
+  / *Condition*: optional / *Type*: int  / *Default*: None /
+
+* ``labels``
+
+  A semicolon separated list of labels assigned to the gauge. The order of labels must fit to the order of label names like defined in ``add_gauge``.
+
+  / *Condition*: optional / *Type*: str  / *Default*: None /
+
+**Returns:**
+
+* ``success``
+
+  / *Type*: bool /
+
+  Indicates if the computation of the keyword was successful or not
+
+* ``result``
+
+  / *Type*: str /
+
+  The result of the computation of the keyword
+      """
+      success = False
+      result  = "UNKNOWN"
+      if name is None:
+         result = "Parameter 'name' not defined"
+         return success, result
+      if name not in self.__dictGauges:
+         result = f"Gauge '{name}' not defined"
+         return success, result
+      if value is not None:
+         try:
+            value = int(value)
+         except Exception as ex:
+            success = False
+            result  = str(ex)
+            return success, result
+      oGauge = self.__dictGauges[name]
+      if labels is None:
+         if value is None:
+            oGauge.dec()
+         else:
+            oGauge.dec(value)
+      else:
+         labellist = labels.split(';')
+         listLabelValues = []
+         for label in labellist:
+            label = label.strip()
+            listLabelValues.append(label)
+         if value is None:
+            oGauge.labels(*listLabelValues).dec()
+         else:
+            oGauge.labels(*listLabelValues).dec(value)
+      success = True
+      listResults = []
+      listResults.append(f"Gauge '{name}' decremented")
+      if value is not None:
+         listResults.append(f"by value '{value}'")
+      if labels is not None:
+         listResults.append(f"with labels: '{labels}'")
+      result = " ".join(listResults)
+      return success, result
+   # eof def dec_gauge(...):
+
+
+# eof class prometheus_interface():
+

robotframework-prometheus-0.6.1/README.rst

@@ -0,0 +1,73 @@
+.. Copyright 2020-2024 Robert Bosch GmbH
+
+.. Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+Package Description
+===================
+
+The interface library **prometheus_interface** provides Robot Framework keywords to communicate with the monitoring system **Prometheus**.
+
+
+Currently this library is under development. We work on it. But what is available up to now, is not ready for being used in productive systems
+(but hopefully will be in near future).
+
+
+
+Package Documentation
+---------------------
+
+A (growing) detailed documentation of the **prometheus_interface** can be found here:
+
+`PrometheusInterface.pdf <https://github.com/test-fullautomation/robotframework-prometheus/blob/develop/PrometheusInterface/PrometheusInterface.pdf>`_
+
+Feedback
+--------
+
+To give us a feedback, you can send an email to `Thomas Pollerspöck <mailto:Thomas.Pollerspoeck@de.bosch.com>`_
+
+In case you want to report a bug or request any interesting feature, please don't hesitate to raise a ticket.
+
+Maintainers
+-----------
+
+`Holger Queckenstedt <mailto:Holger.Queckenstedt@de.bosch.com>`_
+
+`Thomas Pollerspöck <mailto:Thomas.Pollerspoeck@de.bosch.com>`_
+
+Contributors
+------------
+
+`Holger Queckenstedt <mailto:Holger.Queckenstedt@de.bosch.com>`_
+
+`Thomas Pollerspöck <mailto:Thomas.Pollerspoeck@de.bosch.com>`_
+
+License
+-------
+
+Copyright 2020-2024 Robert Bosch GmbH
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    |License: Apache v2|
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+
+.. |License: Apache v2| image:: https://img.shields.io/pypi/l/robotframework.svg
+   :target: http://www.apache.org/licenses/LICENSE-2.0.html

robotframework-prometheus-0.6.1/robotframework_prometheus.egg-info/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.1
+Name: robotframework-prometheus
+Version: 0.6.1
+Summary: Additional Robot Framework keywords
+Home-page: https://github.com/test-fullautomation/robotframework-prometheus
+Author: Holger Queckenstedt
+Author-email: Holger.Queckenstedt@de.bosch.com
+License: UNKNOWN
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development
+Requires-Python: >=3.0
+Description-Content-Type: text/markdown
+
+Package Description
+===================
+
+The interface library **prometheus\_interface** provides Robot Framework
+keywords to communicate with the monitoring system **Prometheus**.
+
+Currently this library is under development. We work on it. But what is
+available up to now, is not ready for being used in productive systems
+(but hopefully will be in near future).
+
+Package Documentation
+---------------------
+
+A (growing) detailed documentation of the **prometheus\_interface** can
+be found here:
+
+[PrometheusInterface.pdf](https://github.com/test-fullautomation/robotframework-prometheus/blob/develop/PrometheusInterface/PrometheusInterface.pdf)
+
+Feedback
+--------
+
+To give us a feedback, you can send an email to [Thomas
+Pollerspöck](mailto:Thomas.Pollerspoeck@de.bosch.com)
+
+In case you want to report a bug or request any interesting feature,
+please don\'t hesitate to raise a ticket.
+
+Maintainers
+-----------
+
+[Holger Queckenstedt](mailto:Holger.Queckenstedt@de.bosch.com)
+
+[Thomas Pollerspöck](mailto:Thomas.Pollerspoeck@de.bosch.com)
+
+Contributors
+------------
+
+[Holger Queckenstedt](mailto:Holger.Queckenstedt@de.bosch.com)
+
+[Thomas Pollerspöck](mailto:Thomas.Pollerspoeck@de.bosch.com)
+
+License
+-------
+
+Copyright 2020-2024 Robert Bosch GmbH
+
+Licensed under the Apache License, Version 2.0 (the \"License\"); you
+may not use this file except in compliance with the License. You may
+obtain a copy of the License at
+
+> [![License: Apache
+> v2](https://img.shields.io/pypi/l/robotframework.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an \"AS IS\" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+

robotframework-prometheus-0.6.1/robotframework_prometheus.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.rst
+setup.py
+PrometheusInterface/PrometheusInterface.pdf
+PrometheusInterface/__init__.py
+PrometheusInterface/prometheus_interface.py
+robotframework_prometheus.egg-info/PKG-INFO
+robotframework_prometheus.egg-info/SOURCES.txt
+robotframework_prometheus.egg-info/dependency_links.txt
+robotframework_prometheus.egg-info/requires.txt
+robotframework_prometheus.egg-info/top_level.txt

robotframework-prometheus-0.6.1/robotframework_prometheus.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

robotframework-prometheus-0.6.1/robotframework_prometheus.egg-info/requires.txt

@@ -0,0 +1,3 @@
+PythonExtensionsCollection
+robotframework
+prometheus-client

robotframework-prometheus-0.6.1/robotframework_prometheus.egg-info/top_level.txt

@@ -0,0 +1 @@
+PrometheusInterface

robotframework-prometheus-0.6.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

robotframework-prometheus-0.6.1/setup.py

@@ -0,0 +1,224 @@
+# **************************************************************************************************************
+#
+#  Copyright 2020-2024 Robert Bosch GmbH
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+#
+# **************************************************************************************************************
+#
+# setup.py
+#
+# XC-HWP/ESW3-Queckenstedt
+#
+# Extends the standard setuptools installation by adding the documentation in PDF format
+# (requires installation mode) and tidying up some folders.
+#
+# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+#
+# This script deletes folders (as defined in config.CRepositoryConfig, depending on the position of this script):
+# - previous builds within this repository
+# - previous installations within
+#   * <Python installation>\Lib\site-packages (Windows)
+#   * <Python installation>/../lib/python3.9/site-packages (Linux)
+#
+# before the build and the installation start again!
+#
+#                                         !!! USE WITH CAUTION !!!
+#
+# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+#
+# --------------------------------------------------------------------------------------------------------------
+#
+# * Hints:
+#
+# The usual
+#    packages = setuptools.find_packages(),
+# is replaced by
+#    packages = [str(oRepositoryConfig.Get('PACKAGENAME')), ],
+# to avoid that also config.CRepositoryConfig() and additions.CExtendedSetup() are part of the distribution.
+# CRepositoryConfig and CExtendedSetup() are only repository internal helper.
+#
+# * Known issues:
+#
+#   - setuptools do not properly update an existing package installation under <Python installation>\Lib\site-packages\<package name>!
+#     > Files modified manually within installation folder, are still modified after repeated execution of setuptools.
+#     > Files added manually within installation folder, are still present there after repeated execution of setuptools.
+#     > Only files deleted manually within installation folder, are are restored there after repeated execution of setuptools.
+#   - No such issues with <Python installation>\Lib\site-packages\<package name>-<versions>.egg-info.
+#   - Solution: explicit deletion of all previous output (all documentation-, build- and installation-folder, except the egg-info folder)
+#     (see 'delete_previous_build()' and 'delete_previous_installation()')
+#
+# --------------------------------------------------------------------------------------------------------------
+#
+# 24.06.2022
+#
+# --------------------------------------------------------------------------------------------------------------
+
+import os, sys, platform, shlex, subprocess
+import setuptools
+from setuptools.command.install import install
+
+# prefer the repository local version of all additional libraries (instead of the installed version under site-packages)
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "./additions")))
+
+from config.CRepositoryConfig import CRepositoryConfig # providing repository and environment specific information
+from additions.CExtendedSetup import CExtendedSetup # providing functions to support the extended setup process
+
+import colorama as col
+
+col.init(autoreset=True)
+
+COLBR = col.Style.BRIGHT + col.Fore.RED
+COLBY = col.Style.BRIGHT + col.Fore.YELLOW
+COLBG = col.Style.BRIGHT + col.Fore.GREEN
+
+SUCCESS = 0
+ERROR   = 1
+
+# --------------------------------------------------------------------------------------------------------------
+
+def printerror(sMsg):
+    sys.stderr.write(COLBR + f"Error: {sMsg}!\n")
+
+def printexception(sMsg):
+    sys.stderr.write(COLBR + f"Exception: {sMsg}!\n")
+
+# --------------------------------------------------------------------------------------------------------------
+
+class ExtendedInstallCommand(install):
+    """Extended setup for installation mode."""
+
+    def run(self):
+
+        listCmdArgs = sys.argv
+        if ( ('install' in listCmdArgs) or ('build' in listCmdArgs) or ('sdist' in listCmdArgs) or ('bdist_wheel' in listCmdArgs) ):
+            install.run(self)
+        return SUCCESS
+
+# eof class ExtendedInstallCommand(install):
+
+# --------------------------------------------------------------------------------------------------------------
+
+# -- Even in case of other command line parameters than 'install' or 'build' are used we need the following objects.
+#    (Without repository configuration commands like '--author-email' would not be possible)
+
+# -- setting up the repository configuration
+oRepositoryConfig = None
+try:
+    oRepositoryConfig = CRepositoryConfig(os.path.abspath(sys.argv[0]))
+except Exception as ex:
+    print()
+    printexception(str(ex))
+    print()
+    sys.exit(ERROR)
+
+# -- setting up the extended setup
+oExtendedSetup = None
+try:
+    oExtendedSetup = CExtendedSetup(oRepositoryConfig)
+except Exception as ex:
+    print()
+    printexception(str(ex))
+    print()
+    sys.exit(ERROR)
+
+# --------------------------------------------------------------------------------------------------------------
+
+long_description = "long description" # variable is required even in case of other command line parameters than 'install' or 'build' are used
+
+listCmdArgs = sys.argv
+if ( ('install' in listCmdArgs) or ('build' in listCmdArgs) or ('sdist' in listCmdArgs) or ('bdist_wheel' in listCmdArgs) ):
+    print()
+    print(COLBY + "Entering extended installation")
+    print()
+
+    print(COLBY + "Extended setup step 1/5: Calling the documentation builder")
+    print()
+
+    nReturn = oExtendedSetup.genpackagedoc()
+    if nReturn != SUCCESS:
+        sys.exit(nReturn)
+
+    print(COLBY + "Extended setup step 2/5: Converting the repository README")
+    print()
+
+    nReturn = oExtendedSetup.convert_repo_readme()
+    if nReturn != SUCCESS:
+        sys.exit(nReturn)
+
+    print(COLBY + "Extended setup step 3/5: Deleting previous setup outputs (build, dist, <package name>.egg-info within repository)")
+    print()
+
+    nReturn = oExtendedSetup.delete_previous_build()
+    if nReturn != SUCCESS:
+        sys.exit(nReturn)
+
+    if ( ('bdist_wheel' in listCmdArgs) or ('build' in listCmdArgs) ):
+        print()
+        print(COLBY + "Skipping extended setup step 4/5: Deleting previous package installation folder within site-packages")
+        print()
+    else:
+        print()
+        print(COLBY + "Extended setup step 4/5: Deleting previous package installation folder within site-packages") # (<package name> and <package name>_doc under <Python installation>\Lib\site-packages
+        print()
+        nReturn = oExtendedSetup.delete_previous_installation()
+        if nReturn != SUCCESS:
+            sys.exit(nReturn)
+
+    README_MD = str(oRepositoryConfig.Get('README_MD'))
+    with open(README_MD, "r", encoding="utf-8") as fh:
+        long_description = fh.read()
+    fh.close()
+
+# --------------------------------------------------------------------------------------------------------------
+
+# -- the 'setup' itself
+
+print(COLBY + "Extended setup step 5/5: install.run(self)")
+print()
+
+setuptools.setup(
+    name         = str(oRepositoryConfig.Get('REPOSITORYNAME')),
+    version      = str(oRepositoryConfig.Get('PACKAGEVERSION')),
+    author       = str(oRepositoryConfig.Get('AUTHOR')),
+    author_email = str(oRepositoryConfig.Get('AUTHOREMAIL')),
+    description  = str(oRepositoryConfig.Get('DESCRIPTION')),
+    long_description = long_description,
+    long_description_content_type = str(oRepositoryConfig.Get('LONGDESCRIPTIONCONTENTTYPE')),
+    url = str(oRepositoryConfig.Get('URL')),
+    packages = [str(oRepositoryConfig.Get('PACKAGENAME')),],
+    package_dir = {str(oRepositoryConfig.Get('REPOSITORYNAME')) : str(oRepositoryConfig.Get('PACKAGENAME'))},
+    classifiers = [
+        str(oRepositoryConfig.Get('PROGRAMMINGLANGUAGE')),
+        str(oRepositoryConfig.Get('LICENCE')),
+        str(oRepositoryConfig.Get('OPERATINGSYSTEM')),
+        str(oRepositoryConfig.Get('DEVELOPMENTSTATUS')),
+        str(oRepositoryConfig.Get('INTENDEDAUDIENCE')),
+        str(oRepositoryConfig.Get('TOPIC')),
+    ],
+    python_requires = str(oRepositoryConfig.Get('PYTHONREQUIRES')),
+    cmdclass={
+        'install': ExtendedInstallCommand,
+    },
+    install_requires = oRepositoryConfig.Get('INSTALLREQUIRES'),
+    package_data={f"{oRepositoryConfig.Get('PACKAGENAME')}" : oRepositoryConfig.Get('PACKAGEDATA')},
+)
+
+# --------------------------------------------------------------------------------------------------------------
+
+print()
+print(COLBG + "Extended installation done")
+print()
+
+# --------------------------------------------------------------------------------------------------------------
+