3552db50c2
- AGE encryption with master password model - Core commands: init, show, insert, edit, generate, rm, mv, cp, find, grep, ls - Git integration for version control - Clipboard support (X11 and Wayland) - Secure password generation - Backup and restore functionality - Comprehensive security features - Complete documentation
77 lines
1.5 KiB
Markdown
77 lines
1.5 KiB
Markdown
# Contributing to PassAGE
|
|
|
|
Thank you for your interest in contributing to PassAGE!
|
|
|
|
## Getting Started
|
|
|
|
1. **Fork the repository** on GitHub
|
|
2. **Clone your fork** locally
|
|
3. **Create a branch** for your changes
|
|
4. **Make your changes** and test them
|
|
5. **Submit a pull request**
|
|
|
|
## Development Setup
|
|
|
|
1. **Fork and clone the repository:**
|
|
```bash
|
|
git clone https://git.fraggle.lol/fraggle/PassAGE.git
|
|
cd PassAGE
|
|
```
|
|
|
|
2. **Install dependencies:**
|
|
```bash
|
|
go mod download
|
|
```
|
|
|
|
3. **Build the project:**
|
|
```bash
|
|
make build
|
|
# or
|
|
go build -o passage .
|
|
```
|
|
|
|
4. **Run tests:**
|
|
```bash
|
|
make test
|
|
# or
|
|
go test ./...
|
|
```
|
|
|
|
## Code Style
|
|
|
|
- Follow standard Go formatting (`go fmt`)
|
|
- Run `go vet` before committing
|
|
- Use meaningful variable and function names
|
|
- Add comments for non-obvious code
|
|
|
|
## Testing
|
|
|
|
- Write tests for new features
|
|
- Ensure all tests pass: `go test ./...`
|
|
- Test with race detector: `make test-race`
|
|
|
|
## Submitting Changes
|
|
|
|
1. Create a branch for your changes
|
|
2. Make your changes
|
|
3. Ensure code compiles and tests pass
|
|
4. Submit a pull request with a clear description
|
|
|
|
## Building Manpages
|
|
|
|
If you modify documentation, rebuild the manpage:
|
|
|
|
```bash
|
|
make man
|
|
```
|
|
|
|
Requires `pandoc` or `go-md2man` to be installed.
|
|
|
|
## Repository Setup
|
|
|
|
If you're setting up the repository for the first time, see [SETUP.md](SETUP.md) for git initialization instructions.
|
|
|
|
## Questions?
|
|
|
|
Feel free to open an issue for questions or discussions.
|