Class JSONPatchItem

Create an entry for the patch list.

Args:
    **op**:
        Operation: ::

           add, copy, move, remove, replace, test

    **target**:
        Target node. ::

           target := (
               <rfc6901-string>
               | JSONPointer
               | <path-items-list>
               )

    **param**:
        Specific parameter for the operation.

        +-------+--------------------+
        | type  | operation          |
        +=======+====================+
        | value | add, replace, test |
        +-------+--------------------+
        | src   | copy, move         |
        +-------+--------------------+
        | param | None for 'remove'  |
        +-------+--------------------+

    kargs:
        **replace**:
            Replace masked characters in *target* specification. ::

               replace := (
                    True    # replaces rfc6901 escape sequences: ~0 and ~1
                  | False   # omit unescaping
               )

            .. note::
            
               Match operations are proceeded literally, thus the
               escaped characters should be consistent,
               see rfc6901, Section 3.

            default := False

Returns:
    When successful returns 'True', else returns either 'False', or
    raises an exception.
    Success is the complete addition only, thus one failure returns
    False.

Raises:
    JSONDataPatchItemError

Overrides: object.__init__

Evaluates the related task for the provided data.

Args:
    **jdata**:
        JSON data the task has to be 
        applied on.

Returns:
    Returns a tuple of: ::

       (n,lerr): 

       n:    number of present active entries
       lerr: list of failed entries

Raises:
    JSONDataPatchError:

Compares this pointer with x.

Args:
    **x**:
        A valid Pointer.

Returns:
    *True* or *False*.

Raises:
    JSONPointerError

Support of various mappings.

#. self[key]

#. self[i:j:k]

#. x in self

#. for x in self

Compares this pointer with x.

Args:
    **x**: A valid Pointer.

Returns:
    *True* or *False*.

Raises:
    JSONPointerError

Prints the patch string in accordance to RFC6901.

Overrides: object.__repr__

Prints the patch string in accordance to RFC6901.

Overrides: object.__str__

Applies the present patch list on the provided JSON document.

Args:
    **jsondata**:
        Document to be patched.

    kargs:
        **replace**:
            Replace masked characters in *target* specification. ::

               replace := (
                    True    # replaces rfc6901 escape sequences: ~0 and ~1
                  | False   # omit unescaping
               )

            .. note::
            
               Match operations are proceeded literally, thus the
               escaped characters should be consistent,
               see rfc6901, Section 3.

               If already decoded e.g. by the constructor, than should be
               *FALSE*, is not idempotent.

            default := False
    
Returns:
    When successful returns 'True', else raises an exception.
    Or returns a tuple: ::

       (n,lerr): 

       n:    number of present active entries
       lerr: list of failed entries

Raises:
    JSONDataPatchError: