Add created_at property to know when vms are created

setup.py

@@ -2,7 +2,7 @@
 
 
 setup(
-    version='4.0.0',
+    version='4.1.0',
     name='osirium-vcdriver',
     description='A vcenter driver based on pyvmomi, fabric and pywinrm',
     url='https://github.com/Osirium/vcdriver',

test/integration/test_integration.py

@@ -1,3 +1,4 @@
+import datetime
 import hashlib
 import os
 import shutil
@@ -226,3 +227,8 @@ def test_snapshots(vms):
         vm.revert_snapshot(snapshot_name)
         with snapshot(vm):
             pass
+
+
+def test_created_at(vms):
+    for vm in vms.values():
+        assert type(vm.created_at) == datetime.datetime

test/unit/test_vm.py

@@ -1,3 +1,4 @@
+import datetime
 import mock
 import os
 
@@ -655,3 +656,12 @@ def test_get_all_virtual_machines(get_all_vcenter_objects, connection):
     obj2 = mock.MagicMock()
     get_all_vcenter_objects.return_value = [obj1, obj2]
     assert len(get_all_virtual_machines()) == 2
+
+
+@mock.patch('vcdriver.vm.connection')
+def test_created_at(connection):
+    vm = VirtualMachine()
+    vm_object_mock = mock.MagicMock()
+    vm_object_mock.config.changeVersion = '2018-06-13T15:12:43.700814Z'
+    vm.__setattr__('_vm_object', vm_object_mock)
+    assert vm.created_at == datetime.datetime(2018, 6, 13, 15, 12, 43, 700814)

vcdriver/vm.py

@@ -2,6 +2,7 @@
 
 import base64
 import contextlib
+import datetime
 import os
 import sys
 import time
@@ -197,6 +198,12 @@ def ip(self):
             validate_ip(ip)
             return ip
 
+    @property
+    def created_at(self):
+        return datetime.datetime.strptime(
+            self._vm_object.config.changeVersion, '%Y-%m-%dT%H:%M:%S.%fZ'
+        )
+
     @configurable([
         ('Virtual Machine Remote Management', 'vcdriver_vm_ssh_username'),
         ('Virtual Machine Remote Management', 'vcdriver_vm_ssh_password')