blob: b3f8be35c6f7de24e953fb613129fcce15218b93 (
plain)
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
|
%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
|
