Skip to content

vmj/groovy-upcloud

Repository files navigation

Build Status Release Javadoc

Groovy UpCloud

Groovy UpCloud is an unofficial library that provides an asynchronous Groovy interface to the UpCloud API.

Features

Groovy UpCloud library is fully asynchronous. When invoking the API, the HTTP transaction is performed in a pool of background threads, and the results are passed to the application. The communication (currently) happens via callbacks. By default, the IO thread pool has four workers, i.e. four HTTP transactions concurrently.

When used as a base for Groovy scripting, Groovy UpCloud provides a script base class that makes it easier to deal with the concurrent nature: the top-level code and all the callbacks are executed in a dedicated thread, separate from the IO thread pool.

Groovy UpCloud library has full support for UpCloud API version 1.2.8 (current as of Feb 2020).

Requirements

Groovy UpCloud is built on Groovy 3.0. This library is available at The Central Repository and jcenter

API Documentation

The main resources managed in UpCloud are servers, IP addresses, storages, firewall rules, and tags. You might want to start with those.

Also, in order to understand how the library works, you might want to dive into Session, and Resource.