Releasing version 1.3.2 (#16)

Author: mross22

CHANGELOG.rst

@@ -4,6 +4,26 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`_.
 
+====================
+ 1.3.2 - 2017-05-18
+====================
+
+-------
+ Added
+-------
+
+* Support for VCN private subnets using the prohibit_public_ip_on_vnic parameter on oraclebmc.core.VirtualNetworkClient.create_subnet.
+* Support for FastConnect
+* Support for list_regions and region subscription operations
+* First class support for new IAD region
+
+-------
+ Fixed
+-------
+
+* For manually created configs (not from a file), use default values for optional fields that are not present (`GitHub issue <https://github.com/oracle/bmcs-python-sdk/issues/13>`_)
+* Updated parsing of 'region' config value to enable better support for unrecognized regions
+
 ====================
  1.3.1 - 2017-04-27
 ====================

docs/forward-compatibility.rst

@@ -0,0 +1,5 @@
+.. _forward-compatibility:
+
+Forward Compatibility
+~~~~~~~~~~~~~~~~~~~~~~
+Some response fields are enum-typed. In the future, individual services may return values not covered by existing enums for that field. To address this possibility, every enum-type response field has an additional value named "UNKNOWN_ENUM_VALUE". If a service returns a value that is not recognized by your version of the SDK, then the response field will be set to this value. Please ensure that your code handles the "UNKNOWN_ENUM_VALUE" case if you have conditional logic based on an enum-typed field.

docs/index.rst

@@ -33,6 +33,7 @@ To get started, head over to the :ref:`installation instructions <install>` or s
 
     installation
     configuration
+	forward-compatibility
     quickstart
     parallel-ops
     raw-requests

oraclebmc/base_client.py

@@ -15,7 +15,7 @@
 from dateutil.parser import parse
 
 from . import constants, exceptions, regions
-from .config import validate_config
+from .config import get_config_value_or_default, validate_config
 from .request import Request
 from .response import Response
 from .version import __version__
@@ -66,11 +66,11 @@ def __init__(self, service, config, signer, type_mapping):
 
         self.type_mappings = merge_type_mappings(self.primitive_type_map, type_mapping)
         self.session = requests.Session()
-        self.user_agent = build_user_agent(config["additional_user_agent"])
+        self.user_agent = build_user_agent(get_config_value_or_default(config, "additional_user_agent"))
 
         self.logger = logging.getLogger("{}.{}".format(__name__, id(self)))
         self.logger.addHandler(logging.NullHandler())
-        if config["log_requests"]:
+        if get_config_value_or_default(config, "log_requests"):
             self.logger.setLevel(logging.DEBUG)
             six.moves.http_client.HTTPConnection.debuglevel = 1
         else:

oraclebmc/config.py

@@ -94,6 +94,10 @@ def validate_config(config):
         raise InvalidConfig(errors)
 
 
+def get_config_value_or_default(config, key):
+    return config.get(key, DEFAULT_CONFIG.get(key))
+
+
 def _as_bool(x):
     if x in [True, False]:
         return x

oraclebmc/core/blockstorage_client.py

@@ -6,7 +6,7 @@
 import six
 
 from ..base_client import BaseClient
-from ..config import validate_config
+from ..config import get_config_value_or_default, validate_config
 from ..signer import Signer
 from ..util import Sentinel
 from .models import core_type_mapping
@@ -22,7 +22,7 @@ def __init__(self, config):
             user=config["user"],
             fingerprint=config["fingerprint"],
             private_key_file_location=config["key_file"],
-            pass_phrase=config["pass_phrase"]
+            pass_phrase=get_config_value_or_default(config, "pass_phrase")
         )
         self.base_client = BaseClient("blockstorage", config, signer, core_type_mapping)
 

oraclebmc/core/compute_client.py

@@ -6,7 +6,7 @@
 import six
 
 from ..base_client import BaseClient
-from ..config import validate_config
+from ..config import get_config_value_or_default, validate_config
 from ..signer import Signer
 from ..util import Sentinel
 from .models import core_type_mapping
