Bug 1723575

New Python packages must receive an exception to contain Python 2 version, or just not bother with it. Please fill out the Summary and Description in the spec to something more substantial than just repeating the name.

I've fixed both of the mentioned issues. How does this look?

Here is the new spec:
https://copr-be.cloud.fedoraproject.org/results/dstathis/insights-core/fedora-30-x86_64/00948274-cachecontrol/python-cachecontrol.spec

Here is the new srpm:
https://copr-be.cloud.fedoraproject.org/results/dstathis/insights-core/fedora-30-x86_64/00948274-cachecontrol/cachecontrol-0.12.5-1.fc30.src.rpm

Sorry that one is for cachecontrol. I'll get the ones for insights-core up momentarily.

New spec:
https://copr-be.cloud.fedoraproject.org/results/dstathis/insights-core/fedora-30-x86_64/00948290-insights-core/python-insights-core.spec

New srpm:
https://copr-be.cloud.fedoraproject.org/results/dstathis/insights-core/fedora-30-x86_64/00948290-insights-core/insights-core-3.0.100.974-1.fc30.src.rpm

 - Use a bcond_without for this

%if 0%{?rhel} == 7
%bcond_without python2
%endif

And then:

%if %{with python2}
blah blah
%endif

 - Xour descriptions must be wrapped to 80 characters per line

- Name should be:

Name:		python-%{pkgname}

 - Comments at the end of line are not supported officially by rpm:

%endif # with_python2

  This will fail with rpm 4.15


 - Install the examples with %doc

%files -n python%{python3_pkgversion}-%{pkgname}
%doc examples

 - Build the docs with Sphinx and install them with %doc

# generate html docs
sphinx-build-3 docs html
# remove the sphinx-build leftovers
rm -rf html/.{doctrees,buildinfo}

 -Install the misc docs markdown files:

%files -n python%{python3_pkgversion}-%{pkgname}
%doc examples
%doc CHANGELOG.md CONTRIBUTING.md README.rst

 - you *must* install the LICENSE file with %license in %files for any subpackage compination:

%files -n python2-%{pkgname}
%license LICENSE

%files -n python%{python3_pkgversion}-%{pkgname}
%license LICENSE

 - You are missing the Python provide macro:

%package -n python2-%{pkgname}
Summary:	Data collection and processing framework
%{?python_provide:%python_provide python2-%{pkgname}}

%package -n python%{python3_pkgversion}-%{pkgname}
Summary:	Data collection and processing framework
%{?python_provide:%python_provide python3-%{pkgname}}

See https://docs.fedoraproject.org/en-US/packaging-guidelines/Python/#_the_python_provide_macro

 - add a space between your name and email in you changelog entry

I am having a bit of difficulty properly building the docs. It could be done easily withing a virtualenv. Would that be an reasonable thing to do inside an rpm build given that it is only used to build the docs?

I realized that building the docs with a virtualenv requires "--enable-networking" which I think is not ideal. I will try to figure out how to get the docs without it.

Usually it's just something like:

# generate html docs
sphinx-build-3 docs html
# remove the sphinx-build leftovers
rm -rf html/.{doctrees,buildinfo}


What problem are you encountering?

After adding a number of build dependencies and removing the -W from sphinx-build-3 I have gotten it to build the docs. There are, however, two warning messages that concern me.

/usr/lib/python3.7/site-packages/nbsphinx.py:1174: RuntimeWarning: You are using an unsupported version of pandoc (2.2.1).
Your version must be at least (1.12.1) but less than (2.0.0).
Refer to http://pandoc.org/installing.html.
Continuing with doubts...
  nbconvert.utils.pandoc.check_pandoc_version()


and 


WARNING: Pygments lexer name 'ipython2' is not known


Each one is repeated numerous times and the packages required don't seem to exist in the fedora repos. Pandoc is too new and python2-ipython is no longer packaged


Note: There is a further concern that many of the build dependencies don't exist for python 2 on Centos 7 but that is an issue I will deal with when I submit to EPEL

There's not much you can do about the first one, except wait for a new nbshinx package. I think for the latter, it's also about nbshinx, so you might have to wait for an update there too.

This is an automatic check from review-stats script.

This review request ticket hasn't been updated for some time. We're sorry
it is taking so long. If you're still interested in packaging this software
into Fedora repositories, please respond to this comment clearing the
NEEDINFO flag.

You may want to update the specfile and the src.rpm to the latest version
available and to propose a review swap on Fedora devel mailing list to increase
chances to have your package reviewed. If this is your first package and you
need a sponsor, you may want to post some informal reviews. Read more at
https://fedoraproject.org/wiki/How_to_get_sponsored_into_the_packager_group.

Without any reply, this request will shortly be considered abandoned
and will be closed.
Thank you for your patience.

This is an automatic action taken by review-stats script.

The ticket submitter failed to clear the NEEDINFO flag in a month.
As per https://fedoraproject.org/wiki/Policy_for_stalled_package_reviews
we consider this ticket as DEADREVIEW and proceed to close it.