Download the PHP package purple-dbu/vcloud-sdk-helpers without Composer
On this page you can find all versions of the php package purple-dbu/vcloud-sdk-helpers. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download purple-dbu/vcloud-sdk-helpers
More information about purple-dbu/vcloud-sdk-helpers
Files in purple-dbu/vcloud-sdk-helpers
Package vcloud-sdk-helpers
Short Description Utility classes for vCloud Director PHP SDK
License MIT
Homepage https://github.com/purple-dbu/vcloud-sdk-php-helpers
Informations about the package vcloud-sdk-helpers
vcloud-sdk-php-helpers
Utility classes for vCloud Director PHP SDK
Installation
Installation can be done via Composer. All you need
is to add this to your composer.json
:
Usage
For full usage instructions, please read the API Documentation.
Right Helper
The Right Helper gives you the ability to manipulate user rights with ease. It helps you determining the current logged user rights.
Determine whether the current user is administrator of his organization, or not
Query Helper
The Query Helper gives you the ability to manipulate the vCloud SDK Query Service with ease. It provides abstraction for pagination.
Get all results for query 'adminVApp'
Get the query result for 'adminVApp' with id 'c47ddf20-05de-44f5-b79e-c463992ffd3f'
Exception Helper
The Exception Helper gives you the ability to manipulate vCloud SDK exceptions (VMware_VCloud_SDK_Exception) with ease. It allows extracting the error codes and messages from the original exception message, with is just raw XML of the form:
Get the error message
Get the error code
Metadata helper
The Metadata Helper gives you the ability to manipulate metadata on vCloud objects with ease. It helps finding objects with a particular metadata (to either one particular value, or any value).
Get all vApp Template with a given metadata set (any value)
Get the first vApp Template with a given metadata set to a particular value
Licensing
This project is released under MIT License license. If this license does not fit your requirement for whatever reason, but you would be interested in using the work (as defined below) under another license, please contact Purple DBU at [email protected].
Contributing
Contributions (issues ♥, pull requests ♥♥♥) are more than welcome! Feel free to clone, fork, modify, extend, etc, as long as you respect the license terms.
Requirements
You need to have the following software installed:
- git
- make
- curl
- php >= 5.3.2
You need to have a working vCloud Director installation.
Getting started
To start contributing, the best is to follow these steps:
- Create a GitHub account
- Create your own fork of this project
- Clone it to your machine:
git clone https://github.com/<you>/vcloud-sdk-php-helpers.git
- Go to the project's root directory:
cd vcloud-sdk-php-helpers
- Create the file tests/config.php:
cp tests/config.php.dist tests/config.php
- Edit
tests/config.php
and set values according to your vCloud Director configuration - Install dependencies:
make dependencies
- Run tests:
make test
Common tasks
- Update dependencies:
make dependencies
- Clean dependencies:
make clean
- Check code quality:
make lint
- Run integration tests:
make integration
- Generate stubs for unit tests:
make stubs
- Run unit tests:
make test
- Generate API documentation:
make doc
- Publish API documentation:
make publish
Versioning
Using Semver as a base for versioning, this project also
follow additional guidelines for version numbering. each version is in the
format x.y.z
where:
- Each modification of
x
introduces backward compatibility breaks - Each modification of
y
introduces a new feature - Modifications of
y
are simply corrections of existing patches
All versions of vcloud-sdk-helpers with dependencies
vmware/vcloud-sdk-patched Version >=550.4.0
pear-pear.php.net/http_request2 Version 2.2.*