feat: add installation script and README for ritobin-tools

Author: Crauzer

README.md

@@ -0,0 +1,109 @@
+# ritobin-tools
+
+[![License](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue.svg)](LICENSE-MIT)
+
+A fast, modern CLI utility for working with League of Legends `.bin` files (binary property trees). Convert between binary and human-readable text formats, and diff files with ease.
+
+## Features
+
+- **Convert** — Transform `.bin` files to readable `.py`/`.ritobin` text format and vice versa
+- **Diff** — Compare two bin files with colored unified diff output
+- **Batch Processing** — Recursively convert entire directories
+- **Hashtable Support** — Automatic hash resolution for readable property names
+- **Cross-Platform** — Works on Windows, Linux, and macOS
+
+## Installation
+
+### Windows (PowerShell)
+
+Run this command in PowerShell to install the latest release:
+
+```powershell
+irm https://raw.githubusercontent.com/LeagueToolkit/ritobin-tools/main/install.ps1 | iex
+```
+
+This will:
+- Download the latest release
+- Install to `%LOCALAPPDATA%\LeagueToolkit\ritobin-tools`
+- Add to your PATH automatically
+
+### From Source
+
+Requires [Rust 1.85+](https://rustup.rs/) (edition 2024).
+
+```bash
+git clone https://github.com/LeagueToolkit/ritobin-tools.git
+cd ritobin-tools
+cargo build --release
+```
+
+The binary will be available at `target/release/ritobin-tools`.
+
+## Usage
+
+### Convert
+
+Convert between binary `.bin` files and text `.py`/`.ritobin` formats.
+
+```bash
+# Binary to text
+ritobin-tools convert input.bin
+# → Creates input.py
+
+# Text to binary
+ritobin-tools convert input.py
+# → Creates input.bin
+
+# Specify output path
+ritobin-tools convert input.bin -o output.py
+
+# Convert all files in a directory
+ritobin-tools convert ./data/
+
+# Recursively convert all files
+ritobin-tools convert ./data/ -r
+```
+
+### Diff
+
+Compare two bin files and display differences in unified diff format.
+
+```bash
+# Basic diff
+ritobin-tools diff old.bin new.bin
+
+# Adjust context lines (default: 3)
+ritobin-tools diff old.bin new.bin -C 5
+
+# Disable colored output
+ritobin-tools diff old.bin new.bin --no-color
+```
+
+Supports comparing any combination of `.bin`, `.py`, and `.ritobin` files.
+
+## Configuration
+
+A `config.toml` file is automatically created next to the executable on first run.
+
+```toml
+hashtable_dir = "/path/to/LeagueToolkit/bin_hashtables"
+```
+
+### Hashtables
+
+Hashtables enable human-readable names for properties instead of raw hashes. By default, the tool looks for hashtables in:
+
+```
+~/Documents/LeagueToolkit/bin_hashtables/
+```
+
+You can override this with:
+- The `--hashtable-dir` CLI flag
+- The `hashtable_dir` setting in `config.toml`
+
+## License
+
+Licensed under either of:
+
+- [MIT License](LICENSE-MIT)
+- [Apache License, Version 2.0](LICENSE-APACHE)

install.ps1

@@ -0,0 +1,79 @@
+# Installs the latest ritobin-tools release for Windows (user scope)
+
+param(
+    [string]$Owner = "LeagueToolkit",
+    [string]$Repo  = "ritobin-tools",
+    [string]$Channel = "windows-x64",
+    [string]$InstallDir = "$env:LOCALAPPDATA\LeagueToolkit\ritobin-tools"
+)
+
+$ErrorActionPreference = 'Stop'
+
+Write-Host "Installing ritobin-tools..." -ForegroundColor Cyan
+
+if (!(Test-Path -LiteralPath $InstallDir)) {
+    New-Item -ItemType Directory -Path $InstallDir -Force | Out-Null
+}
+
+# Get latest release metadata
+$releaseApi = "https://api.github.com/repos/$Owner/$Repo/releases/latest"
+try {
+    $release = Invoke-RestMethod -Uri $releaseApi -Headers @{ 'User-Agent' = 'ritobin-tools-installer' }
+} catch {
+    throw "Failed to query GitHub releases: $($_.Exception.Message)"
+}
+
+$tag = $release.tag_name
+# Extract the first semantic version (handles tags like "v0.1.1" or "ritobin-tools-v0.1.1")
+$match = [regex]::Match($tag, '\d+\.\d+\.\d+([\-\+][A-Za-z0-9\.-]+)?')
+$version = if ($match.Success) { $match.Value } else { $tag.TrimStart('v') }
+
+$assetName = "ritobin-tools-$version-$Channel.zip"
+$asset = $release.assets | Where-Object { $_.name -eq $assetName } | Select-Object -First 1
+if (-not $asset) {
+    # Fallback: find any ritobin-tools asset matching the channel
+    $pattern = "^ritobin-tools-.*-" + [regex]::Escape($Channel) + "\.zip$"
+    $asset = $release.assets | Where-Object { $_.name -match $pattern } | Select-Object -First 1
+}
+if (-not $asset) {
+    throw "Could not find asset matching '$assetName' (channel $Channel) in the latest release."
+}
+if ($asset.name -ne $assetName) { $assetName = $asset.name }
+
+$zipPath = Join-Path $env:TEMP $assetName
+Write-Host "Downloading $assetName ($version)..." -ForegroundColor Yellow
+Invoke-WebRequest -Uri $asset.browser_download_url -OutFile $zipPath -UseBasicParsing
+
+Write-Host "Extracting to $InstallDir" -ForegroundColor Yellow
+Expand-Archive -Path $zipPath -DestinationPath $InstallDir -Force
+
+# Create a shim directory so PATH is simple and stable
+$binDir = Join-Path $InstallDir 'bin'
+if (!(Test-Path -LiteralPath $binDir)) { New-Item -ItemType Directory -Path $binDir | Out-Null }
+
+# Ensure the executable exists
+$exePath = Join-Path $InstallDir 'ritobin-tools.exe'
+if (!(Test-Path -LiteralPath $exePath)) {
+    throw "ritobin-tools.exe not found after extraction: $exePath"
+}
+
+# Place a thin cmd shim in bin to avoid spaces in paths and simplify PATH updates
+$shimCmd = @"
+@echo off
+"$exePath" %*
+"@
+Set-Content -LiteralPath (Join-Path $binDir 'ritobin-tools.cmd') -Value $shimCmd -Encoding Ascii -Force
+
+# Add to user PATH if missing
+$currentPath = [Environment]::GetEnvironmentVariable('Path', 'User')
+if (-not ($currentPath -split ';' | Where-Object { $_ -eq $binDir })) {
+    $newPath = if ([string]::IsNullOrEmpty($currentPath)) { $binDir } else { "$currentPath;$binDir" }
+    [Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
+    Write-Host "Added to PATH (User): $binDir" -ForegroundColor Green
+} else {
+    Write-Host "PATH already contains: $binDir" -ForegroundColor Green
+}
+
+Write-Host "Installed ritobin-tools $version to $InstallDir" -ForegroundColor Green
+Write-Host "Open a new terminal and run: ritobin-tools --help" -ForegroundColor Cyan
+