Metadata-Version: 2.4
Name: exshell
Version: 2025020400.0.1
Summary: A library for creating console applications that use Excel as a display.
Project-URL: Repository, https://github.com/muzudho/exshell.git
Author-email: Takahashi Satoshi <muzudho1@gmail.com>
Maintainer-email: Takahashi Satoshi <muzudho1@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: console application,excel
Classifier: Programming Language :: Python
Requires-Python: >=3.12.3
Requires-Dist: openpyxl>=3.1.5
Requires-Dist: tomlkit>=0.13.2
Description-Content-Type: text/markdown

# Exshell

Excel をディスプレイと見立てたコンソール・アプリケーションを作るライブラリー。  
サンプル・プログラムが付いています。  


## 実装例

Exshell は以下のリポジトリーで利用しています。使い方の参考にしてください。  

* 📖 [GitHub > Muzudho > Create a color palette](https://github.com/muzudho/create-a-color-palette)  


## 事前設定

* 構成
    * Windows 11 で動作確認しました
    * デスクトップ・アプリ版の Microsoft Excel がインストールされていることが必要です
* 手順
    * [インストールの手順](https://github.com/muzudho/exshell/blob/main/docs/how_to_install.md)


## 例１

### 概要

![成果物](https://github.com/muzudho/exshell/raw/main/docs/img/202502__pg__01-2238--upper-case.png)  

👆　上図のような表を作成するアプリケーションです。  


### 実行手順

以下のコマンドを打鍵してください。  

```shell
py gradation.py
```

![エクセルのパスを入力](https://github.com/muzudho/exshell/raw/main/docs/img/202502__pg__01-2259--excel-path.png)  

👆　上図。　EXCEL.exe ファイルへのパスを入力してください。  

![コンフィグ設定](https://github.com/muzudho/exshell/raw/main/docs/img/202502__pg__01-2303--config-setup.png)  

👆　このアプリケーションが、 Excel を自動的に開けるようになりました。  

以下、自動的に Excel を開いたり閉じたりが行われます。（下図）  
ターミナルを見たり、 Excel を見たりしてください。  

![色相選択](https://github.com/muzudho/exshell/raw/main/docs/img/202502__pg__01-2310--select-hue.png)  

👆　開かれたワークシートを参考に、番号を入力してください。  

![色の数指定](https://github.com/muzudho/exshell/raw/main/docs/img/202502__pg__01-2312--number-of-colors.png)  

👆　Excel が開かれないこともあります。色の数を指定してください。  

![彩度の選択](https://github.com/muzudho/exshell/raw/main/docs/img/202502__pg__01-2315--select-saturation.png)  

👆　同様。  

![明度の選択](https://github.com/muzudho/exshell/raw/main/docs/img/202502__pg__01-2318--select-brightness.png)  

👆　同様。  

![グラデーションの出力](https://github.com/muzudho/exshell/raw/main/docs/img/202502__pg__01-2319--output-gradation.png)  

👆　グラデーションが出力されました。  
