1
0
Fork 0
mirror of https://github.com/imjasonh/infinite-git synced 2026-07-12 02:41:48 +00:00
infinite-git/README.md
Jason Hall 8919cd5826
Implement pure Go Git HTTP server without CLI dependencies
Major rewrite to eliminate git CLI dependency:
- Created object package for Git object format handling (blob, tree, commit)
- Implemented packfile generation from scratch
- Rewrote repo initialization to create Git repos without CLI
- Implemented git-upload-pack protocol in pure Go
- Updated all server handlers to use new implementation
- Added Git packet tracing to test.sh for debugging
- Fixed tests to work with new implementation

The server now works entirely with Go code, no git commands needed.
Clone operations work correctly, but pull operations still have protocol
negotiation issues that need further debugging.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-23 22:28:50 -04:00

79 lines
No EOL
1.8 KiB
Markdown

# Infinite Git
A Git HTTP server that generates a new commit every time someone pulls from the repository.
## Features
- Implements Git smart HTTP protocol for read-only access
- Generates a unique commit on every pull/clone operation
- Thread-safe commit generation
- Persistent Git repository on disk
- Structured logging with slog
## Installation
```bash
go install github.com/imjasonh/infinite-git/cmd/infinite-git@latest
```
Or build from source:
```bash
git clone https://github.com/imjasonh/infinite-git
cd infinite-git
go build -o infinite-git ./cmd/infinite-git
```
## Usage
Start the server:
```bash
infinite-git
```
Configuration via environment variables:
- `PORT`: HTTP server port (default: "8080")
- `REPO_PATH`: Path to Git repository (default: "./infinite-repo")
Example:
```bash
PORT=3000 REPO_PATH=/tmp/my-infinite-repo infinite-git
```
Logging is configured via the standard clog environment variables.
## Testing
Clone the repository:
```bash
git clone http://localhost:8080
```
Every time you pull, you'll get a new commit:
```bash
cd <cloned-repo>
git pull origin main
# New commit appears!
```
## How It Works
1. When a client initiates a pull/clone, the server intercepts the reference discovery request
2. Before advertising refs, it generates a new commit with:
- A unique file containing the pull counter and timestamp
- A commit message indicating when the pull occurred
3. The new commit is added to the main branch
4. The updated refs are sent to the client
5. The client receives the new commit as part of the normal Git protocol flow
## Implementation Details
- Uses Git plumbing commands (`git add`, `git commit`) to create commits
- Implements pkt-line format for Git protocol communication
- Delegates object transfer to `git upload-pack` for efficiency
- Rejects all push attempts with 403 Forbidden
## License
MIT