README
- ::closeBlob::close
- ::contentBlob::content
- ::content_stringBlob::content_string
- ::is_binaryBlob::is_binary
- ::sizeBlob::size
- ::to_stringBranchInfo::to_string
T
BranchType
- ::short_idCommitInfo::short_id
- ::to_stringCommitInfo::to_string
- ::to_stringDiffStats::to_string
T
GitBlob
T
GitIndex
T
GitRepository
T
GitSignature
T
GitTree
- ::addIndex::add
- ::closeIndex::close
- ::entry_countIndex::entry_count
- ::reloadIndex::reload
- ::removeIndex::remove
- ::writeIndex::write
- ::write_treeIndex::write_tree
T
ObjectType
- ::to_stringRemoteInfo::to_string
- ::blobRepository::blob
- ::branchesRepository::branches
- ::checkout_headRepository::checkout_head
- ::closeRepository::close
- ::commitRepository::commit
- ::commit_simpleRepository::commit_simple
- ::config_getRepository::config_get
- ::default_signatureRepository::default_signature
- ::diff_countRepository::diff_count
- ::diff_statsRepository::diff_stats
- ::head_idRepository::head_id
- ::head_nameRepository::head_name
- ::head_treeRepository::head_tree
- ::indexRepository::index
- ::initRepository::init
- ::logRepository::log
- ::openRepository::open
- ::pathRepository::path
- ::remoteRepository::remote
- ::remote_namesRepository::remote_names
- ::remotesRepository::remotes
- ::resetRepository::reset
- ::status_countRepository::status_count
- ::status_flagsRepository::status_flags
- ::tag_countRepository::tag_count
- ::tagsRepository::tags
T
ResetType
- ::closeSignature::close
- ::emailSignature::email
- ::nameSignature::name
- ::nowSignature::now
- ::is_deletedStatusFlags::is_deleted
- ::is_modifiedStatusFlags::is_modified
- ::is_newStatusFlags::is_new
- ::is_stagedStatusFlags::is_staged
- ::newStatusFlags::new
- ::to_stringStatusFlags::to_string
- ::closeTree::close
- ::entriesTree::entries
- ::entry_countTree::entry_count
- ::to_stringTreeEntry::to_string
V
GIT_SORT_NONE
V
GIT_SORT_REVERSE
V
GIT_SORT_TIME
V
GIT_SORT_TOPOLOGICAL
V
GIT_STATUS_CURRENT
V
GIT_STATUS_INDEX_DELETED
V
GIT_STATUS_INDEX_MODIFIED
V
GIT_STATUS_INDEX_NEW
V
GIT_STATUS_WT_DELETED
V
GIT_STATUS_WT_MODIFIED
V
GIT_STATUS_WT_NEW
V
git_init
V
git_shutdown
V
is_loaded
V
last_error

libgit2

MoonBit bindings for libgit2 - Git operations from MoonBit

git

libgit2

ffi

Download zip

Author

mizchi

Version

0.1.0

License

MIT

Repository

github.com/mizchi/libgit2.mbt

Last updated

10 months ago

Downloads

16K

Dependencies

moonbitlang/x0.4.37

#libgit2.mbt

MoonBit bindings for libgit2 - Git operations from MoonBit.

#Features

Repository operations (open, init, clone)
Commit history traversal
Branch and tag management
Status and diff operations
Tree and blob access
Index operations
Remote operations
And more...

#Installation

#Prerequisites

Install libgit2 on your system:

macOS (Homebrew):

brew install libgit2

Ubuntu/Debian:

sudo apt-get install libgit2-dev

Fedora:

sudo dnf install libgit2-devel

#Add to your project

Add to your moon.mod.json:

{
  "deps": {
    "mizchi/libgit2": "0.1.0"
  }
}

#Usage

#Basic Example

fn main {
  // Initialize libgit2
  if not(@libgit2.git_init()) {
    println("Failed to load libgit2")
    return
  }

  // Open repository
  match @libgit2.Repository::open(".") {
    Some(repo) => {
      println("Repository: \{repo.path()}")

      // Get recent commits
      let commits = repo.log(5)
      for commit in commits {
        println("[\{commit.id.substring(0, 7)}] \{commit.summary}")
      }

      repo.close()
    }
    None => println("Failed to open repository")
  }

  @libgit2.git_shutdown()
}

#More Examples

See the examples/ directory for more usage examples:

basic - Simple repository operations
advanced - Advanced features (branches, remotes, etc.)

#API Documentation

Run moon doc to generate API documentation.

#Core Types

Repository - Git repository handle
CommitInfo - Commit information
BranchInfo - Branch information
RemoteInfo - Remote repository information
DiffStats - Diff statistics
Tree, Blob, Index - Git object types

