Skip to content
/ envied Public
forked from petercinibulk/envied

Handles environment variables in dart from a .env file.

License

Notifications You must be signed in to change notification settings

Etiya/envied

 
 

Repository files navigation

ENVied

Pub CI codecov Melos License: MIT

A cleaner way to handle your environment variables in Dart/Flutter.

(GREATLY inspired by Envify)


Table of Contents


Overview

Using a .env file such as:

KEY=VALUE

or system environment variables such as:

export VAR=test

and a dart class:

import 'package:envied/envied.dart';

part 'env.g.dart';

@Envied()
abstract class Env {
  @EnviedField(varName: 'KEY')
  static const key = _Env.key;
}

Envied will generate the part file which contains the values from your .env file using build_runner

You can then use the Env class to access your environment variable:

print(Env.key); // "VALUE"

Install

Add both envied and envied_generator as dependencies,

If you are using creating a Flutter project:

$ flutter pub add envied
$ flutter pub add --dev envied_generator
$ flutter pub add --dev build_runner

If you are using creating a Dart project:

$ dart pub add envied
$ dart pub add --dev envied_generator
$ dart pub add --dev build_runner

This installs three packages:

  • build_runner, the tool to run code-generators
  • envied_generator, the code generator
  • envied, a package containing the annotations.

Usage

Add a .env file at the root of the project. The name of this file can be specified in your Envied class if you call it something else such as .env.dev.

KEY1=VALUE1
KEY2=VALUE2

Create a class to ingest the environment variables (lib/env/env.dart). Add the annotations for Envied on the class and EnviedField for any environment variables you want to be pulled from your .env file.

IMPORTANT! Add both .env and env.g.dart files to your .gitignore file, otherwise, you might expose your environment variables.

// lib/env/env.dart
import 'package:envied/envied.dart';

part 'env.g.dart';

@Envied(path: '.env.dev')
abstract class Env {
  @EnviedField(varName: 'KEY1')
  static const key1 = _Env.key1;
  @EnviedField()
  static const KEY2 = _Env.KEY2;
}

Then run the generator:

# dart
dart run build_runner build
# flutter
flutter pub run build_runner build

You can then use the Env class to access your environment variables:

print(Env.key1); // "VALUE1"
print(Env.KEY2); // "VALUE2"

Obfuscation

Add the obfuscate flag to EnviedField

@EnviedField(obfuscate: true)

License

MIT © Peter Cinibulk

About

Handles environment variables in dart from a .env file.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 50.3%
  • HTML 34.0%
  • CSS 10.4%
  • Dart 5.3%