{ "info": { "author": "Andrew Craighead", "author_email": "craigheadap@missouri.edu", "bugtrack_url": null, "classifiers": [ "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Topic :: Software Development :: Libraries" ], "description": "# grapi\n(Pronounced: gray-P-I)\n\nPython3 bindings for Graylog's REST API\n\n## Install\nFirst, make sure you have at least Python 3.7 installed.\n### Development\n```\ngit clone git@github.com:interputed/grapi.git\ncd grapi\npipenv install\n```\n### Library Usage\n```\npip3 install grapi\n```\n\n## Example Usage\nTo use, you must first create an *access token* following the instructions at:\n[Graylog REST API Documentation](http://docs.graylog.org/en/2.4/pages/configuration/rest_api.html#creating-and-using-access-token)\nAPI does not support username/password logins as it makes it easier to accidentally expose user credentials.\n\nImport after installation with pip:\n```from grapi.grapi import Grapi```\n\nImport access token string:\n```token = \"\"```\n\nSet URL to desired API path:\n```url = \"https:///api/search/universal/absolute\"```\n\nAll currently implemented URL endpoints can be found in: ```grapi/endpoints.py```\n\nThe list of all possible endpoints that may be implemented in the future is found by adding ```/api/api-browser``` to the URL of your Graylog server.\n\nSetup the Grapi object with url and token:\n```my_api = Grapi(url, token)```\n\nBuild a dictionary of parameters mapped to string values for every parameter of your request:\n```\nmy_params = {\n \"query\": \"\", # Required\n \"fields\": \"\", # Required\n \"from\": \"\", # Required\n \"to\": \"\", # Required\n \"limit\": 10 # Optional: Default limit is 150 in Graylog\n}\n```\n\nNow, simply call the send method of my_api with the type of request method (get, post, put, delete):\n```response = my_api.send(\"get\", **my_params)```\n\nThat's it for a simple search in Python 3 using Graylog's REST API! Now you can manipulate the data however you wish directly in Python. To see the output of your search you can just print it as with anything else in Python:\n```\nprint(response.json())\nOR\nprint(response.text)\n```\n\n#### This is a work in progress, so if the method or endpoint you need isn't yet implemented, add it yourself and send a pull request, post to issues, or simply check back later and it should be added.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/interputed/grapi", "keywords": "graylog,graylog-api,graylog api,python3 graylog,python3 graylog api,python3 graylog-api", "license": "", "maintainer": "", "maintainer_email": "", "name": "grapi", "package_url": "https://pypi.org/project/grapi/", "platform": "", "project_url": "https://pypi.org/project/grapi/", "project_urls": { "Homepage": "https://github.com/interputed/grapi" }, "release_url": "https://pypi.org/project/grapi/0.1.4/", "requires_dist": null, "requires_python": "", "summary": "Python 3 bindings for Graylog's REST API", "version": "0.1.4" }, "last_serial": 4416707, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "23d70c3d002f207d11fb24a2ba34e51c", "sha256": "7d78205dd0f70902c46614e9d4c514e1120fd4dc1b28a0c2c2b1637fd773a20a" }, "downloads": -1, "filename": "grapi-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "23d70c3d002f207d11fb24a2ba34e51c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5214, "upload_time": "2018-10-01T21:50:03", "url": "https://files.pythonhosted.org/packages/0b/41/696105ef84539cb7ed198bebd486712141f8842984ee8a5e7b41238902cc/grapi-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f899b70b03ae60694686ecd41142be0a", "sha256": "0850ffda879785faa364e791c28af3957d8c2877673386162f6bba861ce4e72d" }, "downloads": -1, "filename": "grapi-0.1.0.tar.gz", "has_sig": false, "md5_digest": "f899b70b03ae60694686ecd41142be0a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3402, "upload_time": "2018-10-01T21:50:04", "url": "https://files.pythonhosted.org/packages/d8/98/8e6e7517263a52c72bb24432c6391615b63a27fac212aacc3043484807a5/grapi-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "79a717116bbcef177520ea7be73efe2a", "sha256": "883a60facfd4b8fc232ef1c69d8e9103d767b1c861e59b89e1859b8f3dafa588" }, "downloads": -1, "filename": "grapi-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "79a717116bbcef177520ea7be73efe2a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6189, "upload_time": "2018-10-02T18:22:47", "url": "https://files.pythonhosted.org/packages/26/1c/6a17339bbd61f4fb944efea5b497b77fc76711105df3c96ca4d5ed350d6c/grapi-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "dba9c48d21b26de97fc71b08eb032a51", "sha256": "bea1df0ba6e7f1858698ed9b4702c960a378573a2e751569d4998c90d9e97f05" }, "downloads": -1, "filename": "grapi-0.1.1.tar.gz", "has_sig": false, "md5_digest": "dba9c48d21b26de97fc71b08eb032a51", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4395, "upload_time": "2018-10-02T18:22:49", "url": "https://files.pythonhosted.org/packages/ef/2e/8b4c903a5434100463084e40b9b4167b41713f06fd589d632cae3b00d5e6/grapi-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "5a9411fc40e47aace1cd7ae23f375576", "sha256": "982202ee1a5837a5bb71255546101334abd8cf845ea509756da84d31d132654c" }, "downloads": -1, "filename": "grapi-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "5a9411fc40e47aace1cd7ae23f375576", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6222, "upload_time": "2018-10-16T20:12:00", "url": "https://files.pythonhosted.org/packages/f3/03/b8fa5a546605a33747a45c9c8ae1443b6cc0424c6d6c53a09e0b7d26b727/grapi-0.1.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1e07135b529e5dcb0bb46f18b5034413", "sha256": "c1cdd182e9e36694e12ebf9a65251861b03b5a5375ab430fc429a2b0a5e41de4" }, "downloads": -1, "filename": "grapi-0.1.2.tar.gz", "has_sig": false, "md5_digest": "1e07135b529e5dcb0bb46f18b5034413", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4423, "upload_time": "2018-10-16T20:12:02", "url": "https://files.pythonhosted.org/packages/3c/25/b40ca9894dac13eb7ad3759528636fc0a595ab190f1d3c47558ca2c2ceb2/grapi-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "04a3ed26911a03c89571aa65664b757e", "sha256": "ac538b6a7df6b1bae907af6f1a25fda80132327aab20d6f1d3c3ee84561dd07c" }, "downloads": -1, "filename": "grapi-0.1.3-py3-none-any.whl", "has_sig": false, "md5_digest": "04a3ed26911a03c89571aa65664b757e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6402, "upload_time": "2018-10-25T20:19:23", "url": "https://files.pythonhosted.org/packages/a0/86/62d656dff920ec25566480656e99ff706bc074c45e5c91f1e6164c4baecc/grapi-0.1.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ad7422d35aedf30f958dcbc7f14fc1b0", "sha256": "1077bf1610e43347540a2631af21ad40c71d9b62ca7d247a0fd9e8422176c105" }, "downloads": -1, "filename": "grapi-0.1.3.tar.gz", "has_sig": false, "md5_digest": "ad7422d35aedf30f958dcbc7f14fc1b0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4605, "upload_time": "2018-10-25T20:19:25", "url": "https://files.pythonhosted.org/packages/be/6e/d0c97bc09215841827bca863a090f6632b11a19535422a725aa3b81a4284/grapi-0.1.3.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "446c2cc6018153712e7eafe86841be16", "sha256": "95f3fb7ec17e80b131fff6b08af295d1250dad1fd120de17cb93356363070d9b" }, "downloads": -1, "filename": "grapi-0.1.4-py3-none-any.whl", "has_sig": false, "md5_digest": "446c2cc6018153712e7eafe86841be16", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6403, "upload_time": "2018-10-25T20:27:27", "url": "https://files.pythonhosted.org/packages/97/8f/01e0c7fb06048dcfd9260d52982b111a05dbd72ab4a6fcb9e0c3fb2e564b/grapi-0.1.4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "306d1bd48f9bdd5de31ad1a4532167a2", "sha256": "2a004d142020fcd185abd57cf7697d878711e26c67c05bed178cbfcc41234951" }, "downloads": -1, "filename": "grapi-0.1.4.tar.gz", "has_sig": false, "md5_digest": "306d1bd48f9bdd5de31ad1a4532167a2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4604, "upload_time": "2018-10-25T20:27:30", "url": "https://files.pythonhosted.org/packages/3b/d5/14fa9de61ff6b9a1b42aa426b45b6612065c30e20658548619eadf517f4d/grapi-0.1.4.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "446c2cc6018153712e7eafe86841be16", "sha256": "95f3fb7ec17e80b131fff6b08af295d1250dad1fd120de17cb93356363070d9b" }, "downloads": -1, "filename": "grapi-0.1.4-py3-none-any.whl", "has_sig": false, "md5_digest": "446c2cc6018153712e7eafe86841be16", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6403, "upload_time": "2018-10-25T20:27:27", "url": "https://files.pythonhosted.org/packages/97/8f/01e0c7fb06048dcfd9260d52982b111a05dbd72ab4a6fcb9e0c3fb2e564b/grapi-0.1.4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "306d1bd48f9bdd5de31ad1a4532167a2", "sha256": "2a004d142020fcd185abd57cf7697d878711e26c67c05bed178cbfcc41234951" }, "downloads": -1, "filename": "grapi-0.1.4.tar.gz", "has_sig": false, "md5_digest": "306d1bd48f9bdd5de31ad1a4532167a2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4604, "upload_time": "2018-10-25T20:27:30", "url": "https://files.pythonhosted.org/packages/3b/d5/14fa9de61ff6b9a1b42aa426b45b6612065c30e20658548619eadf517f4d/grapi-0.1.4.tar.gz" } ] }