{ "info": { "author": "iovetux", "author_email": "me@ilovetux.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Topic :: Utilities" ], "description": "********\r\nPlugemin\r\n********\r\n\r\n.. image:: https://travis-ci.org/iLoveTux/plugemin.svg?branch=master\r\n :alt: Travis-CI Build Status (for Linux)\r\n :target: https://travis-ci.org/iLoveTux/plugemin\r\n\r\n.. image:: https://readthedocs.org/projects/plugemin/badge/?version=latest\r\n :target: http://plugemin.readthedocs.io/en/latest/?badge=latest\r\n :alt: Documentation Status\r\n\r\nplugemin is a simple utility which uses the amazing jinja2 templating engine\r\nand structured data such as XML, JSON or CSV to plug values into templates\r\nmany times. Think of a form letter, but endlessly useful. With this you\r\ncan render plain text, HTML, XML, JSON or even Python or C. Anything is\r\npossible as long as it is plain text (UTF is supported) in the end.\r\n\r\nplugemin was initially designed to template commands which were to be sent over\r\nSSH to target systems.\r\n\r\nGetting Started\r\n===============\r\n\r\nThese instructions will get you a copy of the project up and running\r\non your local machine for development and testing purposes.\r\n\r\nPrerequisites\r\n-------------\r\n\r\nYou will need the following software installed:\r\n\r\n* Python >= 2.7\r\n* jinja2\r\n* lxml\r\n\r\nlxml is the only one which needs a compiler to install. If this is an issue,\r\nI would recomend the great\r\n`Anaconda Python Distribution `_\r\nwhich includes all the prerequisites installed by default.\r\n\r\nInstalling\r\n----------\r\n\r\nYou can install the latest stable version with the following command:\r\n\r\n.. code:: bash\r\n\r\n $ pip install plugemin\r\n\r\nor for the latest development version, you can use the following command:\r\n\r\n.. code:: bash\r\n\r\n $ pip install git+https://github.com/ilovetux/plugemin.git\r\n\r\nRunning the tests\r\n-----------------\r\n\r\nIn order to run the tests, you will need to clone the repository and kick off\r\nthe tests with a single command. All of that can be done with the following\r\ncommands:\r\n\r\n.. code:: bash\r\n\r\n $ git clone https://github.com/ilovetux/plugemin\r\n $ cd plugemin\r\n $ python setup.py nosetests\r\n\r\n\r\nThat's it, the tests should pass, if they don't please open an\r\n`issue `_ and be sure to include:\r\n\r\n* The commands you ran to get your results\r\n* The versions of Python, lxml and jinja2 you have installed\r\n* What Operating system\r\n* Any details which would cause your setup to be considered non-standard\r\n such as running an obscure version of Linux\r\n\r\nBasic Usage\r\n-----------\r\n\r\nPlugemin will look for templates in a series of locations and take a\r\nstructured data format as input. It will render the template with each\r\npiece of data.\r\n\r\n*Example*\r\n\r\nin C:\\\\plugemin\\\\templates\\\\backup-delete.j2::\r\n\r\n cp {{src}} {{dst}}\r\n rm {{src}}\r\n\r\nin C:\\\\tmp\\\\files.csv::\r\n\r\n src,dst\r\n /var/log/*,/tmp/.\r\n /usr/var/log/*,/tmp/.\r\n /var/www/*,/tmp/.\r\n\r\nThen you can use the following command::\r\n\r\n C:\\> plugemin -t backup-delete.j2 -d C:\\plugemin\\files.csv\r\n cp /var/log/* /tmp/.\r\n rm /var/log/*\r\n cp /usr/var/log/* /tmp/.\r\n rm /usr/var/log/*\r\n cp /var/www/* /tmp/.\r\n rm /var/www/*\r\n\r\nContributing\r\n============\r\n\r\nPlease read\r\n`CONTRIBUTING.rst `_\r\nfor details on our code of conduct, and the process for submitting pull\r\nrequests to us.\r\n\r\nVersioning\r\n==========\r\n\r\nWe use `SemVer `_ for versioning. For the versions\r\navailable, see the\r\n`tags on this repository `_.\r\n\r\nAuthors\r\n=======\r\n\r\n* `iLoveTux `_\r\n\r\nSee also the list of\r\n`contributors `_\r\nwho participated in this project.\r\n\r\nLicense\r\n=======\r\n\r\nThis project is licensed under the GPL Version 3 or later, please see\r\nthe `LICENSE `_\r\nfile for details\r\n\r\nAcknowledgments\r\n===============\r\n\r\n* Hat tip to anyone who's code was used (Jinja2, lxml and Python)\r\n* Brian Kearney and James Brennan for the inspiration to build this utility\r\n* Anyone listed in the contributors file\r\n* Everyone who helps us by submitting issues and pull requests\r\n", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/ilovetux/plugemin", "keywords": "template reports", "license": "GPLv3", "maintainer": null, "maintainer_email": null, "name": "plugemin", "package_url": "https://pypi.org/project/plugemin/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/plugemin/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://github.com/ilovetux/plugemin" }, "release_url": "https://pypi.org/project/plugemin/0.1.1/", "requires_dist": null, "requires_python": null, "summary": "A template as a service utility...you know, for DevOps", "version": "0.1.1" }, "last_serial": 2809364, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "d3ca18ea99b46f71de3c61b782234bdb", "sha256": "c253d0369fc1645b1b47181deef5dee2fbc34885838558af766461ca0a6a140f" }, "downloads": -1, "filename": "plugemin-0.1.0.tar.gz", "has_sig": false, "md5_digest": "d3ca18ea99b46f71de3c61b782234bdb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3972, "upload_time": "2017-04-10T15:31:38", "url": "https://files.pythonhosted.org/packages/00/e5/b319eecd61eac31d5c5545414f05cff1238c1893b65bc4a89379807e4248/plugemin-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "ac4f4ad5d6a05a8c02ea475d4d9b30f3", "sha256": "d93573f9f476df91df9a8cbd931e2e7ec1b78474029c9c89d0b4fe25d9b21b80" }, "downloads": -1, "filename": "plugemin-0.1.1.zip", "has_sig": false, "md5_digest": "ac4f4ad5d6a05a8c02ea475d4d9b30f3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8623, "upload_time": "2017-04-17T18:51:06", "url": "https://files.pythonhosted.org/packages/24/b1/d8375d66c102cdfab9feb6fc7d6244977f54db9d90a950a7426256da150c/plugemin-0.1.1.zip" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "ac4f4ad5d6a05a8c02ea475d4d9b30f3", "sha256": "d93573f9f476df91df9a8cbd931e2e7ec1b78474029c9c89d0b4fe25d9b21b80" }, "downloads": -1, "filename": "plugemin-0.1.1.zip", "has_sig": false, "md5_digest": "ac4f4ad5d6a05a8c02ea475d4d9b30f3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8623, "upload_time": "2017-04-17T18:51:06", "url": "https://files.pythonhosted.org/packages/24/b1/d8375d66c102cdfab9feb6fc7d6244977f54db9d90a950a7426256da150c/plugemin-0.1.1.zip" } ] }