46 lines
1.5 KiB
Python
46 lines
1.5 KiB
Python
# Copyright 2020 Google LLC
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# https://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
import struct
|
|
|
|
# NOTE: ``__config__`` **must** be the first import because it (may)
|
|
# modify the search path used to locate shared libraries.
|
|
import google_crc32c.__config__ # type: ignore
|
|
from google_crc32c._crc32c import extend # type: ignore
|
|
from google_crc32c._crc32c import value # type: ignore
|
|
from google_crc32c._checksum import CommonChecksum
|
|
|
|
|
|
class Checksum(CommonChecksum):
|
|
"""Hashlib-alike helper for CRC32C operations.
|
|
|
|
Args:
|
|
initial_value (Optional[bytes]): the initial chunk of data from
|
|
which the CRC32C checksum is computed. Defaults to b''.
|
|
"""
|
|
|
|
__slots__ = ("_crc",)
|
|
|
|
def __init__(self, initial_value=b""):
|
|
self._crc = value(initial_value)
|
|
|
|
def update(self, chunk):
|
|
"""Update the checksum with a new chunk of data.
|
|
|
|
Args:
|
|
chunk (Optional[bytes]): a chunk of data used to extend
|
|
the CRC32C checksum.
|
|
"""
|
|
self._crc = extend(self._crc, chunk)
|