#Main Functions

#Repository Operations

Repository::open(path: String) -> Repository?
Repository::init(path: String, is_bare: Bool) -> Repository?
Repository::close(self: Repository) -> Unit

#Commit Operations

Repository::log(self: Repository, max_count: Int) -> Array[CommitInfo]
Repository::head_commit(self: Repository) -> CommitInfo?

#Branch Operations

Repository::branches(self: Repository, include_remote: Bool) -> Array[BranchInfo]
Repository::current_branch(self: Repository) -> String?

See lib/run.mbt for the complete API.

#Testing

Run tests:

moon test --target native

#Architecture

This library uses a 3-layer architecture:

MoonBit API (lib/run.mbt)
    ↓
C Wrapper (lib/stub.c)
    ↓
libgit2 (dynamic library)

The C wrapper handles:

Dynamic library loading (dlopen/dlsym)
Type conversion (MoonBit Bytes ↔ C strings)
Memory management
Platform-specific paths (macOS, Linux)

#Platform Support

macOS: ✓ (Intel & Apple Silicon)
Linux: ✓
Windows: Not yet tested

#License

MIT License - See LICENSE for details.

#Contributing

Contributions welcome! Please open an issue or pull request.

Blob

source

pub struct Blob {
  // private fields
}

ブロブ（ファイル内容）

Blob::close

source

fn Blob::close(self : Blob) -> Unit

ブロブを閉じる

Blob::content

source

fn Blob::content(self : Blob) -> Bytes

ブロブの内容を取得（バイト列）

Blob::content_string

source

fn Blob::content_string(self : Blob) -> String

ブロブの内容を文字列として取得

Blob::is_binary

source

fn Blob::is_binary(self : Blob) -> Bool

バイナリファイルかどうか

Blob::size

source

fn Blob::size(self : Blob) -> Int64

ブロブのサイズを取得

BranchInfo

source

pub struct BranchInfo {
  name : String
  branch_type : BranchType
}

ブランチ情報

BranchInfo::to_string

source

fn BranchInfo::to_string(self : BranchInfo) -> String

BranchType

source

pub enum BranchType {
  Local
  Remote
}

ブランチタイプ

CommitInfo

source

pub struct CommitInfo {
  id : String
  message : String
  summary : String
  author_name : String
  author_email : String
  committer_name : String
  committer_email : String
  time : Int64
}

コミット情報

CommitInfo::short_id

source

fn CommitInfo::short_id(self : CommitInfo) -> String

CommitInfo::to_string

source

fn CommitInfo::to_string(self : CommitInfo) -> String

DiffStats

source

pub struct DiffStats {
  files_changed : Int
  insertions : Int
  deletions : Int
}

差分統計

DiffStats::to_string

source

fn DiffStats::to_string(self : DiffStats) -> String

GitBlob

source

type GitBlob

GitIndex

source

type GitIndex

GitRepository

source

type GitRepository

GitSignature

source

type GitSignature

GitTree

source

type GitTree

Index

source

pub struct Index {
  // private fields
}

インデックス（ステージングエリア）

Index::add

source

fn Index::add(self : Index, path : String) -> Bool

ファイルをステージに追加

Index::close

source

fn Index::close(self : Index) -> Unit

インデックスを閉じる

Index::entry_count

source

fn Index::entry_count(self : Index) -> Int

ステージされたエントリ数

Index::reload

source

fn Index::reload(self : Index) -> Bool

インデックスを再読み込み

Index::remove

source

fn Index::remove(self : Index, path : String) -> Bool

ファイルをステージから削除

Index::write

source

fn Index::write(self : Index) -> Bool

インデックスを書き込み

Index::write_tree

source

fn Index::write_tree(self : Index) -> String?

インデックスからツリーを作成し、ツリー OID を返す

ObjectType

source

pub enum ObjectType {
  Blob
  Tree
  Commit
  Tag
  Unknown
}

オブジェクトタイプ

RemoteInfo

source

pub struct RemoteInfo {
  name : String
  url : String
  push_url : String
}

リモート情報

RemoteInfo::to_string

source

fn RemoteInfo::to_string(self : RemoteInfo) -> String

Repository

source

pub struct Repository {
  // private fields
}

リポジトリ

Repository::blob

source

fn Repository::blob(self : Repository, oid : String) -> Blob?

OID からブロブを取得

Repository::branches

source

fn Repository::branches(self : Repository, include_remote : Bool) -> Array[BranchInfo]

ブランチ一覧を取得

Repository::checkout_head

source

fn Repository::checkout_head(self : Repository) -> Bool

HEAD にチェックアウト

Repository::close

source

