koca 0.1.6

The Koca library
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

# Koca
[![Crates.io](https://img.shields.io/crates/v/koca)](https://crates.io/crates/koca)
[![GHCR](https://img.shields.io/badge/ghcr-koca-blue)](https://github.com/koca-build/koca/pkgs/container/koca)

**The universal build, package, and publishing tool.**

Koca is a modern, universal, and system-native package manager designed to simplify the process of building and distributing applications across multiple platforms. It is so powerful that it even builds and packages itself!

## Why Koca?

- **Universal:** Build for any operating system—Windows, macOS, and Linux distributions (Ubuntu, Debian, Red Hat)—using a single build file.
- **System Native:** Leverage native packaging systems to output familiar formats like `.exe`, `.pkg`, `.deb`, `.rpm`, and more.
- **Lightning Fast:** Optimized for speed with a Rust-based backend, ensuring your builds are as fast as possible.
- **Developer First:** Focus on building your application, not the packaging tooling around it.

## Example: Packaging Claude Code

Koca uses a simple, bash-like syntax for its build files. Here is an example of how you can package Claude Code using Koca:

```bash
pkgname=claude-code
pkgver=2.1.50
pkgrel=1
pkgdesc='Terminal-based AI coding assistant'
arch=('x86_64')

build() {
    # Download the pre-built Claude Code binary, using the version we defined above with Bash variable syntax
    curl -L "https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/${pkgver}/linux-x64/claude" -o claude
    chmod +x claude
}

package() {
    # Koca provides the $pkgdir environment variable to stage your package
    install -Dm 755 "claude" "${pkgdir}/usr/bin/claude"
}
```

To create a package from this script:

```bash
# Create a .deb and .rpm package for Claude Code
koca create claude-code.koca --output-type all
```

## Getting Started

### Installation

#### GitHub Releases
You can download the latest pre-built binaries for your platform from the [GitHub releases](https://github.com/koca-build/koca/releases/) page.

#### Via Cargo
If you have Rust and Cargo installed, you can build and install Koca from source:

```bash
cargo install koca-cli
```

#### Via Docker
You can also run Koca as a Docker container:

```bash
docker run --rm -v $(pwd):/workspace ghcr.io/koca-build/koca create /workspace/your-app.koca
```

### Usage

The `create` command is the primary way to build packages:

```bash
# Create .deb and .rpm packages (default)
koca create your-app.koca

# Create an .rpm package
koca create your-app.koca --output-type rpm
```

## License

Koca is released under the [FSL-1.1-MIT](LICENSE) license.