Add "Context bindings - Finding bindings"

packages/loopback/lib/context/index.ts

@@ -5,7 +5,7 @@
 import {Binding} from './binding';
 
 export class Context {
-  private registry: Map<string, any>;
+  private registry: Map<string, Binding>;
 
   constructor() {
     this.registry = new Map();
@@ -27,6 +27,23 @@ export class Context {
     return this.registry.has(key);
   }
 
+  find(pattern: string): Binding[] {
+    let bindings = [];
+    if (pattern) {
+      // TODO: swap with production grade glob to regex lib
+      const glob = new RegExp('^' + pattern.split('*').join('.*') + '$');
+      this.registry.forEach(binding => {
+        const isMatch = glob.test(binding.key);
+        if (isMatch)
+          bindings.push(binding);
+      });
+    } else {
+      bindings = Array.from(this.registry.values());
+    }
+
+    return bindings;
+  }
+
   get(key: string) {
     const binding = this.registry.get(key);
     return binding.value;

packages/loopback/test/acceptance/context-bindings/finding-bindings.feature.md

@@ -0,0 +1,52 @@
+# Feature: Context Binding - Finding bindings
+
+## Scenario: Finding all bindings
+
+- Given a context
+- And a binding with key `foo` bound to the value `bar`
+- And another binding with key `bat` bound to the value `baz`
+- When I find all bindings
+- Then I get a list of all bindings
+
+```ts
+// create a container for bindings
+const ctx = new Context();
+
+// creating two simple bindings
+ctx.bind('foo').to('bar');
+ctx.bind('baz').to('qux');
+
+// find all bindings
+const bindings = ctx.find();
+
+const keys = bindings.map(binding => {
+  return binding.key;
+});
+console.log(keys); // => ['foo', 'baz']
+```
+
+## Scenario: Finding bindings by pattern
+
+- Given a context
+- And a binding with key `my.foo` bound to the value `bar`
+- And another binding with key `my.baz` bound to the value `qux`
+- When I find all bindings using a pattern
+- Then I get a list of all bindings matching the pattern
+
+```ts
+// create a container for bindings
+const ctx = new Context({
+  delimiter: '.' // default
+});
+
+// creating three simple bindings
+ctx.bind('my.foo').to('bar');
+ctx.bind('my.baz').to('qux');
+ctx.bind('ur.quux').to('quuz');
+
+// find all bindings
+const bindings = ctx.find('my.*');
+
+const keys = bindings.map(binding => binding.key)
+console.log(keys); // => ['my.foo', 'my.baz']
+```

packages/loopback/test/acceptance/context-bindings/finding-bindings.ts

@@ -0,0 +1,55 @@
+// Copyright IBM Corp. 2013,2017. All Rights Reserved.
+// Node module: loopback
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+import {expect} from '@loopback/testlab';
+import * as util from 'loopback/test/support/util';
+
+describe('Context bindings - Finding bindings', () => {
+  let ctx;
+
+  describe('Finding all binding', () => {
+    before('given a context', createContext);
+    before('with two simple bindings', () => {
+      createBinding('foo', 'bar');
+      createBinding('baz', 'qux');
+    });
+
+    describe('when I find all bindings', () => {
+      it('returns all bindings', () => {
+        const bindings = ctx.find();
+        const keys = bindings.map(binding => {
+          return binding.key;
+        });
+        expect(keys).to.include('foo', 'baz');
+      });
+    });
+
+  });
+
+  describe('Finding bindings by pattern', () => {
+    before('given a context', createContext);
+    before('with namespaced bindings', () => {
+      createBinding('my.foo', 'bar');
+      createBinding('my.baz', 'qux');
+      createBinding('ur.quux', 'quuz');
+    });
+
+    describe('when I find all bindings using a pattern', () => {
+      it('returns all bindings matching the pattern', () => {
+        const bindings = ctx.find('my.*');
+        const keys = bindings.map(binding => binding.key);
+        expect(keys).to.include('my.foo', 'my.baz');
+        expect(keys).to.not.include('ur.quux');
+      });
+    });
+  });
+
+  function createContext() {
+    ctx = util.getContext();
+  }
+  function createBinding(key, value) {
+    ctx.bind(key).to(value);
+  }
+});