{ "info": { "author": "OpenFin", "author_email": "dev@openfin.co", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: Apache Software License", "Programming Language :: Python :: 2.7" ], "description": "# OpenFin Log Management CLI\r\n\r\n## Overview\r\n\r\nThe OpenFin Log Management CLI allows users to interact with the Log Management service via the command line. Apps that have log management enabled will have their logs encrypted and uploaded to the log management service after the RVM closes. This CLI can be used to list logs stored by app names and/or desktops, and to download and decrypt those log files so that the app provider can read and use them for debugging purposes.\r\n\r\n### Assumptions\r\n\r\nThe following are requirements for using the CLI tool:\r\n- Python 2.7 must be installed.\r\n- Run `pip install oflog` to install the CLI tool.\r\n\r\n### Features\r\n\r\n- List application names, and list desktop id's for a given app name.\r\n- List logs for a given application.\r\n- Download and decrypt zipped files from the log management service.\r\n\r\n### Upgrading\r\n- To upgrade to a newer version, run `pip install --upgrade oflog`\r\n\r\n## Getting started\r\n\r\n### File Structure\r\n\r\n- openfin_log_cli.py: cli tool entry point.\r\n- config.ini: file that contains default configuration information, including log manager url, api key, and private key file.\r\n\r\n### Configuration\r\nRun `oflog --configure` and answer the prompts for base-url, api-key, and private-key to configure the cli. Configuration is stored in `~/.openfin/config.ini`\r\n\r\n### Usage\r\n\r\nAll commands return JSON responses from the log management service.\r\nAll commands require at least the base url and the api key to be configured either in config.ini or the arguments `--base-url` or `--api-key`. For downloading logs, an RSA private key file in PEM form must also be configured in either config.ini or the argument `--private-key`.\r\nIf the aforementioned configuration items are provided both in the config.ini file and as a command line argument, the command line argument will take precedence.\r\n\r\n### Commands\r\n* `oflog --get-app-names`: list all the application names.\r\n* `oflog --get-app-desktops --app-name `: list all the desktops for a given app name.\r\n* `oflog --get-desktop-logs --app-name --desktop-id `: list all the logs for a given app name / desktop combination.\r\n* `oflog --get-logs --app-name `: get all the logs for a given app name.\r\n* `oflog --download-log `: download a log with the given id and decrypt it with the provided private key file.\r\n\r\n\r\n### Other arguments\r\n\r\n- `--start-date`: causes `--get-logs` and `--get-desktop-logs` to only show logs past that start date.\r\n- `--end-date`: causes `--get-logs` and `--get-desktop-logs` to only show logs before that end date. Can be used in conjunction with `--start-date`.\r\n- `--private-key`: location of RSA private key in PEM form, used to decrypt logs. This flag overrides the private key set in config.ini.\r\n- `--base-url`: base url for api calls. This flag overrides the url set in config.ini.\r\n- `--api-key`: api key for api calls. This flag overrides the api key set in config.ini.\r\n- `--version`: shows the version of the CLI tool.\r\n- `--help`: shows descriptions of commands and arguments.\r\n\r\n## Contributing\r\n\r\nThis is an open source project and all are encouraged to contribute.\r\n\r\n### Development\r\nYou can test any changes that you make locally by substituting `oflog` by running the `openfin_log_cli.py` file (e.g. calling the CLI like so: `python log_manager_cli\\openfin_log_cli.py `).\r\n\r\n## License\r\n\r\nThis project uses the [Apache2 license](https://www.apache.org/licenses/LICENSE-2.0).\r\nBy downloading OpenFin, you agree to the terms of our [Developer License](https://openfin.co/developer-agreement/).\r\n\r\n## Support\r\n\r\nPlease enter an issue in the repo for any questions or problems. Alternatively, please contact us at support@openfin.co\r\n\r\n\r\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/openfin/log-manager-cli", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "oflog", "package_url": "https://pypi.org/project/oflog/", "platform": "", "project_url": "https://pypi.org/project/oflog/", "project_urls": { "Homepage": "https://github.com/openfin/log-manager-cli" }, "release_url": "https://pypi.org/project/oflog/0.3.0/", "requires_dist": [ "requests (>=2.18.4)", "pycrypto (>=2.6.1)" ], "requires_python": "", "summary": "CLI for the OpenFin Log Management Service", "version": "0.3.0" }, "last_serial": 4732887, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "fbca6536764d0f4557ce41d63514d52d", "sha256": "86a603e091a9ecd9f41d510c741ea0fe6036caa41c2868de72d48cb456e76439" }, "downloads": -1, "filename": "oflog-0.1.0-py2-none-any.whl", "has_sig": false, "md5_digest": "fbca6536764d0f4557ce41d63514d52d", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 6705, "upload_time": "2018-08-07T17:31:54", "url": "https://files.pythonhosted.org/packages/ad/79/8f89e9f64512ade5c6ba2a2c9c667d9b444c2f4d95401f9b97d6c9d80b36/oflog-0.1.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "83d66f7e1a92289d29e771f047953491", "sha256": "acfd69c30501c8a28cceb1aef7f134ed126d90b007a5320961109c1005a786a1" }, "downloads": -1, "filename": "oflog-0.1.0.tar.gz", "has_sig": false, "md5_digest": "83d66f7e1a92289d29e771f047953491", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5509, "upload_time": "2018-08-07T17:31:58", "url": "https://files.pythonhosted.org/packages/9a/13/a117f617dab6b5706f0c4867168f01de0963ff020453abd3d25ac95a2775/oflog-0.1.0.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "48f138784c281734e9045cfc03790485", "sha256": "7b3a6ca10aca7ee23aa43700b484ffd6ac22fdf527bfebcf5077e6c5369b3e1a" }, "downloads": -1, "filename": "oflog-0.2.0-py2-none-any.whl", "has_sig": false, "md5_digest": "48f138784c281734e9045cfc03790485", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 7024, "upload_time": "2018-11-29T22:06:22", "url": "https://files.pythonhosted.org/packages/d0/8a/c76008fe29506d4e624b5df10e3e5dbefe4428f9aec3af598e8d7067a640/oflog-0.2.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "83dc34db3b337e8d512819e3bc0886b4", "sha256": "d4e6a2d11d7bc316d52ce7e251e6265ea424e5b9187253dfc7532009dc509b77" }, "downloads": -1, "filename": "oflog-0.2.0.tar.gz", "has_sig": false, "md5_digest": "83dc34db3b337e8d512819e3bc0886b4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5958, "upload_time": "2018-11-29T22:06:24", "url": "https://files.pythonhosted.org/packages/43/09/7c126fc7b13f6944edc1ddbe70691d4ea01af99f923395dda1798dfc1c67/oflog-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "dc96c492545713e5b6a31c0ef77dc8e4", "sha256": "3115dbd102776823e2a9e863b6a64b36d2ee24d98b4e4a4d127b14ac34089215" }, "downloads": -1, "filename": "oflog-0.3.0-py2-none-any.whl", "has_sig": false, "md5_digest": "dc96c492545713e5b6a31c0ef77dc8e4", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 7142, "upload_time": "2019-01-23T20:42:40", "url": "https://files.pythonhosted.org/packages/13/ca/c255cb79aa0c4246312c2d58e29baebdf7cc0fb8faaf30ec0049654530c7/oflog-0.3.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1d92bd8f6073956d11e646aa5f3733b8", "sha256": "a8bffb06cb0fb38008c32639821c7581894ce8a02e94b69d476f1bab8e88796d" }, "downloads": -1, "filename": "oflog-0.3.0.tar.gz", "has_sig": false, "md5_digest": "1d92bd8f6073956d11e646aa5f3733b8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6198, "upload_time": "2019-01-23T20:42:41", "url": "https://files.pythonhosted.org/packages/a9/d5/e4abe9b1fabf931fb94359b371cd800b60c4869b1c947c3decd9a4ced10f/oflog-0.3.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "dc96c492545713e5b6a31c0ef77dc8e4", "sha256": "3115dbd102776823e2a9e863b6a64b36d2ee24d98b4e4a4d127b14ac34089215" }, "downloads": -1, "filename": "oflog-0.3.0-py2-none-any.whl", "has_sig": false, "md5_digest": "dc96c492545713e5b6a31c0ef77dc8e4", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 7142, "upload_time": "2019-01-23T20:42:40", "url": "https://files.pythonhosted.org/packages/13/ca/c255cb79aa0c4246312c2d58e29baebdf7cc0fb8faaf30ec0049654530c7/oflog-0.3.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1d92bd8f6073956d11e646aa5f3733b8", "sha256": "a8bffb06cb0fb38008c32639821c7581894ce8a02e94b69d476f1bab8e88796d" }, "downloads": -1, "filename": "oflog-0.3.0.tar.gz", "has_sig": false, "md5_digest": "1d92bd8f6073956d11e646aa5f3733b8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6198, "upload_time": "2019-01-23T20:42:41", "url": "https://files.pythonhosted.org/packages/a9/d5/e4abe9b1fabf931fb94359b371cd800b60c4869b1c947c3decd9a4ced10f/oflog-0.3.0.tar.gz" } ] }