diff --git a/src/pyjsonld.py b/src/pyjsonld.py index 69af0f6f2..e39cce462 100644 --- a/src/pyjsonld.py +++ b/src/pyjsonld.py @@ -145,7 +145,7 @@ LINK_HEADER_REL = 'http://www.w3.org/ns/json-ld#context' MAX_CONTEXT_URLS = 10 -def compact(input_, ctx, options=None): +def compact(input_, ctx, options: {} = None): """ Performs JSON-LD compaction. @@ -165,7 +165,7 @@ def compact(input_, ctx, options=None): return JsonLdProcessor().compact(input_, ctx, options) -def expand(input_, options=None): +def expand(input_, options: {} = None): """ Performs JSON-LD expansion. @@ -181,7 +181,7 @@ def expand(input_, options=None): return JsonLdProcessor().expand(input_, options) -def flatten(input_, ctx=None, options=None): +def flatten(input_, ctx=None, options: {} = None): """ Performs JSON-LD flattening. @@ -198,7 +198,7 @@ def flatten(input_, ctx=None, options=None): return JsonLdProcessor().flatten(input_, ctx, options) -def frame(input_, frame2, options=None): +def frame(input_, frame2, options: {} = None): """ Performs JSON-LD framing. @@ -219,7 +219,7 @@ def frame(input_, frame2, options=None): return JsonLdProcessor().frame(input_, frame2, options) -def link(input_, ctx, options=None): +def link(input_, ctx, options: {} = None): """ **Experimental** @@ -244,7 +244,7 @@ def link(input_, ctx, options=None): return frame(input, frame2, options) -def normalize(input_: {}, options=None): +def normalize(input_: {}, options: {} = None): """ Performs JSON-LD normalization. @@ -261,7 +261,7 @@ def normalize(input_: {}, options=None): return JsonLdProcessor().normalize(input_, options) -def from_rdf(input_, options=None): +def from_rdf(input_, options: {} = None): """ Converts an RDF dataset to JSON-LD. @@ -279,7 +279,7 @@ def from_rdf(input_, options=None): return JsonLdProcessor().from_rdf(input_, options) -def to_rdf(input_, options=None): +def to_rdf(input_, options: {} = None): """ Outputs the RDF dataset found in the given JSON-LD object. @@ -690,7 +690,7 @@ class JsonLdProcessor(object): # processor-specific RDF parsers self.rdf_parsers = None - def compact(self, input_, ctx, options): + def compact(self, input_, ctx, options: {}): """ Performs JSON-LD compaction. @@ -803,7 +803,7 @@ class JsonLdProcessor(object): return {'compacted': compacted, 'activeCtx': active_ctx} return compacted - def expand(self, input_, options): + def expand(self, input_, options: {}): """ Performs JSON-LD expansion. @@ -892,7 +892,7 @@ class JsonLdProcessor(object): # normalize to an array return JsonLdProcessor.arrayify(expanded) - def flatten(self, input_, ctx, options): + def flatten(self, input_, ctx, options: {}): """ Performs JSON-LD flattening. @@ -936,7 +936,7 @@ class JsonLdProcessor(object): return compacted - def frame(self, input_, frame2, options): + def frame(self, input_, frame2, options: {}): """ Performs JSON-LD framing. @@ -1043,7 +1043,7 @@ class JsonLdProcessor(object): active_ctx, compacted[graph], options) return compacted - def normalize(self, input_, options): + def normalize(self, input_, options: {}): """ Performs RDF normalization on the given JSON-LD input. @@ -1078,7 +1078,7 @@ class JsonLdProcessor(object): # do normalization return self._normalize(dataset, options) - def from_rdf(self, dataset, options): + def from_rdf(self, dataset, options: {}): """ Converts an RDF dataset to JSON-LD. @@ -1124,7 +1124,7 @@ class JsonLdProcessor(object): # convert from RDF return self._from_rdf(dataset, options) - def to_rdf(self, input_, options): + def to_rdf(self, input_, options: {}): """ Outputs the RDF dataset found in the given JSON-LD object. @@ -1176,7 +1176,7 @@ class JsonLdProcessor(object): return {} return dataset - def process_context(self, active_ctx, local_ctx, options): + def process_context(self, active_ctx: {}, local_ctx: {}, options: {}): """ Processes a local context, retrieving any URLs as necessary, and returns a new active context in its callback. @@ -1711,7 +1711,7 @@ class JsonLdProcessor(object): return True - def _compact(self, active_ctx, active_property, element, options): + def _compact(self, active_ctx: {}, active_property, element, options: {}): """ Recursively compacts an element using the given active context. All values must be in expanded form before this method is called. @@ -1913,7 +1913,8 @@ class JsonLdProcessor(object): return element def _expand( - self, active_ctx, active_property, element, options, inside_list): + self, active_ctx: {}, active_property, element, options: {}, + inside_list): """ Recursively expands an element using the given context. Any context in the element will be removed. All context URLs must have been retrieved @@ -2193,7 +2194,7 @@ class JsonLdProcessor(object): return [value for key, value in sorted(default_graph.items()) if not _is_subject_reference(value)] - def _frame(self, input_, frame2, options): + def _frame(self, input_, frame2, options: {}): """ Performs JSON-LD framing. @@ -2223,7 +2224,7 @@ class JsonLdProcessor(object): state, sorted(state['subjects'].keys()), frame2, framed, None) return framed - def _normalize(self, dataset, options): + def _normalize(self, dataset, options: {}): """ Performs RDF normalization on the given RDF dataset. @@ -2350,7 +2351,7 @@ class JsonLdProcessor(object): # return parsed RDF dataset return JsonLdProcessor.parse_nquads(''.join(normalized)) - def _from_rdf(self, dataset, options): + def _from_rdf(self, dataset, options: {}): """ Converts an RDF dataset to JSON-LD. @@ -2492,7 +2493,7 @@ class JsonLdProcessor(object): return result - def _process_context(self, active_ctx, local_ctx, options): + def _process_context(self, active_ctx: {}, local_ctx: {}, options: {}): """ Processes a local context and returns a new active context. @@ -2637,7 +2638,7 @@ class JsonLdProcessor(object): rval.append({'@value': item, '@language': key.lower()}) return rval - def _expand_value(self, active_ctx, active_property, value): + def _expand_value(self, active_ctx: {}, active_property, value): """ Expands the given value by using the coercion and keyword rules in the given context. @@ -2691,7 +2692,7 @@ class JsonLdProcessor(object): return rval - def _graph_to_rdf(self, graph, namer, options): + def _graph_to_rdf(self, graph, namer, options: {}): """ Creates an array of RDF triples for the given graph. @@ -3179,7 +3180,7 @@ class JsonLdProcessor(object): return True return False - def _get_frame_flag(self, frame2, options, name): + def _get_frame_flag(self, frame2, options: {}, name): """ Gets the frame flag value for the given flag name. @@ -3358,7 +3359,7 @@ class JsonLdProcessor(object): else: parent.append(output) - def _remove_preserve(self, ctx, input_, options): + def _remove_preserve(self, ctx, input_, options: {}): """ Removes the @preserve keywords as the last step of the framing algorithm. @@ -3578,7 +3579,7 @@ class JsonLdProcessor(object): return None def _select_term( - self, active_ctx, iri, value, containers, + self, active_ctx: {}, iri, value, containers, type_or_language, type_or_language_value): """ Picks the preferred compaction term from the inverse context entry. @@ -3630,7 +3631,7 @@ class JsonLdProcessor(object): return None def _compact_iri( - self, active_ctx, iri, value=None, vocab=False, reverse=False): + self, active_ctx: {}, iri, value=None, vocab=False, reverse=False): """ Compacts an IRI or keyword into a term or CURIE if it can be. If the IRI has an associated value it may be passed. @@ -3779,7 +3780,7 @@ class JsonLdProcessor(object): # return IRI as is return iri - def _compact_value(self, active_ctx, active_property, value): + def _compact_value(self, active_ctx: {}, active_property, value): """ Performs value compaction on an object with @value or @id as the only property. @@ -3861,7 +3862,8 @@ class JsonLdProcessor(object): rval[self._compact_iri(active_ctx, '@id')] = compacted return rval - def _create_term_definition(self, active_ctx, local_ctx, term, defined): + def _create_term_definition(self, active_ctx: {}, local_ctx: {}, + term, defined): """ Creates a term definition during context processing. @@ -4043,8 +4045,8 @@ class JsonLdProcessor(object): return def _expand_iri( - self, active_ctx, value, base=False, vocab=False, - local_ctx=None, defined=None): + self, active_ctx: {}, value, base=False, vocab=False, + local_ctx: {} = None, defined=None): """ Expands a string value to a full IRI. The string may be a term, a prefix, a relative IRI, or an absolute IRI. The associated absolute @@ -4251,7 +4253,7 @@ class JsonLdProcessor(object): # replace all URLs in the input self._find_context_urls(input_, urls, replace=True, base=base) - def _get_initial_context(self, options): + def _get_initial_context(self, options: {}): """ Gets the initial context. @@ -4266,7 +4268,7 @@ class JsonLdProcessor(object): 'inverse': None } - def _get_inverse_context(self, active_ctx): + def _get_inverse_context(self, active_ctx: {}): """ Generates an inverse context for use in the compaction algorithm, if not already generated for the given active context. @@ -4322,7 +4324,7 @@ class JsonLdProcessor(object): return inverse - def _clone_active_context(self, active_ctx): + def _clone_active_context(self, active_ctx: {}): """ Clones an active context, creating a child active context. @@ -4728,14 +4730,14 @@ class ActiveContextCache(object): self.cache = {} self.size = size - def get(self, active_ctx, local_ctx): + def get(self, active_ctx: {}, local_ctx: {}): """ get """ key1 = json.dumps(active_ctx) key2 = json.dumps(local_ctx) return self.cache.get(key1, {}).get(key2) - def set(self, active_ctx, local_ctx, result): + def set(self, active_ctx: {}, local_ctx: {}, result): """ set """ if len(self.order) == self.size: