Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alexandrelam/blame-detective-cli
Empowering Developers to Track and Expose Code Alterations! 🕵️ 🔎 Now in the terminal!
https://github.com/alexandrelam/blame-detective-cli
Last synced: 2 months ago
JSON representation
Empowering Developers to Track and Expose Code Alterations! 🕵️ 🔎 Now in the terminal!
- Host: GitHub
- URL: https://github.com/alexandrelam/blame-detective-cli
- Owner: alexandrelam
- License: mit
- Created: 2024-03-16T09:02:29.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-03-21T22:15:31.000Z (9 months ago)
- Last Synced: 2024-06-20T21:06:32.330Z (6 months ago)
- Language: Go
- Homepage:
- Size: 27.6 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![MIT License][license-shield]][license-url]
[![LinkedIn][linkedin-shield]][linkedin-url]
Blame Detective CLI ✅
Empowering Developers to Track and Expose Code Alterations! 🕵️
Explore the docs
Report Bug
·
Request Feature
Table of Contents
## About The Project
Blame Detective is a highly efficient and user-friendly application designed to streamline the process of bug tracking and debugging in software development projects. By leveraging its powerful features, Blame Detective empowers developers to identify and resolve bugs quickly and effectively, saving valuable time and resources.
In the cli!
## Prerequisites
- VSCode (or edit the file editor in `/home/alex/Documents/blame-detective-cli/cmd/blamed.go`)
## Install
Linux
```sh
curl -L https://github.com/alexandrelam/blame-detective-cli/raw/main/linux-blamed -o "$HOME/.local/bin/blamed" && chmod +x "$HOME/.local/bin/blamed"
```
Mac ARM
```sh
curl -L https://github.com/alexandrelam/blame-detective-cli/raw/main/macos-blamed -o "$HOME/.local/bin/blamed" && chmod +x "$HOME/.local/bin/blamed"
```
Windows
```sh
curl no-windows-🤡
```
## Uninstall
```sh
rm "$HOME/.local/bin/blamed" && rm -rf /tmp/blamed
```
## Usage
Blame Detective offers a range of powerful features to streamline the bug tracking and debugging process. Here are some examples of how you can effectively use the application:
### Options
- -from : Specifies the starting commit hash for viewing the log.
- -since : Specifies the starting date for viewing the log.
- -author : Specifies the author of the commits to filter.
- -to : Specifies the ending commit hash for viewing the log (default: HEAD).
- -until : Specifies the ending date for viewing the log (default: now).
- -editor : Specifies the text editor to use for displaying commit changes (default: code).
### Example
View commits since a specific date by a particular authors:
```bash
blamed -since "2023-01-01"
```
```bash
blamed -since "2023-01-01 -ignore \.json"
```
```bash
blamed -since "2023-01-01" -author "Alexandre Lam\|John Doe"
```
View commits between two specific commit hashes:
```bash
blamed -from abc123 -to def456
```
### Note
Either a starting commit hash (-f) or a starting date (-s) must be provided.
If an ending date (-u) is not provided, it defaults to the current date.
The script uses the git log command to generate the commit history.
The commits and their changes are displayed using the specified text editor.
## Roadmap
See the [open issues](https://github.com/alexandrelam/blame-detective-cli/issues) for a full list of proposed features (and known issues).
- [x] Generate batch of whole.diff files
- [x] Generate concurently diff folder from batched whole.diff files
- [ ] Cache query, generate folder name with a hash from the command
- [ ] Add .blamedignore config file
- [ ] Ignore big useless files
- [ ] Readd loading bar
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## License
Distributed under the MIT License. See `LICENSE.txt` for more information.
## Contact
Project Link: [https://github.com/alexandrelam/blame-detective-cli](https://github.com/alexandrelam/blame-detective-cli)
## Acknowledgments
- [me](https://github.com/alexandrelam/blame-detective-cli)
[contributors-shield]: https://img.shields.io/github/contributors/alexandrelam/blame-detective-cli.svg?style=for-the-badge
[contributors-url]: https://github.com/alexandrelam/blame-detective-cli/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/alexandrelam/blame-detective-cli.svg?style=for-the-badge
[forks-url]: https://github.com/alexandrelam/blame-detective-cli/network/members
[stars-shield]: https://img.shields.io/github/stars/alexandrelam/blame-detective-cli.svg?style=for-the-badge
[stars-url]: https://github.com/alexandrelam/blame-detective-cli/stargazers
[issues-shield]: https://img.shields.io/github/issues/alexandrelam/blame-detective-cli.svg?style=for-the-badge
[issues-url]: https://github.com/alexandrelam/blame-detective-cli/issues
[license-shield]: https://img.shields.io/github/license/alexandrelam/blame-detective-cli.svg?style=for-the-badge
[license-url]: https://github.com/alexandrelam/blame-detective-cli/blob/master/LICENSE.txt
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
[linkedin-url]: https://www.linkedin.com/in/alexandre-lam-74787b191/
[React.js]: https://img.shields.io/badge/React-20232A?style=for-the-badge&logo=react&logoColor=61DAFB
[React-url]: https://reactjs.org/