chronsync-0.1.3 is not a library.

🕰️ chronsync - Lightweight Task Scheduler Daemon

chronsyncは、Rustで構築された超軽量なCLIタスクスケジューラー（デーモン）です。 JSON設定ファイルに基づき、cronライクなスケジュールで外部コマンドを永続的に実行します。設定ファイルの変更を即座に検知し、実行中のタスクを停止・再構築（リロード）するホットリロード機能を備えています。

✨ 特徴

🛡️ 堅牢な設計: Rustの非同期ランタイム tokio を採用し、安定した長時間稼働を実現。
🔄 ホットリロード: 設定ファイル（config.json）の変更をリアルタイムで監視。サービスを再起動することなく、保存と同時にタスク定義を更新します。
⏰ 詳細なスケジューリング: 秒単位を含む Cron形式で、精密な実行時刻の指定が可能。
🚀 高パフォーマンス: シングルバイナリで動作し、リソース消費を最小限に抑えます。

📦 インストールとビルド

ソースコードからビルドしてインストールします。

# リポジトリのクローン
git clone https://github.com/coil398/chronsync.git
cd chronsync

# ローカルへのインストール (パスが通った場所にバイナリが配置されます)
cargo install --path .

⚙️ 設定ファイル (`config.json`)

chronsyncの動作には設定ファイルが必須です。アプリケーションは起動時に標準的な設定ディレクトリ（XDG Base Directoryなど）を検索します。

設定ファイルの配置場所

設定ディレクトリに config.json を作成してください。

OS	パス
Linux / macOS	`~/.config/chronsync/config.json`

💡 ヒント: 初回起動時に設定ファイルが見つからない場合、chronsyncは検索したパスをエラーログに出力して終了します。そのパスを参考にファイルを配置してください。

設定フォーマット

JSON形式で tasks 配列を定義します。

{
  "tasks": [
    {
      "name": "ping_test",
      "cron_schedule": "*/5 * * * * *", 
      "command": "/bin/echo",
      "args": ["Hello World"]
    },
    {
      "name": "shell_script_example",
      "cron_schedule": "0 0 * * * *", 
      "command": "/bin/sh",
      "args": [
        "-c",
        "/bin/echo \"Current date is $(date)\""
      ]
    }
  ]
}

name: タスクの識別子（ログ出力に使用）。
cron_schedule: cron形式のスケジュール文字列（秒分時日月曜日年）。
- 例: */1 * * * * * (毎秒), 0 30 9 * * * (毎日9:30:00)
command: 実行するコマンドのパス。
args: コマンドへの引数の配列。
- 注意: パイプ | やリダイレクト >、環境変数展開 $VAR を使用したい場合は、command にシェル（/bin/sh や /bin/bash）を指定し、args で "-c" とコマンド文字列を渡してください。

🚀 実行方法

手動実行 (開発・テスト)

# コンパイルして実行
cargo run

Systemd ユーザーサービスとして登録 (Linux)

常駐プロセスとして動作させる場合、systemdのユーザーサービスとして登録するのが便利です。

ユニットファイルの作成 ~/.config/systemd/user/chronsync.service を作成します（ディレクトリがない場合は作成してください）。

[Unit]
Description=chronsync Task Scheduler
After=network.target

[Service]
# cargo installでインストールしたバイナリのパスを指定
# "which chronsync" コマンドで確認できます (例: /home/ユーザー名/.cargo/bin/chronsync)
ExecStart=%h/.cargo/bin/chronsync

# 常に再起動
Restart=always
RestartSec=5s

# ログ出力設定
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=default.target

サービスの有効化と起動

# 設定の再読み込み
systemctl --user daemon-reload

# サービスの起動
systemctl --user start chronsync

# 自動起動の有効化
systemctl --user enable chronsync

ログの確認
```
journalctl --user -u chronsync -f
```

📂 プロジェクト構成

.
├── src/
│   ├── main.rs       # エントリーポイント、初期化、メインループ
│   ├── config.rs     # 設定ファイルの定義と読み込みロジック
│   ├── scheduler.rs  # タスクのスケジューリングと実行管理
│   └── watcher.rs    # 設定ファイルの変更監視
├── config.json       # 設定ファイルのサンプル
└── Cargo.toml        # 依存関係定義

chronsync 0.1.3