feat(api): add read() function

Author: zkat

README.md

@@ -0,0 +1,42 @@
+# libnpmconfig [![npm version](https://img.shields.io/npm/v/libnpmconfig.svg)](https://npm.im/libnpmconfig) [![license](https://img.shields.io/npm/l/libnpmconfig.svg)](https://npm.im/libnpmconfig) [![Travis](https://img.shields.io/travis/npm/libnpmconfig.svg)](https://travis-ci.org/npm/libnpmconfig) [![AppVeyor](https://ci.appveyor.com/api/projects/status/github/zkat/libnpmconfig?svg=true)](https://ci.appveyor.com/project/zkat/libnpmconfig) [![Coverage Status](https://coveralls.io/repos/github/npm/libnpmconfig/badge.svg?branch=latest)](https://coveralls.io/github/npm/libnpmconfig?branch=latest)
+
+[`libnpmconfig`](https://github.com/npm/libnpmconfig) is a Node.js library for
+programmatically managing npm's configuration files and data.
+
+## Example
+
+```js
+const config = require('libnpmconfig')
+
+console.log('configured registry:', config.read({
+  registry: 'https://default.registry/'
+}))
+// => configured registry: https://registry.npmjs.org
+```
+
+## Install
+
+`$ npm install libnpmconfig`
+
+## Table of Contents
+
+* [Example](#example)
+* [Install](#install)
+* [API](#api)
+
+### API
+
+##### <a name="read"></a> `> read(moreOpts, readOpts)`
+
+Reads configurations from the filesystem and the env and returns a
+[`figgy-pudding`](https://npm.im/figgy-pudding) object with the configuration
+values.
+
+If `moreOpts` is provided, it will be merged with the returned config pudding,
+shadowing any read values.
+
+If `readOpts.cwd` is provided, it will be used instead of `process.cwd()` as the
+starting point for config searching.
+
+If `readOpts.userconfig` is provided, it will be used as the user configuration
+file, shadowing `moreOpts.userconfig`, which is also acceptable.

index.js

@@ -0,0 +1,66 @@
+'use strict'
+
+const fs = require('fs')
+const figgyPudding = require('figgy-pudding')
+const ini = require('ini')
+const os = require('os')
+const path = require('path')
+
+const NpmConfig = figgyPudding({}, {
+  // Open up the pudding object.
+  other () { return true }
+})
+
+const ConfigOpts = figgyPudding({
+  cache: { default: path.join(os.homedir(), '.npm') },
+  cwd: { default: () => process.cwd() },
+  userconfig: { default: path.join(os.homedir(), '.npmrc') }
+})
+
+module.exports.read = getNpmConfig
+function getNpmConfig (_opts, configOpts) {
+  const opts = NpmConfig(_opts)
+  const copts = ConfigOpts(configOpts)
+  const configs = copts.cwd.split(path.sep).reduce((acc, next) => {
+    acc.path = path.join(acc.path, next)
+    acc.configs.push(maybeReadIni(path.join(acc.path, '.npmrc')))
+    acc.configs.push(maybeReadIni(path.join(acc.path, 'npmrc')))
+    return acc
+  }, {
+    path: '',
+    configs: []
+  }).configs.concat(
+    maybeReadIni(copts.userconfig || opts.userconfig)
+  ).filter(x => x)
+  const env = Object.keys(process.env).reduce((acc, key) => {
+    if (key.match(/^npm_config_/i)) {
+      const newKey = key.toLowerCase()
+        .replace(/^npm_config_/i, '')
+        .replace(/(?!^)_/g, '-')
+      acc[newKey] = process.env[key]
+    }
+    return acc
+  }, {})
+  const newOpts = NpmConfig(...configs, env, _opts)
+  if (newOpts.cache) {
+    return newOpts.concat({
+      cache: path.join(newOpts.cache, '_cacache')
+    })
+  } else {
+    return newOpts
+  }
+}
+
+function maybeReadIni (f) {
+  let txt
+  try {
+    txt = fs.readFileSync(f, 'utf8')
+  } catch (err) {
+    if (err.code === 'ENOENT') {
+      return ''
+    } else {
+      throw err
+    }
+  }
+  return ini.parse(txt)
+}

package-lock.json

@@ -1,5 +1,7 @@
 {
   "name": "libnpmconfig",
+  "version": "1.0.0",
+  "description": "Standalone library for reading/writing/managing npm configurations",
   "author": {
     "name": "Kat Marchán",
     "email": "kzm@zkat.tech",
@@ -11,7 +13,7 @@
     "release": "standard-version -s",
     "postrelease": "npm publish && git push --follow-tags",
     "pretest": "standard",
-    "test": "tap -J -100 test/*.js",
+    "test": "tap -J --100 test/*.js",
     "update-coc": "weallbehave -o . && git add CODE_OF_CONDUCT.md && git commit -m 'docs(coc): updated CODE_OF_CONDUCT.md'",
     "update-contrib": "weallcontribute -o . && git add CONTRIBUTING.md && git commit -m 'docs(contributing): updated CONTRIBUTING.md'"
   },
@@ -27,5 +29,9 @@
     "url": "https://github.com/npm/libnpmconfig.git"
   },
   "bugs": "https://github.com/npm/libnpmconfig/issues",
-  "homepage": "https://npmjs.com/package/libnpmconfig"
+  "homepage": "https://npmjs.com/package/libnpmconfig",
+  "dependencies": {
+    "figgy-pudding": "^3.5.1",
+    "ini": "^1.3.5"
+  }
 }