pi-env-loader

Расширение для pi — загружает переменные окружения из .env файла.

Extension for pi — Load variables from .env file.

English version 🇺🇸 / 🇬🇧 | Версия на русском 🇷🇺

🇷🇺

Установка

pi install npm:@htwdev/pi-env-loader
pi install git:github.com/HTWDEVRU/pi-env-loader

Попробовать без установки

pi -e git:github.com/HTWDEVRU/pi-env-loader
pi -e npm:@htwdev/pi-env-loader

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

/env                       # Загрузить из .env в корне проекта
/env .env.local            # Загрузить из конкретного файла
/env ./config/dev.env      # Загрузить из подпапки
/env list                  # Посмотреть все установленные переменные
/env .env.local list       # Посмотреть список из файла
/env get DATABASE_URL      # Получить переменную из env
/env .env.local get DB     # Получить переменную из файла

Команды

| Команда | Описание | |---------|----------| | /env | Загрузить переменные из .env | | /env <PATH_TO_FILE> | Загрузить из указанного файла (поддержка Unicode и Windows путей) | | /env list | Показать все установленные переменные окружения | | /env <PATH> list | Показать переменные из файла | | /env get KEY | Получить значение переменной из env | | /env <PATH> get KEY | Получить значение переменной из файла | | /env set KEY VALUE | Установить переменную в process.env только | | /env help | Показать справку |

Имена переменных

Только ASCII символы: A-Z, a-z, 0-9, _

Кириллица и другие Unicode символы поддерживаются только в путях к файлам.

.env Синтаксис

# Стандартный
KEY=value
KEY="значение с пробелами"

# Расширенный
export KEY=value
KEY?=value              # установить если не существует (никогда не перезаписывает)
KEY+=value              # добавить к существующему (через : или ;)
KEY-=value              # добавить в начало

# Интерполяция
DATABASE_URL=postgres://$USER:pass@localhost/db
API_URL=${BASE_URL}/api

# Multiline
MULTI_LINE=строка1\
строка2

# Escape-последовательности
NEWLINE="строка1\nстрока2"
TAB="кол1\tкол2"

Пути

Поддерживаются Unix и Windows пути, включая кириллицу:

/env .env                    # Unix стиль
/env C:\\Projects\\.env      # Windows стиль
/env C:/Projects/.env        # Windows (Unix-style separators)
/env проекты/настройки.env   # Кириллица в путях

Смешанные разделители (Git Bash на Windows):

PATH=/c/Users/user/bin:$PATH  # Unix-style в Git Bash

Защищённые переменные

Не перезаписываются: PATH, HOME, USER, SHELL, TERM, TEMP, TMP, WINDIR и др.

Маскирование

Автоматически маскируются: *_KEY, *_SECRET, *_PASSWORD, *_TOKEN, *_AUTH, *_PRIVATE.

Лицензия

MIT

Vibecode

100%

🇺🇸 / 🇬🇧

English version

Версия на русском 🇷🇺

pi extension for loading environment variables from .env files.

Installation

pi install npm:@htwdev/pi-env-loader
pi install git:github.com/HTWDEVRU/pi-env-loader

Try without installing

pi -e git:github.com/HTWDEVRU/pi-env-loader
pi -e npm:@htwdev/pi-env-loader

Quick Start

/env                       # Load from .env in project root
/env .env.local            # Load from specific file
/env ./config/dev.env      # Load from subfolder
/env list                  # List all currently set environment variables
/env .env.local list       # List variables from custom file
/env get DATABASE_URL      # Get specific variable from env
/env .env.local get DB     # Get variable from custom file

Commands

| Command | Description | |---------|-------------| | /env | Load variables from .env | | /env <PATH_TO_FILE> | Load from custom file path (Unicode and Windows paths supported) | | /env list | List all currently set environment variables | | /env <PATH> list | List variables from custom file | | /env get KEY | Get specific variable value from env | | /env <PATH> get KEY | Get variable value from custom file | | /env set KEY VALUE | Set variable in process.env only | | /env help | Show help |

Variable Names

Only ASCII characters: A-Z, a-z, 0-9, _

Unicode characters supported only in file paths.

.env Syntax

# Standard
KEY=value
KEY="value with spaces"

# Extended
export KEY=value
KEY?=value              # set only if not exists (never overwrites)
KEY+=value              # append to existing (with : or ;)
KEY-=value              # prepend to existing

# Interpolation
DATABASE_URL=postgres://$USER:pass@localhost/db
API_URL=${BASE_URL}/api

# Multiline
MULTI_LINE=line1\
line2

# Escape sequences
NEWLINE="line1\nline2"
TAB="col1\tcol2"

Paths

Unix and Windows paths supported, including Cyrillic in paths:

/env .env                    # Unix style
/env C:\\Projects\\.env      # Windows style
/env C:/Projects/.env        # Windows (Unix-style separators)
/env projects/settings.env   # Cyrillic in paths (only in file paths)

Mixed separators supported (Git Bash on Windows):

PATH=/c/Users/user/bin:$PATH  # Unix-style in Git Bash

Protected Variables

Never overwritten: PATH, HOME, USER, SHELL, TERM, TEMP, TMP, WINDIR etc.

Masking

Automatically masked: *_KEY, *_SECRET, *_PASSWORD, *_TOKEN, *_AUTH, *_PRIVATE.

License

MIT

Vibecode

100%