dfindexeddb 20240305__py3-none-any.whl → 20240324__py3-none-any.whl

dfindexeddb/cli.py

@@ -1,180 +0,0 @@
-# -*- coding: utf-8 -*-
-# Copyright 2024 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.
-"""A CLI tool for dfindexeddb."""
-import argparse
-import dataclasses
-from datetime import datetime
-import json
-import pathlib
-import sys
-import traceback
-
-from dfindexeddb import errors
-from dfindexeddb import version
-from dfindexeddb.leveldb import descriptor
-from dfindexeddb.leveldb import ldb
-from dfindexeddb.leveldb import log
-from dfindexeddb.indexeddb import chromium
-from dfindexeddb.indexeddb import v8
-
-
-_VALID_PRINTABLE_CHARACTERS = (
-    'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789' +
-    '!"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~.')
-
-
-class Encoder(json.JSONEncoder):
-  """A JSON encoder class for dfindexeddb fields."""
-  def default(self, o):
-    if isinstance(o, bytes):
-      out = []
-      for x in o:
-        if chr(x) not in _VALID_PRINTABLE_CHARACTERS:
-          out.append(f'\\x{x:02X}')
-        else:
-          out.append(chr(x))
-      return ''.join(out)
-    if isinstance(o, datetime):
-      return o.isoformat()
-    if isinstance(o, v8.Undefined):
-      return "<undefined>"
-    if isinstance(o, v8.Null):
-      return "<null>"
-    if isinstance(o, set):
-      return list(o)
-    if isinstance(o, v8.RegExp):
-      return str(o)
-    return json.JSONEncoder.default(self, o)
-
-
-def _Output(structure, to_json=False):
-  """Helper method to output parsed structure to stdout."""
-  if to_json:
-    structure_dict = dataclasses.asdict(structure)
-    print(json.dumps(structure_dict, indent=2, cls=Encoder))
-  else:
-    print(structure)
-
-
-def IndexeddbCommand(args):
-  """The CLI for processing a log/ldb file as indexeddb."""
-  if args.source.name.endswith('.log'):
-    records = list(
-        log.FileReader(args.source).GetKeyValueRecords())
-  elif args.source.name.endswith('.ldb'):
-    records = list(
-        ldb.FileReader(args.source).GetKeyValueRecords())
-  else:
-    print('Unsupported file type.', file=sys.stderr)
-    return
-
-  for record in records:
-    try:
-      record = chromium.IndexedDBRecord.FromLevelDBRecord(record)
-    except (errors.ParserError, errors.DecoderError) as err:
-      print(
-          (f'Error parsing blink value: {err} for {record.__class__.__name__} '
-           f'at offset {record.offset}'), file=sys.stderr)
-      print(f'Traceback: {traceback.format_exc()}', file=sys.stderr)
-    _Output(record, to_json=args.json)
-
-
-def ManifestCommand(args):
-  """The CLI for processing MANIFEST aka Descriptor files."""
-  manifest_file = descriptor.FileReader(args.source)
-
-  for version_edit in manifest_file.GetVersionEdits():
-    _Output(version_edit, to_json=args.json)
-
-
-def LdbCommand(args):
-  """The CLI for processing ldb files."""
-  ldb_file = ldb.FileReader(args.source)
-
-  if args.structure_type == 'blocks':
-    # Prints block information.
-    for block in ldb_file.GetBlocks():
-      _Output(block, to_json=args.json)
-
-  elif args.structure_type == 'records':
-    # Prints key value record information.
-    for record in ldb_file.GetKeyValueRecords():
-      _Output(record, to_json=args.json)
-
-
-def LogCommand(args):
-  """The CLI for processing log files."""
-  log_file = log.FileReader(args.source)
-
-  if args.structure_type == 'blocks':
-    # Prints block information.
-    for block in log_file.GetBlocks():
-      _Output(block, to_json=args.json)
-
-  elif args.structure_type == 'physical_records':
-    # Prints log file physical record information.
-    for log_file_record in log_file.GetPhysicalRecords():
-      _Output(log_file_record, to_json=args.json)
-
-  elif args.structure_type == 'write_batches':
-    # Prints log file batch information.
-    for batch in log_file.GetWriteBatches():
-      _Output(batch, to_json=args.json)
-
-  elif args.structure_type in ('parsed_internal_key', 'records'):
-    # Prints key value record information.
-    for record in log_file.GetKeyValueRecords():
-      _Output(record, to_json=args.json)
-
-
-def App():
-  """The CLI app entrypoint."""
-  parser = argparse.ArgumentParser(
-      prog='dfindexeddb',
-      description='A cli tool for the dfindexeddb package',
-      epilog=f'Version {version.GetVersion()}')
-
-  parser.add_argument(
-      '-s', '--source', required=True, type=pathlib.Path, 
-      help='The source leveldb file')
-  parser.add_argument('--json', action='store_true', help='Output as JSON')
-  subparsers = parser.add_subparsers(required=True)
-
-  parser_log = subparsers.add_parser('log')
-  parser_log.add_argument(
-      'structure_type', choices=[
-          'blocks',
-          'physical_records',
-          'write_batches',
-          'parsed_internal_key',
-          'records'])
-  parser_log.set_defaults(func=LogCommand)
-
-  parser_log = subparsers.add_parser('ldb')
-  parser_log.add_argument(
-      'structure_type', choices=[
-          'blocks',
-          'records'])
-  parser_log.set_defaults(func=LdbCommand)
-
-  parser_log = subparsers.add_parser('manifest')
-  parser_log.set_defaults(func=ManifestCommand)
-
-  parser_log = subparsers.add_parser('indexeddb')
-  parser_log.set_defaults(func=IndexeddbCommand)
-
-  args = parser.parse_args()
-
-  args.func(args)

