oci 1.3.9

Oracle Cloud Infrastructure Python SDK

About

This is the Python SDK for Oracle Cloud Infrastructure. Python 2.7+ and 3.5+ are supported.

>>> import oci
# Set up config
>>> config = oci.config.from_file(
...     "~/.oci/config",
...     "DEFAULT")
# Create a service client
>>> identity = oci.identity.IdentityClient(config)
# Get the current user
>>> user = identity.get_user(config["user"]).data
>>> print(user)
{
  "compartment_id": "ocid1.tenancy.oc1...",
  "description": "Test user",
  "id": "ocid1.user.oc1...",
  "inactive_status": null,
  "lifecycle_state": "ACTIVE",
  "name": "[e-mail]",
  "time_created": "2016-08-30T23:46:44.680000+00:00"
}

The project is open source and maintained by Oracle Corp. The home page for the project is here.

Installation

pip install oci

See the installation guide for installation troubleshooting and alternative install methods.

Development

Getting Started

Assuming that you have Python and virtualenv installed, set up your environment and install the required dependencies like this:

git clone https://github.com/oracle/oci-python-sdk.git
cd oci-python-sdk
virtualenv oci-python-sdk-env
. oci-python-sdk-env/bin/activate
pip install -r requirements.txt
pip install -e .

You should also set up your configuration files as described here

Running Tests

The SDK uses pytest as its test framework. You can run tests against Python 2.7 Python 3.5 using the tox command. Note that this requires that you have those versions of Python installed, otherwise you must pass -e or run tests directly:

# This will run tests against all configured Pythons in tox.ini (currently 2.7 and 3.5). You need to have those versions installed
tox

# This will run tests against a specific Python versions
tox -e py27

If you wish to run an individual test then you can run:

py.test -s tests/integ/test_launch_instance_tutorial.py

Specifying a config file

By default, the tests will look for a config file at ‘tests/resources/config’ and use the DEFAULT profile. You can change this with the --config-file and --config-profile options.

# Use a different config file, still using the DEFAULT profile
tox -- --config-file ~/.oci/config

# Using a different profile in the default config file
tox -- --config-profile IAD_PROFILE

Specifying environment variables

In addition to a valid config file for your tenancy, the tests also require the following environment variables to be set:

• OCI_PYSDK_PUBLIC_SSH_KEY_FILE: path to a public SSH key (.pub file) that will be given access to the instance launched in test_launch_instance_tutorial.py.

Generating Documentation

Sphinx is used for documentation. You can generate HTML locally with the following:

pip install -r requirements.txt
cd docs
make html

Generating the wheel

The SDK is packaged as a wheel. In order to generate the wheel you can run:

python setup.py sdist bdist_wheel

This wheel can then be installed via pip.

Examples

Examples can be found here.

Documentation

Full documentation, including prerequisites and installation and configuration instructions, can be found here.

API reference can be found here.

Help

See the “Questions or Feedback” section here.

Changes

See CHANGELOG.

Contributing

oci-python-sdk is an open source project. See CONTRIBUTING for details.

Oracle gratefully acknowledges the contributions to oci-python-sdk that have been made by the community.

Known Issues

You can find information on any known issues with the SDK here and under the “Issues” tab of this project’s GitHub repository.

License

Copyright (c) 2016, 2017, Oracle and/or its affiliates. All rights reserved.

This SDK and sample is dual licensed under the Universal Permissive License 1.0 and the Apache License 2.0.

See LICENSE for more details.