Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commita3eafab

Browse files
authored
Merge pull request#1773 from python-gitlab/jlvillal/pagination
fix: handle situation where gitlab.com does not return values
2 parents501f9a1 +cb824a4 commita3eafab

File tree

5 files changed

+35
-23
lines changed

5 files changed

+35
-23
lines changed

‎docs/api-usage.rst‎

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -265,8 +265,17 @@ The generator exposes extra listing information as received from the server:
265265
* ``prev_page``: if ``None`` the current page is the first one
266266
* ``next_page``: if ``None`` the current page is the last one
267267
* ``per_page``: number of items per page
268-
* ``total_pages``: total number of pages available
269-
* ``total``: total number of items in the list
268+
* ``total_pages``: total number of pages available. This may be a ``None`` value.
269+
* ``total``: total number of items in the list. This may be a ``None`` value.
270+
271+
..note::
272+
273+
For performance reasons, if a query returns more than 10,000 records, GitLab
274+
does not return the ``total_pages`` or ``total`` headers. In this case,
275+
``total_pages`` and ``total`` will have a value of ``None``.
276+
277+
For more information see:
278+
https://docs.gitlab.com/ee/user/gitlab_com/index.html#pagination-response-headers
270279

271280
Sudo
272281
====

‎gitlab/base.py‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -288,12 +288,12 @@ def per_page(self) -> int:
288288
returnself._list.per_page
289289

290290
@property
291-
deftotal_pages(self)->int:
291+
deftotal_pages(self)->Optional[int]:
292292
"""The total number of pages."""
293293
returnself._list.total_pages
294294

295295
@property
296-
deftotal(self)->int:
296+
deftotal(self)->Optional[int]:
297297
"""The total number of items."""
298298
returnself._list.total
299299

‎gitlab/client.py‎

Lines changed: 17 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -917,14 +917,12 @@ def _query(
917917
self._next_url=next_url
918918
exceptKeyError:
919919
self._next_url=None
920-
self._current_page:Optional[Union[str,int]]=result.headers.get("X-Page")
921-
self._prev_page:Optional[Union[str,int]]=result.headers.get("X-Prev-Page")
922-
self._next_page:Optional[Union[str,int]]=result.headers.get("X-Next-Page")
923-
self._per_page:Optional[Union[str,int]]=result.headers.get("X-Per-Page")
924-
self._total_pages:Optional[Union[str,int]]=result.headers.get(
925-
"X-Total-Pages"
926-
)
927-
self._total:Optional[Union[str,int]]=result.headers.get("X-Total")
920+
self._current_page:Optional[str]=result.headers.get("X-Page")
921+
self._prev_page:Optional[str]=result.headers.get("X-Prev-Page")
922+
self._next_page:Optional[str]=result.headers.get("X-Next-Page")
923+
self._per_page:Optional[str]=result.headers.get("X-Per-Page")
924+
self._total_pages:Optional[str]=result.headers.get("X-Total-Pages")
925+
self._total:Optional[str]=result.headers.get("X-Total")
928926

929927
try:
930928
self._data:List[Dict[str,Any]]=result.json()
@@ -965,19 +963,22 @@ def per_page(self) -> int:
965963
assertself._per_pageisnotNone
966964
returnint(self._per_page)
967965

966+
# NOTE(jlvillal): When a query returns more than 10,000 items, GitLab doesn't return
967+
# the headers 'x-total-pages' and 'x-total'. In those cases we return None.
968+
# https://docs.gitlab.com/ee/user/gitlab_com/index.html#pagination-response-headers
968969
@property
969-
deftotal_pages(self)->int:
970+
deftotal_pages(self)->Optional[int]:
970971
"""The total number of pages."""
971-
ifTYPE_CHECKING:
972-
assertself._total_pagesisnotNone
973-
returnint(self._total_pages)
972+
ifself._total_pagesisnotNone:
973+
returnint(self._total_pages)
974+
returnNone
974975

975976
@property
976-
deftotal(self)->int:
977+
deftotal(self)->Optional[int]:
977978
"""The total number of items."""
978-
ifTYPE_CHECKING:
979-
assertself._totalisnotNone
980-
returnint(self._total)
979+
ifself._totalisnotNone:
980+
returnint(self._total)
981+
returnNone
981982

982983
def__iter__(self)->"GitlabList":
983984
returnself

‎pyproject.toml‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -87,3 +87,6 @@ disable = [
8787
"useless-object-inheritance",
8888

8989
]
90+
91+
[tool.pytest.ini_options]
92+
xfail_strict =true

‎tests/unit/test_gitlab.py‎

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,9 @@
1616
# You should have received a copy of the GNU Lesser General Public License
1717
# along with this program. If not, see <http://www.gnu.org/licenses/>.
1818

19+
importcopy
1920
importpickle
2021
importwarnings
21-
fromcopyimportdeepcopy
2222

2323
importpytest
2424
importresponses
@@ -109,15 +109,14 @@ def _strip_pagination_headers(response):
109109
"""
110110
https://docs.gitlab.com/ee/user/gitlab_com/index.html#pagination-response-headers
111111
"""
112-
stripped=deepcopy(response)
112+
stripped=copy.deepcopy(response)
113113

114114
delstripped["headers"]["X-Total-Pages"]
115115
delstripped["headers"]["X-Total"]
116116

117117
returnstripped
118118

119119

120-
@pytest.mark.xfail(reason="See #1686")
121120
@responses.activate
122121
deftest_gitlab_build_list_missing_headers(gl,resp_page_1,resp_page_2):
123122
stripped_page_1=_strip_pagination_headers(resp_page_1)

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp