{ "info": { "author": "Yaroslav Polyakov", "author_email": "xenon@sysattack.com", "bugtrack_url": null, "classifiers": [], "description": "# okerrupdate - simple interface to update okerr indicator\n\n## Simplest \n\nReads textid and secret from default config file (/etc/okerrclient.conf), updates heartbeat indicator 'test:1' with status OK. If no such indicator - creates it (if policy allows autocreate). \n~~~\n#!/usr/bin/python\nimport okerrupdate\nop = okerrupdate.OkerrProject()\ni = op.indicator(\"test:1\")\ni.update('OK')\n~~~\n\n\n## More detailed\n\nSets verbose mode. Sets textid and secret from script. Creates numerical indicator and sets parameters for it, then updates it.\n~~~\n#!/usr/bin/python\nimport okerrupdate\n\n# create okerr project\nop = okerrupdate.OkerrProject('MyTextID', 'MySecret1')\nop.verbose()\n\n# create indicator\ni = op.indicator(\"test:1\", method='numerical|maxlim=37')\ni.update('36.6', 'Current temperature is normal')\n~~~\n\n# Classes and Methods\n\n## OkerrProject\n\n~~~\ndef __init__(self, textid=None, secret=None, url=None, dry_run=False, config=None):\n~~~\n\nIf textid not specified, read_config() method used. \n\n- textid - project textid\n- secret - secret key to update indicators\n- url - URL of server (You dont need to use it in most cases)\n- dry_run - if True, no indicators will be updated\n- config - filename of okerrclient.conf file\n\n~~~\ndef read_config(self, filename=None):\n~~~\nReads textid and secret from config file *filename* (default: /etc/okerrclient.conf). \n\n\n~~~\ndef setloglevel(self,lvl):\n self.log.setLevel(lvl)\n \ndef verbose(self):\n self.setloglevel(logging.DEBUG)\n\ndef setlog(self, log):\n self.log = log\n~~~\n\nCan be used to configure logging\n\n~~~\ndef indicator(self, name, secret=None, method=None, policy=None, tags=None, error=None, origkeypath=None, keypath=None):\n~~~\nMost important method. Returns OkerrIndicator project with this parameters.\n\n## OkerrIndicator\n~~~\ndef __init__(self, name, project, secret=None, method=None, policy=None, tags=None, error=None, origkeypath=None, keypath=None):\n~~~\nUsually not used directly, OkerrProject.indicator() will create it.\n\n~~~\ndef update(self, status, details=None):\n~~~\nUpdates indicator. Raises OkerrExc exception if any problem. Requests exceptions are catched inside method and OkerrExc is raised.\n\nSkips update if less then 300 seconds passed since last update. (So, it's safe to call it in quick loop, it will handle throttling itself)\n\n## OkerrExc\nDummy class for exceptions. Use it to catch any exception. Snippet from okerrupdate code:\n~~~\nclass OkerrExc(Exception):\n pass\n~~~\n\n## Examples\n~~~\nfrom okerrupdate import OkerrProject, OkerrExc\n\nop = OkerrProject() # textid and secret not specified, will be read from /etc/okerrclient.conf\nop.verbose()\ni = op.indicator('testindicator', method='numerical|minlim=0|maxlim=100')\n\ntry:\n i.update(80)\nexcept OkerrExc as e:\n print(\"Got OkerrExc: {}\".format(e))\n~~~", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://okerr.com/", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "okerrupdate", "package_url": "https://pypi.org/project/okerrupdate/", "platform": "", "project_url": "https://pypi.org/project/okerrupdate/", "project_urls": { "Homepage": "http://okerr.com/" }, "release_url": "https://pypi.org/project/okerrupdate/1.1.13/", "requires_dist": null, "requires_python": "", "summary": "micro client for okerr cloud monitoring system", "version": "1.1.13" }, "last_serial": 4680757, "releases": { "1.0": [ { "comment_text": "", "digests": { "md5": "39f8b85b3b25e6dc010e83100a2f3f46", "sha256": "db26967b5bc3946367a0365188f34b718ac56dbc82a42fbf1fe023b63f893c26" }, "downloads": -1, "filename": "okerrupdate-1.0.tar.gz", "has_sig": false, "md5_digest": "39f8b85b3b25e6dc010e83100a2f3f46", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3262, "upload_time": "2018-03-11T12:47:55", "url": "https://files.pythonhosted.org/packages/4a/fd/c6a7d943547b490e0ef29265c2b043fcfe1ea5ccbf1ce49d9fd2ecfb7045/okerrupdate-1.0.tar.gz" } ], "1.1": [ { "comment_text": "", "digests": { "md5": "d2827fcac21d3424d1bc489ac4dd57f3", "sha256": "d4e498be548cf8588d951965654c9dbc904065a55fb40f45ec7d29a72edb08da" }, "downloads": -1, "filename": "okerrupdate-1.1.tar.gz", "has_sig": false, "md5_digest": "d2827fcac21d3424d1bc489ac4dd57f3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3385, "upload_time": "2018-03-11T14:53:50", "url": "https://files.pythonhosted.org/packages/ed/1c/f94a63c6ea3b3b892b00255b202036cd332d25bf440044438974f5bec214/okerrupdate-1.1.tar.gz" } ], "1.1.1": [ { "comment_text": "", "digests": { "md5": "932a8721afd40b6bb80174a03c6fe429", "sha256": "a2552171667c8f661ea6e49f24a66e6a6ee9a7cf1fa7a1f081bf48be4f67c4c9" }, "downloads": -1, "filename": "okerrupdate-1.1.1.tar.gz", "has_sig": false, "md5_digest": "932a8721afd40b6bb80174a03c6fe429", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3395, "upload_time": "2018-03-11T14:56:55", "url": "https://files.pythonhosted.org/packages/49/78/0e4e141f91acada13016112fe40b4fd2e3d5d2ddd3d28d1f90cb77ebbc72/okerrupdate-1.1.1.tar.gz" } ], "1.1.10": [ { "comment_text": "", "digests": { "md5": "d240620a9e2ea6858f14ac2479cd0748", "sha256": "0daf979100b2b14fd3a922f2f73b4b945b9ae9240b97bc54b612baf636c772fb" }, "downloads": -1, "filename": "okerrupdate-1.1.10.tar.gz", "has_sig": false, "md5_digest": "d240620a9e2ea6858f14ac2479cd0748", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4170, "upload_time": "2018-09-25T12:30:47", "url": "https://files.pythonhosted.org/packages/33/5d/4fb0541bf00bbe10c1ef9b546bf7113ac0f4f887dbdb47750830c9355345/okerrupdate-1.1.10.tar.gz" } ], "1.1.11": [ { "comment_text": "", "digests": { "md5": "281aad9448a71e8e3f15b3245b6cd8ff", "sha256": "9cfec5f2c8dcf63d775f644d3e6124f01c1e18c0bc4066ad12bdf5919aecaaab" }, "downloads": -1, "filename": "okerrupdate-1.1.11.tar.gz", "has_sig": false, "md5_digest": "281aad9448a71e8e3f15b3245b6cd8ff", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4279, "upload_time": "2018-10-04T08:53:44", "url": "https://files.pythonhosted.org/packages/80/6e/2fd7b1c02985a3a9c589f975cb1cbc6c0b39446f59cf2d0ebc4c55b96dc2/okerrupdate-1.1.11.tar.gz" } ], "1.1.12": [ { "comment_text": "", "digests": { "md5": "d32d152b6e4dd40b3fa13521a82868b0", "sha256": "7d575a5c9a8c7c70221a402d306312d9e13cc9179b85a72848d7b2aa426f2f1f" }, "downloads": -1, "filename": "okerrupdate-1.1.12.tar.gz", "has_sig": false, "md5_digest": "d32d152b6e4dd40b3fa13521a82868b0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5056, "upload_time": "2018-10-04T09:39:41", "url": "https://files.pythonhosted.org/packages/5f/9d/1446942d530b4f711ce916cb241e44984cb61dd2b2efe4f66663f24be3a6/okerrupdate-1.1.12.tar.gz" } ], "1.1.13": [ { "comment_text": "", "digests": { "md5": "a31f1ccb14b2231d679d5b27d4020e3b", "sha256": "a64c087e9f835b22f14ff91bb62abe5023afb37188635b6c47312b3ae3dc2d67" }, "downloads": -1, "filename": "okerrupdate-1.1.13.tar.gz", "has_sig": false, "md5_digest": "a31f1ccb14b2231d679d5b27d4020e3b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5077, "upload_time": "2019-01-10T11:35:00", "url": "https://files.pythonhosted.org/packages/02/3d/ce450602a8139921e9c984208ed9e3123ee7dae6ffd6d5034d908783a8bb/okerrupdate-1.1.13.tar.gz" } ], "1.1.2": [ { "comment_text": "", "digests": { "md5": "1e4078a166c028eeebca47bc7053875a", "sha256": "0c3ea63a70ca339978ef4cb61603f068308c7f45cf7f0adc4b08114200a15ebb" }, "downloads": -1, "filename": "okerrupdate-1.1.2.tar.gz", "has_sig": false, "md5_digest": "1e4078a166c028eeebca47bc7053875a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3397, "upload_time": "2018-03-11T15:01:09", "url": "https://files.pythonhosted.org/packages/38/fc/3c344bb11a8eb8ffb1f2a24eb0ccdc6b24acae0f5201da4bdaf8689f50b1/okerrupdate-1.1.2.tar.gz" } ], "1.1.3": [ { "comment_text": "", "digests": { "md5": "b284d6d406915bcc8c9986c2577046b6", "sha256": "cd51863df9b627d8be6fc149eec586a005eccd00235c69d4c69c050e290f19da" }, "downloads": -1, "filename": "okerrupdate-1.1.3.tar.gz", "has_sig": false, "md5_digest": "b284d6d406915bcc8c9986c2577046b6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3368, "upload_time": "2018-03-11T15:12:44", "url": "https://files.pythonhosted.org/packages/7e/f1/a43b73fc353f3edebafdb97a179c9a5c337e959fd904b937180d9df92a24/okerrupdate-1.1.3.tar.gz" } ], "1.1.4": [ { "comment_text": "", "digests": { "md5": "7ce005893653cad0d39ef41009d3864a", "sha256": "688cec3dd056c60ab14bb27bd0db4278111bc7ee6aa3ff4ee368fcf589f65b94" }, "downloads": -1, "filename": "okerrupdate-1.1.4.tar.gz", "has_sig": false, "md5_digest": "7ce005893653cad0d39ef41009d3864a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3548, "upload_time": "2018-03-12T19:32:19", "url": "https://files.pythonhosted.org/packages/d3/fa/daa1d3b91c7158f441e97da9fbecf6b3e731bc135332b349b510a564baa0/okerrupdate-1.1.4.tar.gz" } ], "1.1.5": [ { "comment_text": "", "digests": { "md5": "2c61ceb4dc809444b59ba70c8696c97a", "sha256": "4bf7d6e0a1b9c6c79b79993d21073ab65fb63840a3635943aa4d231b588ffce6" }, "downloads": -1, "filename": "okerrupdate-1.1.5.tar.gz", "has_sig": false, "md5_digest": "2c61ceb4dc809444b59ba70c8696c97a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4032, "upload_time": "2018-03-30T13:58:41", "url": "https://files.pythonhosted.org/packages/54/38/adcc9d497775170a6aea0e01c9aca2305f2caa65ff6b5dc39c70ec2938f3/okerrupdate-1.1.5.tar.gz" } ], "1.1.6": [ { "comment_text": "", "digests": { "md5": "7f82cdb0a055822dc31fa852a8c332db", "sha256": "6314277b4392d84c24f44f60688bde3a741b20f1ccdd2e874796833a93025c47" }, "downloads": -1, "filename": "okerrupdate-1.1.6.tar.gz", "has_sig": false, "md5_digest": "7f82cdb0a055822dc31fa852a8c332db", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4123, "upload_time": "2018-05-01T11:58:34", "url": "https://files.pythonhosted.org/packages/75/5b/1f37f9b86e359fa3f83243c0f12e8b61f3cd6ce778379b73de24e179d3d9/okerrupdate-1.1.6.tar.gz" } ], "1.1.7": [ { "comment_text": "", "digests": { "md5": "f359d27e79714d55197e10cee5615c1f", "sha256": "8427ddf7b2e1eaa738a15e3e93eb7a6f52500d41e5c761748fecc2b282b9ba60" }, "downloads": -1, "filename": "okerrupdate-1.1.7.tar.gz", "has_sig": false, "md5_digest": "f359d27e79714d55197e10cee5615c1f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4131, "upload_time": "2018-05-01T19:18:19", "url": "https://files.pythonhosted.org/packages/fb/11/3fdb1da3d87dc9235960778ce4a908191b56990d3e9dde0c1b2fb7d4329f/okerrupdate-1.1.7.tar.gz" } ], "1.1.8": [ { "comment_text": "", "digests": { "md5": "672bdce1cc71610b688b31d056235ca5", "sha256": "f755bf82c7479fdd6ce393a755b4b187d34174bf05bb0d7c46beee54a4352728" }, "downloads": -1, "filename": "okerrupdate-1.1.8.tar.gz", "has_sig": false, "md5_digest": "672bdce1cc71610b688b31d056235ca5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4151, "upload_time": "2018-09-25T11:16:30", "url": "https://files.pythonhosted.org/packages/70/69/0d44b65c854a9498a00ed407dd2000c587cc2ea1fead4870ae9bf4e41b99/okerrupdate-1.1.8.tar.gz" } ], "1.1.9": [ { "comment_text": "", "digests": { "md5": "6d8030a09e2ed5ad4a70f7ce3706db1c", "sha256": "24c0c836a91fa5090688c885b5503bd976f2d7c2ed4b326f41ed0e42be2ffd59" }, "downloads": -1, "filename": "okerrupdate-1.1.9.tar.gz", "has_sig": false, "md5_digest": "6d8030a09e2ed5ad4a70f7ce3706db1c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4159, "upload_time": "2018-09-25T11:42:59", "url": "https://files.pythonhosted.org/packages/90/2c/68378b39e70fd5a0e9eba130d3fd54a2a00d953fb3555581c4d11e183e4f/okerrupdate-1.1.9.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a31f1ccb14b2231d679d5b27d4020e3b", "sha256": "a64c087e9f835b22f14ff91bb62abe5023afb37188635b6c47312b3ae3dc2d67" }, "downloads": -1, "filename": "okerrupdate-1.1.13.tar.gz", "has_sig": false, "md5_digest": "a31f1ccb14b2231d679d5b27d4020e3b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5077, "upload_time": "2019-01-10T11:35:00", "url": "https://files.pythonhosted.org/packages/02/3d/ce450602a8139921e9c984208ed9e3123ee7dae6ffd6d5034d908783a8bb/okerrupdate-1.1.13.tar.gz" } ] }