RETIRED, Windows / Hyper-V library for OpenStack projects.
Go to file
Lucian Petrut 0857a0eb81 Cleanup utilsfactory map
This change cleans up the utilsfactory map, making it easier to add
new classes.

Most classes have 6.2 as a minimum version, without having a maximum
version cap. For this reason, this change sets those versions as
defaults so that we don't have to be explicit every time.

At the same time, we're now using a list for each class type, instead
of a dict that uses the class name as a key (which is redundant). So,
something like this:

'networkutils': {
    'NetworkUtils': {
        'min_version': 6.2,
        'max_version': 6.3,
        'path': 'os_win.utils.network.networkutils.NetworkUtils'},
    'NetworkUtilsR2': {
        'min_version': 6.3,
        'max_version': None,
        'path': 'os_win.utils.network.networkutils.NetworkUtilsR2'}},

... becomes

'networkutils': [
    {'max_version': 6.3,
     'path': 'os_win.utils.network.networkutils.NetworkUtils'},
    {'min_version': 6.3,
     'path': 'os_win.utils.network.networkutils.NetworkUtilsR2'},
],

Change-Id: I7919617166b2e872f1b50c0a0f40196fc90e9a82
2019-01-16 14:41:43 +02:00
doc/source doc: Switch to openstackdocstheme 2017-11-13 19:03:37 +00:00
etc Add config sample to os-win docs 2017-11-13 17:53:39 +00:00
os_win Cleanup utilsfactory map 2019-01-16 14:41:43 +02:00
releasenotes Update reno for stable/rocky 2018-07-26 12:36:17 +00:00
.coveragerc Change ignore-errors to ignore_errors 2015-09-21 14:42:06 +00:00
.gitignore Add config sample to os-win docs 2017-11-13 17:53:39 +00:00
.gitreview Rename project to os-win 2015-09-17 05:21:49 -07:00
.mailmap Adds oslo cookiecutter template 2015-08-05 19:48:23 +03:00
.testr.conf Renames project to os-windows 2015-08-25 13:35:09 +03:00
.zuul.yaml add python 3.6 unit test job 2018-08-24 06:31:41 +00:00
CONTRIBUTING.rst Rename project to os-win 2015-09-17 05:21:49 -07:00
HACKING.rst Update the documentation link for doc migration 2017-07-24 17:27:49 +08:00
LICENSE Initial commit 2015-08-05 19:34:43 +03:00
MANIFEST.in Adds oslo cookiecutter template 2015-08-05 19:48:23 +03:00
README.rst Add release note link in README 2018-06-27 23:29:54 +08:00
babel.cfg Adds oslo cookiecutter template 2015-08-05 19:48:23 +03:00
lower-constraints.txt Updated from global requirements 2018-08-02 06:57:19 -07:00
requirements.txt Updated from global requirements 2018-08-02 06:57:19 -07:00
setup.cfg Add oslo.config entry point 2017-11-10 15:59:49 +02:00
setup.py Updated from global requirements 2017-03-02 17:50:41 +00:00
test-requirements.txt Updated from global requirements 2018-03-15 07:46:04 +00:00
tox.ini fix tox python3 overrides 2018-06-06 15:27:01 -04:00

README.rst

Team and repository tags

image

os-win

Windows / Hyper-V library for OpenStack projects.

This library contains Windows / Hyper-V specific code commonly used in OpenStack projects. The library can be used in any other OpenStack projects where it is needed.

Release Notes

How to Install

os-win is released on Pypi, meaning that it can be installed and upgraded via pip. To install os-win, run the following command:

pip install os-win

To upgrade os-win, run the following command:

pip install -U os-win

Note that the first OpenStack release to use os-win is Mitaka. Previous releases do not benefit from this library.

Tests

You will have to install the test dependencies first to be able to run the tests.

C:\os_win> pip install -r requirements.txt
C:\os_win> pip install -r test-requirements.txt

You can run the unit tests with the following command.

C:\os_win> nosetests os_win\tests\unit

How to contribute

To contribute to this project, please go through the following steps.

  1. Clone the project and keep your working tree updated.
  2. Make modifications on your working tree.
  3. Run unit tests.
  4. If the tests pass, commit your code.
  5. Submit your code via git review.
  6. Check that Jenkins and the Microsoft Hyper-V CI pass on your patch.
  7. If there are issues with your commit, ammend, and submit it again via git review.
  8. Wait for the patch to be reviewed.

Features

os-win is currently used in the following OpenStack projects:

  • nova
  • cinder
  • compute-hyperv
  • networking-hyperv
  • ceilometer
  • os-brick