@@ -22,7 +22,7 @@ def __init__(self, config):
             user=config["user"],
             fingerprint=config["fingerprint"],
             private_key_file_location=config["key_file"],
-            pass_phrase=config["pass_phrase"]
+            pass_phrase=get_config_value_or_default(config, "pass_phrase")
         )
         self.base_client = BaseClient("compute", config, signer, core_type_mapping)
 
@@ -673,8 +673,9 @@ def launch_instance(self, launch_instance_details, **kwargs):
         on that resource type, or by viewing the resource in the Console.
 
         When you launch an instance, it is automatically attached to a Virtual
-        Network Interface Card (VNIC) and given both a public and private IP address.
-        To get both addresses, use the :func:`list_vnic_attachments`
+        Network Interface Card (VNIC). The VNIC has a private IP address from
+        the subnet's CIDR, and optionally a public IP address.
+        To get the addresses, use the :func:`list_vnic_attachments`
         operation to get the VNIC ID for the instance, and then call
         :func:`get_vnic` with the VNIC ID.
 

oraclebmc/core/models/__init__.py

@@ -9,6 +9,8 @@
 from .console_history import ConsoleHistory
 from .cpe import Cpe
 from .create_cpe_details import CreateCpeDetails
+from .create_cross_connect_details import CreateCrossConnectDetails
+from .create_cross_connect_group_details import CreateCrossConnectGroupDetails
 from .create_dhcp_details import CreateDhcpDetails
 from .create_drg_attachment_details import CreateDrgAttachmentDetails
 from .create_drg_details import CreateDrgDetails
@@ -19,15 +21,24 @@
 from .create_security_list_details import CreateSecurityListDetails
 from .create_subnet_details import CreateSubnetDetails
 from .create_vcn_details import CreateVcnDetails
+from .create_virtual_circuit_details import CreateVirtualCircuitDetails
+from .create_vnic_details import CreateVnicDetails
 from .create_volume_backup_details import CreateVolumeBackupDetails
 from .create_volume_details import CreateVolumeDetails
+from .cross_connect import CrossConnect
+from .cross_connect_group import CrossConnectGroup
+from .cross_connect_location import CrossConnectLocation
+from .cross_connect_mapping import CrossConnectMapping
+from .cross_connect_port_speed_shape import CrossConnectPortSpeedShape
+from .cross_connect_status import CrossConnectStatus
 from .dhcp_dns_option import DhcpDnsOption
 from .dhcp_option import DhcpOption
 from .dhcp_options import DhcpOptions
 from .dhcp_search_domain_option import DhcpSearchDomainOption
 from .drg import Drg
 from .drg_attachment import DrgAttachment
 from .egress_security_rule import EgressSecurityRule
+from .fast_connect_provider_service import FastConnectProviderService
 from .ip_sec_connection import IPSecConnection
 from .ip_sec_connection_device_config import IPSecConnectionDeviceConfig
 from .ip_sec_connection_device_status import IPSecConnectionDeviceStatus
@@ -39,6 +50,7 @@
 from .instance_credentials import InstanceCredentials
 from .internet_gateway import InternetGateway
 from .launch_instance_details import LaunchInstanceDetails
+from .letter_of_authority import LetterOfAuthority
 from .port_range import PortRange
 from .route_rule import RouteRule
 from .route_table import RouteTable
@@ -50,6 +62,8 @@
 from .tunnel_status import TunnelStatus
 from .udp_options import UdpOptions
 from .update_cpe_details import UpdateCpeDetails
+from .update_cross_connect_details import UpdateCrossConnectDetails
+from .update_cross_connect_group_details import UpdateCrossConnectGroupDetails
 from .update_dhcp_details import UpdateDhcpDetails
 from .update_drg_attachment_details import UpdateDrgAttachmentDetails
 from .update_drg_details import UpdateDrgDetails
@@ -61,9 +75,12 @@
 from .update_security_list_details import UpdateSecurityListDetails
 from .update_subnet_details import UpdateSubnetDetails
 from .update_vcn_details import UpdateVcnDetails
+from .update_virtual_circuit_details import UpdateVirtualCircuitDetails
 from .update_volume_backup_details import UpdateVolumeBackupDetails
 from .update_volume_details import UpdateVolumeDetails
 from .vcn import Vcn
