Metadata-Version: 2.1
Name: xlfly
Version: 0.5.0
Summary: 
Author: Your Name
Author-email: you@example.com
Requires-Python: >=3.9
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: pandas (>=1.5.2)
Requires-Dist: pillow (>=9.4.0)
Requires-Dist: pywin32 (>=300)
Requires-Dist: setuptools (>=70.1.0)
Requires-Dist: uv (>=0.2.15,<0.3.0)
Requires-Dist: xlwings (>=0.28.0)
Description-Content-Type: text/markdown

# xlfly - separate GUI based Excel tools

I love xlwings! However, I have noticed it very difficult to handle heavy calculations if using user defined functions. Hence xlfly: making using UDF easier. I chose separate GUI so that I can run parallel threads easier. 

## Usage

![usage demo](doc/usage_demo.png)

This package only works on Windows

1. Write python commands in Excel cells. Select it, click to run!
2. Write python in **commments** section in Excel. Select it, and click to run! Note: if there is comment, the cell value commands will NOT run.

Note: if there is numeric value and a comment on the cell, the cell will not **run** the numeric value. For example, say "A1" cell has value 1, and comment "sht["A1"].value = 1", you run it. It will not run the "1" in the cell

Create Windows Start Menu Item:

```bash
>>> xly --init
```


Excel selection to "Run Python"
1. Write python expressions in the cells
2. Select the cell with python scripts
3. Click "Run Python" button


I used the icon from https://www.iconfinder.com/search?q=wings&price=free drawn by Monsieur Steven Ankri. Thanks!

### Special commands

* self.run_cell()

    Run multiple cells with a command

    Example:
    `run_cell(xw.books.active.sheets.active["A1:A5"])`

* xw.Range.to_link()

    Convert the range to link texts values. It is used for cases where you want to preserve the link to update the data in the future

* self.show_console()

    Show the console window. In case you want to give the user indicator info in console window

* self.hide_console()

    Hide the console 

## Templates

Specify a template root path to have all subfolders as options in the "templates > choose template" menu. Once selected, the main() function in the __init__.py file in that subfolder will be executed to initialize the template.

This is useful when you want the user to set up the template on the fly

UDF VBA functions - sometimes users wants to have functions they can directly use in the Excel cells. In that case, it is recommended to write *.xlam files with UDF inside, then move it to the user addin directory. Such copy file over operation can be done with xlfly.move_addin() function

## PythonPath

When run python, both `current workbook` and `script_path` setting from setting page will be added to pythonpath. You can put your draft python script file in the same folder as current Excel file to debug.


## default folder

Within template folder, you can add "default" subfolder to be added to pythonpath by default, and the default.py file will be imported automatically. This is useful if you want to create Excel use cases where user can work on an empty Excel file without installing anything or making changes to Excel file

## Debug

To debug the scripts in Excel, run the menu: tools > create debug script. There will be a debug.py file to the same folder as current Excel file. You can start from there to debug

script of the same name from Excel file folder will be imported first. 

- Thus you can debug by putting the scripts in the Excel folder
- Once done, move the file to the python path specified in the config page


Error messages will be thrown out:

![error message](doc/error_msg.png)

You can also toggle to show the console at Menu: Tools > Toggle Console

Progress: suggest to use xlwings's app.status_bar = "status message" to display process message
