mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-12-22 21:55:25 +00:00
docs: rewrite polkit docs generator in Python
As part of a goal to eliminate Perl from libvirt build tools, rewrite the genaclperms.pl tool in Python. This was a straight conversion, manually going line-by-line to change the syntax from Perl to Python. Thus the overall structure of the file and approach is the same. Tested-by: Cole Robinson <crobinso@redhat.com> Reviewed-by: Cole Robinson <crobinso@redhat.com> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
This commit is contained in:
Daniel P. Berrangé
parent
52a2c5b06b
commit
6a64be6c78
@ -58,6 +58,7 @@ EXTRA_DIST = \
|
|||||||
scripts/check-symsorting.py \
|
scripts/check-symsorting.py \
|
||||||
scripts/dtrace2systemtap.py \
|
scripts/dtrace2systemtap.py \
|
||||||
scripts/esx_vi_generator.py \
|
scripts/esx_vi_generator.py \
|
||||||
|
scripts/genaclperms.py \
|
||||||
scripts/genpolkit.py \
|
scripts/genpolkit.py \
|
||||||
scripts/gensystemtap.py \
|
scripts/gensystemtap.py \
|
||||||
scripts/group-qemu-caps.py \
|
scripts/group-qemu-caps.py \
|
||||||
|
|||||||
@ -344,7 +344,6 @@ schemadir = $(pkgdatadir)/schemas
|
|||||||
schema_DATA = $(wildcard $(srcdir)/schemas/*.rng)
|
schema_DATA = $(wildcard $(srcdir)/schemas/*.rng)
|
||||||
|
|
||||||
EXTRA_DIST= \
|
EXTRA_DIST= \
|
||||||
genaclperms.pl \
|
|
||||||
site.xsl subsite.xsl newapi.xsl page.xsl \
|
site.xsl subsite.xsl newapi.xsl page.xsl \
|
||||||
wrapstring.xsl \
|
wrapstring.xsl \
|
||||||
$(dot_html_in) $(dot_rst) $(gif) $(apipng) \
|
$(dot_html_in) $(dot_rst) $(gif) $(apipng) \
|
||||||
@ -359,8 +358,8 @@ EXTRA_DIST= \
|
|||||||
acl_generated = aclperms.htmlinc
|
acl_generated = aclperms.htmlinc
|
||||||
|
|
||||||
aclperms.htmlinc: $(top_srcdir)/src/access/viraccessperm.h \
|
aclperms.htmlinc: $(top_srcdir)/src/access/viraccessperm.h \
|
||||||
$(srcdir)/genaclperms.pl Makefile.am
|
$(top_srcdir)/scripts/genaclperms.py Makefile.am
|
||||||
$(AM_V_GEN)$(PERL) $(srcdir)/genaclperms.pl $< > $@
|
$(AM_V_GEN)$(RUNUTF8) $(PYTHON) $(top_srcdir)/scripts/genaclperms.py $< > $@
|
||||||
|
|
||||||
CLEANFILES = \
|
CLEANFILES = \
|
||||||
$(dot_html) \
|
$(dot_html) \
|
||||||
|
|||||||
@ -1,125 +0,0 @@
|
|||||||
#!/usr/bin/env perl
|
|
||||||
#
|
|
||||||
# Copyright (C) 2013 Red Hat, Inc.
|
|
||||||
#
|
|
||||||
# This library is free software; you can redistribute it and/or
|
|
||||||
# modify it under the terms of the GNU Lesser General Public
|
|
||||||
# License as published by the Free Software Foundation; either
|
|
||||||
# version 2.1 of the License, or (at your option) any later version.
|
|
||||||
#
|
|
||||||
# This library is distributed in the hope that it will be useful,
|
|
||||||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
||||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
||||||
# Lesser General Public License for more details.
|
|
||||||
#
|
|
||||||
# You should have received a copy of the GNU Lesser General Public
|
|
||||||
# License along with this library. If not, see
|
|
||||||
# <http://www.gnu.org/licenses/>.
|
|
||||||
#
|
|
||||||
|
|
||||||
use strict;
|
|
||||||
use warnings;
|
|
||||||
|
|
||||||
my @objects = (
|
|
||||||
"CONNECT", "DOMAIN", "INTERFACE",
|
|
||||||
"NETWORK_PORT", "NETWORK", "NODE_DEVICE",
|
|
||||||
"NWFILTER_BINDING", "NWFILTER",
|
|
||||||
"SECRET", "STORAGE_POOL", "STORAGE_VOL",
|
|
||||||
);
|
|
||||||
|
|
||||||
my %class;
|
|
||||||
|
|
||||||
foreach my $object (@objects) {
|
|
||||||
my $class = lc $object;
|
|
||||||
|
|
||||||
$class =~ s/(^\w|_\w)/uc $1/eg;
|
|
||||||
$class =~ s/_//g;
|
|
||||||
$class =~ s/Nwfilter/NWFilter/;
|
|
||||||
$class = "vir" . $class . "Ptr";
|
|
||||||
|
|
||||||
$class{$object} = $class;
|
|
||||||
}
|
|
||||||
|
|
||||||
my $objects = join ("|", @objects);
|
|
||||||
|
|
||||||
my %opts;
|
|
||||||
my $in_opts = 0;
|
|
||||||
|
|
||||||
my %perms;
|
|
||||||
|
|
||||||
while (<>) {
|
|
||||||
if ($in_opts) {
|
|
||||||
if (m,\*/,) {
|
|
||||||
$in_opts = 0;
|
|
||||||
} elsif (/\*\s*\@(\w+):\s*(.*?)\s*$/) {
|
|
||||||
$opts{$1} = $2;
|
|
||||||
}
|
|
||||||
} elsif (m,/\*\*,) {
|
|
||||||
$in_opts = 1;
|
|
||||||
} elsif (/VIR_ACCESS_PERM_($objects)_((?:\w|_)+),/) {
|
|
||||||
my $object = $1;
|
|
||||||
my $perm = lc $2;
|
|
||||||
next if $perm eq "last";
|
|
||||||
|
|
||||||
$perm =~ s/_/-/g;
|
|
||||||
|
|
||||||
$perms{$object} = {} unless exists $perms{$object};
|
|
||||||
$perms{$object}->{$perm} = {
|
|
||||||
desc => $opts{desc},
|
|
||||||
message => $opts{message},
|
|
||||||
anonymous => $opts{anonymous}
|
|
||||||
};
|
|
||||||
%opts = ();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
print <<EOF;
|
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!DOCTYPE html>
|
|
||||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
||||||
<body>
|
|
||||||
EOF
|
|
||||||
|
|
||||||
foreach my $object (sort { $a cmp $b } keys %perms) {
|
|
||||||
my $class = $class{$object};
|
|
||||||
my $olink = lc "object_" . $object;
|
|
||||||
print <<EOF;
|
|
||||||
<h3><a id="$olink">$class</a></h3>
|
|
||||||
<table>
|
|
||||||
<thead>
|
|
||||||
<tr>
|
|
||||||
<th>Permission</th>
|
|
||||||
<th>Description</th>
|
|
||||||
</tr>
|
|
||||||
</thead>
|
|
||||||
<tbody>
|
|
||||||
EOF
|
|
||||||
|
|
||||||
foreach my $perm (sort { $a cmp $b } keys %{$perms{$object}}) {
|
|
||||||
my $description = $perms{$object}->{$perm}->{desc};
|
|
||||||
|
|
||||||
die "missing description for $object.$perm" unless
|
|
||||||
defined $description;
|
|
||||||
|
|
||||||
my $plink = lc "perm_" . $object . "_" . $perm;
|
|
||||||
$plink =~ s/-/_/g;
|
|
||||||
|
|
||||||
print <<EOF;
|
|
||||||
<tr>
|
|
||||||
<td><a id="$plink">$perm</a></td>
|
|
||||||
<td>$description</td>
|
|
||||||
</tr>
|
|
||||||
EOF
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
print <<EOF;
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
EOF
|
|
||||||
}
|
|
||||||
|
|
||||||
print <<EOF;
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
EOF
|
|
||||||
121
scripts/genaclperms.py
Executable file
121
scripts/genaclperms.py
Executable file
@ -0,0 +1,121 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
#
|
||||||
|
# Copyright (C) 2013-2019 Red Hat, Inc.
|
||||||
|
#
|
||||||
|
# This library is free software; you can redistribute it and/or
|
||||||
|
# modify it under the terms of the GNU Lesser General Public
|
||||||
|
# License as published by the Free Software Foundation; either
|
||||||
|
# version 2.1 of the License, or (at your option) any later version.
|
||||||
|
#
|
||||||
|
# This library is distributed in the hope that it will be useful,
|
||||||
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||||
|
# Lesser General Public License for more details.
|
||||||
|
#
|
||||||
|
# You should have received a copy of the GNU Lesser General Public
|
||||||
|
# License along with this library. If not, see
|
||||||
|
# <http://www.gnu.org/licenses/>.
|
||||||
|
#
|
||||||
|
|
||||||
|
import re
|
||||||
|
import sys
|
||||||
|
|
||||||
|
objects = [
|
||||||
|
"CONNECT", "DOMAIN", "INTERFACE",
|
||||||
|
"NETWORK_PORT", "NETWORK", "NODE_DEVICE",
|
||||||
|
"NWFILTER_BINDING", "NWFILTER",
|
||||||
|
"SECRET", "STORAGE_POOL", "STORAGE_VOL",
|
||||||
|
]
|
||||||
|
|
||||||
|
|
||||||
|
classes = {}
|
||||||
|
|
||||||
|
for obj in objects:
|
||||||
|
klass = obj.lower()
|
||||||
|
|
||||||
|
klass = re.sub(r'''(^\w|_\w)''', lambda a: a.group(1).upper(), klass)
|
||||||
|
klass = klass.replace("_", "")
|
||||||
|
klass = klass.replace("Nwfilter", "NWFilter")
|
||||||
|
klass = "vir" + klass + "Ptr"
|
||||||
|
|
||||||
|
classes[obj] = klass
|
||||||
|
|
||||||
|
|
||||||
|
objectstr = "|".join(objects)
|
||||||
|
|
||||||
|
opts = {}
|
||||||
|
in_opts = {}
|
||||||
|
|
||||||
|
perms = {}
|
||||||
|
|
||||||
|
aclfile = sys.argv[1]
|
||||||
|
with open(aclfile, "r") as fh:
|
||||||
|
for line in fh:
|
||||||
|
if in_opts:
|
||||||
|
if line.find("*/") != -1:
|
||||||
|
in_opts = False
|
||||||
|
else:
|
||||||
|
m = re.search(r'''\*\s*\@(\w+):\s*(.*?)\s*$''', line)
|
||||||
|
if m is not None:
|
||||||
|
opts[m.group(1)] = m.group(2)
|
||||||
|
elif line.find("**") != -1:
|
||||||
|
in_opts = True
|
||||||
|
else:
|
||||||
|
m = re.search(r'''VIR_ACCESS_PERM_(%s)_((?:\w|_)+),''' %
|
||||||
|
objectstr, line)
|
||||||
|
if m is not None:
|
||||||
|
obj = m.group(1)
|
||||||
|
perm = m.group(2).lower()
|
||||||
|
if perm == "last":
|
||||||
|
continue
|
||||||
|
|
||||||
|
perm = perm.replace("_", "-")
|
||||||
|
|
||||||
|
if obj not in perms:
|
||||||
|
perms[obj] = {}
|
||||||
|
perms[obj][perm] = {
|
||||||
|
"desc": opts.get("desc", None),
|
||||||
|
"message": opts.get("message", None),
|
||||||
|
"anonymous": opts.get("anonymous", None),
|
||||||
|
}
|
||||||
|
opts = {}
|
||||||
|
|
||||||
|
print('<?xml version="1.0" encoding="UTF-8"?>')
|
||||||
|
print('<!DOCTYPE html>')
|
||||||
|
print('<html xmlns="http://www.w3.org/1999/xhtml">')
|
||||||
|
print(' <body>')
|
||||||
|
|
||||||
|
for obj in sorted(perms.keys()):
|
||||||
|
klass = classes[obj]
|
||||||
|
|
||||||
|
olink = "object_" + obj.lower()
|
||||||
|
|
||||||
|
print(' <h3><a id="%s">%s</a></h3>' % (olink, klass))
|
||||||
|
print(' <table>')
|
||||||
|
print(' <thead>')
|
||||||
|
print(' <tr>')
|
||||||
|
print(' <th>Permission</th>')
|
||||||
|
print(' <th>Description</th>')
|
||||||
|
print(' </tr>')
|
||||||
|
print(' </thead>')
|
||||||
|
print(' <tbody>')
|
||||||
|
|
||||||
|
for perm in sorted(perms[obj].keys()):
|
||||||
|
description = perms[obj][perm]["desc"]
|
||||||
|
|
||||||
|
if description is None:
|
||||||
|
raise Exception("missing description for %s.%s" % (obj, perm))
|
||||||
|
|
||||||
|
plink = "perm_" + obj.lower() + "_" + perm.lower()
|
||||||
|
plink = plink.replace("-", "_")
|
||||||
|
|
||||||
|
print(' <tr>')
|
||||||
|
print(' <td><a id="%s">%s</a></td>' % (plink, perm))
|
||||||
|
print(' <td>%s</td>' % description)
|
||||||
|
print(' </tr>')
|
||||||
|
|
||||||
|
print(' </tbody>')
|
||||||
|
print(' </table>')
|
||||||
|
|
||||||
|
print(' </body>')
|
||||||
|
print('</html>')
|
||||||
Loading…
Reference in New Issue
Block a user