{ "info": { "author": "Suku John George", "author_email": "sukujgrg@gmail.com", "bugtrack_url": null, "classifiers": [ "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "# pptx-builder-from-yaml\n\n> CLI to generate powerpoint slides from simple yaml file[s]\n\n* [pptx-builder-from-yaml](#pptx-builder-from-yaml)\n * [Dependencies to run the CLI](#dependencies-to-run-the-cli)\n * [How to install?](#how-to-install)\n * [How does a yaml file look like for generating pptx?](#how-does-a-yaml-file-look-like-for-generating-pptx)\n * [How to use the CLI?](#how-to-use-the-cli)\n * [How to generate pptx[s]?](#how-to-generate-pptxs)\n * [How to validate a yaml and then generate the PPTX?](#how-to-validate-a-yaml-and-then-generate-the-pptx)\n * [FAQs](#faqs)\n * [How can I add same footer to all pptx[s] built using the CLI?](#how-can-i-add-same-footer-to-all-pptxs-built-using-the-cli)\n * [How to get different backgrounds for the generated pptx files using the CLI?](#how-to-get-different-backgrounds-for-the-generated-pptx-files-using-the-cli)\n * [How to setup development environment?](#how-to-setup-development-environment)\n * [How to run tests?](#how-to-run-tests)\n\n\n## Dependencies to run the CLI\n- `>= python3.4`\n- python modules\n - `click==7.0.0`\n - [python-pptx==0.6.16](https://python-pptx.readthedocs.io/en/latest/)\n - `PyYAML==3.13`\n\n## How to install?\n> https://pypi.org/project/pptx-builder-from-yaml/\n```bash\npip install pptx-builder-from-yaml\n```\n\n## How does a yaml file look like for generating pptx?\n\nHere is a sample yaml file - [Dummy.yml](unit_tests/pptx_builder/yamls/Dummy.yml)\n\n## How to use the CLI?\n```bash\n$ pptx-builder --help\nUsage: pptx-builder [OPTIONS] YAML_PATHS...\n\n A powerpoint builder\n\n https://github.com/sukujgrg/pptx-builder-from-yaml\n\nOptions:\n -pt, --pptx-template-path PATH [required]\n -ms, --master-slide-idx INTEGER\n [default: 0]\n -sl, --slide-layout-idx INTEGER\n [default: 6]\n -fs, --font-size INTEGER [default: 32]\n -fn, --font-name TEXT [default: Calibri]\n -ns, --dst-dir TEXT [default: ./generated-pptx]\n -ta, --slide-txt-alignment [left|middle|right]\n [default: left]\n --validate Run yaml validation against schema\n --version Show the version and exit.\n --help Show this message and exit.\n```\n### How to generate pptx[s]?\n```bash\npptx-builder slide_yamls/ -pt pptx-templates/default.pptx\n```\n**Notes:**\n- `slide_yamls/` is the directory that holds `yaml` files for slides. The `yaml`[s] must\nfollow the schema defined in the code. [Here](unit_tests/pptx_builder/yamls/Dummy.yml) is an\nexample `yaml` file. `slide_yamls` are positional arguments and can accept files and\ndirectories. If a positional argument is a directory, it will try to build individual\n`pptx` with each `yaml` files in the same directory.\n- `--pptx-template-path | -pt` is expecting either a directory or a pptx file. If it is a \ndirectory, `pptx-builder` will chose one among all the pptx files found in the same directory.\nThe pptx template file should be without any change to master slide index or in slide\nlayout index. If there are any changes to master slide index or slide layout, you need to\npass corresponding `int` type to `-ms` and `-sl` options.\nA sample pptx template file can seen here [pptx-templates](unit_tests/pptx_builder/pptx-templates).\n- The default `--new-slide-path` is `tmp` directory and hence it depends on the operating\nsystem you run the `pptx-builder` on.\n\n\n### How to validate a yaml and then generate the PPTX?\n```bash\npptx-builder slide_yamls/dummy.yml -dm master_slides/default.pptx --validate\n```\n\n## FAQs\n### How can I add same footer to all pptx[s] built using the CLI?\n\nAdd footer to pptx template file to pass with `--pptx-template-path` option\n\n### How to get different backgrounds for the generated pptx files using the CLI?\n\nCreate different pptx template files with different backgrounds and pass it on to\n`--pptx-template-path` option. See [this](https://youtu.be/AftDaPQwhPg) video on\ncreating pptx template file.\n\n## How to setup development environment?\n\n```bash\ngit clone https://github.com/sukujgrg/pptx-builder-from-yaml.git\n\ncd pptx-builder-from-yaml\n\npipenv install --dev\n\npipenv shell\n\npipenv graph\n```\n\n## How to run tests?\n```bash\ncd pptx-builder-from-yaml/\n\ntox .\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/sukujgrg/pptx-builder-from-yaml", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "pptx-builder-from-yaml", "package_url": "https://pypi.org/project/pptx-builder-from-yaml/", "platform": "", "project_url": "https://pypi.org/project/pptx-builder-from-yaml/", "project_urls": { "Homepage": "https://github.com/sukujgrg/pptx-builder-from-yaml" }, "release_url": "https://pypi.org/project/pptx-builder-from-yaml/0.0.4/", "requires_dist": [ "click (==7.0)", "python-pptx (==0.6.16)", "PyYAML (==3.13)", "jsonschema (==2.6.0)" ], "requires_python": ">=3.4", "summary": "CLI to generate powerpoint slides from simple yaml file[s]", "version": "0.0.4" }, "last_serial": 4614405, "releases": { "0.0.0": [ { "comment_text": "", "digests": { "md5": "880413c0cd8bba8f63a811e5cf494d2b", "sha256": "5c6053b5a56f6e12a6d509c9559415089418aa14e7c5097d482eaa07945f8e79" }, "downloads": -1, "filename": "pptx_builder_from_yaml-0.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "880413c0cd8bba8f63a811e5cf494d2b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.4", "size": 6698, "upload_time": "2018-12-18T23:26:46", "url": "https://files.pythonhosted.org/packages/ef/0c/5ba99738909e081f9bedd4c554461488450c2765dbd3dcc377b983d53a15/pptx_builder_from_yaml-0.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7c0a156e3eb52aed182c4e6512c16fa5", "sha256": "73e90022fde0950ee3ff4b985e60831214d24a6a0c7f978761e25624644d72e1" }, "downloads": -1, "filename": "pptx-builder-from-yaml-0.0.0.tar.gz", "has_sig": false, "md5_digest": "7c0a156e3eb52aed182c4e6512c16fa5", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.4", "size": 5515, "upload_time": "2018-12-18T23:26:48", "url": "https://files.pythonhosted.org/packages/80/8f/e4d446168230f5d68fa9bc35a222b499a0d15d539aa926c8b68cb4969021/pptx-builder-from-yaml-0.0.0.tar.gz" } ], "0.0.1": [ { "comment_text": "", "digests": { "md5": "a982d4220fe5968b9e36fef8699bee97", "sha256": "a6e12d1ba2b9a9b595cfded390bbd4181943e87d3e74287ca3b962d54d1413e8" }, "downloads": -1, "filename": "pptx_builder_from_yaml-0.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "a982d4220fe5968b9e36fef8699bee97", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.4", "size": 4295, "upload_time": "2018-12-13T20:00:15", "url": "https://files.pythonhosted.org/packages/e9/fc/07ce1f63169dd5589aedb71cb559522052bda27e33fa7f358b82db72a459/pptx_builder_from_yaml-0.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "38954b5dcfed603c7f70663bb1891743", "sha256": "c3010c2a20775facc100c4bb468aea325d0cf53a2ed65e5f1b5a25189e04e2e3" }, "downloads": -1, "filename": "pptx-builder-from-yaml-0.0.1.tar.gz", "has_sig": false, "md5_digest": "38954b5dcfed603c7f70663bb1891743", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.4", "size": 3601, "upload_time": "2018-12-13T20:00:18", "url": "https://files.pythonhosted.org/packages/3c/72/72eca138a585e4577360f4ce0499b60606a297a92adc803f14799ed49ce9/pptx-builder-from-yaml-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "a0fa6349e6619fce86a13cb86d9ddf6e", "sha256": "5c4cb3843d27cb5805735da4a81351979dad86e4506e00f6cd9afc03e980a90e" }, "downloads": -1, "filename": "pptx_builder_from_yaml-0.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "a0fa6349e6619fce86a13cb86d9ddf6e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.4", "size": 6827, "upload_time": "2018-12-13T21:25:50", "url": "https://files.pythonhosted.org/packages/60/45/59e6f0e9da46b41af3fdfec990e82340e8a68067745caaf0de7fce03f4c6/pptx_builder_from_yaml-0.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b4123d5ad00d434273bcfb71b33f5512", "sha256": "3398067ca5d67feed3c68d972f6accae361caa27b44c5143b1712e5b98634ba4" }, "downloads": -1, "filename": "pptx-builder-from-yaml-0.0.2.tar.gz", "has_sig": false, "md5_digest": "b4123d5ad00d434273bcfb71b33f5512", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.4", "size": 5746, "upload_time": "2018-12-13T21:25:51", "url": "https://files.pythonhosted.org/packages/ba/7a/f658eaf59f82376b75d24cc5792a14dee395a88c54ae399f27c6c987211b/pptx-builder-from-yaml-0.0.2.tar.gz" } ], "0.0.3": [ { "comment_text": "", "digests": { "md5": "c05850baaae17709cf09e39487f64284", "sha256": "a1618d0de1882114f350a63dbb4e914b70462b4d6ed5e2a910febd42cd3fcf67" }, "downloads": -1, "filename": "pptx_builder_from_yaml-0.0.3-py3-none-any.whl", "has_sig": false, "md5_digest": "c05850baaae17709cf09e39487f64284", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.4", "size": 6905, "upload_time": "2018-12-17T09:40:47", "url": "https://files.pythonhosted.org/packages/25/3f/6ad66880a7a9dd95c1a177e360eb97b90c81ccf9f10fa5325c03f1e7ff49/pptx_builder_from_yaml-0.0.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1fd58d597df408bb80c16664c97b85f5", "sha256": "a162014dc580e90ef2ef01cf4384939b7b7f1fa21bae8276d401d39d0c35efe3" }, "downloads": -1, "filename": "pptx-builder-from-yaml-0.0.3.tar.gz", "has_sig": false, "md5_digest": "1fd58d597df408bb80c16664c97b85f5", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.4", "size": 5818, "upload_time": "2018-12-17T09:40:49", "url": "https://files.pythonhosted.org/packages/38/d5/5184835d214948b402c34da906e5c7dab511b5ee46934e5e1d27efac26cc/pptx-builder-from-yaml-0.0.3.tar.gz" } ], "0.0.4": [ { "comment_text": "", "digests": { "md5": "90e1b880a847d7394a724b5396a01e15", "sha256": "c9d59e8885463e1a4e764fcb0bfd25fc2d154e869b5bea4b4adfc8fd7470b1bb" }, "downloads": -1, "filename": "pptx_builder_from_yaml-0.0.4-py3-none-any.whl", "has_sig": false, "md5_digest": "90e1b880a847d7394a724b5396a01e15", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.4", "size": 6697, "upload_time": "2018-12-18T23:46:29", "url": "https://files.pythonhosted.org/packages/21/20/7b20adcdf2d17beeae622cea1a9e4ab8487cc2a5957493b82f23c384879f/pptx_builder_from_yaml-0.0.4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1fdab628f54c7df3e330591fde583792", "sha256": "52d0bf452a1ddef14e2d5ad373a0fc52adf83369153c7bba5616f91bd4e1415e" }, "downloads": -1, "filename": "pptx-builder-from-yaml-0.0.4.tar.gz", "has_sig": false, "md5_digest": "1fdab628f54c7df3e330591fde583792", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.4", "size": 5502, "upload_time": "2018-12-18T23:46:31", "url": "https://files.pythonhosted.org/packages/b7/8d/66d624190cc9a34aca89ca26a2107ce455cc5a35e6bd39793178473872ff/pptx-builder-from-yaml-0.0.4.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "90e1b880a847d7394a724b5396a01e15", "sha256": "c9d59e8885463e1a4e764fcb0bfd25fc2d154e869b5bea4b4adfc8fd7470b1bb" }, "downloads": -1, "filename": "pptx_builder_from_yaml-0.0.4-py3-none-any.whl", "has_sig": false, "md5_digest": "90e1b880a847d7394a724b5396a01e15", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.4", "size": 6697, "upload_time": "2018-12-18T23:46:29", "url": "https://files.pythonhosted.org/packages/21/20/7b20adcdf2d17beeae622cea1a9e4ab8487cc2a5957493b82f23c384879f/pptx_builder_from_yaml-0.0.4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1fdab628f54c7df3e330591fde583792", "sha256": "52d0bf452a1ddef14e2d5ad373a0fc52adf83369153c7bba5616f91bd4e1415e" }, "downloads": -1, "filename": "pptx-builder-from-yaml-0.0.4.tar.gz", "has_sig": false, "md5_digest": "1fdab628f54c7df3e330591fde583792", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.4", "size": 5502, "upload_time": "2018-12-18T23:46:31", "url": "https://files.pythonhosted.org/packages/b7/8d/66d624190cc9a34aca89ca26a2107ce455cc5a35e6bd39793178473872ff/pptx-builder-from-yaml-0.0.4.tar.gz" } ] }