FazBrowse GitHub Viewer
|
Trending
|
URL:
|
Home
Tools:
[Download Repo ZIP]
[View Raw Code]
[Original HTTPS Page]
python-gitlab/docs/ext/docstrings.py at master · vvv/python-gitlab · GitHub
vvv
python-gitlab
Repository navigation
Code
Pull requests
Actions
Projects
Security and quality
Insights
Expand file tree
Breadcrumbs
python-gitlab
/
docs
/
ext
/
docstrings.py
Copy path
More file actions
More file actions
Latest commit
History
History
History
59 lines (44 loc) · 1.82 KB
Breadcrumbs
python-gitlab
/
docs
/
ext
/
docstrings.py
Copy path
File metadata and controls
59 lines (44 loc) · 1.82 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
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
import
inspect
import
itertools
import
os
import
jinja2
import
six
import
sphinx
import
sphinx
.
ext
.
napoleon
as
napoleon
from
sphinx
.
ext
.
napoleon
.
docstring
import
GoogleDocstring
def
classref
(
value
,
short
=
True
):
return
value
if
not
inspect
.
isclass
(
value
):
return
":class:%s"
%
value
tilde
=
"~"
if
short
else
""
string
=
"%s.%s"
%
(
value
.
__module__
,
value
.
__name__
)
return
":class:`%sgitlab.objects.%s`"
%
(
tilde
,
value
.
__name__
)
def
setup
(
app
):
app
.
connect
(
"autodoc-process-docstring"
,
_process_docstring
)
app
.
connect
(
"autodoc-skip-member"
,
napoleon
.
_skip_member
)
conf
=
napoleon
.
Config
.
_config_values
for
name
, (
default
,
rebuild
)
in
six
.
iteritems
(
conf
):
app
.
add_config_value
(
name
,
default
,
rebuild
)
return
{
"version"
:
sphinx
.
__display_version__
,
"parallel_read_safe"
:
True
}
def
_process_docstring
(
app
,
what
,
name
,
obj
,
options
,
lines
):
result_lines
=
lines
docstring
=
GitlabDocstring
(
result_lines
,
app
.
config
,
app
,
what
,
name
,
obj
,
options
)
result_lines
=
docstring
.
lines
()
lines
[:]
=
result_lines
[:]
class
GitlabDocstring
(
GoogleDocstring
):
def
_build_doc
(
self
,
tmpl
,
**
kwargs
):
env
=
jinja2
.
Environment
(
loader
=
jinja2
.
FileSystemLoader
(
os
.
path
.
dirname
(
__file__
)),
trim_blocks
=
False
)
env
.
filters
[
"classref"
]
=
classref
template
=
env
.
get_template
(
tmpl
)
output
=
template
.
render
(
**
kwargs
)
return
output
.
split
(
"
\n
"
)
def
__init__
(
self
,
docstring
,
config
=
None
,
app
=
None
,
what
=
""
,
name
=
""
,
obj
=
None
,
options
=
None
):
super
(
GitlabDocstring
,
self
).
__init__
(
docstring
,
config
,
app
,
what
,
name
,
obj
,
options
)
if
name
.
startswith
(
"gitlab.v4.objects"
)
and
name
.
endswith
(
"Manager"
):
self
.
_parsed_lines
.
extend
(
self
.
_build_doc
(
"manager_tmpl.j2"
,
cls
=
self
.
_obj
))
Back
|
FazBrowse Home
|
New Git URL