dfindexeddb-20240305.dist-info/RECORD

@@ -1,22 +0,0 @@
-dfindexeddb/__init__.py,sha256=KPYL9__l8od6_OyDfGRTgaJ6iy_fqIgZ-dS2S-e3Rac,599
-dfindexeddb/cli.py,sha256=fm7iGA5k1VVIc4jT80w8yQ2kb6h9AucByikwNFNuG3A,5593
-dfindexeddb/errors.py,sha256=PNpwyf_lrPc4TE77oAakX3mu5D_YcP3f80wq8Y1LkvY,749
-dfindexeddb/utils.py,sha256=fp4NaJhJR1LI4THH3PPo_dGyuMkQ6sOtk-l3e9lIdLY,10349
-dfindexeddb/version.py,sha256=KH2nfTUTTcPB19XDYtCGJUOAturiQSDckkQvGgYWdYg,750
-dfindexeddb/indexeddb/__init__.py,sha256=kExXSVBCTKCD5BZJkdMfUMqGksH-DMJxP2_lI0gq-BE,575
-dfindexeddb/indexeddb/blink.py,sha256=MblpYfv-ByG7n_fjYKu2EUhpfVJdUveoW4oSAg5T4tY,3534
-dfindexeddb/indexeddb/chromium.py,sha256=6aePZ7quQzQgHi2KYtlmrjeWZyURGdUFYKIPH80cEAs,44696
-dfindexeddb/indexeddb/definitions.py,sha256=yline3y3gmZx6s-dwjpPDNs5HO4zT6KZqPWQfEsHDoM,7413
-dfindexeddb/indexeddb/v8.py,sha256=ldqpc9T1kG7BOdjnHjQ5hNO9OCXZ3_Zd6vRSpC-NrEA,21893
-dfindexeddb/leveldb/__init__.py,sha256=KPYL9__l8od6_OyDfGRTgaJ6iy_fqIgZ-dS2S-e3Rac,599
-dfindexeddb/leveldb/definitions.py,sha256=d34YBXNRJZklS-KLKOKiwf_ojxevQedYaoJoNGaeM5g,1109
-dfindexeddb/leveldb/descriptor.py,sha256=tfJ0Smk4apUuVZIxEWDTPPjNaTqVtRndA1YsZdHlceI,10394
-dfindexeddb/leveldb/ldb.py,sha256=dOZpzh9WHL3qwfTyIJFn6-OaApTNnqTHeJgXYwOM1-c,7931
-dfindexeddb/leveldb/log.py,sha256=5m6OADTM7BP3AWbamlqAwTn_UGcG2UXZz1YpCq1o4Gk,8858
-dfindexeddb-20240305.dist-info/AUTHORS,sha256=QbvjbAom57fpEkekkCVFUj0B9KUMGraR510aUMBC-PE,286
-dfindexeddb-20240305.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-dfindexeddb-20240305.dist-info/METADATA,sha256=_iqPyDYZsvVd-ITp--C8yyfwB11gs_D1JIIKFDAezW4,15933
-dfindexeddb-20240305.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-dfindexeddb-20240305.dist-info/entry_points.txt,sha256=UsfPLLhTiVAAtZ8Rq3ZR7JNFGMuHqJy-tugGWonQWtc,52
-dfindexeddb-20240305.dist-info/top_level.txt,sha256=X9OTaub1c8S_JJ7g-f8JdkhhdiZ4x1j4eni1hdUCwE4,12
-dfindexeddb-20240305.dist-info/RECORD,,

dfindexeddb-20240305.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-dfindexeddb = dfindexeddb.cli:App