fn Repository::close(self : Repository) -> Unit

リポジトリを閉じる

Repository::commit

source

fn Repository::commit(self : Repository, message : String, author : Signature, committer : Signature, tree_oid : String) -> String?

コミットを作成（HEAD を親として）戻り値: 新しいコミットの OID

Repository::commit_simple

source

fn Repository::commit_simple(self : Repository, message : String) -> String?

簡易コミット（デフォルト署名を使用）

Repository::config_get

source

fn Repository::config_get(self : Repository, name : String) -> String?

git config の値を取得

Repository::default_signature

source

fn Repository::default_signature(self : Repository) -> Signature?

リポジトリのデフォルト署名（user.name, user.email から）

Repository::diff_count

source

fn Repository::diff_count(self : Repository) -> Int

ワーキングツリーの変更ファイル数を取得

Repository::diff_stats

source

fn Repository::diff_stats(self : Repository) -> DiffStats?

ワーキングツリーの差分統計を取得

Repository::head_id

source

fn Repository::head_id(self : Repository) -> String?

HEADのコミットIDを取得

Repository::head_name

source

fn Repository::head_name(self : Repository) -> String?

HEADの参照名を取得

Repository::head_tree

source

fn Repository::head_tree(self : Repository) -> Tree?

HEAD のツリーを取得

Repository::index

source

fn Repository::index(self : Repository) -> Index?

インデックスを開く

Repository::init

source

fn Repository::init(path : String) -> Repository?

新しいリポジトリを初期化

Repository::log

source

fn Repository::log(self : Repository, max_count : Int) -> Array[CommitInfo]

コミット履歴を取得（最新からn件）

Repository::open

source

fn Repository::open(path : String) -> Repository?

リポジトリを開く

Repository::path

source

fn Repository::path(self : Repository) -> String

リポジトリのパスを取得

Repository::remote

source

fn Repository::remote(self : Repository, name : String) -> RemoteInfo?

リモート情報を取得

Repository::remote_names

source

fn Repository::remote_names(self : Repository) -> Array[String]

リモート名一覧を取得

Repository::remotes

source

fn Repository::remotes(self : Repository) -> Array[RemoteInfo]

すべてのリモート情報を取得

Repository::reset

source

fn Repository::reset(self : Repository, commit_oid : String, reset_type : ResetType) -> Bool

指定したコミットにリセット

Repository::status_count

source

fn Repository::status_count(self : Repository) -> Int

ワーキングツリーのステータス（変更ファイル数）

Repository::status_flags

source

fn Repository::status_flags(self : Repository) -> Array[StatusFlags]

ワーキングツリーのステータスフラグ一覧を取得

Repository::tag_count

source

fn Repository::tag_count(self : Repository) -> Int

タグ数を取得

Repository::tags

source

fn Repository::tags(self : Repository) -> Array[String]

タグ一覧を取得

ResetType

source

pub(all) enum ResetType {
  Soft
  Mixed
  Hard
}

リセットタイプ

Signature

source

pub struct Signature {
  // private fields
}

署名（author/committer）

Signature::close

source

fn Signature::close(self : Signature) -> Unit

署名を解放

Signature::email

source

fn Signature::email(self : Signature) -> String

署名のメールアドレス

Signature::name

source

fn Signature::name(self : Signature) -> String

署名の名前

Signature::now

source

fn Signature::now(name : String, email : String) -> Signature?

現在時刻で署名を作成

StatusFlags

source

pub struct StatusFlags {
  flags : Int
}

ステータスフラグ

StatusFlags::is_deleted

source

fn StatusFlags::is_deleted(self : StatusFlags) -> Bool

StatusFlags::is_modified

source

fn StatusFlags::is_modified(self : StatusFlags) -> Bool

StatusFlags::is_new

source

fn StatusFlags::is_new(self : StatusFlags) -> Bool

StatusFlags::is_staged

source

fn StatusFlags::is_staged(self : StatusFlags) -> Bool

StatusFlags::new

source

fn StatusFlags::new(flags : Int) -> StatusFlags

StatusFlags::to_string

source

fn StatusFlags::to_string(self : StatusFlags) -> String

Tree

source

pub struct Tree {
  // private fields
}

ツリー

Tree::close

source

fn Tree::close(self : Tree) -> Unit

Tree::entries

source

fn Tree::entries(self : Tree) -> Array[TreeEntry]

Tree::entry_count

source

fn Tree::entry_count(self : Tree) -> Int

TreeEntry

source

pub struct TreeEntry {
  name : String
  id : String
  object_type : ObjectType
}

ツリーエントリ情報

TreeEntry::to_string

source

fn TreeEntry::to_string(self : TreeEntry) -> String

GIT_SORT_NONE

