suffix

suffix

🇷🇺 Русский | 🇬🇧 English

🇷🇺 Русский

Библиотека для парсинга строк с суффиксами в числовые значения (размеры, время, bool).

Возможности

• Преобразование строк с суффиксами (KB, MB, GiB, b, bit и др.) в байты, килобайты, мегабайты и т.д.
• Поддержка битовых и байтовых суффиксов, десятичной и двоичной системы.
• Преобразование времени с суффиксами (s, m, h, d, M, Y) в секунды.
• Преобразование строк в булевы значения (yes, no, 1, 0, и др.).
• Безопасные (ToX) и небезопасные (UnsafeToX) функции.
• Покрытие unit-тестами.

Примеры использования

package main

import (
    "fmt"
    "github.com/a3ak/suffix"
)

func main() {
    size, _ := suffix.ToB("1.5GB") // 1500000000
    fmt.Println(size)

    sec, _ := suffix.ToSeconds("2h") // 7200
    fmt.Println(sec)

    b, _ := suffix.ToBool("yes") // true
    fmt.Println(b)
}

Поддерживаемые суффиксы

Размеры

• Десятичные: KB, MB, GB, TB
• Двоичные: KiB, MiB, GiB, TiB
• Биты: b, bit, Kb, Mb, Gb, Tb
• Без суффикса или B — байты

Время

• s — секунды
• m — минуты
• h — часы
• d — дни
• W — недели
• M — месяцы (30 дней)
• Y — годы (12 месяцев)

Булевы значения

• Истина: 1, true, yes, ok, up, y
• Ложь: 0, false, no, fail, down, n

Установка

go get github.com/a3ak/suffix

Тестирование

go test

Лицензия

MIT

🇬🇧 English

Library for parsing strings with suffixes into numeric values (sizes, time, bool).

Features

• Convert strings with suffixes (KB, MB, GiB, b, bit, etc.) to bytes, kilobytes, megabytes, etc.
• Supports bit and byte suffixes, decimal and binary systems.
• Parse time with suffixes (s, m, h, d, M, Y) to seconds.
• Parse boolean values from strings (yes, no, 1, 0, etc.).
• Safe (ToX) and unsafe (UnsafeToX) functions.
• Unit test coverage.

Usage examples

package main

import (
    "fmt"
    "github.com/a3ak/suffix"
)

func main() {
    size, _ := suffix.ToB("1.5GB") // 1500000000
    fmt.Println(size)

    sec, _ := suffix.ToSeconds("2h") // 7200
    fmt.Println(sec)

    b, _ := suffix.ToBool("yes") // true
    fmt.Println(b)
}

Supported suffixes

Sizes

• Decimal: KB, MB, GB, TB
• Binary: KiB, MiB, GiB, TiB
• Bits: b, bit, Kb, Mb, Gb, Tb
• No suffix or B — bytes

Time

• s — seconds
• m — minutes
• h — hours
• d — days
• W — weeks
• M — months (30 days)
• Y — years (12 months)

Boolean values

• True: 1, true, yes, ok, up, y
• False: 0, false, no, fail, down, n

Installation

go get github.com/a3ak/suffix

Testing

go test

License

MIT