README
U
Commit
U
CommitInfo
U
FileSystem
U
GitError
U
HttpClient
U
HttpResponse
U
MockHttpClient
U
ObjectId
U
ObjectStore
U
ObjectType
U
PackCompression
U
PackDeltaMode
U
PackObject
U
RepoFileSystem
U
Sha1State
U
TestFs
U
TreeEntry
V
checkout_commit
V
checkout_commit_to_fs
V
create_blob
V
create_blob_string
V
create_commit
V
create_object
V
create_tree
V
hash_blob
V
hash_blob_string
V
hash_object_content
V
join_path
V
materialize_clone_to_fs
V
parse_commit
V
parse_tree
V
serialize_commit_content
V
serialize_tree
V
sha1
V
sha1_array
V
sha1_array_prefix
V
sha1_prefix
V
write_git_metadata

bit

Pure MoonBit Git implementation

git

packfile

protocol

Download zip

Author

mizchi

Version

0.18.3

License

Apache-2.0

Repository

github.com/mizchi/bit-vcs

Last updated

8 months ago

Downloads

104K

#bit

Git implementation in MoonBit - fully compatible with some extensions.

Warning: This is an experimental implementation. Do not use in production. Data corruption may occur in worst case scenarios. Always keep backups of important repositories.

#Install

Supported platforms: Linux x64, macOS arm64/x64

# One-line install
curl -fsSL https://raw.githubusercontent.com/mizchi/bit-vcs/main/install.sh | bash

# Or install via MoonBit toolchain
moon install mizchi/bit/cmd/bit

#Subdirectory Clone

Clone subdirectories directly from GitHub:

# Using @user/repo/path shorthand
bit clone mizchi/bit-vcs:src/x/fs

# Or paste GitHub browser URL
bit clone https://github.com/user/repo/tree/main/packages/core

# Single file download
bit clone https://github.com/user/repo/blob/main/README.md

Cloned subdirectories have their own .git directory. When placed inside another git repository, git automatically treats them as embedded repositories (like submodules) - the parent repo won't commit their contents.

#Standard Git Commands

bit clone https://github.com/user/repo
bit checkout -b feature
bit add .
bit commit -m "changes"
bit push origin feature

#Compatibility

Hash algorithm: SHA-1 only.
SHA-256 repositories and --object-format=sha256 are not supported.
Git config: reads global aliases from ~/.gitconfig (or GIT_CONFIG_GLOBAL) only.
Shell aliases (prefixed with !) are not supported.

#Environment Variables

BIT_BENCH_GIT_DIR: override .git path for bench_real (x/fs benchmarks).
BIT_PACK_CACHE_LIMIT: max number of pack files to keep in memory (default: 2; 0 disables cache).
BIT_RACY_GIT: when set, rehash even if stat matches to avoid racy-git false negatives.

#Extensions

#Fs - Virtual Filesystem

Mount any commit as a filesystem with lazy blob loading:

let fs = Fs::from_commit(fs, ".git", commit_id)
let files = fs.readdir(fs, "src")
let content = fs.read_file(fs, "src/main.mbt")

#Kv - Distributed KV Store

Git-backed key-value store with Gossip protocol sync:

let db = Kv::init(fs, fs, git_dir, node_id)
db.set(fs, fs, "users/alice/profile", value, ts)
db.sync_with_peer(fs, fs, peer_url)

#Hub - Git-Native Huboration

Pull Requests and Issues stored as Git objects:

let hub = Hub::init(fs, fs, git_dir)
let pr = hub.create_pr(fs, fs, "Fix bug", "...",
  source_branch, target_branch, author, ts)

#License

Apache-2.0

Commit

source

using @mizchi/bit/object {type mizchi/bit/object}

Git commit object

CommitInfo

source

using @mizchi/bit/repo {type mizchi/bit/repo}

FileSystem

source

using @mizchi/bit/types {trait mizchi/bit/types}

GitError

source

using @mizchi/bit/object {type mizchi/bit/object}

Git operation errors

HttpClient

source

using @mizchi/bit/types {trait mizchi/bit/types}

HttpResponse

source

using @mizchi/bit/types {type mizchi/bit/types}

MockHttpClient

source

using @mizchi/bit/types {type mizchi/bit/types}

ObjectId

source

using @mizchi/bit/object {type mizchi/bit/object}

SHA-1 object identifier (20 bytes)

ObjectStore

source

using @mizchi/bit/repo {type mizchi/bit/repo}

ObjectType

source

using @mizchi/bit/object {type mizchi/bit/object}

Git object types

PackCompression

source

using @mizchi/bit/object {type mizchi/bit/object}

Compression mode for packfile entries

PackDeltaMode

source

using @mizchi/bit/object {type mizchi/bit/object}

Delta encoding mode for packfile generation

PackObject

source

using @mizchi/bit/object {type mizchi/bit/object}

A Git object ready for packing

RepoFileSystem

source

using @mizchi/bit/types {trait mizchi/bit/types}

Sha1State

source

using @mizchi/bit/object {type mizchi/bit/object}

TestFs

source

using @mizchi/bit/io {type mizchi/bit/io}

TreeEntry

source

using @mizchi/bit/object {type mizchi/bit/object}

Tree entry in a Git tree object

checkout_commit

source

fn checkout_commit(store : @mizchi/bit/repo.ObjectStore
ObjectStore, commit_id : @mizchi/bit/object.ObjectId
ObjectId) -> Map[String, Bytes] raise @mizchi/bit/object.GitError
GitError

checkout_commit_to_fs

source

fn checkout_commit_to_fs(store : @mizchi/bit/repo.ObjectStore
ObjectStore, commit_id : @mizchi/bit/object.ObjectId
ObjectId, fs : &@mizchi/bit/types.FileSystem
FileSystem, root : String) -> Unit raise @mizchi/bit/object.GitError
GitError

