Page MenuHomeSoftware Heritage
Files F9338437

release.py
No OneTemporary
Actions

release.py
View Options

# Copyright (C) 2015-2019 The Software Heritage developers
# See the AUTHORS file at the top-level directory of this distribution
# License: GNU Affero General Public License version 3, or any later version
# See top-level LICENSE file for more information
from swh.web.common import service
from swh.web.api import utils
from swh.web.api.apidoc import api_doc
from swh.web.api.apiurls import api_route
from swh.web.api.views.utils import api_lookup
@api_route(r'/release/(?P<sha1_git>[0-9a-f]+)/', 'api-1-release',
checksum_args=['sha1_git'])
@api_doc('/release/')
def api_release(request, sha1_git):
"""
.. http:get:: /api/1/release/(sha1_git)/
Get information about a release in the archive.
Releases are identified by **sha1** checksums, compatible with Git tag identifiers.
See :func:`swh.model.identifiers.release_identifier` in our data model module for details
about how they are computed.
:param string sha1_git: hexadecimal representation of the release **sha1_git** identifier
:reqheader Accept: the requested response content type,
either ``application/json`` (default) or ``application/yaml``
:resheader Content-Type: this depends on :http:header:`Accept` header of request
:>json object author: information about the author of the release
:>json string author_url: link to :http:get:`/api/1/person/(person_id)/` to get
information about the author of the release
:>json string date: ISO representation of the release date (in UTC)
:>json string id: the release unique identifier
:>json string message: the message associated to the release
:>json string name: the name of the release
:>json string target: the target identifier of the release
:>json string target_type: the type of the target, can be either **release**,
**revision**, **content**, **directory**
:>json string target_url: a link to the adequate api url based on the target type
**Allowed HTTP Methods:** :http:method:`get`, :http:method:`head`, :http:method:`options`
:statuscode 200: no error
:statuscode 400: an invalid **sha1_git** value has been provided
:statuscode 404: requested release can not be found in the archive
**Example:**
.. parsed-literal::
:swh_web_api:`release/208f61cc7a5dbc9879ae6e5c2f95891e270f09ef/`
""" # noqa
error_msg = 'Release with sha1_git %s not found.' % sha1_git
return api_lookup(
service.lookup_release, sha1_git,
notfound_msg=error_msg,
enrich_fn=utils.enrich_release)

File Metadata

Mime Type
text/x-python
Expires
Jul 4 2025, 8:48 AM (7 w, 1 h ago)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
3384281

Event Timeline

About · Developer information · Legal