Added option for download of attachments and update of Readme.md

Author: Martin Silkjær

README.md

@@ -52,7 +52,7 @@ ok: [localhost] => {
 ```yaml
 # Get username for Google
 - debug:
-    msg: {{ lookup('bitwarden', 'Google', field='username' }}
+    msg: {{ lookup('bitwarden', 'Google', field='username') }}
 ```
 
 The above might result in:
@@ -69,7 +69,7 @@ ok: [localhost] => {
 ```yaml
 # Get all available fields for an entry
 - debug:
-    msg: {{ lookup('bitwarden', 'Google', field='item' }}
+    msg: {{ lookup('bitwarden', 'Google', field='item') }}
 ```
 
 The above might result in:
@@ -109,7 +109,7 @@ ok: [localhost] => {
 ```yaml
 # Get the value of a custom field
 - debug:
-    msg: {{ lookup('bitwarden', 'Google', field='mycustomfield', custom_field=true }}
+    msg: {{ lookup('bitwarden', 'Google', field='mycustomfield', custom_field=true) }}
 ```
 
 The above might result in:
@@ -120,3 +120,21 @@ ok: [localhost] => {
     "msg": "the value of my custom field"
     }
 ```
+
+### download attachments files
+
+```yaml
+# Get the value of a custom field
+- debug:
+    msg: {{ lookup('bitwarden', 'privateKey.pem',  itemid='123456-1234-1234-abbf-60c345aaa3e', attachments=true ) }}
+```
+Optional parameters - output='/ansible/publicKey.pem'
+
+The above might result in:
+
+```
+TASK [debug] *********************************************************
+ok: [localhost] => {
+    "msg": "Saved /publicKey.pem"
+    }
+```

lookup_plugins/bitwarden.py

@@ -120,6 +120,10 @@ def get_custom_field(self, key, field):
         data = json.loads(self.get_entry(key, 'item'))
         return next(x for x in data['fields'] if x['name'] == field)['value']
 
+    def get_attachments(self, key, itemid, output):
+        attachment = ['get', 'attachment', '{}'.format(key), '--output={}'.format(output), '--itemid={}'.format(itemid)]
+        return self._run(attachment)
+
 
 class LookupModule(LookupBase):
 
@@ -142,6 +146,15 @@ def run(self, terms, variables=None, **kwargs):
                 values.append(bw.get_custom_field(term, field))
             elif field == 'notes':
                 values.append(bw.get_notes(term))
+            if kwargs.get('attachments'):
+                if kwargs.get('itemid'):
+                    itemid = kwargs.get('itemid')
+                    output = kwargs.get('output', term)
+                    values.append(bw.get_attachments(term, itemid, output))
+                else:
+                    raise AnsibleError("Missing value for - itemid - "
+                                       "Please set parameters as example: - "
+                                       "itemid='f12345-d343-4bd0-abbf-4532222' ")
             else:
                 values.append(bw.get_entry(term, field))
         return values