create_blob

source

fn create_blob(content : Bytes) -> (@mizchi/bit/object.ObjectId
ObjectId, Bytes)

Create a blob object from content

create_blob_string

source

fn create_blob_string(content : String) -> (@mizchi/bit/object.ObjectId
ObjectId, Bytes)

Create a blob from string content

create_commit

source

fn create_commit(commit : @mizchi/bit/object.Commit
Commit) -> (@mizchi/bit/object.ObjectId
ObjectId, Bytes)

Create a commit object

create_object

source

fn create_object(obj_type : @mizchi/bit/object.ObjectType
ObjectType, content : Bytes) -> (@mizchi/bit/object.ObjectId
ObjectId, Bytes)

Create a Git object and return its ID and compressed data Format: {type} {size}\0{content} -> SHA-1 -> zlib compress

create_tree

source

fn create_tree(entries : Array[@mizchi/bit/object.TreeEntry
TreeEntry]) -> (@mizchi/bit/object.ObjectId
ObjectId, Bytes)

Create a tree object from entries Entries must be sorted by name

hash_blob

source

fn hash_blob(content : Bytes) -> @mizchi/bit/object.ObjectId
ObjectId

Hash a blob without creating the compressed object - optimized with incremental SHA1

hash_blob_string

source

fn hash_blob_string(content : String) -> @mizchi/bit/object.ObjectId
ObjectId

Hash a blob from string - optimized with incremental SHA1

hash_object_content

source

fn hash_object_content(obj_type : @mizchi/bit/object.ObjectType
ObjectType, content : Bytes) -> @mizchi/bit/object.ObjectId
ObjectId

Hash object content (without compression) - optimized with incremental SHA1

join_path

source

fn join_path(root : String, path : String) -> String

materialize_clone_to_fs

source

fn materialize_clone_to_fs(store : @mizchi/bit/repo.ObjectStore
ObjectStore, commit_id : @mizchi/bit/object.ObjectId
ObjectId, refname : String, remote_url : String, fs : &@mizchi/bit/types.FileSystem
FileSystem, root : String) -> Unit raise @mizchi/bit/object.GitError
GitError

parse_commit

source

fn parse_commit(content : Bytes) -> @mizchi/bit/repo.CommitInfo
CommitInfo raise @mizchi/bit/object.GitError
GitError

parse_tree

source

fn parse_tree(content : Bytes) -> Array[@mizchi/bit/object.TreeEntry
TreeEntry] raise @mizchi/bit/object.GitError
GitError

serialize_commit_content

source

fn serialize_commit_content(commit : @mizchi/bit/object.Commit
Commit) -> Bytes

Serialize commit to raw content bytes (without git object header)

serialize_tree

source

fn serialize_tree(entries : Array[@mizchi/bit/object.TreeEntry
TreeEntry]) -> Bytes

Serialize tree entries to raw content bytes (without git object header)

sha1

source

fn sha1(data : Bytes) -> @mizchi/bit/object.ObjectId
ObjectId

Compute SHA-1 hash of data

sha1_array

source

fn sha1_array(data : Array[Byte]) -> @mizchi/bit/object.ObjectId
ObjectId

Compute SHA-1 hash of data from Array

sha1_array_prefix

source

fn sha1_array_prefix(data : Array[Byte], len : Int) -> @mizchi/bit/object.ObjectId
ObjectId

Compute SHA-1 hash of Array prefix (first len bytes).

sha1_prefix

source

fn sha1_prefix(data : Bytes, len : Int) -> @mizchi/bit/object.ObjectId
ObjectId

Compute SHA-1 hash of data prefix (first len bytes).

write_git_metadata

source

fn write_git_metadata(store : @mizchi/bit/repo.ObjectStore
ObjectStore, commit_id : @mizchi/bit/object.ObjectId
ObjectId, refname : String, remote_url : String, fs : &@mizchi/bit/types.FileSystem
FileSystem, root : String) -> Unit raise @mizchi/bit/object.GitError
GitError

Source Files

top.mbt

Site source Report issue Packages Build queue Skills Statistics

bit

#bit

#Install

#Subdirectory Clone

#Standard Git Commands

#Compatibility

#Environment Variables

#Extensions

#Fs - Virtual Filesystem

#Kv - Distributed KV Store

#Hub - Git-Native Huboration

#License

#Commit

#CommitInfo

#FileSystem

#GitError

#HttpClient

#HttpResponse

#MockHttpClient

#ObjectId

#ObjectStore

#ObjectType

#PackCompression

#PackDeltaMode

#PackObject

#RepoFileSystem

#Sha1State

#TestFs

#TreeEntry

#checkout_commit

#checkout_commit_to_fs

#create_blob

#create_blob_string

#create_commit

#create_object

#create_tree

#hash_blob

#hash_blob_string

#hash_object_content

#join_path

#materialize_clone_to_fs

#parse_commit

#parse_tree

#serialize_commit_content

#serialize_tree

#sha1

#sha1_array

#sha1_array_prefix

#sha1_prefix

#write_git_metadata

Source Files

Commit

CommitInfo

FileSystem

GitError

HttpClient

HttpResponse

MockHttpClient

ObjectId

ObjectStore

ObjectType

PackCompression

PackDeltaMode

PackObject

RepoFileSystem

Sha1State

TestFs

TreeEntry

checkout_commit

checkout_commit_to_fs

create_blob

create_blob_string

create_commit

create_object

create_tree

hash_blob

hash_blob_string

hash_object_content

join_path

materialize_clone_to_fs

parse_commit

parse_tree

serialize_commit_content

serialize_tree

sha1

sha1_array

sha1_array_prefix

sha1_prefix

write_git_metadata