+from .virtual_circuit import VirtualCircuit
+from .virtual_circuit_bandwidth_shape import VirtualCircuitBandwidthShape
 from .vnic import Vnic
 from .vnic_attachment import VnicAttachment
 from .volume import Volume
@@ -78,6 +95,8 @@
     "ConsoleHistory": ConsoleHistory,
     "Cpe": Cpe,
     "CreateCpeDetails": CreateCpeDetails,
+    "CreateCrossConnectDetails": CreateCrossConnectDetails,
+    "CreateCrossConnectGroupDetails": CreateCrossConnectGroupDetails,
     "CreateDhcpDetails": CreateDhcpDetails,
     "CreateDrgAttachmentDetails": CreateDrgAttachmentDetails,
     "CreateDrgDetails": CreateDrgDetails,
@@ -88,15 +107,24 @@
     "CreateSecurityListDetails": CreateSecurityListDetails,
     "CreateSubnetDetails": CreateSubnetDetails,
     "CreateVcnDetails": CreateVcnDetails,
+    "CreateVirtualCircuitDetails": CreateVirtualCircuitDetails,
+    "CreateVnicDetails": CreateVnicDetails,
     "CreateVolumeBackupDetails": CreateVolumeBackupDetails,
     "CreateVolumeDetails": CreateVolumeDetails,
+    "CrossConnect": CrossConnect,
+    "CrossConnectGroup": CrossConnectGroup,
+    "CrossConnectLocation": CrossConnectLocation,
+    "CrossConnectMapping": CrossConnectMapping,
+    "CrossConnectPortSpeedShape": CrossConnectPortSpeedShape,
+    "CrossConnectStatus": CrossConnectStatus,
     "DhcpDnsOption": DhcpDnsOption,
     "DhcpOption": DhcpOption,
     "DhcpOptions": DhcpOptions,
     "DhcpSearchDomainOption": DhcpSearchDomainOption,
     "Drg": Drg,
     "DrgAttachment": DrgAttachment,
     "EgressSecurityRule": EgressSecurityRule,
+    "FastConnectProviderService": FastConnectProviderService,
     "IPSecConnection": IPSecConnection,
     "IPSecConnectionDeviceConfig": IPSecConnectionDeviceConfig,
     "IPSecConnectionDeviceStatus": IPSecConnectionDeviceStatus,
@@ -108,6 +136,7 @@
     "InstanceCredentials": InstanceCredentials,
     "InternetGateway": InternetGateway,
     "LaunchInstanceDetails": LaunchInstanceDetails,
+    "LetterOfAuthority": LetterOfAuthority,
     "PortRange": PortRange,
     "RouteRule": RouteRule,
     "RouteTable": RouteTable,
@@ -119,6 +148,8 @@
     "TunnelStatus": TunnelStatus,
     "UdpOptions": UdpOptions,
     "UpdateCpeDetails": UpdateCpeDetails,
+    "UpdateCrossConnectDetails": UpdateCrossConnectDetails,
+    "UpdateCrossConnectGroupDetails": UpdateCrossConnectGroupDetails,
     "UpdateDhcpDetails": UpdateDhcpDetails,
     "UpdateDrgAttachmentDetails": UpdateDrgAttachmentDetails,
     "UpdateDrgDetails": UpdateDrgDetails,
@@ -130,9 +161,12 @@
     "UpdateSecurityListDetails": UpdateSecurityListDetails,
     "UpdateSubnetDetails": UpdateSubnetDetails,
     "UpdateVcnDetails": UpdateVcnDetails,
+    "UpdateVirtualCircuitDetails": UpdateVirtualCircuitDetails,
     "UpdateVolumeBackupDetails": UpdateVolumeBackupDetails,
     "UpdateVolumeDetails": UpdateVolumeDetails,
     "Vcn": Vcn,
+    "VirtualCircuit": VirtualCircuit,
+    "VirtualCircuitBandwidthShape": VirtualCircuitBandwidthShape,
     "Vnic": Vnic,
     "VnicAttachment": VnicAttachment,
     "Volume": Volume,