Skip to content

Commit

Permalink
feat: Update the readme w/ screenshots
Browse files Browse the repository at this point in the history
  • Loading branch information
kmesiab committed Jan 17, 2024
1 parent ad6cde2 commit c7c273b
Show file tree
Hide file tree
Showing 4 changed files with 35 additions and 16 deletions.
51 changes: 35 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,23 @@ languages.
- **AI-Powered Insights**: Employs ChatGPT for in-depth code analysis.
- **User-Friendly CLI**: Simple and intuitive command-line interface
for easy usage.
- **Markdown Reports**: Outputs code reviews in markdown for flexible viewing and integration.

![Screenshot](./assets/cadre-screenshot.png)

## Review Details

Each diff file is reviewed in isolation. Code reviews are broken into several sections:

- Technical Accuracy
- Best Practices
- Performance and Scalability
- Readability and Clarity
- Maintainability
- Testability
- Contextual Fit

![Screenshot](./assets/cadre-best-practices-screenshot.png)

## Installation 🔧

Expand All @@ -31,38 +48,40 @@ Follow these steps:
go install github.com/kmesiab/cadre@latest
```

Set your OpenAI API Key:
Set your OpenAI API Key (You can also pass this value on the command
line w/ `--key`):

```bash
export OPENAI_API_KEY=sk-[SECRET]
```

Set your Ignore Files. These are file types that will be excluded from
code reviews. They should be a comma-separated list of file extensions.
For example:
To run the program:

```bash
export IGNORE_FILES=.mod,.sum
cadre --url [url to github pull request]
```
---
## Usage 💡

To run the program:
To review a pull request, run the following command:

```bash
cadre
./cadre --url [url to github pull request]
```
or

## Usage 💡

**Usage instructions for Cadre CLI go here. Provide examples and explain
how users can interact with it.**
```bash
# Run the application with a GitHub pull request URL and API key
./cadre --url=https://github.com/user/repo/pull/123 --key=your_api_key
```

## Development and Testing 🧪
### Command-Line Switches

### Building the Project 🏗️
- `--url`: The GitHub pull request URL. Example: `--url=https://github.com/user/repo/pull/123`
- `--key`: Your OpenAI API key. You can also set this using the `OPENAI_API_KEY`
environment variable. Example: `--key=your_api_key`
- `--help`: Show help information.

```bash
make build
```

### Running Tests ✔️

Expand Down
Binary file added assets/cadre-best-practices-screenshot.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/cadre-screenshot.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/cadre-self-review.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit c7c273b

Please sign in to comment.