<commit_before>libvirt-go
============

[![Build Status](http://ci.serversaurus.com/github.com/alexzorin/libvirt-go/status.svg?branch=master)](http://ci.serversaurus.com/github.com/alexzorin/libvirt-go)

Go bindings for libvirt.

Versions
--------------
Please use the `0.9` branch for libvirt 0.9.8 and below, which will be tagged `v1.x` releases: `gopkg.in/alexzorin/libvirt-go.v1` [(docs)](http://gopkg.in/alexzorin/libvirt-go.v1).

The `master` branch targets the 1.x version of libvirt, which will be tagged `v2.x` releases: `gopkg.in/alexzorin/libvirt-go.v2` [(docs)](http://gopkg.in/alexzorin/libvirt-go.v2).

Make sure to have libvirt-dev package (or the development files otherwise somewhere in your include path)

Documentation
--------------

* [api documentation for the bindings](http://godoc.org/github.com/alexzorin/libvirt-go)
* [api documentation for libvirt](http://libvirt.org/html/libvirt-libvirt.html)

Contributing
-------------

Please fork and write tests.

Integration tests are available where functionality isn't provided by the test driver, see `integration_test.go`.

`Vagrantfiles` are included to provision testing environments to run the integration tests:

* `cd ./vagrant/{branch}` (i.e `./vagrant/master`, where you will find a `Vagrantfile` for the `master` branch)<commit_msg>Update README to reflect #40 changes<commit_after># libvirt-go

[![Build Status](http://ci.serversaurus.com/github.com/alexzorin/libvirt-go/status.svg?branch=master)](http://ci.serversaurus.com/github.com/alexzorin/libvirt-go)

Go bindings for libvirt.

Make sure to have `libvirt-dev` package (or the development files otherwise somewhere in your include path)

## Version Support
Currently, the only supported version of libvirt is **1.2.2**, tagged as `v2.x` releases `gopkg.in/alexzorin/libvirt-go.v2` [(docs)](http://gopkg.in/alexzorin/libvirt-go.v2).

The bindings will probably work with versions of libvirt that are higher than 1.2.2, depending on what is added in those releases. However, no features are currently being added that will cause the build or tests to break against 1.2.2.

### OS Compatibility Matrix

To quickly see what version of libvirt your OS can easily support (may be outdated). Obviously, nothing below 1.2.2 is usable with these bindings.

| OS Release   | libvirt Version                |
| ------------ | ------------------------------ |
| FC19         | 1.2.9 from libvirt.org/sources |
| Debian 7     | 1.2.4 from wheezy-backports    |
| Debian 6     | 0.9.12 from squeeze-backports  |
| Ubuntu 14.04 | 1.2.2 from trusty              |
| RHEL 6       | 0.10.x                         |
| RHEL 5       | 0.8.x                          |


### 0.9.x Support

Previously there was support for libvirt 0.9.8 and below, however this is no longer being updated. These releases were tagged `v1.x` at `gopkg.in/alexzorin/libvirt-go.v1` [(docs)](http://gopkg.in/alexzorin/libvirt-go.v1).

## Documentation

* [api documentation for the bindings](http://godoc.org/github.com/alexzorin/libvirt-go)
* [api documentation for libvirt](http://libvirt.org/html/libvirt-libvirt.html)

## Contributing

Please fork and write tests.

Integration tests are available where functionality isn't provided by the test driver, see `integration_test.go`.

A `Vagrantfile` is included to run the integration tests:

* `cd ./vagrant/{branch}` (i.e `./vagrant/master`, where you will find a `Vagrantfile` for the `master` branch)
{'fraction_non_alphanumeric': 0.14231884057971014, 'fraction_numerical': 0.01884057971014493, 'mean_word_length': 3.368354430379747, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3761719', 'n_tokens_mistral': 1162, 'n_tokens_neox': 1076, 'n_words': 335}