{ "info": { "author": "J\u00fcrgen Knauth", "author_email": "pubsrc@binary-overflow.de", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "License :: OSI Approved :: Apache Software License", "Programming Language :: Python :: 3.5" ], "description": "jk_commentjson\n==============\n\nIntroduction\n------------\n\nThis python module allows reading JSON files including comments.\n\nThis module is an improved version of Vaidik Kapoor's ``commentjson`` module provided at PyPi at ``https://pypi.python.org/pypi/commentjson/``. The original version has been ported to Python 3 and the regular expressions have been improved.\n\nInformation about this module can be found here:\n\n* github.org_\n* pypi.python.org_\n\n.. _github.org: https://github.com/jkpubsrc/python-module-jk-commentjson\n.. _pypi.python.org: https://pypi.python.org/pypi/jk_commentjson\n\nForeword\n--------\n\nThe original ``commentjson`` module implemented by Vaidik Kapoor makes use of regular expressions to preprocess files before forwarding the data to the Python ``json`` parser to actually parse the data. Of course this approach must be considered to be a hack, especially as the existing implementation does not manage all special situations in parsing.\n\nThe library `jk_commentjson` improves on the current implementation by fixing and extending the expression approach. Though the current approach works quite well nevertheless it is still a hack.\n\nThe author of `jk_commentjson` will replace the existing implementation with a real parser one day, but that will take a bit of time to fully implement and test. Unfortunately due to lack of time this can't be done in the next weeks or months. Besides: The current approach works well in most use cases anyway. Till that day until the existing implementation will be replaced all users of this library will need to get along with the current implementation. Which you will likely find working pretty well until you not run into the following bug:\n\n* If a JSON file is provided in a single line not terminated by a line feed, comments in this file will not be parsed.\n\nSo use multi-line JSON files please (which you will likely do anyway as comments in JSON files indicate that these files address human beings and therefor will not be single-line-JSON files anyway).\n\nHow to use this module\n----------------------\n\n### Import\n\nTo import this module use the following statement:\n\n::\n\n import jk_commentjson\n\n### Parsing\n\nYou can parse JSON files like this:\n\n::\n\n json_loaded = commentjson.loads(json_string)\n\nA JSON file can contain comments of the following style:\n\n* line comments using \"//\" (C-style comments)\n* line comments using \"#\" (Python-style comments)\n\nContact Information\n-------------------\n\nThis is Open Source code. That not only gives you the possibility of freely using this code it also\nallows you to contribute. Feel free to contact the author(s) of this software listed below, either\nfor comments, collaboration requests, suggestions for improvement or reporting bugs:\n\n* J\u00fcrgen Knauth: jknauth@uni-goettingen.de, pubsrc@binary-overflow.de\n\nLicense\n-------\n\nThis software is provided under the following license:\n\n* Apache Software License 2.0\n\n\n\n", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/jkpubsrc/python-module-jk-commentjson/tarball/0.2017.10.7", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/jkpubsrc/python-module-jk-commentjson", "keywords": "json", "license": "Apache 2.0", "maintainer": "", "maintainer_email": "", "name": "jk_commentjson", "package_url": "https://pypi.org/project/jk_commentjson/", "platform": "", "project_url": "https://pypi.org/project/jk_commentjson/", "project_urls": { "Download": "https://github.com/jkpubsrc/python-module-jk-commentjson/tarball/0.2017.10.7", "Homepage": "https://github.com/jkpubsrc/python-module-jk-commentjson" }, "release_url": "https://pypi.org/project/jk_commentjson/0.2017.10.7/", "requires_dist": null, "requires_python": "", "summary": "This is a JSON parsing module that can get along with comments in JSON files.", "version": "0.2017.10.7" }, "last_serial": 3232309, "releases": { "0.2017.10.7": [ { "comment_text": "", "digests": { "md5": "12094b33ebf4ae1afec97be96adffde6", "sha256": "1e7b7ab773209e83c27b1bcb12e230652f060e5c9c9c910ea05d741c45ccb4cd" }, "downloads": -1, "filename": "jk_commentjson-0.2017.10.7.tar.gz", "has_sig": false, "md5_digest": "12094b33ebf4ae1afec97be96adffde6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4179, "upload_time": "2017-10-07T10:15:12", "url": "https://files.pythonhosted.org/packages/29/9d/c5708c3e95ee437ac572c3cd862f673dea3beadde8fe59f3e08600f5d223/jk_commentjson-0.2017.10.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "12094b33ebf4ae1afec97be96adffde6", "sha256": "1e7b7ab773209e83c27b1bcb12e230652f060e5c9c9c910ea05d741c45ccb4cd" }, "downloads": -1, "filename": "jk_commentjson-0.2017.10.7.tar.gz", "has_sig": false, "md5_digest": "12094b33ebf4ae1afec97be96adffde6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4179, "upload_time": "2017-10-07T10:15:12", "url": "https://files.pythonhosted.org/packages/29/9d/c5708c3e95ee437ac572c3cd862f673dea3beadde8fe59f3e08600f5d223/jk_commentjson-0.2017.10.7.tar.gz" } ] }