Welcome to SwiftGitX! 🎉
SwiftGitX is a modern Swift wrapper for libgit2. It's designed to make working with Git in Swift easy and efficient. Plus, it fully supports the Swift Package Manager and has no external dependencies.
let url = URL(string: "https://github.com/ibrahimcetin/SwiftGitX.git")!
let repository = try await Repository.clone(from: url, to: URL(string: "/path/to/clone")!)
let latestCommit = try repository.HEAD.target as? Commit
let main = try repository.branch.get(named: "main")
let feature = try repository.branch.create(named: "feature", from: main)
try repository.switch(to: feature)SwiftGitX offers:
- Swift concurrency support: Take advantage of async/await for smooth, non-blocking Git operations.
- Throwing functions: Handle errors gracefully with Swift's error handling.
- Full SPM support: Easily integrate SwiftGitX into your projects.
- Intuitive design: A user-friendly API that's similar to the Git command line interface, making it easy to learn and use.
- Wrapper, not just bindings: SwiftGitX provides a complete Swift experience with no low-level C functions or types. It also includes modern Git commands, offering more functionality than other libraries.
To get started, just add SwiftGitX to your project:
- File > Add Package Dependencies...
- Enter https://github.com/ibrahimcetin/SwiftGitX.git
- Select "Up to Next Major" with "0.1.0"
Or add SwiftGitX to your Package.swift file:
dependencies: [
.package(url: "https://github.com/ibrahimcetin/SwiftGitX.git", from: "0.1.0"),
]Check out online documentation here. Thanks to Swift-Docc, you can access everything seamlessly in Xcode.
SwiftGitX is easy to build and test. It requires only Swift, no additional system dependencies. To build SwiftGitX, run:
swift buildTo test SwiftGitX, run:
swift testWe welcome contributions! Whether you want to report a bug, request a feature, improve documentation, or add tests, we appreciate your help.
For developers, when contributing, please ensure to add appropriate tests and documentation to keep our project robust and well-documented.
Thank you for considering SwiftGitX for your project. I'm excited to see what you’ll build! 😊
Feel free to let me know if there's anything specific you'd like to adjust further! 🚀