https://github.com/NCHlab/excel_generator
CLI/GUI tool that generates custom formatted table in excel, ready to go
https://github.com/NCHlab/excel_generator
Last synced: 4 months ago
JSON representation
CLI/GUI tool that generates custom formatted table in excel, ready to go
- Host: GitHub
- URL: https://github.com/NCHlab/excel_generator
- Owner: NCHlab
- Created: 2020-04-19T14:54:51.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T09:50:06.000Z (over 2 years ago)
- Last Synced: 2024-08-13T07:08:55.074Z (8 months ago)
- Language: Python
- Homepage:
- Size: 147 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- jimsghstars - NCHlab/excel_generator - CLI/GUI tool that generates custom formatted table in excel, ready to go (Python)
README
# Excel Generator
This is a quick excel generator CLI/GUI Tool, with the GUI created using PySide2 GUI library.
This tool allows for quick generation of basic excel sheet formatted into a table.
(The primary object of this project is to learn how to use QT5 / PySide2 Library to create a GUI interface)
## GUI
Fill 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.
The 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.
To Create py file from the QT Designer ui file:
```bash
pyside2-uic gui_menu.ui -o main.py
```## CLI Tool
The CLI version allows for the program to be executed via a Terminal.
```bash
python excel_gen_cli.py -f "Houses" -p "PATH\Where\To\Save" -th "Table, Header, names, seperated, by, a, comma" -ac Accent2# To gen a formatted file quickly
python excel_gen_cli.py -qc True
```| Argument | Alias | Help | Default Value |
| --------------- | ----- | -------------------------------------------------------------------- | ------------------------- |
| --table_header | -th | Column Table Names e.g "Car Make, Model, Year, Price" | |
| --filename | -f | Name of the file to be created | Sheet1 |
| --filepath | -p | Location where file should be saved | Same place as file called |
| --sheetname | -s | Name of the Excel Sheet | Sheet1 |
| --rows | -r | \ | 4 |
| --columns | -c | \ | 5 |
| --accent_type | -ac | Accent Types (Accent1 - 5 exist) | Accent1 |
| --quick_create | -qc | Allows for quick generation of file (uses most defaults) | False |
| --force_columns | -fc | Enables for more cols to be created than table header names provided | False |## Examples
```bash
# Normal Usage
python 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# Simple use . to use current directory
python excel_gen_cli.py -f Cars -s Cars_to_buy_v1 -p "." -th "Make, Model, Year, Price, Fuel Type, Colour" -ac Accent2# Generate Rows and columns
python excel_gen_cli.py -f Cars -s Cars_to_buy_v1 -p "." -ac Accent2 -r 5 -c 10# Generator columns with headers, but format table for more columns
python excel_gen_cli.py -f Cars -s Cars_to_buy_v1 -p "." -th "Make, Model, Year, Price, Fuel Type, Colour" -c 10 -fc true
```
```bash
# Quick Create
python excel_gen_cli.py -qc True
```
# Building The Program
This project uses `auto-py-to-exe` to create an executable file which can be found in the release section.
How ever to build from source code, you can use pythons build function (This way means that the file is larger ~300MB instead of ~80MB).
git clone this repo, ensure `cx_Freeze` is installed and run:
```bash
python setup.py build
```
