{ "info": { "author": "Max Elia Schweigkofler", "author_email": "schweigkofler.max@gmail.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "# licensr\nA command-line interface for easily licensing your project and make it compliant to the REUSE-Initiative's guidelines\n\n---\n[![reuse compliant](https://reuse.software/badge/reuse-compliant.svg)](https://reuse.software/)\n[![PyPI](https://img.shields.io/pypi/v/licensr.svg?maxAge=3700)](http://pypi.python.org/pypi/licensr)\n[![PyPI](https://img.shields.io/pypi/pyversions/licensr.svg?maxAge=3700)](http://pypi.python.org/pypi/licensr)\n\nMaking your project compliant to the guidelines of the [REUSE Initiative](https://reuse.software/) i.e. adding license and copyright information to every file in your project is an annoying process and can be quite tedious.\n\nLicensr allows you to quickly add your chosen to your project from the command line. \nYou just have to download the full license texts of your chosen licenses (and the one of your project's dependencies) and configure the config file to make the tool match your needs.\n\nDon't see what you need?\n[Open an issue](https://github.com/max-elia/licensr/issues/new)\nto suggest any changes or improvements!\n\n### Prerequisites\n\n* Python 3.4+\n\n### Installation\n\n```bash\n$ pip install licensr\n```\n\nAlternatively, grab the\n[zip](https://github.com/max-elia/licensr/tarball/v0.1)!\n\n### Usage\n\nFrom the command line:\n\n```bash\n$ licensr -c \"config file\" -p \"project name\"\n```\n\nThe arguments are optional and will default to \"config.json\" and the current working directory.\n\n### Configuration\n\n#license_text\nThe path to the file with the full license text. This file itself will be excluded from the licensing process. You are responsible for removing afterwards from your project.\nDon't place your license_text files into the LICENSES folder, because it will be rewritten during the licensing.\n\n#SPDX\nThe short identifier of the license.\n\n## Source Code Header\n#src_extensions_and_comment\nYou are required to add a comment-header to every source code file in your project. Therefore you have to specify under src_extensions_and_comment the src_extensions and the corresponding comment characters for every programming language used.\nFor the comments you can put either one (single-line comment), two (opening and closing) or three (opening - middle - closing) strings into a list.\n\n#header\nThe header has to include a copyright notice and the SPDX Identifier of the license. In the config file it can be given as a path to a file or as string of the full header (be sure to include \"\\n\")\n\nFor the src files this information is sufficient.\nHowever we often don't have the ability to add the necessary information to every file for several reasons (e.g. binary files).\nThe [REUSE Initiative's practices](https://reuse.software/practices/2.0/) specify two other possibilities to add the licensing and copyright information also for those files.\n* Debian File\n\ta file in the [DEP-5/copyright](https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/) file format\n* .license File\n\ta file with the same name but the .license extension, containing the header.\n\n## Debian File\nFor this method in addition to the SPDX we need:\n#copyright\nYear and Name of the copyright holder(s)\n\n## .license File\nFor this method we only need the header.\n\n#exceptions\nIf we have different licenses or copyright holders, we have to consider them in the exceptions. Here we have to specify the \"path\" variable for the desired directory or file. For the rest, based on which of the three preceding methods you want to use, you have to specify exactly the same options like before (except for the license_text, if the license is the same)\n\nIf more that one licensing-method is possible the order in which the methods are used is:\n1. Source Code Header\n2. Debian File\n3. .license File\n\nATTENTION: The tool overwrites all old headers with the new ones. Be sure to save them if you need them.\n\n\n### Contributing\n\nI accept [pull requests](https://github.com/max-elia/licensr/compare);\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/max-elia/licensr", "keywords": "licenser licensing reuse open source", "license": "", "maintainer": "", "maintainer_email": "", "name": "licensr", "package_url": "https://pypi.org/project/licensr/", "platform": "", "project_url": "https://pypi.org/project/licensr/", "project_urls": { "Homepage": "https://github.com/max-elia/licensr" }, "release_url": "https://pypi.org/project/licensr/0.1.1/", "requires_dist": null, "requires_python": "", "summary": "A CLI for licensing your project", "version": "0.1.1" }, "last_serial": 4659729, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "79a5c2bb23f92f9da77d4b976c4a016e", "sha256": "95cd9d2ce8403e94a487ead786e2c4dbf4fabc91112b892e2cc1a8ef2dda40f7" }, "downloads": -1, "filename": "licensr-0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "79a5c2bb23f92f9da77d4b976c4a016e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5876, "upload_time": "2019-01-04T08:52:26", "url": "https://files.pythonhosted.org/packages/50/39/e97260138cb75bd1c38e361b8105cb3701c3992045d3263e97606a69da87/licensr-0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "beb967e212527ba557c0666d2ab6d724", "sha256": "f3eb55513d6189a5a3577985524ca02da63bb91d794f81aad549ccec6024cae5" }, "downloads": -1, "filename": "licensr-0.1.tar.gz", "has_sig": false, "md5_digest": "beb967e212527ba557c0666d2ab6d724", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5417, "upload_time": "2019-01-04T08:52:28", "url": "https://files.pythonhosted.org/packages/72/c6/f583d54b003832d154419a59aaaec5c60a607075dcd4ec8e50004816bf57/licensr-0.1.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "9eaaf04ee4b46a416e888388a73fdd2f", "sha256": "647755ad9943e5a439a6f206323f6f06e46f221557a04aba46e71742467076d0" }, "downloads": -1, "filename": "licensr-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "9eaaf04ee4b46a416e888388a73fdd2f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5999, "upload_time": "2019-01-04T10:29:58", "url": "https://files.pythonhosted.org/packages/15/5f/d2051a6b5357417601d24da8ccd7b118b167d10925b542f51e30f13bf4cc/licensr-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f372f98e81869ee4ebc6f2a05da522b7", "sha256": "c67dd06064e823357a3f68e6a432dcc4651045c23060fb2363d6e6ce85360793" }, "downloads": -1, "filename": "licensr-0.1.1.tar.gz", "has_sig": false, "md5_digest": "f372f98e81869ee4ebc6f2a05da522b7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5515, "upload_time": "2019-01-04T10:29:59", "url": "https://files.pythonhosted.org/packages/7f/aa/537658d3f74feed1ecbdf797990a0186d49da50a340b556f62d12ed55267/licensr-0.1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9eaaf04ee4b46a416e888388a73fdd2f", "sha256": "647755ad9943e5a439a6f206323f6f06e46f221557a04aba46e71742467076d0" }, "downloads": -1, "filename": "licensr-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "9eaaf04ee4b46a416e888388a73fdd2f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5999, "upload_time": "2019-01-04T10:29:58", "url": "https://files.pythonhosted.org/packages/15/5f/d2051a6b5357417601d24da8ccd7b118b167d10925b542f51e30f13bf4cc/licensr-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f372f98e81869ee4ebc6f2a05da522b7", "sha256": "c67dd06064e823357a3f68e6a432dcc4651045c23060fb2363d6e6ce85360793" }, "downloads": -1, "filename": "licensr-0.1.1.tar.gz", "has_sig": false, "md5_digest": "f372f98e81869ee4ebc6f2a05da522b7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5515, "upload_time": "2019-01-04T10:29:59", "url": "https://files.pythonhosted.org/packages/7f/aa/537658d3f74feed1ecbdf797990a0186d49da50a340b556f62d12ed55267/licensr-0.1.1.tar.gz" } ] }