You can not select more than 25 topics
			Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
		
		
		
		
		
			
		
			
				
					74 lines
				
				2.0 KiB
			
		
		
			
		
	
	
					74 lines
				
				2.0 KiB
			| 
											3 years ago
										 | // TypeScript Version: 3.0
 | ||
|  | /// <reference types="node" />
 | ||
|  | 
 | ||
|  | export interface DotenvParseOutput { | ||
|  |   [name: string]: string; | ||
|  | } | ||
|  | 
 | ||
|  | /** | ||
|  |  * Parses a string or buffer in the .env file format into an object. | ||
|  |  * | ||
|  |  * See https://docs.dotenv.org
 | ||
|  |  * | ||
|  |  * @param src - contents to be parsed. example: `'DB_HOST=localhost'` | ||
|  |  * @param options - additional options. example: `{ debug: true }` | ||
|  |  * @returns an object with keys and values based on `src`. example: `{ DB_HOST : 'localhost' }` | ||
|  |  */ | ||
|  | export function parse<T extends DotenvParseOutput = DotenvParseOutput>( | ||
|  |   src: string | Buffer | ||
|  | ): T; | ||
|  | 
 | ||
|  | export interface DotenvConfigOptions { | ||
|  |   /** | ||
|  |    * Default: `path.resolve(process.cwd(), '.env')` | ||
|  |    * | ||
|  |    * Specify a custom path if your file containing environment variables is located elsewhere. | ||
|  |    * | ||
|  |    * example: `require('dotenv').config({ path: '/custom/path/to/.env' })` | ||
|  |    */ | ||
|  |   path?: string; | ||
|  | 
 | ||
|  |   /** | ||
|  |    * Default: `utf8` | ||
|  |    * | ||
|  |    * Specify the encoding of your file containing environment variables. | ||
|  |    * | ||
|  |    * example: `require('dotenv').config({ encoding: 'latin1' })` | ||
|  |    */ | ||
|  |   encoding?: string; | ||
|  | 
 | ||
|  |   /** | ||
|  |    * Default: `false` | ||
|  |    * | ||
|  |    * Turn on logging to help debug why certain keys or values are not being set as you expect. | ||
|  |    * | ||
|  |    * example: `require('dotenv').config({ debug: process.env.DEBUG })` | ||
|  |    */ | ||
|  |   debug?: boolean; | ||
|  | 
 | ||
|  |   /** | ||
|  |    * Default: `false` | ||
|  |    * | ||
|  |    * Override any environment variables that have already been set on your machine with values from your .env file. | ||
|  |    * | ||
|  |    * example: `require('dotenv').config({ override: true })` | ||
|  |    */ | ||
|  |   override?: boolean; | ||
|  | } | ||
|  | 
 | ||
|  | export interface DotenvConfigOutput { | ||
|  |   error?: Error; | ||
|  |   parsed?: DotenvParseOutput; | ||
|  | } | ||
|  | 
 | ||
|  | /** | ||
|  |  * Loads `.env` file contents into process.env. | ||
|  |  * | ||
|  |  * See https://docs.dotenv.org
 | ||
|  |  * | ||
|  |  * @param options - additional options. example: `{ path: './custom/path', encoding: 'latin1', debug: true, override: false }` | ||
|  |  * @returns an object with a `parsed` key if successful or `error` key if an error occurred. example: { parsed: { KEY: 'value' } } | ||
|  |  * | ||
|  |  */ | ||
|  | export function config(options?: DotenvConfigOptions): DotenvConfigOutput; |