{ "info": { "author": "", "author_email": "", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "\n**nicexcel** is a lightweight Python package \nthat provides the possibility of exporting pandas \nnative DataFrame objects into nicely formatted MS Excel files.\n\nThe package leverages **pandas** and **openpyxl** open-source \nPython libraries to add some simple aesthetic details to output Excel files.\nThis improves the overall aspect and usability of the files, hence, it \ncan help in the automation of reporting activities.\n\n1. Column widths auto-adapted to fit characters contained inside them\n2. Header row containing filterable columns within Excel (by default)\n3. Header row freezed (by default)\n4. No indexing by default (vs **pandas** default index set on)\n5. Columns in the output Excel file have a formatting that resembles \n**pandas** default data types. However, it is still possible to specify some \nnumber format via specific arguments\n\n#### Getting started with *to_excel()*\n\nThe **nicexcel** package main functionality consists in the exporting of \npandas.DataFrame object. The *to_excel()* method is conceived as\na wrapper of the popular *pd.DataFrame.to_excel()* that takes two \nkey inputs:\n * **df**: pd.DataFrame instance\n * **filename**: string containing file path where the output \n *.xlsx* file will be saved\n\nSee below a simple example of application\n\n```python\nimport nicexcel as nl\nimport pandas as pd\n\n# instantiate mock data\nmock_df = pd.DataFrame(data={\n 'Product Line': [\"T-Shirts\", \"Jeans\", \"Jackets\"],\n 'Units sold': [11213, 9908, 2345],\n 'Yearly Revenues': [30000.0411, 45513.1228, 10220.103],\n 'Gross Margin (%)': [0.223, 0.1151, 0.458]})\n\n# column format\ncols_format = {'Integer': ['Yearly Income'], '%': ['Gross Margin (%)']}\n\n# generate nicely formatted excel\nnl.to_excel(\n df=mock_df,\n filename='output.xlsx',\n cols_format=cols_format)\n``` \n\n![Output Results](https://raw.githubusercontent.com/scouseralex/nicexcel/master/docs-images/method1_snippet.png)\n\n\n#### A second method: *to_excel_ms()*\n\nIn a similar fashion, the *nicexcel.to_excel_ms()* allows the \npossibility of exporting a group of different *pd.DataFrame* \nobjects to the same output .xlsx files on different worksheets.\n\nThe method takes two main arguments\n * **dfs**: dict of pd.DataFrame instances\n * **filename**: string containing file path where the output \n *.xlsx* file will be saved\n\nSee an example of application below.\n\n```python\nimport nicexcel as nl\nimport pandas as pd\n\n# get sample data\ntx_df = pd.DataFrame(data={\n 'date': ['11/08/2018', '09/04/2018', '30/03/2018'], \n 'customer': ['XYZ Corporation', 'ABC Electric', 'XYZ Corporation'],\n 'price': [113.202, 220.99, 90.1011]})\ncust_df = pd.DataFrame(data={\n 'customer': ['ABC Electric', 'XYZ Corporation'],\n 'city': ['London', 'Tokyo'],\n 'revenue (M)': [100.2334, 76.23216]})\n\n# initiate dict of dataframes\ndfs = {'transactional_db': tx_df, 'customer_db': cust_df}\n\n# generate nicely formatted excel file\nnl.to_excel_ms(\n dfs=dfs,\n filename='output_ms')\n``` \n)\n\n### Documentation\nThe documentation is available in docstrings provided within \nthe code.\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/scouseralex/nicexcel", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "nicexcel", "package_url": "https://pypi.org/project/nicexcel/", "platform": "", "project_url": "https://pypi.org/project/nicexcel/", "project_urls": { "Homepage": "https://github.com/scouseralex/nicexcel" }, "release_url": "https://pypi.org/project/nicexcel/0.1.12/", "requires_dist": [ "pandas (>=0.20.0)", "openpyxl (>=2.5.0)" ], "requires_python": ">=3.6.0", "summary": "A package for writing nicely formatted Pandas dataframes in Excel data files", "version": "0.1.12" }, "last_serial": 4854367, "releases": { "0.1.10": [ { "comment_text": "", "digests": { "md5": "28bfe4f115e1100237ef6ea7e6a55600", "sha256": "c9bc81afd683719051a9aac0a7236cd31461647b61f57117cae6eb1f3699d1b0" }, "downloads": -1, "filename": "nicexcel-0.1.10-py3-none-any.whl", "has_sig": false, "md5_digest": "28bfe4f115e1100237ef6ea7e6a55600", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 11131, "upload_time": "2019-02-21T21:28:37", "url": "https://files.pythonhosted.org/packages/11/e1/ecec746fed32bf77e101e40751adb1785bc8822fa4b7c5f01a6c615e8535/nicexcel-0.1.10-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a9d0e6d601f2c9cace7b10b7762ca252", "sha256": "c8a087dc0b15ca9e16933a5e315b43d83df8871f44e89b33d3124c4f81eaf21d" }, "downloads": -1, "filename": "nicexcel-0.1.10.tar.gz", "has_sig": false, "md5_digest": "a9d0e6d601f2c9cace7b10b7762ca252", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 8518, "upload_time": "2019-02-21T21:28:39", "url": "https://files.pythonhosted.org/packages/15/8a/7a149bbb37c571ffaf3a3491d284c95c0d7a450b3de451d131cfc9efa299/nicexcel-0.1.10.tar.gz" } ], "0.1.11": [ { "comment_text": "", "digests": { "md5": "11529a3f652aa2a4aa51a23c46def7a5", "sha256": "2f4649e1c0f0918493614119c18b807272b25384df144bb1924c0a660d48d4bf" }, "downloads": -1, "filename": "nicexcel-0.1.11-py3-none-any.whl", "has_sig": false, "md5_digest": "11529a3f652aa2a4aa51a23c46def7a5", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 11372, "upload_time": "2019-02-22T08:06:47", "url": "https://files.pythonhosted.org/packages/da/0e/eea86d4e4fb58579016c866ace0b841ddecdc8db534c8af1f7b59bc844d8/nicexcel-0.1.11-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "106f676f42d6a536410959f233418b7c", "sha256": "5b0068c65b6086f58977fa3658a2c3e818f3b4940b385f471cd209d43847f559" }, "downloads": -1, "filename": "nicexcel-0.1.11.tar.gz", "has_sig": false, "md5_digest": "106f676f42d6a536410959f233418b7c", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 8737, "upload_time": "2019-02-22T08:06:48", "url": "https://files.pythonhosted.org/packages/33/69/0a9a84f4c879b1997e6d641ab432a5bfbbbb2277319ad2dd04ddc1345abc/nicexcel-0.1.11.tar.gz" } ], "0.1.12": [ { "comment_text": "", "digests": { "md5": "2c6f74e38434e711e01454b10035473f", "sha256": "d8a1e8a3eae545f3256c5f4563480f0728f2c38d688d7444fff1e96edf73869c" }, "downloads": -1, "filename": "nicexcel-0.1.12-py3-none-any.whl", "has_sig": false, "md5_digest": "2c6f74e38434e711e01454b10035473f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 11378, "upload_time": "2019-02-22T12:52:04", "url": "https://files.pythonhosted.org/packages/58/a2/b82217b64b41e038b2545ed7dc2c8f8362397eeac1dc2cf3dbf7e0478b8e/nicexcel-0.1.12-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "625a39644874aae612d1de1347572d11", "sha256": "e5ec95a26d46ae335b44632e665c087772ac7926dc2b3db830b95a7a06c742cc" }, "downloads": -1, "filename": "nicexcel-0.1.12.tar.gz", "has_sig": false, "md5_digest": "625a39644874aae612d1de1347572d11", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 8734, "upload_time": "2019-02-22T12:52:06", "url": "https://files.pythonhosted.org/packages/10/aa/f69ccd82acbaa3c0b2d1a56efde99494e854abce623225951a66eb114fe0/nicexcel-0.1.12.tar.gz" } ], "0.1.6": [ { "comment_text": "", "digests": { "md5": "459ec7ce5c409e701d91ccbcb156257d", "sha256": "4689bc6e91bad0d1fcabd6a689c134d7049e176a72fa4ee2cb1c5559f57b5609" }, "downloads": -1, "filename": "nicexcel-0.1.6-py3-none-any.whl", "has_sig": false, "md5_digest": "459ec7ce5c409e701d91ccbcb156257d", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 9095, "upload_time": "2019-02-04T23:09:13", "url": "https://files.pythonhosted.org/packages/2e/a7/eaa5618e283fa3e8704c296a96cf583dcc7cd3e3495e7c9f0ba76f0ad696/nicexcel-0.1.6-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8d34d34c6af8793db331103f8425c738", "sha256": "366b2143d3f7de753e72e2e0131d247f51c86c2262ee41f458cb2ed1c2d4a238" }, "downloads": -1, "filename": "nicexcel-0.1.6.tar.gz", "has_sig": false, "md5_digest": "8d34d34c6af8793db331103f8425c738", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 6891, "upload_time": "2019-02-04T23:09:15", "url": "https://files.pythonhosted.org/packages/a4/07/343633ea145508f61a57ce7f029acce9ecce774245a4616d265ecb1c7340/nicexcel-0.1.6.tar.gz" } ], "0.1.7": [ { "comment_text": "", "digests": { "md5": "3479a7a9727c97af763248856165f432", "sha256": "bdccfefe00f3055f624db8a19b639aa6486f76dbb89aa60ec34fb2eeaeba95da" }, "downloads": -1, "filename": "nicexcel-0.1.7-py3-none-any.whl", "has_sig": false, "md5_digest": "3479a7a9727c97af763248856165f432", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 9046, "upload_time": "2019-02-06T21:57:58", "url": "https://files.pythonhosted.org/packages/ff/3b/5f6bd843298dcc3dd8d96102488799255c0e034f9fdfb025df679e56e581/nicexcel-0.1.7-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "048b4ba364d9dfe51d26f2675fa06663", "sha256": "63d2793eea926b15df7ca625ad16f54fb6140963339fef4f9b85298300024dc6" }, "downloads": -1, "filename": "nicexcel-0.1.7.tar.gz", "has_sig": false, "md5_digest": "048b4ba364d9dfe51d26f2675fa06663", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 6861, "upload_time": "2019-02-06T21:58:00", "url": "https://files.pythonhosted.org/packages/9a/d3/db9f1e23f4b118a447668efb056f302a86781e71510762dcf5d5465b0319/nicexcel-0.1.7.tar.gz" } ], "0.1.8": [ { "comment_text": "", "digests": { "md5": "0bfa1a31c17de312bc599923b7f86f98", "sha256": "4e82a440841c9ffb507f06a255d31ec079ca09cd80321b3e27e08b4fca1be4bd" }, "downloads": -1, "filename": "nicexcel-0.1.8-py3-none-any.whl", "has_sig": false, "md5_digest": "0bfa1a31c17de312bc599923b7f86f98", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 9041, "upload_time": "2019-02-06T22:03:01", "url": "https://files.pythonhosted.org/packages/38/60/346fde06ed842ac6c560b614a49a87778b28ae01f33abf4d356370774f81/nicexcel-0.1.8-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "6da8b7b28a118970dbe488db7d78c3de", "sha256": "e66e72efa0f12e8f82f40d29f2561bd4c9c8e62244e28000d7cc2696a425df41" }, "downloads": -1, "filename": "nicexcel-0.1.8.tar.gz", "has_sig": false, "md5_digest": "6da8b7b28a118970dbe488db7d78c3de", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 6865, "upload_time": "2019-02-06T22:03:02", "url": "https://files.pythonhosted.org/packages/2a/66/e8ea0c5f5c4ea0260599694ca965b4e54a8ced7cded8596abc674446535c/nicexcel-0.1.8.tar.gz" } ], "0.1.9": [ { "comment_text": "", "digests": { "md5": "ec9a73c113b04ea965fcccf2a5c71105", "sha256": "143e3c9ac3d7bf796e498333ef3257930aec15c5a52b1ea24fbb53651c96ba3d" }, "downloads": -1, "filename": "nicexcel-0.1.9-py3-none-any.whl", "has_sig": false, "md5_digest": "ec9a73c113b04ea965fcccf2a5c71105", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 9044, "upload_time": "2019-02-06T22:16:22", "url": "https://files.pythonhosted.org/packages/70/db/ffcb9c1d541ce238266328929dfb91762301936f8f567d4019de43cc4baa/nicexcel-0.1.9-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8694a51adafc60839b7501a06549420e", "sha256": "ed32ec7aaf921b14eb1e8384174c9ff93ce2ba3409116fad1bcb72998ba5e4f6" }, "downloads": -1, "filename": "nicexcel-0.1.9.tar.gz", "has_sig": false, "md5_digest": "8694a51adafc60839b7501a06549420e", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 6859, "upload_time": "2019-02-06T22:16:24", "url": "https://files.pythonhosted.org/packages/ae/d1/31cf84819b58ff5f9ee57ec67a3c1061bbeb4d77364f9844740e29f9876f/nicexcel-0.1.9.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "2c6f74e38434e711e01454b10035473f", "sha256": "d8a1e8a3eae545f3256c5f4563480f0728f2c38d688d7444fff1e96edf73869c" }, "downloads": -1, "filename": "nicexcel-0.1.12-py3-none-any.whl", "has_sig": false, "md5_digest": "2c6f74e38434e711e01454b10035473f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 11378, "upload_time": "2019-02-22T12:52:04", "url": "https://files.pythonhosted.org/packages/58/a2/b82217b64b41e038b2545ed7dc2c8f8362397eeac1dc2cf3dbf7e0478b8e/nicexcel-0.1.12-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "625a39644874aae612d1de1347572d11", "sha256": "e5ec95a26d46ae335b44632e665c087772ac7926dc2b3db830b95a7a06c742cc" }, "downloads": -1, "filename": "nicexcel-0.1.12.tar.gz", "has_sig": false, "md5_digest": "625a39644874aae612d1de1347572d11", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 8734, "upload_time": "2019-02-22T12:52:06", "url": "https://files.pythonhosted.org/packages/10/aa/f69ccd82acbaa3c0b2d1a56efde99494e854abce623225951a66eb114fe0/nicexcel-0.1.12.tar.gz" } ] }