OSS Perks

ossperks CLI

Просматривайте программы льгот для OSS и проверяйте, подходит ли ваш проект — прямо из терминала.

Обзор

ossperks — это инструмент командной строки без необходимости настройки, который позволяет:

  • Просматривать все программы льгот для OSS в одном месте
  • Искать программы по ключевым словам, поставщикам или категориям
  • Отображать полную информацию о любой программе (льготы, требования, как подать заявку)
  • Проверять, подходит ли ваш собственный репозиторий для участия в программах — автоматически, получая актуальные данные через API GitHub или GitLab
  • Открывать сайт ossperks прямо из терминала

Установка

npm install -g ossperks

Или запустить без установки:

npx ossperks

Быстрый старт


# Список всех программ

ossperks list

# Проверить текущий проект

cd /path/to/your/repo
ossperks check

# Поиск по ключевому слову

ossperks search "hosting"

# Показать сведения о программе

ossperks show vercel

# Откройте ossperks.com в вашем браузере

ossperks open

Псевдонимы команд

Каждая команда имеет короткие псевдонимы для удобства:

КомандаПсевдоним(ы)
listls
showinfo
searchfind, s
checkck
categoriescats

Как работает обнаружение репозитория

ossperks check автоматически определяет ваш репозиторий без дополнительных запросов:

  1. Читает поле repository из package.json в текущей директории
  2. При отсутствии использует remote.origin.url из .git/config
  3. Обращается к публичному API GitHub, GitLab, Codeberg или Gitea для получения актуальных данных (звёзды, лицензия, активность и т.д.)
  4. Сопоставляет эти данные с требованиями каждой программы

Для публичных репозиториев API-токены не требуются.

Телеметрия

CLI собирает анонимную статистику использования (название команды, версия, ОС) для улучшения инструмента. Названия репозиториев, имена пользователей и личная информация никогда не собираются.

Чтобы отказаться, установите одну из этих переменных окружения:

export DO_NOT_TRACK=1

# или

export DISABLE_TELEMETRY=1

Уведомления об обновлениях

Когда в npm доступна новая версия, CLI показывает однострочное уведомление после вывода команды. Проверка кэшируется локально на 1 час и никогда не блокирует выполнение команды.

Следующие шаги

  • list — просмотреть все программы
  • show — посмотреть сведения о программе
  • check — автоматически проверить соответствие вашего репозитория требованиям
  • search — найти программы по ключевому слову
  • categories — просмотреть по категориям (интерактивно в TTY)

On this page