/usr/share/doc/python-oslo.policy-doc/html/usage.html is in python-oslo.policy-doc 1.6.0-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Usage — oslo.policy documentation</title>
<link rel="stylesheet" href="_static/nature.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/tweaks.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="oslo.policy documentation" href="index.html" />
<link rel="next" title="Configuration Options" href="opts.html" />
<link rel="prev" title="Installation" href="installation.html" />
</head>
<body role="document">
<div id="header">
<h1 id="logo"><a href="http://www.openstack.org/">OpenStack</a></h1>
<ul id="navigation">
<li><a href="http://www.openstack.org/" title="Go to the Home page" class="link">Home</a></li>
<li><a href="http://www.openstack.org/projects/" title="Go to the OpenStack Projects page">Projects</a></li>
<li><a href="http://www.openstack.org/user-stories/" title="Go to the User Stories page" class="link">User Stories</a></li>
<li><a href="http://www.openstack.org/community/" title="Go to the Community page" class="link">Community</a></li>
<li><a href="http://www.openstack.org/blog/" title="Go to the OpenStack Blog">Blog</a></li>
<li><a href="http://wiki.openstack.org/" title="Go to the OpenStack Wiki">Wiki</a></li>
<li><a href="http://docs.openstack.org/" title="Go to OpenStack Documentation" class="current">Documentation</a></li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="usage">
<h1>Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h1>
<p>To use oslo.policy in a project, import the relevant module. For
example:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="kn">from</span> <span class="nn">oslo_policy</span> <span class="kn">import</span> <span class="n">policy</span>
</pre></div>
</div>
<div class="section" id="migrating-to-oslo-policy">
<h2>Migrating to oslo.policy<a class="headerlink" href="#migrating-to-oslo-policy" title="Permalink to this headline">¶</a></h2>
<p>Applications using the incubated version of the policy code from Oslo aside
from changing the way the library is imported, may need to make some extra
changes.</p>
<div class="section" id="changes-to-enforcer-initialization">
<h3>Changes to Enforcer Initialization<a class="headerlink" href="#changes-to-enforcer-initialization" title="Permalink to this headline">¶</a></h3>
<p>The <code class="docutils literal"><span class="pre">oslo.policy</span></code> library no longer assumes a global configuration object is
available. Instead the <code class="xref py py-class docutils literal"><span class="pre">oslo_policy.policy.Enforcer</span></code> class has been
changed to expect the consuming application to pass in an <code class="docutils literal"><span class="pre">oslo.config</span></code>
configuration object.</p>
<div class="section" id="when-using-policy-from-oslo-incubator">
<h4>When using policy from oslo-incubator<a class="headerlink" href="#when-using-policy-from-oslo-incubator" title="Permalink to this headline">¶</a></h4>
<div class="highlight-python"><div class="highlight"><pre><span class="n">enforcer</span> <span class="o">=</span> <span class="n">policy</span><span class="o">.</span><span class="n">Enforcer</span><span class="p">(</span><span class="n">policy_file</span><span class="o">=</span><span class="n">_POLICY_PATH</span><span class="p">)</span>
</pre></div>
</div>
</div>
<div class="section" id="when-using-oslo-policy">
<h4>When using oslo.policy<a class="headerlink" href="#when-using-oslo-policy" title="Permalink to this headline">¶</a></h4>
<div class="highlight-python"><div class="highlight"><pre><span class="kn">from</span> <span class="nn">keystone</span> <span class="kn">import</span> <span class="n">config</span>
<span class="n">CONF</span> <span class="o">=</span> <span class="n">config</span><span class="o">.</span><span class="n">CONF</span>
<span class="n">enforcer</span> <span class="o">=</span> <span class="n">policy</span><span class="o">.</span><span class="n">Enforcer</span><span class="p">(</span><span class="n">CONF</span><span class="p">,</span> <span class="n">policy_file</span><span class="o">=</span><span class="n">_POLICY_PATH</span><span class="p">)</span>
</pre></div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Usage</a><ul>
<li><a class="reference internal" href="#migrating-to-oslo-policy">Migrating to oslo.policy</a><ul>
<li><a class="reference internal" href="#changes-to-enforcer-initialization">Changes to Enforcer Initialization</a><ul>
<li><a class="reference internal" href="#when-using-policy-from-oslo-incubator">When using policy from oslo-incubator</a></li>
<li><a class="reference internal" href="#when-using-oslo-policy">When using oslo.policy</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="installation.html"
title="previous chapter">Installation</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="opts.html"
title="next chapter">Configuration Options</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/usage.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" size="18" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="opts.html" title="Configuration Options"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="installation.html" title="Installation"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">oslo.policy documentation</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2014, OpenStack Foundation.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.3.6.
</div>
<script type="text/javascript">
try {
//Tracking docs.openstack.org/developer/<projectname> only
//The URL is built from the project variable in conf.py
var pageTracker = _gat._getTracker("UA-17511903-1");
pageTracker._setCookiePath("/developer/oslo.policy");
pageTracker._trackPageview();
} catch(err) {}</script>
</body>
</html>
|