diff options
Diffstat (limited to 'python-cornice-sphinx.spec')
| -rw-r--r-- | python-cornice-sphinx.spec | 104 |
1 files changed, 104 insertions, 0 deletions
diff --git a/python-cornice-sphinx.spec b/python-cornice-sphinx.spec new file mode 100644 index 0000000..b3f8be3 --- /dev/null +++ b/python-cornice-sphinx.spec @@ -0,0 +1,104 @@ +%global _empty_manifest_terminate_build 0 +Name: python-cornice_sphinx +Version: 0.3 +Release: 1 +Summary: Generate Sphinx documentation from a Cornice application +License: Apache License (2.0) +URL: https://github.com/Cornices/cornice.ext.sphinx +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/1a/3f/2181824bb8750713798a61e9b98599d0fa0153228cfc18065b80394a187e/cornice_sphinx-0.3.tar.gz +BuildArch: noarch + +Requires: python3-Sphinx +Requires: python3-cornice +Requires: python3-docutils + +%description +*Cornice extension to generate Sphinx doc* +Maintaining documentation while the code is evolving is painful. +Avoiding information duplication is also quite a challenge. +Cornice tries to reduce a bit the pain by providing a Sphinx +(http://sphinx.pocoo.org/) directive that scans the web +services and build the documentation using: +- the description provided when a Service instance is created +- the docstrings of all functions involved in creating the response: + the web services function itself and the validators. +The assumption made is that maintaining those docstrings while +working on the code is easier. + +%package -n python3-cornice_sphinx +Summary: Generate Sphinx documentation from a Cornice application +Provides: python-cornice_sphinx +BuildRequires: python3-devel +BuildRequires: python3-setuptools +%description -n python3-cornice_sphinx +*Cornice extension to generate Sphinx doc* +Maintaining documentation while the code is evolving is painful. +Avoiding information duplication is also quite a challenge. +Cornice tries to reduce a bit the pain by providing a Sphinx +(http://sphinx.pocoo.org/) directive that scans the web +services and build the documentation using: +- the description provided when a Service instance is created +- the docstrings of all functions involved in creating the response: + the web services function itself and the validators. +The assumption made is that maintaining those docstrings while +working on the code is easier. + +%package help +Summary: Development documents and examples for cornice_sphinx +Provides: python3-cornice_sphinx-doc +%description help +*Cornice extension to generate Sphinx doc* +Maintaining documentation while the code is evolving is painful. +Avoiding information duplication is also quite a challenge. +Cornice tries to reduce a bit the pain by providing a Sphinx +(http://sphinx.pocoo.org/) directive that scans the web +services and build the documentation using: +- the description provided when a Service instance is created +- the docstrings of all functions involved in creating the response: + the web services function itself and the validators. +The assumption made is that maintaining those docstrings while +working on the code is easier. + +%prep +%autosetup -n cornice_sphinx-0.3 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-cornice_sphinx -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Fri Feb 24 2023 Python_Bot <Python_Bot@openeuler.org> - 0.3-1 +- Package Spec generated |