This commit is part of a series to retire the Packaging Deb
project. Step 2 is to remove all content from the project
repos, replacing it with a README notification where to find
ongoing work, and how to recover the repo if needed at some
future point (as in
https://docs.openstack.org/infra/manual/drivers.html#retiring-a-project).
Change-Id: I61c76fb6f2868ba5c1bd73493adf676288809449
Method 'parse_file_contents' is expected to return
dict object after parsing the policy file, but
it will return None if file is empty currently.
Fix it.
Change-Id: I2841ccdb0f657fdb583e94d889cdd2685d7068b4
The 'sphinxext' module provided by 'oslo.config' uses field lists [1] for
its defaults. Provide some cross-promotional, deal mechanics, revenue
streams, jargon synergy between these two plugins (i.e. make them look
similar).
This message was approved by Jack Donaghy [2].
[1] http://docutils.sourceforge.net/docs/user/rst/quickref.html#field-lists
[2] https://youtu.be/aocZo3oeNxw
Change-Id: I6e478152a278a877ae37588be930b0b833eb09cd
In a definition list, a term must be immediately followed by an
(indented) definition. However, the current implementation added a
newline resulting in a paragraph followed by a blockquote. Resolve this
oversight.
Change-Id: If8dae36885be23b1784b8b1d7015b92bb630abbe
Closes-Bug: #1702442
The message is a string, and target and credentials are dicts. Not only
do they make the message very ugly and hard for a human to parse, but
they are giving information that is typically unnecessary and won't be
understood by most users.
Closes-Bug: #1673859
Change-Id: Iabd7d6ebb0fda1c631bb219846643a065fa4fb31
This will provide a more parsable sample policy file for us in docs.
This compliments the 'sphinxpolicygen' module.
Change-Id: Id99b21e7c0a66aaf4223e60074626914235e0ca5
Use https instead of http to ensure the safety without containing our
account/password information
Change-Id: I07f0af54f8cbcfd2100d55415b5b1c6dec32f3d4
We recently merged a patch that enhanced the RuleDefault object by
allowing it to have more attributes:
Ie9b335420394166bb39c43e3d26fcc9237ffd1a0
This commit describes its usage in the usage documentation.
Change-Id: I8f6e6bc289a046b09529f707874314c69757ee11
This patch adds a release note for changes made here[0].
[0]: Ie9b335420394166bb39c43e3d26fcc9237ffd1a0
Change-Id: I0ffbc069e86f0d3df41d1bb3840977990b8cac56
With the idea of adding a more descriptive policy rule so
operators can understand what a policy rule controls. This
patch ensures `oslopolicy-sample-generator` adds the
api(s) and method(s) {if given} to policy description.
Change-Id: If4ca9bc191ac263f861373c432a1fafc3f7d596e
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 some invalid docstrings. These are cleaned up.
Change-Id: Ic6a028bab428b23255f36e5b2d64ee8d4d32978d
This change is needed to comment out rule from the generated
sample-policy file. Added new parameter 'include_help' to
_generate_sample method and changed the tests accordingly.
blueprint policy-docs
Change-Id: I6883f248dcd6ec4829e684210c2de44863431df7
This patch adds the needed subclass to define policy objects
that now require the description and operations parameters.
The operations parameter when defining a policy rule should follow
the below format.
- operations : list of dicts containing the api url and verb.
Ex : operations=[{path='/some/url/', method='GET'}]
This change make sure operators have all the information needed
in a centralized location in order to make decisions and understand
the purpose of a certain policy.
Change-Id: Ie9b335420394166bb39c43e3d26fcc9237ffd1a0
Changed generator code to add new line at the end of each policy,
so that it would be easier to read. This change is required for
implementing this spec https://review.openstack.org/#/c/433010/
blueprint policy-docs
Change-Id: Ie85516b2741c94bab6e9bcd65f92ce38cb250fc6
Multiline descriptions are not displayed properly in the generated
sample file because of the wrapper used.
This patch changes the formatting of help text by wrapping each
line.
Change-Id: Ic19a06189caa0002458881c543c63c7540e301de
Since pbr already landed and the old version of hacking seems not
work very well with pbr>=2, we should update it to match global
requirement.
Partial-Bug: #1668848
Change-Id: Ia07952992bd90213ed9ad9b0adaa7a47553708f7
The gating on python 3.4 is restricted to <= Mitaka. This is due
to the change from Ubuntu Trusty to Xenial, where only python3.5
is available. There is no need to continue to keep these settings.
Change-Id: I1ce696484f3f1c07a08fb9bde51d2c8ac26cc7be