{"id":14065514,"url":"https://github.com/NCHlab/excel_generator","last_synced_at":"2025-07-29T20:33:02.086Z","repository":{"id":50170152,"uuid":"257026629","full_name":"NCHlab/excel_generator","owner":"NCHlab","description":"CLI/GUI tool that generates custom formatted table in excel, ready to go","archived":false,"fork":false,"pushed_at":"2022-12-08T09:50:06.000Z","size":151,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-08-13T07:08:55.074Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NCHlab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-04-19T14:54:51.000Z","updated_at":"2023-01-23T22:56:53.000Z","dependencies_parsed_at":"2023-01-25T00:45:48.085Z","dependency_job_id":null,"html_url":"https://github.com/NCHlab/excel_generator","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NCHlab%2Fexcel_generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NCHlab%2Fexcel_generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NCHlab%2Fexcel_generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NCHlab%2Fexcel_generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NCHlab","download_url":"https://codeload.github.com/NCHlab/excel_generator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228046158,"owners_count":17861101,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-13T07:04:32.142Z","updated_at":"2024-12-04T04:31:13.353Z","avatar_url":"https://github.com/NCHlab.png","language":"Python","readme":"# Excel Generator\n\nThis is a quick excel generator CLI/GUI Tool, with the GUI created using PySide2 GUI library.\n\nThis tool allows for quick generation of basic excel sheet formatted into a table.\n\n(The primary object of this project is to learn how to use QT5 / PySide2 Library to create a GUI interface)\n\n## GUI\n\nFill out the fields and hit create to generate an excel sheet. If you fill out the `Headers` field, you do not need to set the number of columns, however you can override this by ticking the checkbox.\n\n\u003cimg src=\"./images/gui_ex1.png\" alt=\"Image Of Window with filled out information\" width=\"350\" height=\"303\"\u003e\n\n\u003cimg src=\"./images/gui_ex2.png\" alt=\"Image Of Created info box\" width=\"350\" height=\"303\"\u003e\n\nThe GUI version allows a quick way to create an excel file using the `quick create` button. The location of the file is set to where the program is located unless the filepath is provided.\n\n\u003cimg src=\"./images/gui_ex3.png\" alt=\"Image Of Quick Create\" width=\"380\" height=\"319\"\u003e\n\nTo Create py file from the QT Designer ui file:\n\n```bash\npyside2-uic gui_menu.ui -o main.py\n```\n\n## CLI Tool\n\nThe CLI version allows for the program to be executed via a Terminal.\n\n```bash\npython excel_gen_cli.py -f \"Houses\" -p \"PATH\\Where\\To\\Save\" -th \"Table, Header, names, seperated, by, a, comma\" -ac Accent2\n\n# To gen a formatted file quickly\npython excel_gen_cli.py -qc True\n```\n\n| Argument        | Alias | Help                                                                 | Default Value             |\n| --------------- | ----- | -------------------------------------------------------------------- | ------------------------- |\n| --table_header  | -th   | Column Table Names e.g \"Car Make, Model, Year, Price\"                |                           |\n| --filename      | -f    | Name of the file to be created                                       | Sheet1                    |\n| --filepath      | -p    | Location where file should be saved                                  | Same place as file called |\n| --sheetname     | -s    | Name of the Excel Sheet                                              | Sheet1                    |\n| --rows          | -r    | \\\u003cNum\u003e                                                               | 4                         |\n| --columns       | -c    | \\\u003cNum\u003e                                                               | 5                         |\n| --accent_type   | -ac   | Accent Types (Accent1 - 5 exist)                                     | Accent1                   |\n| --quick_create  | -qc   | Allows for quick generation of file (uses most defaults)             | False                     |\n| --force_columns | -fc   | Enables for more cols to be created than table header names provided | False                     |\n\n## Examples\n\n```bash\n# Normal Usage\npython excel_gen_cli.py -f Cars -s Cars_to_buy_v1 -p \"/home/ncy/projects/cars_proj/\" -th \"Make, Model, Year, Price, Fuel Type, Colour\" -ac Accent2\n\n# Simple use . to use current directory\npython excel_gen_cli.py -f Cars -s Cars_to_buy_v1 -p \".\" -th \"Make, Model, Year, Price, Fuel Type, Colour\" -ac Accent2\n\n# Generate Rows and columns\npython excel_gen_cli.py -f Cars -s Cars_to_buy_v1 -p \".\" -ac Accent2 -r 5 -c 10\n\n# Generator columns with headers, but format table for more columns\npython excel_gen_cli.py -f Cars -s Cars_to_buy_v1 -p \".\" -th \"Make, Model, Year, Price, Fuel Type, Colour\" -c 10 -fc true\n```\n\n![Image](./images/create_ex1.png)\n\n```bash\n# Quick Create\npython excel_gen_cli.py -qc True\n```\n\n![Image](./images/quick_create_ex2.png)\n\n# Building The Program\n\nThis project uses `auto-py-to-exe` to create an executable file which can be found in the release section.\n\nHow ever to build from source code, you can use pythons build function (This way means that the file is larger ~300MB instead of ~80MB).\n\ngit clone this repo, ensure `cx_Freeze` is installed and run:\n\n```bash\npython setup.py build\n```\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNCHlab%2Fexcel_generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FNCHlab%2Fexcel_generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNCHlab%2Fexcel_generator/lists"}