Merge branch 'develop'

.github/workflows/test.yml

@@ -3,6 +3,7 @@ name: test
 on:
   push:
   pull_request:
+  workflow_dispatch:
 
 jobs:
   test:

README.md

@@ -6,26 +6,46 @@ HSP3言語で書かれたプログラムをテストするためのフレーム
 
 ## インストール
 
-以下の手順でhsptestをインストールすることができます。
+hsptestを使用する手段によって、以下の2通りのインストール方法があります。
+1. バッチファイル(`run_hsptest.bat`)からhsptestを実行する場合
+2. コマンドラインからhsptestを実行する場合
 
-1. HSP3をインストールします
-2. HSP3インストールフォルダ(例：`C:/hsp36`)を環境変数PATHに追加します
-3. [Releases](https://github.com/mass-0910/hsptest/releases/latest)からhsptest.zipをダウンロードします
-4. hsptest.zipを解凍し、中に含まれているファイルを以下のように移動してください
-   |移動するファイル|移動先フォルダ|
-   |---|---|
-   |`hsptest.exe`|HSP3インストールフォルダ直下 (例：`C:\hsp36`)|
-   |`common`内の全ての`.as`ファイル|HSP3インストールフォルダの`common`フォルダ (例：`C:\hsp36\common`)|
+### バッチファイル(`run_hsptest.bat`)からhsptestを実行する場合
 
-## 使い方
+起動用のバッチファイルからhsptestを実行する場合は、以下の手順でインストールしてください。
+
+1. [Releases](https://github.com/mass-0910/hsptest/releases/latest)からhsptest.zipをダウンロードします
+2. hsptest.zipを解凍し、中に含まれる`install.bat`を実行します。
+3. 以下の画像のように、`run_hsptest.bat`ファイルをテストスクリプトが格納されたフォルダに移動させます
+
+![run_hsptest](https://github.com/mass-0910/hsptest/assets/53329734/7f256589-39dc-448a-a5a8-6c67be9ac7c8)
+
+### コマンドラインからhsptestを実行する場合
+
+hsptestをコマンドラインからhsptestを実行する場合は、以下の手順でインストールしてください。
+
+1. HSP3インストールフォルダ(例：`C:/hsp36`)を環境変数PATHに追加します
+2. [Releases](https://github.com/mass-0910/hsptest/releases/latest)からhsptest.zipをダウンロードします
+3. hsptest.zipを解凍し、中に含まれる`install.bat`を実行します。
+
+## バッチファイル(`run_hsptest.bat`)の使い方
+
+`run_hsptest.bat`をエクスプローラからダブルクリックすることで、hsptestの実行が開始します。  
+コマンドプロンプトが起動され、テストスクリプトを実行した結果が表示されます。
+
+また、hsptest_log.txtというファイルが生成され、その中にテストのログが出力されます。
+
+コマンドラインからhsptestを実行する場合、`run_hsptest.bat`は使用しません。
+
+## コマンドラインからの使い方
 
 以下のコマンドでhsptestを実行できます。
 
 ```
 hsptest
 ```
 
-hsptestは、カレントディレクトリに置かれている`test`を名前に含む`.hsp`スクリプトファイルをテストスクリプトとして認識し、それらを実行します。テストスクリプトが別のフォルダに置かれてある場合は、そのフォルダを引数で指定することができます。
+テストスクリプトが別のフォルダに置かれてある場合は、そのフォルダを引数で指定することができます。
 
 ```
 hsptest path/to/testfolder
@@ -48,6 +68,7 @@ hsptestを実行する際に以下のオプションを指定できます。
 
 ## テストスクリプトの書き方
 
+hsptestは、`test`を名前に含むHSPスクリプトファイルをテストスクリプトとして認識し、それらを実行します。  
 hsptestで実行されるテストは、テスト一つに対して一つのサブルーチンで記述する必要があります。テストサブルーチンのラベル名は、`*test`から始まるものである必要があります。以下の例のようにテストスクリプトを記述してください。
 
 ```

VERSION

@@ -1,5 +1,5 @@
 # encoing Shift-JIS
-_PRODUCTVERSION=0.8
+_PRODUCTVERSION=0.7.1
 Comments=HSP3�e�X�g�t���[�����[�N
 FileDescription=HSP3�e�X�g�t���[�����[�N���s�t�@�C��
 LegalCopyright=(c)2022 mass-0910

hsptest.hsp

@@ -21,7 +21,7 @@
 #uselib "winmm.dll"
 #cfunc timeGetTime "timeGetTime"
 
-version = "0.8"
+version = "0.7.1"
 
 sdim stdout, 2000
 sdim ln, 2000

install.bat

@@ -0,0 +1,38 @@
+@echo off
+
+@rem HSPインストールフォルダを取得する
+if "%1"=="" (
+    for /D %%a in (C:\hsp3*) do (
+        set hsp_dir=%%a
+    )
+) else (
+    if not exist "%1" (
+        echo %1 ：フォルダが見つかりません
+        pause
+        exit /B 1
+    )
+    set hsp_dir=%1
+)
+
+@rem インストールフォルダを取得できなかったらエラー表示して終了
+if not defined hsp_dir (
+    echo HSP3のインストールフォルダが見つかりませんでした。
+    echo このバッチファイルの引数にHSP3のインストールフォルダのパスを入力してください。
+    echo 例）> install.bat C:\hsp36
+    pause
+    exit /B 1
+)
+
+@rem hsptestのインストールを開始する
+echo %hsp_dir%にhsptestのインストールを開始します。
+copy /Y hsptest.exe %hsp_dir%
+copy /Y common\* %hsp_dir%\common
+
+if %ERRORLEVEL% neq 0 (
+    echo hsptestのインストールに失敗しました。
+    pause
+    exit /B 1
+)
+
+echo hsptestのインストールが完了しました。
+pause

run_hsptest.bat

@@ -0,0 +1,28 @@
+@echo off
+
+@rem 注意1：このバッチファイルはテストスクリプト(test_***.hsp)が含まれているフォルダに配置してください。
+
+@rem 注意2：このバッチファイルはC:\hsp3*フォルダにHSP3がインストールされていることを想定して書かれてあります。
+@rem C:\hsp3*以外の場所にHSP3をインストールしている場合、以下の変数にインストールフォルダへのパスを代入してください。
+set hsp_dir=
+
+@rem Cドライブ直下からHSPインストールフォルダを探す
+if not defined hsp_dir (
+    for /D %%a in (C:\hsp3*) do (
+        set hsp_dir=%%a
+    )
+)
+
+@rem インストールフォルダを取得できなかったらエラー表示して終了
+if not defined hsp_dir (
+    echo HSP3のインストールフォルダが見つかりませんでした。
+    echo %0をメモ帳などのエディタで開き、7行目のhsp_dir変数に、ご自分のPCのHSP3インストールフォルダへのパスを書き込んでください。
+    echo 例）set hsp_dir=%USERPROFILE%\hsp36
+    pause
+    exit /B 1
+)
+
+@rem hsptest実行
+%hsp_dir%\hsptest.exe -v -l hsptest_log.txt -s
+
+pause