summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* Updated from global requirementsOpenStack Proposal Bot2018-02-131-2/+2
| | | | Change-Id: I6d24e2d5e411d631eae955cb63391cde6eeb6538
* Updated from global requirementsOpenStack Proposal Bot2018-01-041-0/+3
| | | | Change-Id: Ia615971a83f613b396299ac015dbb2a4e02848b6
* Follow the new PTI for document buildChangBo Guo(gcb)2017-12-201-0/+5
| | | | | | | | | | | | For compliance with the Project Testing Interface as described in: https://governance.openstack.org/tc/reference/project-testing-interface.html For more detials information, please refer to: http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html Change-Id: I3d86f1897dc900ba815c0c3975e95e27bb29b532
* rearrange existing documentation to fit the new standard layout3.27.0Akihiro Motoki2017-07-0126-50/+49
| | | | Change-Id: I0727caae202b385d740b006fd957b990e308c6d7
* switch from oslosphinx to openstackdocsthemeAkihiro Motoki2017-07-011-3/+10
| | | | Change-Id: Ief1b96ec6d08552f285540a68994c70cc9af3098
* Use Sphinx 1.5 warning-is-error3.24.0Stephen Finucane2017-03-161-2/+0
| | | | | | | | | | | | | | | | With pbr 2.0 and Sphinx 1.5, the setting for treat sphinx warnings as errors is setting warning-is-error in build_sphinx section. Migrate the setting from the old warnerrors one. There are two issues: - The `*` character is recognized as an emphasis character and must be escaped - The index references modules that have since been removed These are resolved. Change-Id: Id078022c0f75bf8f162b693d260f67116eb6428b
* Add missing documentation for secretutilsEric Brown2017-02-231-1/+1
| | | | | | | | | | | | The current doc page for secretutils is blank [1], most likely because of the way constant_time_compare is in the exception block. This patch manually tells sphinx to doc the constant_time_compare function. Also adds the oslo.utils version when the module was added. [1]: https://docs.openstack.org/developer/oslo.utils/api/secretutils.html Change-Id: Ic1fb15176c93f126826f568149cabf4b8e5450d8
* Create dictutils and add 'flatten_dict_to_keypairs'Hanxi Liu2016-11-012-0/+7
| | | | | | | | | | | This function has been shared at least kwapi and all Telemetry projects including ceilometer, aodh, panko and gnocchi. As a generator, it produces sequence of keypairs for nested dictionaries. It seems to be good moving it to the common shared code. So add an initial dictutils and tests for it. Change-Id: Ibd7c2ce4ef9c2608910b26169a804eb463759c7f
* Trivial fixes to the usage docEric Brown2016-10-281-3/+3
| | | | | | | * Doc title containing too many = * A tab instead of spaces Change-Id: I87cc4cec257d937fcc87d98b76ef0446451fc822
* Add missing specs_matcher documentationChangBo Guo(gcb)2016-09-242-0/+7
| | | | | | Closes-Bug: #1616610 Change-Id: Id26af1ef6b19ace9d03611aba5389af644392b2c
* Merge "Create secretutils and include 'constant_time_compare' function"Jenkins2016-01-212-0/+7
|\
| * Create secretutils and include 'constant_time_compare' functionJoshua Harlow2016-01-192-0/+7
| | | | | | | | | | | | | | | | | | | | | | This code (or a version of it) is being shared by at least nova and keystonemiddleware and it seems like a good idea to move it to being common shared code (especially due to the importance of getting this code correct). This adds an initial secretutils and adds tests for it. Change-Id: Ia603202a065d5b345608e712f63f7af21fd74dea
* | Add missing doc index for imageutils and fnmatchChangBo Guo(gcb)2015-12-141-0/+2
| | | | | | | | | | | | | | | | We added these two modules recently, but didn't include them in doc index. This commit add them in doc index and add version information about when they were added. Change-Id: Ic3347f57a722187fc4bfe68fce6f08fba97af7fb
* | Use versionadded and versionchanged in docVictor Stinner2015-10-172-0/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Document in which version new types and functions were added using ".. versionadded:: x.y". Document changes using ".. versionchanged:: x.y." For new modules, add the versionadded tag in the module top docstring, not on each type/function. Add fileutils to documentation. The doc part was forgotten during the graduation. Add docstrings to convert versions of versionutils. I used "git blame" + "git tag --contains=SHA1" to find these version, and then I checked manually each version. Change-Id: Ia2f00aa29eb36410a49fc1d350896a569a7737a1
* | Ensure stopwatch __enter__, __exit__ are in docsJoshua Harlow2015-10-011-0/+1
| | | | | | | | | | | | | | | | | | People typically want to know if this can be used as a context manager (it can); so make sure that the generated docs explicitly shows them (vs not showing them, which is the default). Change-Id: I97d512afc79581478a5b7e734108c38635b79f45
* | Add some timeutils stop watch examplesJoshua Harlow2015-09-302-0/+104
| | | | | | | | Change-Id: Id63243562bf92d370c3e3239ff4d64f53a0ace93
* | Move 'history' -> release notes sectionJoshua Harlow2015-09-251-1/+8
|/ | | | | | | | This seems to better match what the other oslo libraries are calling this section, so we might as well call it that to. Change-Id: Ib90d1e0bb2c90776c81a2b272f9aeb5c3565bfc6
* versionutils: add version convert helper methodsChangBo Guo(gcb)2015-07-102-0/+7
| | | | | | | | | | Nova[1] and Cinder[2] have same version convert methods. We can put them in versionutils and make them don't maintain their version. [1]https://github.com/openstack/nova/blob/master/nova/utils.py#L1044 [2]https://github.com/openstack/cinder/blob/master/cinder/utils.py#L789 Change-Id: I5a7e212bd0d661ce9ec89ae06a9f4c3bc7200d1e
* Add missing reflection + uuidutils docsJoshua Harlow2015-04-133-0/+14
| | | | | | | | | These do not seem to have been created and made appear, so make them appear and make sure the exposed public API(s) have docstrings so that they appear in the generated docs. Change-Id: Ie34e46647b0b20d936ddaa15dc824d0e2d2ca99d
* Add pypi download + version badgesJoshua Harlow2015-04-073-14/+22
| | | | | | | | Also makes the docs look more like the other oslo libraries so that the content is easily readable across projects. Change-Id: I85158a89f103cdef2afa268558592c46ce6c3411
* Add a eventlet utils helper moduleJoshua Harlow2015-02-101-0/+6
| | | | | | | | | | | | | | When greenthreads are being used (and/or eventlet is available and some modules have been monkey-patched) emit warnings to the users that certain modules should be monkey-patched and if they are not then spurious or unexpected lock-ups and/or hangs may result due to this type of mixed usage which doesn't typically end well. This commit adds that functionality to a new eventlet utils module that can be used by calling code when that code really knows it will not work without modules being patched or partially being patched. Change-Id: I9a856fc0a6502b438c8da9b2f589154a6fa89a9f
* Add TimeFixtureBrant Knudson2015-01-161-0/+6
| | | | | | | | There was no fixture for using the functions related to timeutils.set_time_override. A fixture is handy because clear_time_override must be done for cleanup. Change-Id: Ifef8d9f20fa9e5aa96ebf5040f290f65b503f0bd
* Move files out of the namespace packageDoug Hellmann2015-01-068-8/+8
| | | | | | | | | | Move the public API out of oslo.utils to oslo_utils. Retain the ability to import from the old namespace package for backwards compatibility for this release cycle. bp/drop-namespace-packages Change-Id: Ic6dd62097399bf75e3d11b4d8a6400971069c415
* Add history/changelog to docsDavanum Srinivas2014-10-042-0/+2
| | | | Change-Id: Iec3a5cfd6245835c39e7dbe0354abb3353e42d5f
* Add API docs and clean up other docsDoug Hellmann2014-07-2312-7/+66
| | | | | | | Add auto-generated documentation for the public modules in the library and clean up a bit of the docstrings used. Change-Id: Id5efa5c413b82e13f1a7ac78c92e39c193f12214
* Cleaning up index.rst fileChristian Berendt2014-07-211-6/+1
| | | | | | Removed notes about the generation of the file. Change-Id: I06355eb96cbd0fb564b7e7dbe3c10adecad74a1d
* exported from oslo-incubator by graduate.shDavanum Srinivas2014-06-186-0/+120