KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #dsh #dsh-plugin #ai-agent #claude-code #codex #typescript #ai-agents #mcp #cli #rust #deepseek-harness

penv.macro

★ 76 Open GitHub ↗

A macro used with babel-plugin-macros to write configurations for multiple environments, and remove configurations are irrelevant with the specified environment from your codes finally.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

- [penv.macro](#penvmacro)
  - [Language](#language)
  - [Installation](#installation)
  - [Usage](#usage)
    - [Basic](#basic)
    - [With default value](#with-default-value)
    - [Advanced](#advanced)
  - [Issues](#issues)
  - [License](#license)

# penv.macro

[![version][version-badge]][package]
![downloads][downloads-badge]
[![Build Status][travis-svg]][travis-repo]
[![MIT License][license-badge]][license]
[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg?style=flat-square)](https://conventionalcommits.org)
[![Babel Macro](https://img.shields.io/badge/babel--macro-%F0%9F%8E%A3-f5da55.svg?style=flat-square)](https://github.com/kentcdodds/babel-plugin-macros)

The `penv.macro` aims to write configurations of multiple environments in one
file simultaneously and remove irrelevant configuration codes from the final bundle. If you want to know more about this plugin, please see [here](DETAILS.md).

## Language

[English](#) | [中文](README.zh-CN.md)

## Installation

This module is distributed via [npm](https://www.npmjs.com/) which is bundled with [node](https://nodejs.org/en/) and should be installed as one of your project's `devDependencies`:

```shell
yarn add penv.macro --dev
```

```shell
npm install penv.macro --save-dev
```

You'll also need to install and configure [babel-macros](https://github.com/kentcdodds/babel-plugin-macros) if you haven't already.

## Usage

Once you've [configured `babel-macros`](https://github.com/kentcdodds/babel-plugin-macros/blob/master/other/docs/user.md) you can `import/require` `penv.macro`.

### Basic

```javascript
import env from 'penv.macro'

const BASE_URL = env({
  development: 'https://development.example.com',
  staging: 'https://staging.example.com',
  production: (() => 'https://production.example.com')(),
})

// Assume that the value of `process.env.NODE_ENV` is `production`
const BASE_URL = (() => 'https://production.example.com')()
```

### With default value

```javascript
import env from 'penv.macro'

const BASE_URL = env(
  {
    development: 'https://development.example.com',
    staging: 'https://staging.example.com',
    production: (() => 'https://production.example.com')(),
  },
  'defaultValue',
)

// Assume that the value of `process.env.NODE_ENV` didn't match anything
const BASE_URL = 'defaultValue'
```

### Advanced

The default [node](https://nodejs.org/en/) environment variable used to determine which property value would
be matched is `NODE_ENV`, if you want to change the default setting, you can customize
it by [configuring `babel-plugin-macros`](https://github.com/kentcdodds/babel-plugin-macros/blob/master/other/docs/author.md#config-experimental).

For example in `<ProjectRoot>/package.json`:

```json
{
  "dependencies": {},
  "babelMacros": {
    "penv": {
      "targetName": "NODE_ENV"
    }
  }
}
```

To know more details, please go to the above [link](https://github.com/kentcdodds/babel-plugin-macros/blob/master/other/docs/author.md#config-experimental).

## Issues

Click [here](https://github.com/chengjianhua/penv.macro/issues/new) to open a new issue.

## License

[MIT](https://github.com/chengjianhua/penv.macro/blob/master/LICENSE)

[npm]: https://www.npmjs.com/
[version-badge]: https://img.shields.io/npm/v/penv.macro.svg?style=flat-square
[package]: https://www.npmjs.com/package/penv.macro
[downloads-badge]: https://img.shields.io/npm/dm/penv.macro.svg?style=flat-square
[travis-svg]: https://travis-ci.org/chengjianhua/penv.macro.svg?style=flat-square&branch=master
[travis-repo]: https://travis-ci.org/chengjianhua/penv.macro
[npmcharts]: http://npmcharts.com/compare/penv.macro
[license-badge]: https://img.shields.io/npm/l/penv.macro.svg?style=flat-square
[license]: https://github.com/chengjianhua/penv.macro/blob/master/LICENSE

penv.macro

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README