go-utils

README

📚 Go Utils

Go Utils は、Go言語でアプリケーションを開発する際に繰り返し必要となる、汎用的で再利用可能なユーティリティ機能を集めたライブラリです。

このプロジェクトは、それぞれの機能が独立したパッケージとして提供されており、必要な機能のみをアプリケーションにインポートして利用することで、クリーンな依存関係を維持できます。

✨ 特徴

• モジュール性: 各ユーティリティが独立したGoパッケージとして提供されます。
• 汎用性: 特定のアプリケーションドメインに依存しない、幅広いタスクに適用可能です。
• 信頼性: 外部ライブラリ（例: cenkalti/backoff）を利用して、堅牢な機能を提供します。

---

🛠️ インストール

プロジェクト全体をインストールするには、以下のコマンドを使用します。

go get github.com/shouni/go-utils

特定のパッケージのみを利用する場合は、そのパッケージをインポートしてください（例: import "github.com/shouni/go-utils/timeutil"）。

---

📦 パッケージ構成 (Package Structure)

以下のパッケージがこのリポジトリで提供されています。

パッケージ	説明	主な提供機能	関連情報
iohandler	ファイルI/Oと標準入出力（stdin/stdout）を抽象化します。CLIアプリケーションでの入出力処理を簡潔にします。	ファイルまたは標準入力からのコンテンツの読み込み (ReadInput)、ファイルまたは標準出力へのコンテンツの書き込み (WriteOutput)	-
envutil	環境変数を取得し、存在しない場合にデフォルト値を適用したり、型変換を行ったりするヘルパーを提供します。	環境変数取得 (GetEnv)、型変換付き環境変数取得 (GetEnvAsBool など)	新規追加
urlpath	URLの解析を行い、ファイルシステムパスへの変換や、Webサービス設定におけるURLスキームの安全性の判定に使用します。	URLのサニタイズ、一意なキャッシュパスの生成 (SanitizeURLToUniquePath, GenerateGCSKeyName)、Webサービスのセキュア判定 (IsSecureServiceURL)	-
timeutil	日本標準時 (JST) の取得と変換など、時刻とタイムゾーン処理を単純化します。	JSTの現在時刻の取得 (NowJST)、任意の時刻をJSTへ変換 (ToJST)	新規追加
retry	外部サービス連携などで発生する一時的なエラーに対応するための、汎用的なリトライロジックを提供します。	指数バックオフ、カスタムエラー判定 (Do 関数)	github.com/cenkalti/backoff/v4 を利用
text	テキストデータのクリーンアップと整形を行います。特に、非互換な文字の除去と表示の切り詰めに役立ちます。	絵文字の除去と空白の正規化 (CleanStringFromEmojis)、マルチバイト対応の文字列切り詰め (Truncate)、カンマ区切りのリストパース (ParseCommaSeparatedList)	github.com/forPelevin/gomoji を利用
（その他）	必要に応じて追加されるその他のユーティリティパッケージ。	ロギング、文字列操作、設定管理など

---

📜 ライセンス (License)

このプロジェクトは MIT License の下で公開されています。