Page MenuHomeSoftware Heritage
Files F9349280

snapshot_branch.py
No OneTemporary
Actions

snapshot_branch.py
View Options

# Copyright (C) 2022 The Software Heritage developers
# See the AUTHORS file at the top-level directory of this distribution
# License: GNU General Public License version 3, or any later version
# See top-level LICENSE file for more information
from collections import namedtuple
from swh.graphql.errors import ObjectNotFoundError
from swh.graphql.utils import utils
from swh.storage.interface import PagedResult
from .base_connection import BaseConnection
from .base_node import BaseNode
class BaseSnapshotBranchNode(BaseNode):
# target field for this node is a UNION type
# It is resolved in the top level (resolvers.resolvers.py)
def _get_node_from_data(self, node_data: tuple):
# node_data is a tuple as returned by _get_paged_result in
# SnapshotBranchConnection and _get_node_data in AliasSnapshotBranchNode
# overriding to support this special data structure
branch_name, branch_obj = node_data
node = {
"name": branch_name,
"type": branch_obj.target_type.value,
"target_hash": branch_obj.target,
}
return namedtuple("NodeObj", node.keys())(*node.values())
def is_type_of(self):
return "Branch"
@property
def targetType(self): # To support the schema naming convention
return self._node.type
def snapshot_swhid(self):
"""
Logic to handle multiple branch alias redirects
Alias redirects can be any level deep. Hence the parent snapshot can be
reached only by a loop
This code expects every BranchNode to have a Snapshot parent in the GraphQL query
at some level.
"""
from .snapshot import BaseSnapshotNode
parent = self.obj
while parent:
if isinstance(
parent, BaseSnapshotNode
): # Reached the nearest SnapshotNode object
return parent.swhid
parent = parent.obj
# Reached the root query node. This will never happen with the current entrypoints
raise ObjectNotFoundError("There is no snapshot associated with the branch")
class AliasSnapshotBranchNode(BaseSnapshotBranchNode):
obj: BaseSnapshotBranchNode
def _get_node_data(self):
snapshot_swhid = self.snapshot_swhid()
target_branch = self.obj.target_hash
alias_branch = self.archive.get_snapshot_branches(
snapshot_swhid.object_id, first=1, name_include=target_branch
)
if target_branch not in alias_branch["branches"]:
raise ObjectNotFoundError(
f"Branch name with {target_branch.decode()} is not available"
)
# this will be serialized in _get_node_from_data method in the base class
return (target_branch, alias_branch["branches"][target_branch])
class SnapshotBranchConnection(BaseConnection):
"""
Connection resolver for the branches in a snapshot
"""
from .snapshot import BaseSnapshotNode
obj: BaseSnapshotNode
_node_class = BaseSnapshotBranchNode
def _get_paged_result(self) -> PagedResult:
result = self.archive.get_snapshot_branches(
self.obj.swhid.object_id,
after=self._get_after_arg(),
first=self._get_first_arg(),
target_types=self.kwargs.get("types"),
name_include=self._get_name_include_arg(),
)
# endCursor is the last branch name, logic for that
end_cusrsor = (
result["next_branch"] if result["next_branch"] is not None else None
)
# FIXME, this pagination is not consistent with other connections
# FIX in swh-storage to return PagedResult
# STORAGE-TODO
# this will be serialized in _get_node_from_data method in the node class
return PagedResult(
results=result["branches"].items(), next_page_token=end_cusrsor
)
def _get_after_arg(self):
# after argument must be an empty string by default
after = super()._get_after_arg()
return after.encode() if after else b""
def _get_name_include_arg(self):
name_include = self.kwargs.get("nameInclude", None)
return name_include.encode() if name_include else None
def _get_index_cursor(self, index: int, node: BaseSnapshotBranchNode):
# Snapshot branch is using a different cursor, hence the override
return utils.get_encoded_cursor(node.name)

File Metadata

Mime Type
text/x-python
Expires
Jul 4 2025, 7:14 PM (7 w, 3 d ago)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
3366081

Event Timeline

About · Developer information · Legal