files

package module
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 21, 2025 License: MIT Imports: 7 Imported by: 1

README

files

一般的なファイル操作を提供する go ライブラリ。

ドキュメント

$ go get github.com/thamaji/files

Documentation

Index

Constants

This section is empty.

Variables

View Source
var DefaultDirPerm fs.FileMode = 0755 // ディレクトリパーミッションのデフォルト値(0755)
View Source
var DefaultFilePerm fs.FileMode = 0644 // ファイルパーミッションのデフォルト値(0644)

Functions

func Copy

func Copy(srcpath, dstpath string) error

Copy は、指定された srcpath から dstpath へファイルまたはディレクトリをコピーします。 ファイルの場合は、そのまま内容をコピーし、 ディレクトリの場合は中のファイル・ディレクトリを再帰的にコピーします。

func Create

func Create(name string, opt ...Option) (*os.File, error)

Create は指定されたファイルを読み書きモードで開き、ファイルが存在しない場合は作成します。 オプションでファイルに関する設定を指定できます。

func CreateTemp

func CreateTemp(dir string, pattern string, opt ...Option) (*os.File, error)

CreateTemp は指定されたディレクトリに一時ファイルを作成します。 ディレクトリが存在しない場合は作成し、指定されたパターンに基づいて一時ファイルを作成します。 オプションでファイルに関する設定を指定できます。

func Exists

func Exists(name string) (bool, error)

Exists は指定されたファイルまたはディレクトリが存在するかを確認します。 存在する場合は true を、存在しない場合は false を返します。

func IsDir

func IsDir(name string) (bool, error)

IsDir は指定された名前がディレクトリかどうかを確認します。

func IsEmptyDir

func IsEmptyDir(name string) (bool, error)

IsEmptyDir は指定されたディレクトリが空かどうかを確認します。

func Mkdir

func Mkdir(name string, opt ...Option) error

Mkdir は指定した名前のディレクトリを作成します。 オプションでディレクトリのパーミッションを指定できます。

func MkdirAll

func MkdirAll(path string, opt ...Option) error

MkdirAll は指定したパスに必要なディレクトリを再帰的に作成します。 オプションでディレクトリのパーミッションを指定できます。

func MkdirTemp

func MkdirTemp(dir string, pattern string, opt ...Option) (string, error)

MkdirTemp は指定されたディレクトリに一時ディレクトリを作成します。 作成したディレクトリに指定されたパーミッションを設定します。 オプションでファイルに関する設定を指定できます。

func Move

func Move(oldpath, newpath string) error

Move はファイルまたはディレクトリを oldpath から newpath に移動します。 まず os.Rename を試みますが、失敗した場合は Copy でコピーを行い、 その後、元のファイルを削除します。

func MustExists

func MustExists(name string) bool

MustExists は指定されたファイルまたはディレクトリが存在するかを確認します。 存在する場合は true を返し、存在しない場合は false を返します。 エラーが発生した場合も false を返します。

func MustIsDir

func MustIsDir(name string) bool

MustIsDir は指定された名前がディレクトリかどうかを確認します。 エラーが発生した場合、false を返します。

func MustIsEmptyDir

func MustIsEmptyDir(name string) bool

MustIsEmptyDir は指定されたディレクトリが空かどうかを確認します。 エラーが発生した場合、false を返します。

func MustReadDir

func MustReadDir(name string) []fs.DirEntry

MustReadDir は指定されたディレクトリ内のエントリ(ディレクトリやファイル)の情報を一覧で取得します。 エラーが発生した場合、空のスライスを返します。

func MustReadDirnames

func MustReadDirnames(name string) []string

MustReadDirnames は指定されたディレクトリ内のファイル名のみを一覧で取得します。 エラーが発生した場合、空のスライスを返します。

func MustReaddir

func MustReaddir(name string) []fs.FileInfo

MustReaddir は指定されたディレクトリ内のファイル情報を一覧で取得します。 エラーが発生した場合、空のスライスを返します。

func Open

func Open(name string, opt ...Option) (*os.File, error)

Open は指定されたファイルを読み取り専用で開きます。 オプションでファイルに関する設定を指定できます。

func OpenFile

func OpenFile(name string, flag int, opt ...Option) (*os.File, error)

OpenFile は指定されたファイルを指定されたフラグで開きます。 必要に応じてディレクトリを作成し、ファイルを開き直します。 オプションでファイルに関する設定を指定できます。

func ReadDir

func ReadDir(name string) ([]fs.DirEntry, error)

ReadDir は指定されたディレクトリ内のエントリ(ディレクトリやファイル)の情報を一覧で取得します。

func ReadDirnames

func ReadDirnames(name string) ([]string, error)

ReadDirnames は指定されたディレクトリ内のファイル名のみを一覧で取得します。

func ReadFile

func ReadFile(name string) ([]byte, error)

ReadFile は指定されたファイルを読み込み、その内容をバイトスライスとして返します。

func ReadLine added in v0.1.0

