Hello community,
here is the log from the commit of package python-argparse-manpage for openSUSE:Factory checked in at 2019-09-27 14:47:26
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Comparing /work/SRC/openSUSE:Factory/python-argparse-manpage (Old)
and /work/SRC/openSUSE:Factory/.python-argparse-manpage.new.2352 (New)
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "python-argparse-manpage"
Fri Sep 27 14:47:26 2019 rev:3 rq:730710 version:1.2.2
Changes:
--------
--- /work/SRC/openSUSE:Factory/python-argparse-manpage/python-argparse-manpage.changes 2019-05-20 13:18:15.995918613 +0200
+++ /work/SRC/openSUSE:Factory/.python-argparse-manpage.new.2352/python-argparse-manpage.changes 2019-09-27 14:47:26.704921306 +0200
@@ -1,0 +2,10 @@
+Fri Sep 13 12:41:43 UTC 2019 - Tomáš Chvátal
+
+- Update to 1.2.2:
+ * More complete release tarball, including tests.
+ * Fixed shebang in /bin/argparse-manpage script so it works on
+ Debian/Ubuntu as well as on Fedora.
+ * LICENSE file included in release tarball.
+ * Command-line executable now takes an optional '--output' argument.
+
+-------------------------------------------------------------------
Old:
----
v1.1.tar.gz
New:
----
v1.2.2.tar.gz
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Other differences:
------------------
++++++ python-argparse-manpage.spec ++++++
--- /var/tmp/diff_new_pack.i2vs7j/_old 2019-09-27 14:47:27.208919996 +0200
+++ /var/tmp/diff_new_pack.i2vs7j/_new 2019-09-27 14:47:27.216919975 +0200
@@ -19,7 +19,7 @@
%define mod_name argparse-manpage
%{?!python_module:%define python_module() python-%{**} python3-%{**}}
Name: python-argparse-manpage
-Version: 1.1
+Version: 1.2.2
Release: 0
Summary: Tool for automatic manual page building from a Python ArgumentParser object
License: Apache-2.0
++++++ v1.1.tar.gz -> v1.2.2.tar.gz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/argparse-manpage-1.1/MANIFEST.in new/argparse-manpage-1.2.2/MANIFEST.in
--- old/argparse-manpage-1.1/MANIFEST.in 1970-01-01 01:00:00.000000000 +0100
+++ new/argparse-manpage-1.2.2/MANIFEST.in 2019-09-07 15:24:15.000000000 +0200
@@ -0,0 +1,15 @@
+include AUTHORS
+include LICENSE
+include NEWS
+recursive-include examples *.py *.txt *.cfg *.md
+recursive-include unittests *.py
+include examples/copr/expected-output.1
+include examples/old_format/expected-output.1
+include examples/raw-description/expected-output.1
+include examples/resalloc/expected/man/resalloc-maint.1
+include examples/resalloc/expected/man/resalloc.1
+include examples/copr/fake-deps/HACK
+include examples/copr/fake-deps/copr/README
+include examples/raw-description/bin/dg
+include examples/resalloc/bin/resalloc
+include examples/resalloc/bin/resalloc-maint
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/argparse-manpage-1.1/NEWS new/argparse-manpage-1.2.2/NEWS
--- old/argparse-manpage-1.1/NEWS 1970-01-01 01:00:00.000000000 +0100
+++ new/argparse-manpage-1.2.2/NEWS 2019-09-07 15:24:15.000000000 +0200
@@ -0,0 +1,12 @@
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+New in version 1.2
+
+* Fixed shebang in /bin/argparse-manpage script so it works on
+ Debian/Ubuntu as well as on Fedora.
+
+* LICENSE file included in release tarball.
+
+* Command-line executable now takes an optional '--output' argument.
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/argparse-manpage-1.1/README.md new/argparse-manpage-1.2.2/README.md
--- old/argparse-manpage-1.1/README.md 2018-06-25 22:14:18.000000000 +0200
+++ new/argparse-manpage-1.2.2/README.md 2019-09-07 15:24:15.000000000 +0200
@@ -70,6 +70,15 @@
if you used `get_build_py` helper, `setup.py build` then transitively builds the
manual pages.
+# Command-line usage
+
+You can also use `argparse-manpage` command on a command-line. Example:
+
+ bin/argparse-manpage --pyfile ./pythonfile --function get_parser --author me --author-email me@domain.com --project-name myproject --url https://pagure.io/myproject > cool-manpage.1
+
+This reads `./pythonfile` and executes function `get_parser` from it. The function should be programmed to return an `ArgumentParser` instance which is then used together with the other info supplied on the command-line to generate the man page.
+
+See `bin/argparse-manpage --help` for full info.
# License
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/argparse-manpage-1.1/bin/argparse-manpage new/argparse-manpage-1.2.2/bin/argparse-manpage
--- old/argparse-manpage-1.1/bin/argparse-manpage 2018-06-25 22:14:18.000000000 +0200
+++ new/argparse-manpage-1.2.2/bin/argparse-manpage 2019-09-07 15:24:15.000000000 +0200
@@ -1,4 +1,4 @@
-#! /bin/python
+#! /usr/bin/python
# Copyright (C) 2017 Red Hat, Inc.
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/argparse-manpage-1.1/build_manpages/__init__.py new/argparse-manpage-1.2.2/build_manpages/__init__.py
--- old/argparse-manpage-1.1/build_manpages/__init__.py 2018-06-25 22:14:18.000000000 +0200
+++ new/argparse-manpage-1.2.2/build_manpages/__init__.py 2019-09-07 15:24:15.000000000 +0200
@@ -1 +1 @@
-__version__ = '1.1'
+__version__ = '1.2.2'
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/argparse-manpage-1.1/build_manpages/build_manpage.py new/argparse-manpage-1.2.2/build_manpages/build_manpage.py
--- old/argparse-manpage-1.1/build_manpages/build_manpage.py 2018-06-25 22:14:18.000000000 +0200
+++ new/argparse-manpage-1.2.2/build_manpages/build_manpage.py 2019-09-07 15:24:15.000000000 +0200
@@ -145,12 +145,12 @@
return ''.join(ret)
def _write_filename(self, filename, what):
+ filename = filename if filename != '-' else '/dev/stdout'
dirname = os.path.dirname(filename)
if dirname and not os.path.exists(dirname):
os.makedirs(dirname)
- stream = open(filename, 'w')
- stream.write(what)
- stream.close()
+ with open(filename, 'w') as stream:
+ stream.write(what)
def write(self, filename, seealso=None):
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/argparse-manpage-1.1/build_manpages/cli/__init__.py new/argparse-manpage-1.2.2/build_manpages/cli/__init__.py
--- old/argparse-manpage-1.1/build_manpages/cli/__init__.py 2018-06-25 22:14:18.000000000 +0200
+++ new/argparse-manpage-1.2.2/build_manpages/cli/__init__.py 2019-09-07 15:24:15.000000000 +0200
@@ -42,6 +42,8 @@
ap.add_argument("--author-email", action=fake_cmd.getAction())
ap.add_argument("--project-name", dest='name', action=fake_cmd.getAction())
ap.add_argument("--url", action=fake_cmd.getAction())
+ap.add_argument("--output", dest='outfile', default='-',
+ help="output file; default to stdout")
def main():
@@ -61,4 +63,4 @@
parser = get_parser(import_type, import_from, obj_name, obj_type)
mw = ManPageWriter(parser, fake_cmd)
- mw.write_with_manpage('/dev/stdout')
+ mw.write_with_manpage(args.outfile)
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/argparse-manpage-1.1/setup.py new/argparse-manpage-1.2.2/setup.py
--- old/argparse-manpage-1.1/setup.py 2018-06-25 22:14:18.000000000 +0200
+++ new/argparse-manpage-1.2.2/setup.py 2019-09-07 15:24:15.000000000 +0200
@@ -8,14 +8,12 @@
from build_manpages.build_manpages \
import build_manpages, get_build_py_cmd, get_install_cmd
-ld = """
-Generate manual page an automatic way from ArgumentParser object, so the manpage
-1:1 corresponds to the automatically generated --help output. The manpage
-generator needs to known the location of the object, user can specify that by
-(a) the module name or corresponding python filename and (b) the object name or
-the function name which returns the object. There's a limited support for
-(deprecated) optparse objects, too.
-"""
+
+ROOT_DIR = os.path.dirname(os.path.abspath(__file__))
+
+def get_readme():
+ with open(os.path.join(ROOT_DIR, 'README.md')) as fh:
+ return ''.join(fh.readlines())
setup(
name='argparse-manpage',
@@ -30,7 +28,8 @@
packages=find_packages(),
scripts=['bin/argparse-manpage'],
description='Build manual page from python\'s ArgumentParser object.',
- long_description=ld,
+ long_description=get_readme(),
+ long_description_content_type='text/markdown',
cmdclass={
'build_manpages': build_manpages,
'build_py': get_build_py_cmd(build_py),