{ "info": { "author": "Alexander Tikhonov", "author_email": "random.gauss@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Console", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: MacOS :: MacOS X", "Operating System :: Microsoft :: Windows", "Operating System :: POSIX", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: Implementation :: CPython", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: System", "Topic :: System :: Software Distribution" ], "description": "carbonstat\n==========\n\n.. image:: https://img.shields.io/pypi/v/carbonstat.svg\n :target: https://pypi.python.org/pypi/carbonstat\n\n.. image:: https://img.shields.io/pypi/pyversions/carbonstat.svg\n :target: https://pypi.python.org/pypi/carbonstat\n\n.. image:: https://img.shields.io/badge/license-MIT-blue.svg\n :target: https://raw.githubusercontent.com/Fatal1ty/carbonstat/master/LICENSE\n\nMetrics collection agent for `Carbon`_. It allow you to collect some\nmetrics about your code and measure execution time.\n\nInstallation\n------------\n\nInstall via pip:\n\n::\n\n pip install carbonstat\n\nBasic usage\n-----------\n\nYou can just import ``carbonstat.stat`` instance and play with it:\n\n.. code:: python\n\n from carbonstat import stat\n\n def foo():\n print 'Hello, world!'\n\n foo()\n foo()\n\n stat['foo.count'].add(2) # save `foo.count` metric as execution counter\n\n stat.send() # send packet to Carbon with `foo.count` metric value\n\nAll packets are sent via udp to *127.0.0.1:2003* by default. You can\nchange default destination address via environment variables\n``$CARBOH_HOST`` and ``$CARBON_PORT``.\n\nYou can combine multiple metrics in one ``CarbonStat`` instance too:\n\n.. code:: python\n\n def foo():\n print 'Hello from foo!'\n\n def bar():\n print 'Hello from bar!'\n\n foo()\n foo()\n bar()\n\n stat['foo.count'].add(2)\n stat['bar.count'].add(1)\n\n stat.send() # send packet to Carbon with two metrics\n\nAdvanced usage\n--------------\n\nYou can measure execution time of code blocks with convenient context\nmanager:\n\n.. code:: python\n\n stat = CarbonStat(host=192.168.0.1, port=2003)\n\n def foo(sec):\n sleep(sec)\n print 'Hello after %d seconds!' % sec\n\n with stat.timer('foo.time') as timer:\n timer.start() # measure first\n foo(3)\n timer.stop()\n\n timer.start() # measure again\n foo(5)\n timer.stop()\n\n stat.send() # send packet:\n # heartbeat 0 timespamp\n # foo.time.min 3 timestamp\n # foo.time.avg 4 timestamp\n # foo.time.max 5 timestamp\n\nOr you can do it simpler:\n\n.. code:: python\n\n def foo(sec):\n sleep(sec)\n print 'Hello after %d seconds!' % sec\n\n with stat.timer('foo.time'):\n foo(3)\n with stat.timer('foo.time'):\n foo(5)\n\n stat.send() # send packet like above\n\nYou can even decorate your function and measure it\u2019s execution time\nwhile calling it:\n\n.. code:: python\n\n @stat.timeit('foo.time')\n def foo(sec):\n sleep(sec)\n print 'Hello after %d seconds!' % sec\n\n foo(3)\n foo(5)\n\n stat.send() # send packet like above\n\nExtra\n-----\n\nIn some cases you may need to save the value of any metric after sending\nthe packet to Carbon. You can do it by setting ``accumulate`` attribute\nto ``True``:\n\n\\`\\`\\`\n\n.. _Carbon: https://github.com/graphite-project/carbon", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Fatal1ty/carbonstat", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "carbonstat", "package_url": "https://pypi.org/project/carbonstat/", "platform": "all", "project_url": "https://pypi.org/project/carbonstat/", "project_urls": { "Homepage": "https://github.com/Fatal1ty/carbonstat" }, "release_url": "https://pypi.org/project/carbonstat/1.0/", "requires_dist": null, "requires_python": "", "summary": "Metric collection agent for Carbon", "version": "1.0" }, "last_serial": 3113999, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "3ec7e2d9e280769874d237ccd8f70b73", "sha256": "e27c7107bf28d2e2a4158912bf808f6c9ad9a7f865454f59b73538c7c638550e" }, "downloads": -1, "filename": "carbonstat-0.1.tar.gz", "has_sig": false, "md5_digest": "3ec7e2d9e280769874d237ccd8f70b73", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2250, "upload_time": "2015-06-05T11:00:58", "url": "https://files.pythonhosted.org/packages/eb/16/90f34ae701779a81d48d312738b15c3958afa62f869ee73661a6c5f0dc30/carbonstat-0.1.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "e92f1466b525cccd9d53c38a30904eca", "sha256": "40fb61501c5d23f33e6293ff355f7fa7b7ac8378233960da868c14ece3be0a00" }, "downloads": -1, "filename": "carbonstat-0.1.1.tar.gz", "has_sig": false, "md5_digest": "e92f1466b525cccd9d53c38a30904eca", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2291, "upload_time": "2015-06-05T11:19:45", "url": "https://files.pythonhosted.org/packages/cb/b0/acb8cbe0b2e24e9059db9844a147a8c2ade735e352de9761e3ac169f1479/carbonstat-0.1.1.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "7fdd547abe6a4bb9cb40a740712e12c4", "sha256": "1ea4e730bc89417e49604d44abcee5a68806baf5d8814ad9ac9a67ab141b83d6" }, "downloads": -1, "filename": "carbonstat-0.2.tar.gz", "has_sig": false, "md5_digest": "7fdd547abe6a4bb9cb40a740712e12c4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2085, "upload_time": "2015-06-05T15:48:02", "url": "https://files.pythonhosted.org/packages/b5/6c/52372d1f8a199714a4cf37d420e3e09fa3f7a29983fd85a4c4ed8672121f/carbonstat-0.2.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "110b5a98ccf1837455c7ef599c6383d9", "sha256": "5b379a438445a46120f05355f9c3a7e86052b95fc2890614d960d340bb4b6b60" }, "downloads": -1, "filename": "carbonstat-0.2.1.tar.gz", "has_sig": false, "md5_digest": "110b5a98ccf1837455c7ef599c6383d9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2074, "upload_time": "2015-06-05T17:00:31", "url": "https://files.pythonhosted.org/packages/c6/5c/3bd488aed9c39e4c055c837145c0915964f94705e9c5a5176d8cc56c69b2/carbonstat-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "1c9857f6ea9faeb317026fe3bec92e54", "sha256": "9a0109bdc88cbcbb0ac18e4966307e6d0ceace3ce7e6bacc54ea2e4fa3bdd4d2" }, "downloads": -1, "filename": "carbonstat-0.2.2.tar.gz", "has_sig": false, "md5_digest": "1c9857f6ea9faeb317026fe3bec92e54", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2074, "upload_time": "2015-06-08T09:40:34", "url": "https://files.pythonhosted.org/packages/f4/30/eeb9cffbeabb1335551cf93a75a8916f28b6adbfd890f6daf60b4823e96b/carbonstat-0.2.2.tar.gz" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "1c356967e1d8c228dd6d963934f663bd", "sha256": "15990c08300d80af56e73d72f96f9c1bf40b9d35b085d76c27c721461a996bec" }, "downloads": -1, "filename": "carbonstat-0.2.3.tar.gz", "has_sig": false, "md5_digest": "1c356967e1d8c228dd6d963934f663bd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2091, "upload_time": "2015-06-08T14:42:01", "url": "https://files.pythonhosted.org/packages/da/1f/a4804cad53be0fce247adf83b705b455ee787801097935a32d8d5d1ca4cc/carbonstat-0.2.3.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "d484c5072afdbd382c19bcdffa4a63b3", "sha256": "64201ac9b957cb015ba2a74b2eaf9b2f35d9a6451f0cfb25ffdce934efff8573" }, "downloads": -1, "filename": "carbonstat-0.3.0.tar.gz", "has_sig": false, "md5_digest": "d484c5072afdbd382c19bcdffa4a63b3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2447, "upload_time": "2015-06-08T22:43:42", "url": "https://files.pythonhosted.org/packages/36/f2/2de738ad1a1b9f11db6a1cb62235aae1ecb96d0cdcb6b16c93ad115a5278/carbonstat-0.3.0.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "a96ea611f776e666fb3a763d9ac08f2f", "sha256": "a3f4bd3d1364601e9c1f3b07d27a89161c2b07be0af1b2a6ee4cceb04e87773d" }, "downloads": -1, "filename": "carbonstat-0.3.1.tar.gz", "has_sig": false, "md5_digest": "a96ea611f776e666fb3a763d9ac08f2f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2450, "upload_time": "2015-06-09T09:23:34", "url": "https://files.pythonhosted.org/packages/e1/e8/875ba975dfd0655e7ff7647e769ee1ea448845ffc6ff6049b6e24ed9a2c9/carbonstat-0.3.1.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "fd33583f9bf4888003ae43530ad6f2f7", "sha256": "3e5e2146fc1906232498f57b187ebd701e04685577ea0d8b2127af359b8bef14" }, "downloads": -1, "filename": "carbonstat-0.4.0.tar.gz", "has_sig": false, "md5_digest": "fd33583f9bf4888003ae43530ad6f2f7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2602, "upload_time": "2015-06-10T23:11:23", "url": "https://files.pythonhosted.org/packages/70/57/7bbc231ce302611feadbbbf40df27bde33870d60801f739d4bc6540b9d3a/carbonstat-0.4.0.tar.gz" } ], "0.4.1": [ { "comment_text": "", "digests": { "md5": "7e994286b7ebea7878d3ab77fce070e1", "sha256": "3f163d75cf3de001c40c6ad7bac5d71d8e1fd404772a809d3b0987413962f001" }, "downloads": -1, "filename": "carbonstat-0.4.1.tar.gz", "has_sig": false, "md5_digest": "7e994286b7ebea7878d3ab77fce070e1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2627, "upload_time": "2015-07-03T10:54:51", "url": "https://files.pythonhosted.org/packages/9a/38/845da520c649a1b76e50ffddd5c21427fa933d7b062ad70c80509f272b5a/carbonstat-0.4.1.tar.gz" } ], "0.4.2": [ { "comment_text": "", "digests": { "md5": "b7298cad66923bb45c0ad94e1929d509", "sha256": "3b4de1fea6c1d751b1d1c9620e3c598d76172795166a414feab8133fb5f56e00" }, "downloads": -1, "filename": "carbonstat-0.4.2.tar.gz", "has_sig": false, "md5_digest": "b7298cad66923bb45c0ad94e1929d509", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2674, "upload_time": "2015-07-13T16:44:56", "url": "https://files.pythonhosted.org/packages/4a/15/1be13201cb0f1bc1b6c3f31d71cf9ff8f32a3207cd0d75d7439ea5907d65/carbonstat-0.4.2.tar.gz" } ], "0.4.3": [ { "comment_text": "", "digests": { "md5": "758bd2fef08dadd97bc4b5abe629e9ab", "sha256": "ef4cf9333af3c4c135f8b4cef2b9c99487b47d6e568f55b2c3eeb922780e611d" }, "downloads": -1, "filename": "carbonstat-0.4.3.tar.gz", "has_sig": false, "md5_digest": "758bd2fef08dadd97bc4b5abe629e9ab", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2681, "upload_time": "2016-01-15T10:58:31", "url": "https://files.pythonhosted.org/packages/ea/5a/11a871487609dbdb3f0422aa2b132906946c1e21581b451e8129560671cc/carbonstat-0.4.3.tar.gz" } ], "0.4.4": [ { "comment_text": "", "digests": { "md5": "16b08fc915b0c9dc8ca5c7331b7a1734", "sha256": "5859f66377c071e32a08bef7bc1c2983afdb1a87f83a6482c4006ed0ca33f2c4" }, "downloads": -1, "filename": "carbonstat-0.4.4.tar.gz", "has_sig": false, "md5_digest": "16b08fc915b0c9dc8ca5c7331b7a1734", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2685, "upload_time": "2016-08-29T07:18:37", "url": "https://files.pythonhosted.org/packages/a5/9b/a08637a03f89c832b579f559e14ee52c66764fef5804ce511436044a4bac/carbonstat-0.4.4.tar.gz" } ], "0.4.5": [ { "comment_text": "", "digests": { "md5": "36f3dc5bf9560b69aab173de59b743c3", "sha256": "24d754ae77d4bd98a274f2403d6c7288860310f68169a5e0deeb1efef20fa01a" }, "downloads": -1, "filename": "carbonstat-0.4.5.tar.gz", "has_sig": false, "md5_digest": "36f3dc5bf9560b69aab173de59b743c3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3960, "upload_time": "2016-08-29T07:40:12", "url": "https://files.pythonhosted.org/packages/b2/e8/ec1a1802332c6ae888921acd37e739ec3ca472baa26891a2f4de4af588e0/carbonstat-0.4.5.tar.gz" } ], "0.4.6": [ { "comment_text": "", "digests": { "md5": "cdaa8ed412b70b05f6482d19a05e9d77", "sha256": "621ab8c28489d4af318ec9093ad03163ce4a3f74138850ec810e29fa3b9fc8b5" }, "downloads": -1, "filename": "carbonstat-0.4.6.tar.gz", "has_sig": false, "md5_digest": "cdaa8ed412b70b05f6482d19a05e9d77", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4254, "upload_time": "2016-08-31T08:05:00", "url": "https://files.pythonhosted.org/packages/65/d2/ecffcdf6595da2cb19479c454ee0f22dbaace7cc6f7a290fa41b177d9d97/carbonstat-0.4.6.tar.gz" } ], "1.0": [ { "comment_text": "", "digests": { "md5": "20cc78fa845e4b7186e3e150e5b49222", "sha256": "d8c0c6a3d5cba7bd68bdf89fd491859f013dcfeb4ed16750255315d760a852f4" }, "downloads": -1, "filename": "carbonstat-1.0.tar.gz", "has_sig": false, "md5_digest": "20cc78fa845e4b7186e3e150e5b49222", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4230, "upload_time": "2017-08-22T08:07:04", "url": "https://files.pythonhosted.org/packages/12/34/4d8c9589769249c89ecfaee55f0dfdf21f951546114ff5359445bd6935c6/carbonstat-1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "20cc78fa845e4b7186e3e150e5b49222", "sha256": "d8c0c6a3d5cba7bd68bdf89fd491859f013dcfeb4ed16750255315d760a852f4" }, "downloads": -1, "filename": "carbonstat-1.0.tar.gz", "has_sig": false, "md5_digest": "20cc78fa845e4b7186e3e150e5b49222", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4230, "upload_time": "2017-08-22T08:07:04", "url": "https://files.pythonhosted.org/packages/12/34/4d8c9589769249c89ecfaee55f0dfdf21f951546114ff5359445bd6935c6/carbonstat-1.0.tar.gz" } ] }