bgit 0.4.0

User-friendly Git wrapper for beginners, automating essential tasks like adding, committing, and pushing changes. It includes smart rules to avoid common pitfalls, such as accidentally adding sensitive files or directories and has exclusive support for portable hooks!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

# bgit: One command for most of git

<div align="center">

![GitHub repo size](https://img.shields.io/github/repo-size/rootCircle/bgit?style=for-the-badge&logo=github&logoColor=D9E0EE&labelColor=292324)
![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/rootCircle/bgit/general.yml?style=for-the-badge&logo=github&logoColor=D9E0EE&labelColor=292324)
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/rootCircle/bgit/audit.yml?label=audit&style=for-the-badge&logo=github&logoColor=D9E0EE&labelColor=292324)
![GitHub License](https://img.shields.io/github/license/rootCircle/bgit?label=License&style=for-the-badge&logo=github&logoColor=D9E0EE&labelColor=292324)

[![Codecov](https://img.shields.io/codecov/c/github/rootCircle/bgit?label=Coverage&style=for-the-badge&logo=codecov&logoColor=D9E0EE&labelColor=292324)](https://codecov.io/gh/rootCircle/bgit)

![Crates.io](https://img.shields.io/crates/v/bgit?style=for-the-badge&logo=rust&logoColor=D9E0EE&labelColor=292324)
![Crates.io](https://img.shields.io/crates/d/bgit?style=for-the-badge&logo=rust&logoColor=D9E0EE&labelColor=292324)
![Crates.io](https://img.shields.io/crates/l/bgit?style=for-the-badge&logo=rust&logoColor=D9E0EE&labelColor=292324)
![docs.rs](https://img.shields.io/docsrs/bgit?style=for-the-badge&logo=rust&logoColor=D9E0EE&labelColor=292324)
![Crates.io Size](https://img.shields.io/crates/size/bgit?style=for-the-badge&logo=rust&logoColor=D9E0EE&labelColor=292324)
![Crates.io MSRV](https://img.shields.io/crates/msrv/bgit?style=for-the-badge&logo=rust&logoColor=D9E0EE&labelColor=292324)

</div>

bgit is a simplified wrapper for Git, designed specifically for absolute beginners who find the Git workflow daunting. It automates common Git tasks such as adding, committing, and pushing changes, while also incorporating smart rules to prevent common issues like accidentally adding sensitive files or directories such as `.env` or `node_modules`.

## Features

- **Simplified Workflow**: bgit streamlines the Git workflow by guiding users through common tasks using intuitive command-line prompts.
- **Smart Rules**: bgit incorporates intelligent rules to prevent common mistakes, ensuring that only relevant files are added and committed.
- **Extensible**: Users can easily extend bgit's functionality to suit their specific needs by adding custom rules or commands.
- **Complex Command Support**: bgit allows users to run complex Git commands easily, abstracting away the complexities for beginners.

## Installation

### Quick Install precompiled Binary

- Linux/macOS
  
  - ```bash
    curl -fsSL https://raw.githubusercontent.com/rootCircle/bgit/main/scripts/install.sh | bash
    ```

- Windows (PowerShell)

  - ```psi
    iwr -useb https://raw.githubusercontent.com/rootCircle/bgit/main/scripts/install.ps1 | iex
    ```

Advanced options, supported targets, checksums/signatures, and troubleshooting are documented here:

- See [docs/INSTALL.md](./docs/INSTALL.md)

### Install via Cargo

```bash
cargo install bgit
```

## Getting Started

To start using bgit, navigate to your Git repository directory in your terminal and simply run `bgit`. bgit will guide you through the necessary steps to add, commit, and push your changes.

Here's a basic example of how to use bgit:

```bash
bgit
```

Follow the on-screen prompts to add, commit, and push your changes. bgit will handle the rest, ensuring that only relevant files are included and that your Git repository remains clean and organized.

## How it works?

If you're interested in finding how bgit works, take a look at [ARCHITECTURE.md](./docs/ARCHITECTURE.md).

Want to try it out? Check [bgit_clone_sample](https://github.com/rootCircle/bgit_clone_sample) repository.

## Contributing

Contributions to bgit are welcome! If you encounter any issues or have suggestions for improvements, please feel free to open an issue or submit a pull request on the [bgit GitHub repository](https://github.com/rootCircle/bgit).

## License

bgit is licensed under the MIT License. See the [LICENSE](https://github.com/rootCircle/bgit/blob/main/LICENSE) file for details.

## Disclaimer

Please note that while bgit aims to simplify the Git workflow for beginners, it is not a replacement for learning Git fundamentals. We encourage users to continue learning about Git to fully understand its capabilities and best practices.