func ReadLine(name string) iter.Seq[string]

ReadLine は指定されたファイルを1行ずつ読み込むイテレータを返します。 例:

for line := range ReadLine("example.txt") {
	fmt.Println(line)
}

func Readdir

func Readdir(name string) ([]fs.FileInfo, error)

Readdir は指定されたディレクトリ内のファイル情報を一覧で取得します。

func Remove

func Remove(name string) error

Remove は指定されたファイルを削除します。

func RemoveAll

func RemoveAll(path string) error

RemoveAll は指定されたパスを削除します。 パスがディレクトリの場合、再帰的に中身も削除されます。

func Rename

func Rename(oldpath, newpath string) error

Rename は、指定された oldpath のファイルまたはディレクトリの名前を newpath に変更します。 移動先のパスが異なるデバイス上にある場合など、一部の環境では失敗することがあります。

func SetDefaultDirFileMode

func SetDefaultDirFileMode(perm fs.FileMode)

SetDefaultDirFileMode は、デフォルトのディレクトリパーミッションを設定します。 この関数を呼び出すことで、ディレクトリの作成時に使用されるデフォルトのパーミッションが変更されます。

func SetDefaultFileMode

func SetDefaultFileMode(perm fs.FileMode)

SetDefaultFileMode は、デフォルトのファイルパーミッションを設定します。 この関数を呼び出すことで、ファイルの作成時に使用されるデフォルトのパーミッションが変更されます。

func Walk added in v0.1.0

func Walk(name string) iter.Seq2[string, fs.FileInfo]

Walk は指定したディレクトリを再帰的に走査し、各ファイルのパスとファイル情報を返すイテレータを生成します。 例:

for path, info := range Walk("/some/path") {
	fmt.Println(path, info.Size())
}

func WriteFile

func WriteFile(name string, data []byte, opt ...Option) error

WriteFile は指定されたファイルにデータを書き込みます。 ファイルが存在しない場合は新しく作成し、既存の内容は上書きされます。 オプションでファイルに関する設定を指定できます。

Types

type FileReader

type FileReader struct {
	// contains filtered or unexported fields
}

FileReader はファイルの読み取り操作をラップする構造体です。 Read、ReadAt、Close メソッドを提供します。

func OpenFileReader

func OpenFileReader(name string) (*FileReader, error)

OpenFileReader は、指定されたファイルを読み込み専用で開き、 FileReader インスタンスを返します。

func (*FileReader) Close

func (r *FileReader) Close() error

Close は、ファイルを閉じます。 ファイルを正常に閉じた場合は nil を返し、エラーが発生した場合はそのエラーを返します。

func (*FileReader) Read

func (r *FileReader) Read(p []byte) (int, error)

Read は、ファイルからデータを読み取ります。 引数として渡されたバイトスライスに読み取ったデータを格納し、 実際に読み取ったバイト数とエラーを返します。

func (*FileReader) ReadAt

func (r *FileReader) ReadAt(p []byte, off int64) (int, error)

ReadAt は、指定されたオフセット位置からデータを読み取ります。 引数として渡されたオフセットからデータを読み取り、 実際に読み取ったバイト数とエラーを返します。

type FileWriter

type FileWriter struct {
	// contains filtered or unexported fields
}

FileWriter はファイルへの書き込みを管理する構造体です。

func OpenFileWriter

func OpenFileWriter(name string, opt ...Option) (*FileWriter, error)

OpenFileWriterは、指定されたファイル名に対して安全に書き込むためのWriterを作成します。 書き込み中は一時ファイルにデータが書き込まれ、 書き込みが完了した後に指定された名前のファイルにデータが反映されます。 オプションでファイルに関する設定を指定できます。

func (*FileWriter) Close

func (w *FileWriter) Close() error

Close はファイルをクローズし、必要に応じてファイルの同期、名前の変更を行います。 書き込みエラーが発生した場合はそのエラーを返し、 最後にエラーが発生した場合は一時ファイルを削除します。

func (*FileWriter) Write

func (w *FileWriter) Write(p []byte) (int, error)

Write は指定されたバイトスライスをファイルに書き込みます。 書き込みに成功した場合は書き込まれたバイト数を返します。

func (*FileWriter) WriteAt

func (w *FileWriter) WriteAt(b []byte, off int64) (int, error)

WriteAt は指定されたオフセット位置にデータをファイルに書き込みます。 書き込みに成功した場合は書き込まれたバイト数を返します。

type Option

type Option func(options) options

Option は、設定を変更する関数の型です。

func WithDirPerm

func WithDirPerm(perm fs.FileMode) Option

WithDirPerm は、ディレクトリのパーミッションを設定するオプションを返します。 このオプションは、ディレクトリの作成時に使用されるパーミッションを指定します。

func WithFilePerm

func WithFilePerm(perm fs.FileMode) Option

WithFilePerm は、ファイルのパーミッションを設定するオプションを返します。 このオプションは、ファイルの作成時に使用されるパーミッションを指定します。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL