# human

Human-readable size formatting for Go.

## Features

- **Binary Units**: Uses 1024 as base (KB, MB, GB, etc.)
- **Decimal Units**: Uses 1000 as base (KB, MB, GB, etc.)
- **Auto-scaling**: Automatically selects appropriate unit
- **Precision Control**: Shows decimals only when needed

## Usage

```go
import "gitea.loveuer.com/loveuer/upkg/tool/human"
```

### Binary Format (1024 base)

```go
human.Size(1024)           // "1 KB"
human.Size(1024 * 1024)    // "1 MB"
human.Size(1536)           // "1.50 KB"
human.Size(-1024 * 1024)   // "-1 MB"
```

### Decimal Format (1000 base)

```go
human.SizeDecimal(1000)        // "1 KB"
human.SizeDecimal(1000000)     // "1 MB"
human.SizeDecimal(1000000000)  // "1 GB"
```

### Binary (SI-compatible)

```go
human.SizeBinary(1000)         // "976.56 KB"
human.SizeBinary(1000000)      // "953.67 MB"
```

## Performance

| Function | ns/op | B/op | allocs |
|----------|-------|------|--------|
| Size | 439 | 32 | 3 |
| SizeDecimal | 387 | 32 | 3 |
| SizeBinary | 558 | 40 | 3 |

## Examples

```go
package main

import (
    "fmt"
    "gitea.loveuer.com/loveuer/upkg/tool/human"
)

func main() {
    fmt.Println(human.Size(1024))                  // 1 KB
    fmt.Println(human.Size(1024 * 1024))           // 1 MB
    fmt.Println(human.Size(1024 * 1024 * 1024))    // 1 GB
    fmt.Println(human.Size(1500))                  // 1.46 KB
    fmt.Println(human.Size(0))                     // 0 B
}
```