source

let GIT_SORT_NONE : Int

GIT_SORT_REVERSE

source

let GIT_SORT_REVERSE : Int

GIT_SORT_TIME

source

let GIT_SORT_TIME : Int

GIT_SORT_TOPOLOGICAL

source

let GIT_SORT_TOPOLOGICAL : Int

GIT_STATUS_CURRENT

source

let GIT_STATUS_CURRENT : Int

GIT_STATUS_INDEX_DELETED

source

let GIT_STATUS_INDEX_DELETED : Int

GIT_STATUS_INDEX_MODIFIED

source

let GIT_STATUS_INDEX_MODIFIED : Int

GIT_STATUS_INDEX_NEW

source

let GIT_STATUS_INDEX_NEW : Int

GIT_STATUS_WT_DELETED

source

let GIT_STATUS_WT_DELETED : Int

GIT_STATUS_WT_MODIFIED

source

let GIT_STATUS_WT_MODIFIED : Int

GIT_STATUS_WT_NEW

source

let GIT_STATUS_WT_NEW : Int

git_init

source

fn git_init() -> Bool

ライブラリの初期化（ライブラリのロードも行う）戻り値: 成功時はtrue、失敗時はfalse

git_shutdown

source

fn git_shutdown() -> Unit

ライブラリのシャットダウン

is_loaded

source

fn is_loaded() -> Bool

ライブラリがロードされているかチェック

last_error

source

fn last_error() -> String

最後のエラーメッセージを取得

Source Files

libgit2.mbt

Site source Report issue Packages Build queue Skills Statistics

libgit2

#libgit2.mbt

#Features

#Installation

#Prerequisites

#Add to your project

#Usage

#Basic Example

#More Examples

#API Documentation

#Core Types

#Main Functions

#Repository Operations

#Commit Operations

#Branch Operations

#Testing

#Architecture

#Platform Support

#License

#Contributing

#Related

#Blob

#Blob::close

#Blob::content

#Blob::content_string

#Blob::is_binary

#Blob::size

#BranchInfo

#BranchInfo::to_string

#BranchType

#CommitInfo

#CommitInfo::short_id

#CommitInfo::to_string

#DiffStats

#DiffStats::to_string

#GitBlob

#GitIndex

#GitRepository

#GitSignature

#GitTree

#Index

#Index::add

#Index::close

#Index::entry_count

#Index::reload

#Index::remove

#Index::write

#Index::write_tree

#ObjectType

#RemoteInfo

#RemoteInfo::to_string

#Repository

#Repository::blob

#Repository::branches

#Repository::checkout_head

#Repository::close

#Repository::commit

#Repository::commit_simple

#Repository::config_get

#Repository::default_signature

#Repository::diff_count

#Repository::diff_stats

#Repository::head_id

#Repository::head_name

#Repository::head_tree

#Repository::index

#Repository::init

#Repository::log

#Repository::open

#Repository::path

#Repository::remote

#Repository::remote_names

#Repository::remotes

#Repository::reset

#Repository::status_count

#Repository::status_flags

#Repository::tag_count

#Repository::tags

#ResetType

#Signature

Blob

Blob::close

Blob::content

Blob::content_string

Blob::is_binary

Blob::size

BranchInfo

BranchInfo::to_string

BranchType

CommitInfo

CommitInfo::short_id

CommitInfo::to_string

DiffStats

DiffStats::to_string

GitBlob

GitIndex

GitRepository

GitSignature

GitTree

Index

Index::add

Index::close

Index::entry_count

Index::reload

Index::remove

Index::write

Index::write_tree

ObjectType

RemoteInfo

RemoteInfo::to_string

Repository

Repository::blob

Repository::branches

Repository::checkout_head

Repository::close

Repository::commit

Repository::commit_simple

Repository::config_get

Repository::default_signature

Repository::diff_count

Repository::diff_stats

Repository::head_id

Repository::head_name

Repository::head_tree

Repository::index

Repository::init

Repository::log

Repository::open

Repository::path

Repository::remote

Repository::remote_names

Repository::remotes

Repository::reset

Repository::status_count

Repository::status_flags

Repository::tag_count

Repository::tags

ResetType

Signature

Signature::close

Signature::email

Signature::name

Signature::now

StatusFlags

StatusFlags::is_deleted

StatusFlags::is_modified

StatusFlags::is_new

StatusFlags::is_staged

StatusFlags::new

StatusFlags::to_string

Tree

Tree::close

Tree::entries

Tree::entry_count

TreeEntry

TreeEntry::to_string

GIT_SORT_NONE

GIT_SORT_REVERSE

GIT_SORT_TIME

GIT_SORT_TOPOLOGICAL