import hashlib
import logging
import pdb
from base64 import b64encode
from collections import defaultdict
from io import BytesIO
from pprint import pformat
from uuid import uuid4
import arrow
from flask import (
Blueprint, Response, g, make_response, render_template,
request, send_file)
from rdflib import Graph, plugin, parser#, serializer
from werkzeug.http import parse_date
from lakesuperior import env
from lakesuperior.api import resource as rsrc_api
from lakesuperior.dictionaries.namespaces import ns_collection as nsc
from lakesuperior.dictionaries.namespaces import ns_mgr as nsm
from lakesuperior.exceptions import (
ChecksumValidationError, ResourceNotExistsError, TombstoneError,
ServerManagedTermError, InvalidResourceError, SingleSubjectError,
ResourceExistsError, IncompatibleLdpTypeError,
IndigestibleError)
from lakesuperior.globals import RES_CREATED
from lakesuperior.model.ldp.ldp_factory import LdpFactory
from lakesuperior.model.ldp.ldp_nr import LdpNr
from lakesuperior.model.ldp.ldp_rs import LdpRs
from lakesuperior.model.ldp.ldpr import Ldpr
from lakesuperior.util import toolbox
from lakesuperior.util.toolbox import RequestUtils
DEFAULT_RDF_MIMETYPE = 'text/turtle'
"""
Fallback serialization format used when no acceptable formats are specified.
"""
logger = logging.getLogger(__name__)
rdf_parsable_mimetypes = {
mt.name for mt in plugin.plugins()
if mt.kind is parser.Parser and '/' in mt.name
}
"""MIMEtypes that can be parsed into RDF."""
store = env.app_globals.rdf_store
rdf_serializable_mimetypes = {
#mt.name for mt in plugin.plugins()
#if mt.kind is serializer.Serializer and '/' in mt.name
'application/ld+json',
'application/n-triples',
'application/rdf+xml',
'text/turtle',
'text/n3',
}
"""
MIMEtypes that RDF can be serialized into.
These are not automatically derived from RDFLib because only triple
(not quad) serializations are applicable.
"""
accept_patch = (
'application/sparql-update',
)
std_headers = {
'Accept-Patch' : ','.join(accept_patch),
'Accept-Post' : ','.join(rdf_parsable_mimetypes),
}
"""Predicates excluded by view."""
vw_blacklist = {
}
ldp = Blueprint(
'ldp', __name__, template_folder='templates',
static_url_path='/static', static_folder='templates/static')
"""
Blueprint for LDP REST API. This is what is usually found under ``/rest/`` in
standard fcrepo4. Here, it is under ``/ldp`` but initially ``/rest`` will be
kept for backward compatibility.
"""
## ROUTE PRE- & POST-PROCESSING ##
[docs]@ldp.url_defaults
def bp_url_defaults(endpoint, values):
url_prefix = getattr(g, 'url_prefix', None)
if url_prefix is not None:
values.setdefault('url_prefix', url_prefix)
[docs]@ldp.url_value_preprocessor
def bp_url_value_preprocessor(endpoint, values):
g.url_prefix = values.pop('url_prefix')
g.webroot = request.host_url + g.url_prefix
# Normalize leading slashes for UID.
if 'uid' in values:
values['uid'] = '/' + values['uid'].lstrip('/')
if 'parent_uid' in values:
values['parent_uid'] = '/' + values['parent_uid'].lstrip('/')
[docs]@ldp.before_request
def log_request_start():
logger.info('** Start {} {} **'.format(request.method, request.url))
[docs]@ldp.before_request
def instantiate_req_vars():
g.tbox = RequestUtils()
[docs]@ldp.after_request
def log_request_end(rsp):
logger.info('** End {} {} **'.format(request.method, request.url))
return rsp
## REST SERVICES ##
[docs]@ldp.route('/<path:uid>', methods=['GET'], strict_slashes=False)
@ldp.route('/', defaults={'uid': '/'}, methods=['GET'], strict_slashes=False)
@ldp.route('/<path:uid>/fcr:metadata', defaults={'out_fmt' : 'rdf'},
methods=['GET'])
@ldp.route('/<path:uid>/fcr:content', defaults={'out_fmt' : 'non_rdf'},
methods=['GET'])
def get_resource(uid, out_fmt=None):
r"""
https://www.w3.org/TR/ldp/#ldpr-HTTP_GET
Retrieve RDF or binary content.
:param str uid: UID of resource to retrieve. The repository root has
an empty string for UID.
:param str out_fmt: Force output to RDF or non-RDF if the resource is
a LDP-NR. This is not available in the API but is used e.g. by the
``\*/fcr:metadata`` and ``\*/fcr:content`` endpoints. The default is
False.
"""
out_headers = std_headers.copy()
repr_options = defaultdict(dict)
# Fist check if it's not a 404 or a 410.
try:
if not rsrc_api.exists(uid):
return '', 404
except TombstoneError as e:
return _tombstone_response(e, uid)
# Then process the condition headers.
cond_ret = _process_cond_headers(uid, request.headers)
if cond_ret:
return cond_ret
# Then, business as usual.
# Evaluate which representation is requested.
if 'prefer' in request.headers:
prefer = toolbox.parse_rfc7240(request.headers['prefer'])
logger.debug('Parsed Prefer header: {}'.format(pformat(prefer)))
if 'return' in prefer:
repr_options = parse_repr_options(prefer['return'])
rsrc = rsrc_api.get(uid, repr_options)
with store.txn_ctx():
if out_fmt is None:
rdf_mimetype = _best_rdf_mimetype()
out_fmt = (
'rdf'
if isinstance(rsrc, LdpRs) or rdf_mimetype is not None
else 'non_rdf')
out_headers.update(_headers_from_metadata(rsrc, out_fmt))
uri = g.tbox.uid_to_uri(uid)
# RDF output.
if out_fmt == 'rdf':
if locals().get('rdf_mimetype', None) is None:
rdf_mimetype = DEFAULT_RDF_MIMETYPE
ggr = g.tbox.globalize_imr(rsrc.out_graph)
ggr.namespace_manager = nsm
return _negotiate_content(
ggr, rdf_mimetype, out_headers, uid=uid, uri=uri)
# Datastream.
else:
if not getattr(rsrc, 'local_path', False):
return ('{} has no binary content.'.format(rsrc.uid), 404)
logger.debug('Streaming out binary content.')
if request.range and request.range.units == 'bytes':
# Stream partial response.
# This is only true if the header is well-formed. Thanks, Werkzeug.
rsp = _parse_range_header(
request.range.ranges, rsrc, out_headers
)
else:
rsp = make_response(send_file(
rsrc.local_path, as_attachment=True,
attachment_filename=rsrc.filename,
mimetype=rsrc.mimetype), 200, out_headers)
# This seems necessary to prevent Flask from setting an
# additional ETag.
if 'ETag' in out_headers:
rsp.set_etag(out_headers['ETag'])
rsp.headers.add('Link', f'<{uri}/fcr:metadata>; rel="describedby"')
return rsp
[docs]@ldp.route('/<path:uid>/fcr:versions', methods=['GET'])
def get_version_info(uid):
"""
Get version info (`fcr:versions`).
:param str uid: UID of resource to retrieve versions for.
"""
rdf_mimetype = _best_rdf_mimetype() or DEFAULT_RDF_MIMETYPE
try:
imr = rsrc_api.get_version_info(uid)
except ResourceNotExistsError as e:
return str(e), 404
except InvalidResourceError as e:
return str(e), 409
except TombstoneError as e:
return _tombstone_response(e, uid)
else:
with store.txn_ctx():
return _negotiate_content(g.tbox.globalize_imr(imr), rdf_mimetype)
[docs]@ldp.route('/<path:uid>/fcr:versions/<ver_uid>', methods=['GET'])
def get_version(uid, ver_uid):
"""
Get an individual resource version.
:param str uid: Resource UID.
:param str ver_uid: Version UID.
"""
rdf_mimetype = _best_rdf_mimetype() or DEFAULT_RDF_MIMETYPE
try:
imr = rsrc_api.get_version(uid, ver_uid)
except ResourceNotExistsError as e:
return str(e), 404
except InvalidResourceError as e:
return str(e), 409
except TombstoneError as e:
return _tombstone_response(e, uid)
else:
with store.txn_ctx():
return _negotiate_content(g.tbox.globalize_imr(imr), rdf_mimetype)
[docs]@ldp.route('/<path:parent_uid>', methods=['POST'], strict_slashes=False)
@ldp.route('/', defaults={'parent_uid': '/'}, methods=['POST'],
strict_slashes=False)
def post_resource(parent_uid):
"""
https://www.w3.org/TR/ldp/#ldpr-HTTP_POST
Add a new resource in a new URI.
"""
rsp_headers = std_headers.copy()
slug = request.headers.get('Slug')
kwargs = {}
kwargs['handling'], kwargs['disposition'] = set_post_put_params()
stream, mimetype = _bistream_from_req()
if mimetype in rdf_parsable_mimetypes:
# If the content is RDF, localize in-repo URIs.
global_rdf = stream.read()
kwargs['rdf_data'] = g.tbox.localize_payload(global_rdf)
kwargs['rdf_fmt'] = mimetype
else:
kwargs['stream'] = stream
kwargs['mimetype'] = mimetype
# Check digest if requested.
if 'digest' in request.headers:
try:
kwargs['prov_cksum_algo'], kwargs['prov_cksum'] = (
request.headers['digest'].split('=')
)
except ValueError:
return (
f'Cannot parse digest value: {request.headers["digest"]}',
400
)
try:
rsrc = rsrc_api.create(parent_uid, slug, **kwargs)
except IndigestibleError:
return (
f'Unable to parse digest header: {request.headers["digest"]}'
), 400
except ResourceNotExistsError as e:
return str(e), 404
except (InvalidResourceError, ChecksumValidationError) as e:
return str(e), 409
except TombstoneError as e:
return _tombstone_response(e, uid)
except ServerManagedTermError as e:
rsp_headers['Link'] = (
f'<{uri}>; rel="{nsc["ldp"].constrainedBy}"; '
f'{g.webroot}/info/ldp_constraints"'
)
return str(e), 412
uri = g.tbox.uid_to_uri(rsrc.uid)
with store.txn_ctx():
rsp_headers.update(_headers_from_metadata(rsrc))
rsp_headers['Location'] = uri
if mimetype and kwargs.get('rdf_fmt') is None:
rsp_headers['Link'] = (
f'<{uri}/fcr:metadata>; rel="describedby"; anchor="{uri}"'
)
return uri, 201, rsp_headers
[docs]@ldp.route('/<path:uid>', methods=['PUT'], strict_slashes=False)
@ldp.route('/<path:uid>/fcr:metadata', defaults={'force_rdf' : True},
methods=['PUT'])
def put_resource(uid):
"""
https://www.w3.org/TR/ldp/#ldpr-HTTP_PUT
Add or replace a new resource at a specified URI.
"""
# Parse headers.
logger.debug('Request headers: {}'.format(request.headers))
cond_ret = _process_cond_headers(uid, request.headers, False)
if cond_ret:
return cond_ret
kwargs = {}
kwargs['handling'], kwargs['disposition'] = set_post_put_params()
stream, mimetype = _bistream_from_req()
if mimetype in rdf_parsable_mimetypes:
# If the content is RDF, localize in-repo URIs.
global_rdf = stream.read()
kwargs['rdf_data'] = g.tbox.localize_payload(global_rdf)
kwargs['rdf_fmt'] = mimetype
else:
kwargs['stream'] = stream
kwargs['mimetype'] = mimetype
# Check digest if requested.
if 'digest' in request.headers:
kwargs['prov_cksum_algo'], kwargs['prov_cksum'] = \
request.headers['digest'].split('=')
try:
evt, rsrc = rsrc_api.create_or_replace(uid, **kwargs)
except (
InvalidResourceError, ChecksumValidationError,
ResourceExistsError) as e:
return str(e), 409
except (ServerManagedTermError, SingleSubjectError) as e:
return str(e), 412
except IncompatibleLdpTypeError as e:
return str(e), 415
except TombstoneError as e:
return _tombstone_response(e, uid)
with store.txn_ctx():
rsp_headers = _headers_from_metadata(rsrc)
rsp_headers['Content-Type'] = 'text/plain; charset=utf-8'
uri = g.tbox.uid_to_uri(uid)
if evt == RES_CREATED:
rsp_code = 201
rsp_headers['Location'] = rsp_body = uri
if mimetype and not kwargs.get('rdf_data'):
rsp_headers['Link'] = f'<{uri}/fcr:metadata>; rel="describedby"'
else:
rsp_code = 204
rsp_body = ''
return rsp_body, rsp_code, rsp_headers
[docs]@ldp.route('/<path:uid>', methods=['PATCH'], strict_slashes=False)
@ldp.route('/', defaults={'uid': '/'}, methods=['PATCH'],
strict_slashes=False)
def patch_resource(uid, is_metadata=False):
"""
https://www.w3.org/TR/ldp/#ldpr-HTTP_PATCH
Update an existing resource with a SPARQL-UPDATE payload.
"""
# Fist check if it's not a 404 or a 410.
try:
if not rsrc_api.exists(uid):
return '', 404
except TombstoneError as e:
return _tombstone_response(e, uid)
# Then process the condition headers.
cond_ret = _process_cond_headers(uid, request.headers, False)
if cond_ret:
return cond_ret
handling, _ = set_post_put_params()
rsp_headers = {'Content-Type' : 'text/plain; charset=utf-8'}
if request.mimetype != 'application/sparql-update':
return 'Provided content type is not a valid parsable format: {}'\
.format(request.mimetype), 415
update_str = request.get_data().decode('utf-8')
local_update_str = g.tbox.localize_ext_str(update_str, nsc['fcres'][uid])
try:
rsrc = rsrc_api.update(uid, local_update_str, is_metadata, handling)
except (ServerManagedTermError, SingleSubjectError) as e:
return str(e), 412
except InvalidResourceError as e:
return str(e), 415
else:
with store.txn_ctx():
rsp_headers.update(_headers_from_metadata(rsrc))
return '', 204, rsp_headers
[docs]@ldp.route('/<path:uid>', methods=['DELETE'])
def delete_resource(uid):
"""
Delete a resource and optionally leave a tombstone.
This behaves differently from FCREPO. A tombstone indicated that the
resource is no longer available at its current location, but its historic
snapshots still are. Also, deleting a resource with a tombstone creates
one more version snapshot of the resource prior to being deleted.
In order to completely wipe out all traces of a resource, the tombstone
must be deleted as well, or the ``Prefer:no-tombstone`` header can be used.
The latter will forget (completely delete) the resource immediately.
"""
# Fist check if it's not a 404 or a 410.
try:
if not rsrc_api.exists(uid):
return '', 404
except TombstoneError as e:
return _tombstone_response(e, uid)
# Then process the condition headers.
cond_ret = _process_cond_headers(uid, request.headers, False)
if cond_ret:
return cond_ret
headers = std_headers.copy()
if 'prefer' in request.headers:
prefer = toolbox.parse_rfc7240(request.headers['prefer'])
leave_tstone = 'no-tombstone' not in prefer
else:
leave_tstone = True
rsrc_api.delete(uid, leave_tstone)
return '', 204, headers
[docs]@ldp.route('/<path:uid>/fcr:tombstone', methods=['GET', 'POST', 'PUT',
'PATCH', 'DELETE'])
def tombstone(uid):
"""
Handle all tombstone operations.
The only allowed methods are POST and DELETE; any other verb will return a
405.
"""
try:
rsrc_api.get(uid)
except TombstoneError as e:
if request.method == 'DELETE':
if e.uid == uid:
rsrc_api.delete(uid, False)
return '', 204
else:
return _tombstone_response(e, uid)
elif request.method == 'POST':
if e.uid == uid:
rsrc_uri = rsrc_api.resurrect(uid)
headers = {'Location' : rsrc_uri}
return rsrc_uri, 201, headers
else:
return _tombstone_response(e, uid)
else:
return 'Method Not Allowed.', 405
except ResourceNotExistsError as e:
return str(e), 404
else:
return '', 404
[docs]@ldp.route('/<path:uid>/fcr:versions', methods=['POST', 'PUT'])
def post_version(uid):
"""
Create a new resource version.
"""
if request.method == 'PUT':
return 'Method not allowed.', 405
ver_uid = request.headers.get('slug', None)
try:
ver_uid = rsrc_api.create_version(uid, ver_uid)
except ResourceNotExistsError as e:
return str(e), 404
except InvalidResourceError as e:
return str(e), 409
except TombstoneError as e:
return _tombstone_response(e, uid)
else:
return '', 201, {'Location': g.tbox.uid_to_uri(ver_uid)}
[docs]@ldp.route('/<path:uid>/fcr:versions/<ver_uid>', methods=['PATCH'])
def patch_version(uid, ver_uid):
"""
Revert to a previous version.
NOTE: This creates a new version snapshot.
:param str uid: Resource UID.
:param str ver_uid: Version UID.
"""
try:
rsrc_api.revert_to_version(uid, ver_uid)
except ResourceNotExistsError as e:
return str(e), 404
except InvalidResourceError as e:
return str(e), 409
except TombstoneError as e:
return _tombstone_response(e, uid)
else:
return '', 204
## PRIVATE METHODS ##
def _best_rdf_mimetype():
"""
Check if any of the 'Accept' header values provided is a RDF parsable
format.
"""
for accept in request.accept_mimetypes:
mimetype = accept[0]
if mimetype in rdf_parsable_mimetypes:
return mimetype
return None
def _negotiate_content(gr, rdf_mimetype, headers=None, **vw_kwargs):
"""
Return HTML or serialized RDF depending on accept headers.
"""
if request.accept_mimetypes.best == 'text/html':
return render_template(
'resource.html', gr=gr, nsc=nsc, nsm=nsm,
blacklist=vw_blacklist, arrow=arrow, **vw_kwargs)
else:
for p in vw_blacklist:
gr.remove((None, p, None))
return Response(
gr.serialize(format=rdf_mimetype), 200, headers,
mimetype=rdf_mimetype)
def _bistream_from_req():
"""
Find how a binary file and its MIMEtype were uploaded in the request.
"""
#logger.debug('Content type: {}'.format(request.mimetype))
#logger.debug('files: {}'.format(request.files))
#logger.debug('stream: {}'.format(request.stream))
if request.mimetype == 'multipart/form-data':
# This seems the "right" way to upload a binary file, with a
# multipart/form-data MIME type and the file in the `file`
# field. This however is not supported by FCREPO4.
stream = request.files.get('file').stream
mimetype = request.files.get('file').content_type
# @TODO This will turn out useful to provide metadata
# with the binary.
#metadata = request.files.get('metadata').stream
else:
# This is a less clean way, with the file in the form body and
# the request as application/x-www-form-urlencoded.
# This is how FCREPO4 accepts binary uploads.
stream = request.stream
# @FIXME Must decide what to do with this.
mimetype = request.mimetype
if mimetype == '' or mimetype == 'application/x-www-form-urlencoded':
if getattr(stream, 'limit', 0) == 0:
stream = mimetype = None
else:
mimetype = 'application/octet-stream'
return stream, mimetype
def _tombstone_response(e, uid):
headers = {
'Link': '<{}/fcr:tombstone>; rel="hasTombstone"'.format(request.url),
} if e.uid == uid else {}
return str(e), 410, headers
[docs]def set_post_put_params():
"""
Sets handling and content disposition for POST and PUT by parsing headers.
"""
handling = 'strict'
if 'prefer' in request.headers:
prefer = toolbox.parse_rfc7240(request.headers['prefer'])
logger.debug('Parsed Prefer header: {}'.format(prefer))
if 'handling' in prefer:
handling = prefer['handling']['value']
try:
disposition = toolbox.parse_rfc7240(
request.headers['content-disposition'])
except KeyError:
disposition = None
return handling, disposition
[docs]def parse_repr_options(retr_opts):
"""
Set options to retrieve IMR.
Ideally, IMR retrieval is done once per request, so all the options
are set once in the `imr()` property.
:param dict retr_opts:: Options parsed from `Prefer` header.
"""
logger.debug('Parsing retrieval options: {}'.format(retr_opts))
imr_options = {}
if retr_opts.get('value') == 'minimal':
imr_options = {
'embed_children' : False,
'incl_children' : False,
'incl_inbound' : False,
'incl_srv_mgd' : False,
}
else:
# Default.
imr_options = {
'embed_children' : False,
'incl_children' : True,
'incl_inbound' : False,
'incl_srv_mgd' : True,
}
# Override defaults.
if 'parameters' in retr_opts:
include = retr_opts['parameters']['include'].split(' ') \
if 'include' in retr_opts['parameters'] else []
omit = retr_opts['parameters']['omit'].split(' ') \
if 'omit' in retr_opts['parameters'] else []
logger.debug('Include: {}'.format(include))
logger.debug('Omit: {}'.format(omit))
if str(Ldpr.EMBED_CHILD_RES_URI) in include:
imr_options['embed_children'] = True
if str(Ldpr.RETURN_CHILD_RES_URI) in omit:
imr_options['incl_children'] = False
if str(Ldpr.RETURN_INBOUND_REF_URI) in include:
imr_options['incl_inbound'] = True
if str(Ldpr.RETURN_SRV_MGD_RES_URI) in omit:
imr_options['incl_srv_mgd'] = False
logger.debug('Retrieval options: {}'.format(pformat(imr_options)))
return imr_options
def _headers_from_metadata(rsrc, out_fmt='text/turtle'):
"""
Create a dict of headers from a metadata graph.
:param lakesuperior.model.ldp.ldpr.Ldpr rsrc: Resource to extract metadata
from.
"""
rsp_headers = defaultdict(list)
digest_p = rsrc.metadata.value(nsc['premis'].hasMessageDigest)
# Only add ETag and digest if output is not RDF.
if digest_p:
rsp_headers['ETag'], rsp_headers['Digest'] = (
_digest_headers(digest_p))
last_updated_term = rsrc.metadata.value(nsc['fcrepo'].lastModified)
if last_updated_term:
rsp_headers['Last-Modified'] = arrow.get(last_updated_term)\
.format('ddd, D MMM YYYY HH:mm:ss Z')
for t in rsrc.ldp_types:
rsp_headers['Link'].append('{};rel="type"'.format(t.n3()))
if rsrc.mimetype:
rsp_headers['Content-Type'] = rsrc.mimetype
return rsp_headers
def _digest_headers(digest):
"""
Format ETag and Digest headers from resource checksum.
:param str digest: Resource digest. For an extracted IMR, this is the
value of the ``premis:hasMessageDigest`` property.
"""
digest_components = digest.split(':')
cksum_hex = digest_components[-1]
cksum = bytearray.fromhex(cksum_hex)
digest_algo = digest_components[-2]
etag_str = cksum_hex
digest_str = '{}={}'.format(
digest_algo.upper(), b64encode(cksum).decode('ascii'))
return etag_str, digest_str
def _condition_hdr_match(uid, headers, safe=True):
"""
Conditional header evaluation for HEAD, GET, PUT and DELETE requests.
Determine whether any conditional headers, and which, is/are imposed in the
request (``If-Match``, ``If-None-Match``, ``If-Modified-Since``,
``If-Unmodified-Since``, or none) and what the most relevant condition
evaluates to (``True`` or ``False``).
`RFC 7232 <https://tools.ietf.org/html/rfc7232#section-3.1>`__ does not
indicate an exact condition precedence, except that the ETag
matching conditions void the timestamp-based ones. This function
adopts the following precedence:
- ``If-Match`` is evaluated first if present;
- Else, ``If-None-Match`` is evaluated if present;
- Else, ``If-Modified-Since`` and ``If-Unmodified-Since``
are evaluated if present. If both conditions are present they are
both returned so they can be furher evaluated, e.g. using a logical AND
to allow time-range conditions, where the two terms indicate the early
and late boundary, respectively.
Note that the above mentioned RFC mentions several cases in which these
conditions are ignored, e.g. for a 404 in some cases, or for certain
HTTP methods for ``If-Modified-Since``. This must be implemented by the
calling function.
:param str uid: UID of the resource requested.
:param werkzeug.datastructures.EnvironHeaders headers: Incoming request
headers.
:param bool safe: Whether a "safe" method is being processed. Defaults to
True.
:rtype: dict (str, bool)
:return: Dictionary whose keys are the conditional header names that
have been evaluated, and whose boolean values indicate whether each
condition is met. If no valid conditional header is found, an empty
dict is returned.
"""
# ETag-based conditions.
# This ignores headers with empty values.
if headers.get('if-match') or headers.get('if-none-match'):
cond_hdr = 'if-match' if headers.get('if-match') else 'if-none-match'
# Wildcard matching for unsafe methods. Cannot be part of a list of
# ETags nor be enclosed in quotes.
if not safe and headers.get(cond_hdr) == '*':
return {cond_hdr: (cond_hdr == 'if-match') == rsrc_api.exists(uid)}
req_etags = [
et.strip('\'" ') for et in headers.get(cond_hdr).split(',')]
with store.txn_ctx():
try:
rsrc_meta = rsrc_api.get_metadata(uid)
except ResourceNotExistsError:
rsrc_meta = Graph(uri=nsc['fcres'][uid])
digest_prop = rsrc_meta.value(nsc['premis'].hasMessageDigest)
if digest_prop:
etag, _ = _digest_headers(digest_prop)
if cond_hdr == 'if-match':
is_match = etag in req_etags
else:
is_match = etag not in req_etags
else:
is_match = cond_hdr == 'if-none-match'
return {cond_hdr: is_match}
# Timestmp-based conditions.
ret = {}
if headers.get('if-modified-since') or headers.get('if-unmodified-since'):
try:
rsrc_meta = rsrc_api.get_metadata(uid)
except ResourceNotExistsError:
return {
'if-modified-since': False,
'if-unmodified-since': False
}
with store.txn_ctx():
lastmod_str = rsrc_meta.value(nsc['fcrepo'].lastModified)
lastmod_ts = arrow.get(lastmod_str)
# If date is not in a RFC 5322 format
# (https://tools.ietf.org/html/rfc5322#section-3.3) parse_date
# evaluates to None.
mod_since_date = parse_date(headers.get('if-modified-since'))
if mod_since_date:
cond_hdr = 'if-modified-since'
ret[cond_hdr] = lastmod_ts > arrow.get(mod_since_date)
unmod_since_date = parse_date(headers.get('if-unmodified-since'))
if unmod_since_date:
cond_hdr = 'if-unmodified-since'
ret[cond_hdr] = lastmod_ts < arrow.get(unmod_since_date)
return ret
def _process_cond_headers(uid, headers, safe=True):
"""
Process the outcome of the evaluation of conditional headers.
This yields different response between safe methods (``HEAD``, ``GET``,
etc.) and unsafe ones (``PUT``, ``DELETE``, etc.
:param str uid: Resource UID.
:param werkzeug.datastructures.EnvironHeaders headers: Incoming request
headers.
:param bool safe: Whether a "safe" method is being processed. Defaults to
True.
"""
try:
cond_match = _condition_hdr_match(uid, headers, safe)
except TombstoneError as e:
return _tombstone_response(e, uid)
if cond_match:
if safe:
if 'if-match' in cond_match or 'if-none-match' in cond_match:
# If an expected list of tags is not matched, the response is
# "Precondition Failed". For all other cases, it's "Not Modified".
if not cond_match.get('if-match', True):
return '', 412
if not cond_match.get('if-none-match', True):
return '', 304
# The presence of an Etag-based condition, whether satisfied or not,
# voids the timestamp-based conditions.
elif (
not cond_match.get('if-modified-since', True) or
not cond_match.get('if-unmodified-since', True)):
return '', 304
else:
# Note that If-Modified-Since is only evaluated for safe methods.
if 'if-match' in cond_match or 'if-none-match' in cond_match:
if (
not cond_match.get('if-match', True) or
not cond_match.get('if-none-match', True)):
return '', 412
# The presence of an Etag-based condition, whether satisfied or not,
# voids the timestamp-based conditions.
elif not cond_match.get('if-unmodified-since', True):
return '', 412
def _parse_range_header(ranges, rsrc, headers):
"""
Parse a ``Range`` header and return the appropriate response.
"""
if len(ranges) == 1:
# Single range.
rng = ranges[0]
logger.debug('Streaming contiguous partial content.')
with open(rsrc.local_path, 'rb') as fh:
size = None if rng[1] is None else rng[1] - rng[0]
hdr_endbyte = (
rsrc.content_size - 1 if rng[1] is None else rng[1] - 1)
fh.seek(rng[0])
out = fh.read(size)
headers['Content-Range'] = \
f'bytes {rng[0]}-{hdr_endbyte} / {rsrc.content_size}'
else:
return make_response('Multiple ranges are not yet supported.', 501)
# TODO Format the response as multipart/byteranges:
# https://tools.ietf.org/html/rfc7233#section-4.1
#out = []
#with open(rsrc.local_path, 'rb') as fh:
# for rng in rng_header.ranges:
# fh.seek(rng[0])
# size = None if rng[1] is None else rng[1] - rng[0]
# out.extend(fh.read(size))
return make_response(out, 206, headers)