mirror of
https://github.com/SkinnyMind/libgit2dart.git
synced 2025-05-05 04:39:07 -04:00
91 lines
2.9 KiB
Dart
91 lines
2.9 KiB
Dart
import 'dart:ffi';
|
|
import 'package:libgit2dart/libgit2dart.dart';
|
|
import 'package:libgit2dart/src/bindings/libgit2_bindings.dart';
|
|
import 'package:libgit2dart/src/bindings/revwalk.dart' as bindings;
|
|
|
|
class RevWalk {
|
|
/// Initializes a new instance of the [RevWalk] class.
|
|
///
|
|
/// **IMPORTANT**: Should be freed to release allocated memory.
|
|
RevWalk(Repository repo) {
|
|
_revWalkPointer = bindings.create(repo.pointer);
|
|
}
|
|
|
|
late final Pointer<git_revwalk> _revWalkPointer;
|
|
|
|
/// Pointer to memory address for allocated [RevWalk] object.
|
|
Pointer<git_revwalk> get pointer => _revWalkPointer;
|
|
|
|
/// Returns the list of commits from the revision walk.
|
|
///
|
|
/// Default sorting is reverse chronological order (default in git).
|
|
List<Commit> walk() {
|
|
final pointers = bindings.walk(
|
|
repoPointer: bindings.repository(_revWalkPointer),
|
|
walkerPointer: _revWalkPointer,
|
|
);
|
|
|
|
return pointers.map((e) => Commit(e)).toList();
|
|
}
|
|
|
|
/// Changes the sorting mode when iterating through the repository's contents
|
|
/// to provided [sorting] combination of [GitSort] modes.
|
|
///
|
|
/// Changing the sorting mode resets the walker.
|
|
void sorting(Set<GitSort> sorting) {
|
|
bindings.sorting(
|
|
walkerPointer: _revWalkPointer,
|
|
sortMode: sorting.fold(0, (acc, e) => acc | e.value),
|
|
);
|
|
}
|
|
|
|
/// Adds a new root commit [oid] for the traversal.
|
|
///
|
|
/// The pushed commit will be marked as one of the roots from which to start
|
|
/// the walk. This commit may not be walked if it or a child is hidden.
|
|
///
|
|
/// At least one commit must be pushed onto the walker before a walk can be
|
|
/// started.
|
|
///
|
|
/// The given [oid] must belong to a committish on the walked repository.
|
|
///
|
|
/// Throws a [LibGit2Error] if error occured.
|
|
void push(Oid oid) {
|
|
bindings.push(
|
|
walkerPointer: _revWalkPointer,
|
|
oidPointer: oid.pointer,
|
|
);
|
|
}
|
|
|
|
/// Marks a commit [oid] (and its ancestors) uninteresting for the output.
|
|
///
|
|
/// The given id must belong to a committish on the walked repository.
|
|
///
|
|
/// The resolved commit and all its parents will be hidden from the output on
|
|
/// the revision walk.
|
|
///
|
|
/// Throws a [LibGit2Error] if error occured.
|
|
void hide(Oid oid) {
|
|
bindings.hide(
|
|
walkerPointer: _revWalkPointer,
|
|
oidPointer: oid.pointer,
|
|
);
|
|
}
|
|
|
|
/// Resets the revision walker for reuse.
|
|
///
|
|
/// This will clear all the pushed and hidden commits, and leave the walker
|
|
/// in a blank state (just like at creation) ready to receive new commit
|
|
/// pushes and start a new walk.
|
|
///
|
|
/// The revision walk is automatically reset when a walk is over.
|
|
void reset() => bindings.reset(_revWalkPointer);
|
|
|
|
/// Simplify the history by first-parent.
|
|
///
|
|
/// No parents other than the first for each commit will be enqueued.
|
|
void simplifyFirstParent() => bindings.simplifyFirstParent(_revWalkPointer);
|
|
|
|
/// Releases memory allocated for [RevWalk] object.
|
|
void free() => bindings.free(_revWalkPointer);
|
|
}
|