ex-cd 1.17.0__py3-none-any.whl

ex_cd/__init__.py

@@ -0,0 +1,24 @@
+from .config import build_parser, read_config
+from .history import get_latest_url, put_history_placeholder
+from .output import initialize_logging
+from .download import download_gallery_history
+
+
+def main():
+    parser = build_parser()
+    args = parser.parse_args()
+    logger = initialize_logging(args.loglevel)
+    config = read_config(args, logger)
+    logger.info(f"Parsed config: {args}")
+    url = args.url
+    url, gallery_dir = get_latest_url(url, config, logger)
+    logger.info(f"Downloading: {url} -> {gallery_dir}")
+    put_history_placeholder(url, gallery_dir, config, logger)
+    for _ in range(config['retry']):
+        try:
+            download_gallery_history(url, gallery_dir, config, logger)
+        except Exception as e:
+            logger.error(f"download_gallery_history failed, retry: {e}")
+            continue
+        return  # Successfully downloaded
+    return download_gallery_history(url, gallery_dir, config, logger)  # Final attempt, may raise an exception

ex_cd/__main__.py

@@ -0,0 +1,5 @@
+import sys
+import ex_cd
+
+if __name__ == "__main__":
+    sys.exit(ex_cd.main())

ex_cd/collect.py

@@ -0,0 +1,69 @@
+import os
+import json
+import hashlib
+from .common import META_FOLDER, _get_gallery_metadata_filenames
+from .meta import _download_gallery_meta
+
+
+def _iter_metadata(gallery_dir, logger):
+    meta_folder = os.path.join(gallery_dir, META_FOLDER)
+    for metafile in _get_gallery_metadata_filenames(gallery_dir):
+        img, meta_ext = os.path.splitext(metafile)
+        if not meta_ext == '.json':
+            continue
+        metapath = os.path.join(meta_folder, metafile)
+        try:
+            with open(metapath, encoding='utf8') as fp:
+                yield img, json.load(fp)
+        except Exception as e:
+            logger.warning(f"Cannot load exist json file {metafile}: {e}")
+
+
+def _iter_imgfile_metadata(gallery_dir, logger):
+    for img, meta in _iter_metadata(gallery_dir, logger):
+        imgfile = os.path.join(gallery_dir, img)
+        if not os.path.isfile(imgfile):
+            continue
+        yield imgfile, meta
+
+
+def _check_img(imgfile, meta, logger):
+    if 'image_token' not in meta:
+        return False
+    image_token = meta['image_token']
+    sha1_token = None
+    if not os.path.isfile(imgfile):
+        return False
+    try:
+        with open(imgfile, mode="rb") as fp:
+            sha1_token = hashlib.sha1(fp.read()).hexdigest()
+    except Exception as e:
+        logger.error(f"Invalid {imgfile}: cannot compute token, {e}")
+        return False
+    return image_token == sha1_token[0:10]
+
+
+def _collect_gallery_history(gallery_dir, config, logger):
+    history = {}
+    for imgfile, meta in _iter_imgfile_metadata(gallery_dir, logger):
+        if _check_img(imgfile, meta, logger):
+            history[meta['image_token']] = imgfile
+    return history
+
+
+def _load_gallery_history(url, gallery_dir, config, logger, history):
+    """Move deprecated images from child gallery to parent gallery"""
+    _download_gallery_meta(url, gallery_dir, config, logger)
+    for img, meta in _iter_metadata(gallery_dir, logger):
+        if 'image_token' not in meta:
+            continue
+        image_token = meta['image_token']
+        if image_token not in history:
+            continue
+        imgfile = os.path.join(gallery_dir, img)
+        if _check_img(imgfile, meta, logger):
+            continue
+        if os.path.exists(imgfile):
+            os.remove(imgfile)
+        os.rename(history[image_token], imgfile)
+        del history[image_token]

ex_cd/common.py

@@ -0,0 +1,87 @@
+import os
+from tempfile import TemporaryDirectory
+import json
+import random
+import re
+import ex_cd.gallery_dl_exec as gallery_dl
+
+replace_site_re = re.compile(r"https://e[-x]hentai.org")
+
+
+def replace_site(url, config):
+    site = config["replace-site"]
+    return re.sub(replace_site_re, site, url) if site else url
+
+
+META_FOLDER = '.metadata'
+
+metadata_args = ["--write-metadata", "--postprocessor-option", f"directory={META_FOLDER}"]
+
+
+def _download_gallery_metadata_and_extract_gallery_dir(url, config, logger):
+    '''Download a metadata json file of the gallery'''
+    with TemporaryDirectory() as dirname:
+        filename = os.path.join(dirname, 'temp.txt')
+        gallery_dl_exec = config["gallery-dl-exec"]
+        gallery_dl_meta_args = config["gallery-dl-meta-args"]
+        args = [
+            *gallery_dl_exec, "--no-download", "--no-skip", "--range", "1",
+            "--exec-after", "echo {_directory} > %s" % filename,
+            *metadata_args, *gallery_dl_meta_args, replace_site(url, config)
+        ]
+        logger.debug(f"Exec: {args}")
+        returncode = gallery_dl.main(*args)
+        if returncode != 0 or not os.path.isfile(filename):
+            raise ValueError("Cannot get gallery by gallery-dl")
+        with open(filename, encoding='utf8') as fp:
+            gallery_dir = os.path.join(fp.read().strip())
+            # ↓↓↓↓↓↓↓↓ for stupid windows ↓↓↓↓↓↓↓↓
+            gallery_dir = re.sub(r'^"', "", gallery_dir)
+            gallery_dir = re.sub(r'"$', "", gallery_dir)
+            gallery_dir = re.sub(r'^\\+\?\\+', "", gallery_dir)
+            # ↑↑↑↑↑↑↑↑ for stupid windows ↑↑↑↑↑↑↑↑
+            gallery_dir = os.path.join(gallery_dir)
+    return gallery_dir
+
+
+def _get_gallery_metadata_filenames(gallery_dir):
+    metafiles = []
+    meta_folder = os.path.join(gallery_dir, META_FOLDER)
+    os.makedirs(meta_folder, exist_ok=True)
+    for file in os.listdir(meta_folder):
+        if os.path.splitext(file)[1] == '.json':
+            metafiles.append(file)
+    return metafiles
+
+
+def _get_gallery_metadata_files_path(gallery_dir):
+    meta_folder = os.path.join(gallery_dir, META_FOLDER)
+    return [os.path.join(meta_folder, file) for file in _get_gallery_metadata_filenames(gallery_dir)]
+
+
+def _try_get_gallery_one_metadata_from_dir(gallery_dir, logger):
+    '''Read a json file in the gallery metadata json files'''
+    if gallery_dir is not None:
+        metafiles = _get_gallery_metadata_files_path(gallery_dir)
+        if len(metafiles) > 0:
+            metafile = metafiles[random.randint(0, len(metafiles) - 1)]
+            try:
+                with open(metafile, encoding='utf8') as fp:
+                    return json.load(fp)
+            except Exception as e:
+                logger.error(f"Cannot load exist json file {metafile}: {e}")
+
+
+def get_gallery_one_metadata(url, gallery_dir, config, logger):
+    '''Get a metadata of a gallery'''
+    meta = _try_get_gallery_one_metadata_from_dir(gallery_dir, logger)
+    if not meta:
+        gallery_dir2 = _download_gallery_metadata_and_extract_gallery_dir(url, config, logger)
+        if gallery_dir is None:
+            gallery_dir = gallery_dir2
+        if os.path.abspath(gallery_dir) != os.path.abspath(gallery_dir2):
+            raise ValueError(f"gallery_dir not match: {gallery_dir} != {gallery_dir2}")
+    meta = _try_get_gallery_one_metadata_from_dir(gallery_dir, logger)
+    if not meta:
+        raise ValueError(f"Cannot get metadata: {url, gallery_dir}")
+    return meta

ex_cd/config.py

@@ -0,0 +1,92 @@
+import argparse
+import logging
+import json
+import os
+import sys
+
+
+def build_parser():
+    """Build and configure an ArgumentParser object"""
+    parser = argparse.ArgumentParser(usage="%(prog)s [OPTION]... URL...")
+
+    general = parser.add_argument_group("General Options")
+    general.add_argument(
+        "-c", "--config",
+        dest="config", type=str,
+        help="Path to config json file or a json string",
+        default=None,
+    )
+    output = parser.add_argument_group("Output Options")
+    output.add_argument(
+        "-q", "--quiet",
+        dest="loglevel", default=logging.INFO,
+        action="store_const", const=logging.ERROR,
+        help="Activate quiet mode",
+    )
+    output.add_argument(
+        "-v", "--verbose",
+        dest="loglevel",
+        action="store_const", const=logging.DEBUG,
+        help="Print various debugging information",
+    )
+    parser.add_argument(
+        "url", type=str,
+        help="URL of the gallery to download",
+    )
+
+    return parser
+
+
+config = {
+    # Replace https://e-hentai.org or https://exhentai.org by this before start download
+    "replace-site": None,
+    # Root for the gallery
+    "gallery-root": None,
+    # Regular expression to extract path of the file from URL
+    "path-re": "^https://e[-x]hentai.org/g/([0-9]+)/[0-9a-z]+/*$",
+    # if specified "gallery-root" and valid "path-re", get_gallery_dir_by_re will be used to get path
+
+    # Retry times on failure
+    "retry": 3,
+
+    # Maximum depth of the gallery history
+    "depth": 8,
+
+    # Executable gallery-dl commandline program
+    "gallery-dl-exec": [sys.executable, "-m", "gallery_dl"],
+    # Args for running gallery-dl commandline program
+    "gallery-dl-args": [],
+    # Args for running gallery-dl commandline program for meta extraction
+    "gallery-dl-meta-args": [],
+}
+
+
+def read_config(args, logger):
+    if "EXCD_CONFIG_FILE" in os.environ:
+        try:
+            with open(os.environ["EXCD_CONFIG_FILE"], encoding='utf8') as f:
+                override = json.load(f)
+            for k in config:
+                if k in override:
+                    config[k] = override[k]
+        except Exception as e:
+            logger.warn("Cannot read EXCD_CONFIG_FILE %s: %s" % (os.environ["EXCD_CONFIG_FILE"], e))
+
+    if args.config is not None:
+        if os.path.isfile(args.config):
+            try:
+                with open(args.config, encoding='utf8') as f:
+                    override = json.load(f)
+            except Exception as e:
+                logger.warn("Cannot read config %s: %s" % (args.config, e))
+        else:
+            try:
+                override = json.loads(args.config)
+            except Exception as e:
+                logger.warn("Cannot parse config %s: %s" % (args.config, e))
+
+    for k in config:
+        if k in override:
+            config[k] = override[k]
+    logger.info("Config: %s" % config)
+    return config

ex_cd/deprecate.py

@@ -0,0 +1,44 @@
+import os
+import json
+from .common import META_FOLDER, _get_gallery_metadata_filenames
+from .validate import _validate_gallery
+from .meta import _download_gallery_meta
+
+
+DEPRECAT_COMPLETED_FILE = 'DeprecateCompleted'
+
+
+def _deprecate_gallery_history(parent_url, parent_gallery_dir, child_url, child_gallery_dir, config, logger):
+    """Move deprecated images from parent gallery to child gallery (reverse of _load_gallery_history)"""
+    ok_file = os.path.join(parent_gallery_dir, META_FOLDER, DEPRECAT_COMPLETED_FILE)
+    if os.path.isfile(ok_file):
+        return
+    if not _validate_gallery(parent_url, parent_gallery_dir, config, logger):
+        raise RuntimeError(f"Cannot deprecate from a invalid gallery {parent_gallery_dir}")
+    _download_gallery_meta(child_url, child_gallery_dir, config, logger)
+    # move from parent_gallery_dir
+    parent_metadata_files = _get_gallery_metadata_filenames(parent_gallery_dir)
+    src = {}
+    for metafile in parent_metadata_files:
+        imgfile = metafile[0:-5]
+        metapath = os.path.join(parent_gallery_dir, META_FOLDER, metafile)
+        imgpath = os.path.join(parent_gallery_dir, imgfile)
+        with open(metapath, 'r', encoding='utf8') as fp:
+            meta = json.load(fp)
+            src[meta['image_token']] = imgpath
+    # move to child_gallery_dir
+    child_metadata_files = _get_gallery_metadata_filenames(child_gallery_dir)
+    dst = {}
+    for metafile in child_metadata_files:
+        imgfile = metafile[0:-5]
+        metapath = os.path.join(child_gallery_dir, META_FOLDER, metafile)
+        imgpath = os.path.join(child_gallery_dir, imgfile)
+        with open(metapath, 'r', encoding='utf8') as fp:
+            meta = json.load(fp)
+            dst[meta['image_token']] = imgpath
+    # move them
+    for src_image_token, src_imgpath in src.items():
+        if src_image_token in dst:
+            os.replace(src_imgpath, dst[src_image_token])
+    with open(ok_file, "w", encoding='utf8'):
+        return  # record that this gallery has been validated

ex_cd/download.py

@@ -0,0 +1,74 @@
+import os
+import ex_cd.gallery_dl_exec as gallery_dl
+from .validate import _validate_gallery, DOWNLOAD_RESUME_FILE, VALIDATE_COMPLETED_FILE
+from .collect import _load_gallery_history
+from .common import metadata_args, META_FOLDER, replace_site
+from .history import _get_gallery_parent_url, _get_gallery_dir
+from .deprecate import _deprecate_gallery_history
+from .collect import _collect_gallery_history
+
+
+def _gather_gallery_history(url, gallery_dir, config, logger):
+    this_history = {}
+    ok_file = os.path.join(gallery_dir, META_FOLDER, VALIDATE_COMPLETED_FILE)
+    if not os.path.isfile(ok_file):  # if not complete
+        this_history = _collect_gallery_history(gallery_dir, config, logger)  # collect existing history
+    parent_url = _get_gallery_parent_url(url, gallery_dir, config, logger)
+    if parent_url == '':  # if no parent
+        return this_history  # just return it
+    parent_gallery_dir = _get_gallery_dir(parent_url, config, logger)
+    return {**this_history, **_gather_gallery_history(parent_url, parent_gallery_dir, config, logger)}
+
+
+def download_gallery_history(url, gallery_dir, config, logger, history={}, depth=0):
+    """Download all the history of the gallery"""
+    parent_url = _get_gallery_parent_url(url, gallery_dir, config, logger)
+    if parent_url == '':  # if no parent
+        return _download_gallery(url, gallery_dir, config, logger, history)  # just download it
+    # if has parent
+    parent_gallery_dir = _get_gallery_dir(parent_url, config, logger)
+    if depth >= config["depth"]:
+        return _download_gallery(url, gallery_dir, config, logger,
+                                 {**history, **_gather_gallery_history(parent_url, parent_gallery_dir, config, logger)})
+    ok_file = os.path.join(gallery_dir, META_FOLDER, VALIDATE_COMPLETED_FILE)
+    if not os.path.isfile(ok_file):  # if not complete
+        history = {**history, **_collect_gallery_history(gallery_dir, config, logger)}  # collect existing history
+        # in this process, the VALIDATE_COMPLETED_FILE will be placed from old history to new
+        # if VALIDATE_COMPLETED_FILE is placed here, there is two condition:
+        # 1. all the old gallery is downloaded
+        # 2. this gallery is download by download_gallery_latest and there is old gallery not downloaded
+        # both these two conditions, this gallery should not use as history
+    download_gallery_history(parent_url, parent_gallery_dir, config, logger, history, depth+1)  # download parent
+    _deprecate_gallery_history(parent_url, parent_gallery_dir, url, gallery_dir,
+                               config, logger)  # deprecate from parent
+    return _download_gallery(url, gallery_dir, config, logger, history)  # download the rest
+
+
+def _download_gallery(url, gallery_dir, config, logger, history={}):
+    """download by gallery_dl and validate"""
+    if _validate_gallery(url, gallery_dir, config, logger):  # validate the gallery
+        return  # exit
+    _load_gallery_history(url, gallery_dir, config, logger, history)  # load existing history
+    if _validate_gallery(url, gallery_dir, config, logger):  # validate the gallery
+        return  # record that this gallery has been downloaded
+    resume_url = url
+    resume_file = os.path.join(gallery_dir, META_FOLDER, DOWNLOAD_RESUME_FILE)
+    try:
+        with open(resume_file, "r", encoding="utf8") as fp:
+            resume_url = fp.readline()
+    except:
+        pass
+    gallery_dl_exec = config["gallery-dl-exec"]
+    gallery_dl_meta_args = config["gallery-dl-meta-args"]
+    args = [
+        *gallery_dl_exec,
+        *metadata_args, *gallery_dl_meta_args, replace_site(resume_url, config)
+    ]
+    logger.debug(f"Exec: {args}")
+    returncode = gallery_dl.main(*args)
+    if _validate_gallery(url, gallery_dir, config, logger):  # validate the gallery
+        return  # record that this gallery has been downloaded
+    elif returncode != 0:
+        raise RuntimeError(f"Download failed: {url} -> {gallery_dir}")
+    else:
+        raise RuntimeError(f"Download not valid: {url} -> {gallery_dir}")

ex_cd/gallery_dl_exec.py

@@ -0,0 +1,21 @@
+import subprocess
+
+
+def main(*args):
+    return subprocess.Popen(args=args).wait()
+
+
+if __name__ == "__main__":
+    import sys
+    import os
+    os.chdir(os.path.dirname(os.path.dirname(sys.argv[0])))
+    main(
+        sys.executable, "-m", "gallery_dl",
+        "--no-download",
+        "--write-metadata",
+        "--postprocessor-option", 'directory=metadata',
+        '-v',
+        '--sleep-request', '1',
+        '-c', '.vscode/gallery-dl.config.json',
+        'https://exhentai.org/g/2752577/8ffd3778cb/'
+    )

ex_cd/history.py

@@ -0,0 +1,76 @@
+import os
+import re
+from .common import get_gallery_one_metadata, _download_gallery_metadata_and_extract_gallery_dir
+from .common import META_FOLDER
+
+CHILD_NAME = 'child.url'
+
+
+def _get_gallery_dir_by_re(url, path_re, root):
+    dirname = re.findall(path_re, url)[0]
+    return os.path.join(root, dirname)
+
+
+def _get_gallery_dir_by_gdl(url, config, logger):
+    return _download_gallery_metadata_and_extract_gallery_dir(url, config, logger)
+
+
+def _get_gallery_dir(url, config, logger):
+    try:
+        if config['gallery-root'] and config['path-re']:
+            return _get_gallery_dir_by_re(url, config['path-re'], config['gallery-root'])
+    except Exception as e:
+        logger.warn("Should parse by path-re and gallery-root, but error: %s" % e)
+    return _get_gallery_dir_by_gdl(url, config, logger)
+
+
+url2gid_re = re.compile(r"^https://e[-x]hentai.org/g/([0-9]+)/[0-9a-z]+/*$")
+
+
+def _isparent(url, gallery_dir, child_url, child_gallery_dir, config, logger):
+    metadata = get_gallery_one_metadata(url, gallery_dir, config, logger)
+    child_metadata = get_gallery_one_metadata(child_url, child_gallery_dir, config, logger)
+    return str(metadata['gid']) == re.findall(url2gid_re, child_metadata['parent'])[0]
+
+
+def get_latest_url(url, config, logger):
+    '''Find url of the latest child of `url`'''
+    gallery_dir = _get_gallery_dir(url, config, logger)
+    child_path = os.path.join(gallery_dir, META_FOLDER, CHILD_NAME)
+    if not os.path.isfile(child_path):
+        return url, gallery_dir
+    with open(child_path, encoding='utf8') as fp:
+        child_url = fp.read().strip()
+        child_gallery_dir = None
+        try:
+            if config['gallery-root'] and config['path-re']:
+                child_gallery_dir = _get_gallery_dir_by_re(child_url, config['path-re'], config['gallery-root'])
+        except Exception as e:
+            logger.warn("Should parse by path-re and gallery-root, but error: %s" % e)
+        if not _isparent(url, gallery_dir, child_url, child_gallery_dir, config, logger):  # 交叉验证
+            raise ValueError(f"{url} is not the parent of {child_url}")
+        return get_latest_url(child_url, config, logger)
+
+
+def _get_gallery_parent_url(url, gallery_dir, config, logger):
+    metadata = get_gallery_one_metadata(url, gallery_dir, config, logger)
+    if 'parent' not in metadata:
+        raise ValueError(f"No 'parent' in {url}")
+    return metadata['parent']
+
+
+def put_history_placeholder(url, gallery_dir, config, logger):
+    '''Find and tag all the parent galleries of `url`'''
+    parent_url = _get_gallery_parent_url(url, gallery_dir, config, logger)
+    if parent_url == '':
+        return
+    parent_gallery_dir = _get_gallery_dir(parent_url, config, logger)
+    child_file = os.path.join(parent_gallery_dir, META_FOLDER, CHILD_NAME)
+    os.makedirs(os.path.join(parent_gallery_dir, META_FOLDER), exist_ok=True)
+    if os.path.isfile(child_file):
+        with open(child_file, 'r', encoding='utf8') as fp:
+            if url == fp.read().strip():
+                return put_history_placeholder(parent_url, parent_gallery_dir, config, logger)
+    with open(child_file, 'w', encoding='utf8') as fp:
+        fp.write(url)
+    return put_history_placeholder(parent_url, parent_gallery_dir, config, logger)

ex_cd/meta.py

@@ -0,0 +1,123 @@
+import os
+import re
+import json
+import ex_cd.gallery_dl_exec as gallery_dl
+from .common import META_FOLDER, metadata_args, _get_gallery_metadata_filenames, get_gallery_one_metadata, replace_site
+
+
+META_DOWNLOAD_RESUME_FILE = 'MetaDownloadResume'
+
+
+def _download_gallery_meta(url, gallery_dir, config, logger):
+    """download gallery metadata by gallery_dl"""
+    if _valid_gallery_meta(url, gallery_dir, config, logger):  # validate the gallery
+        return  # exit
+    resume_url = url
+    resume_file = os.path.join(gallery_dir, META_FOLDER, META_DOWNLOAD_RESUME_FILE)
+    try:
+        with open(resume_file, "r", encoding="utf8") as fp:
+            resume_url = fp.readline()
+    except:
+        pass
+    gallery_dl_exec = config["gallery-dl-exec"]
+    gallery_dl_meta_args = config["gallery-dl-meta-args"]
+    args = [
+        *gallery_dl_exec, "--no-download", "--no-skip",
+        *metadata_args, *gallery_dl_meta_args, replace_site(resume_url, config)
+    ]
+    logger.debug(f"Exec: {args}")
+    returncode = gallery_dl.main(*args)
+    if _valid_gallery_meta(url, gallery_dir, config, logger):  # validate the gallery
+        return  # record that this gallery has been downloaded
+    elif returncode != 0:
+        raise RuntimeError(f"Download gallery meta failed: {url} -> {gallery_dir}")
+    else:
+        raise RuntimeError(f"Download gallery meta invalid: {url} -> {gallery_dir}")
+
+
+url2gid_re = re.compile(r"^https://e[-x]hentai.org/g/([0-9]+)/[0-9a-z]+/*$")
+
+
+def _url2gid_by_re(url):
+    return re.findall(url2gid_re, url)[0]
+
+
+url2site_re = re.compile(r"(^https://e[-x]hentai.org)/g/[0-9]+/[0-9a-z]+/*$")
+
+
+def _url2site_by_re(url):
+    return re.findall(url2site_re, url)[0]
+
+
+def _get_image_tokens(url, gallery_dir, config, logger):
+    # check if has enough metadata json files
+    meta = get_gallery_one_metadata(url, gallery_dir, config, logger)
+    if 'filecount' not in meta:
+        raise ValueError(f"'filecount' not in metadata")
+    metafilenames = [None] * int(meta['filecount'])
+    image_tokens = [None] * int(meta['filecount'])
+    should_deletes = [[] for _ in range(int(meta['filecount']))]
+    site, gid = _url2site_by_re(url), _url2gid_by_re(url)
+    for metafilename in _get_gallery_metadata_filenames(gallery_dir):
+        metafile = os.path.join(gallery_dir, META_FOLDER, metafilename)
+        try:
+            with open(metafile, "r", encoding="utf8") as fp:
+                meta = json.load(fp)
+                if str(meta["gid"]) == gid:
+                    num = meta["num"] - 1
+                    # sometimes there are deperated metafiles
+                    if metafilenames[num] is not None:
+                        should_deletes[num].append(metafilenames[num])
+                        should_deletes[num].append(metafilename)
+                        image_tokens[num] = metafilenames[num] = None
+                    elif len(should_deletes[num]) > 0:
+                        should_deletes[num].append(metafilename)
+                    else:
+                        image_tokens[num] = meta["image_token"]
+                        metafilenames[num] = metafilename
+        except Exception as e:
+            logger.error(f"Invalid metadata {metafile}: {e}")
+    # delete deperated metafiles
+    n = 0
+    for should_delete in should_deletes:
+        for delete in should_delete:
+            metafile = os.path.join(gallery_dir, META_FOLDER, delete)
+            if os.path.exists(metafile):
+                os.remove(metafile)
+            n += 1
+    if n > 0:
+        completefile = os.path.join(gallery_dir, META_FOLDER, META_VALIDATE_COMPLETED_FILE)
+        if os.path.exists(completefile):
+            os.remove(completefile)
+        raise ValueError(f"There are {n} deperated metafiles! just deleted! should restart meta doanload!")
+    return site, gid, image_tokens, metafilenames
+
+
+META_VALIDATE_COMPLETED_FILE = 'MetaValidateCompleted'
+
+
+def _valid_gallery_meta(url, gallery_dir, config, logger):
+    """validate the gallery metadata"""
+    ok_file = os.path.join(gallery_dir, META_FOLDER, META_VALIDATE_COMPLETED_FILE)
+    if os.path.isfile(ok_file):  # if valid
+        return True  # exit
+    # check if has enough metadata json files
+    resume_url = url
+    try:
+        site, gid, image_tokens, _ = _get_image_tokens(url, gallery_dir, config, logger)
+        for i, image_token in enumerate(image_tokens):
+            if image_token:
+                resume_url = f"{site}/s/{image_token}/{gid}-{i+1}"
+            else:
+                break
+        if None in image_tokens:
+            resume_file = os.path.join(gallery_dir, META_FOLDER, META_DOWNLOAD_RESUME_FILE)
+            with open(resume_file, "w", encoding='utf8') as fp:
+                fp.write(resume_url)
+                logger.error(f"Invalid {gallery_dir}: no enough metadata files, should resume from {resume_url}")
+            return False
+    except Exception as e:
+        logger.error(f"Invalid {gallery_dir}: {e}")
+
+    with open(ok_file, "w", encoding='utf8'):
+        return True  # record that this gallery has been validated

ex_cd/output.py

@@ -0,0 +1,33 @@
+import logging
+
+
+class Logger(logging.Logger):
+    """Custom Logger that includes extra info in log records"""
+
+    def makeRecord(self, name, level, fn, lno, msg, args, exc_info,
+                   func=None, extra=None, sinfo=None,
+                   factory=logging._logRecordFactory):
+        rv = factory(name, level, fn, lno, msg, args, exc_info, func, sinfo)
+        if extra:
+            rv.__dict__.update(extra)
+        return rv
+
+
+def initialize_logging(loglevel):
+    """Setup basic logging functionality before configfiles have been loaded"""
+    # convert levelnames to lowercase
+    for level in (10, 20, 30, 40, 50):
+        name = logging.getLevelName(level)
+        logging.addLevelName(level, name.lower())
+
+    # register custom Logging class
+    logging.Logger.manager.setLoggerClass(Logger)
+
+    # setup basic logging to stderr
+    handler = logging.StreamHandler()
+    handler.setLevel(loglevel)
+    root = logging.getLogger()
+    root.setLevel(logging.NOTSET)
+    root.addHandler(handler)
+
+    return logging.getLogger("ex-cd")

ex_cd/tools/__init__.py

@@ -0,0 +1,29 @@
+import json
+from .config import build_parser
+from .delete import delete_gallery_history
+from .latest_meta import get_latest_gallery_metadata
+from ..history import put_history_placeholder
+from ..config import read_config
+from ..output import initialize_logging
+
+
+def main():
+    parser = build_parser()
+    args = parser.parse_args()
+    logger = initialize_logging(args.loglevel)
+    config = read_config(args, logger)
+    logger.info(f"Parsed config: {args}")
+
+    if args.command == "delete":
+        delete_gallery_history(args.url, config, logger)
+
+    elif args.command == "latest-meta":
+        latest_url, gallery_dir, metadata = get_latest_gallery_metadata(args.url, config, logger)
+        put_history_placeholder(latest_url, gallery_dir, config, logger)
+        output = json.dumps(metadata, ensure_ascii=False, indent=2)
+        if args.output:
+            with open(args.output, "w", encoding="utf8") as fp:
+                fp.write(output)
+            logger.info(f"Metadata saved to {args.output}")
+        else:
+            print(output)

ex_cd/tools/__main__.py

@@ -0,0 +1,5 @@
+import sys
+import ex_cd.tools
+
+if __name__ == "__main__":
+    sys.exit(ex_cd.tools.main())

ex_cd/tools/config.py

@@ -0,0 +1,48 @@
+import argparse
+import logging
+
+
+def build_parser():
+    """Build and configure an ArgumentParser with subcommands"""
+    parser = argparse.ArgumentParser(
+        prog="ex_cd.tools",
+        description="ex-cd tools for gallery management"
+    )
+
+    # Common options
+    parser.add_argument(
+        "-c", "--config",
+        dest="config", type=str,
+        help="Path to config json file or a json string",
+        default=None,
+    )
+    parser.add_argument(
+        "-q", "--quiet",
+        dest="loglevel", default=logging.INFO,
+        action="store_const", const=logging.ERROR,
+        help="Activate quiet mode",
+    )
+    parser.add_argument(
+        "-v", "--verbose",
+        dest="loglevel",
+        action="store_const", const=logging.DEBUG,
+        help="Print various debugging information",
+    )
+
+    # Subcommands
+    subparsers = parser.add_subparsers(dest="command", required=True, help="Available commands")
+
+    # delete subcommand
+    delete_parser = subparsers.add_parser("delete", help="Delete all history of a gallery")
+    delete_parser.add_argument("url", type=str, help="URL of the gallery to delete")
+
+    # latest-meta subcommand
+    meta_parser = subparsers.add_parser("latest-meta", help="Get metadata of the latest version of a gallery")
+    meta_parser.add_argument("url", type=str, help="URL of the gallery")
+    meta_parser.add_argument(
+        "-o", "--output",
+        dest="output", type=str, default=None,
+        help="Output file path for metadata JSON (default: print to stdout)"
+    )
+
+    return parser

ex_cd/tools/delete.py

@@ -0,0 +1,119 @@
+import os
+import shutil
+from ..common import META_FOLDER
+from ..meta import META_VALIDATE_COMPLETED_FILE, META_DOWNLOAD_RESUME_FILE
+from ..validate import VALIDATE_COMPLETED_FILE, DOWNLOAD_RESUME_FILE
+from ..deprecate import DEPRECAT_COMPLETED_FILE
+from ..history import get_latest_url, put_history_placeholder, _get_gallery_dir, _get_gallery_parent_url
+
+
+def _get_all_history_dirs(url, gallery_dir, config, logger):
+    """Get all gallery directories in the history chain, from newest to oldest"""
+    dirs = [(url, gallery_dir)]
+    try:
+        parent_url = _get_gallery_parent_url(url, gallery_dir, config, logger)
+    except Exception as e:
+        logger.debug(f"No parent for {url}: {e}")
+        return dirs
+    while parent_url:
+        parent_gallery_dir = _get_gallery_dir(parent_url, config, logger)
+        dirs.append((parent_url, parent_gallery_dir))
+        try:
+            parent_url = _get_gallery_parent_url(parent_url, parent_gallery_dir, config, logger)
+        except Exception:
+            break
+    return dirs
+
+
+def _delete_gallery_content(gallery_dir, logger):
+    """Delete all content from a gallery in a resumable way"""
+    meta_folder = os.path.join(gallery_dir, META_FOLDER)
+
+    # Step 1: Delete download completion markers
+    for marker in [VALIDATE_COMPLETED_FILE, DOWNLOAD_RESUME_FILE, DEPRECAT_COMPLETED_FILE]:
+        marker_path = os.path.join(meta_folder, marker)
+        if os.path.isfile(marker_path):
+            os.remove(marker_path)
+            logger.debug(f"Deleted marker: {marker_path}")
+
+    # Step 2: Delete all files outside .metadata (images)
+    if os.path.isdir(gallery_dir):
+        for item in os.listdir(gallery_dir):
+            if item == META_FOLDER:
+                continue
+            item_path = os.path.join(gallery_dir, item)
+            if os.path.isfile(item_path):
+                os.remove(item_path)
+                logger.debug(f"Deleted file: {item_path}")
+            elif os.path.isdir(item_path):
+                shutil.rmtree(item_path)
+                logger.debug(f"Deleted dir: {item_path}")
+
+    # Step 3: Delete meta completion markers
+    for marker in [META_VALIDATE_COMPLETED_FILE, META_DOWNLOAD_RESUME_FILE]:
+        marker_path = os.path.join(meta_folder, marker)
+        if os.path.isfile(marker_path):
+            os.remove(marker_path)
+            logger.debug(f"Deleted meta marker: {marker_path}")
+
+    # Step 4: Delete JSON files in .metadata
+    if os.path.isdir(meta_folder):
+        for item in os.listdir(meta_folder):
+            if item.endswith('.json'):
+                item_path = os.path.join(meta_folder, item)
+                os.remove(item_path)
+                logger.debug(f"Deleted json: {item_path}")
+
+    # Step 5: Delete remaining files in .metadata (like child.url)
+    if os.path.isdir(meta_folder):
+        for item in os.listdir(meta_folder):
+            item_path = os.path.join(meta_folder, item)
+            if os.path.isfile(item_path):
+                os.remove(item_path)
+                logger.debug(f"Deleted remaining: {item_path}")
+
+    # Step 6: Delete the .metadata folder
+    if os.path.isdir(meta_folder):
+        try:
+            os.rmdir(meta_folder)
+        except OSError:
+            shutil.rmtree(meta_folder)
+        logger.debug(f"Deleted metadata folder: {meta_folder}")
+
+    # Step 7: Delete the gallery folder itself
+    if os.path.isdir(gallery_dir):
+        try:
+            os.rmdir(gallery_dir)
+        except OSError:
+            shutil.rmtree(gallery_dir)
+        logger.debug(f"Deleted gallery folder: {gallery_dir}")
+
+
+def delete_gallery_history(url, config, logger):
+    """Delete all history of a gallery
+
+    Args:
+        url: URL of the gallery (can be any version in the history chain)
+        config: Configuration dict
+        logger: Logger instance
+    """
+    # Step 1: Get the latest URL and create placeholder chain
+    url, gallery_dir = get_latest_url(url, config, logger)
+    logger.info(f"Latest gallery: {url} -> {gallery_dir}")
+    put_history_placeholder(url, gallery_dir, config, logger)
+
+    # Step 2: Collect all gallery directories (newest to oldest)
+    all_dirs = _get_all_history_dirs(url, gallery_dir, config, logger)
+    logger.info(f"Found {len(all_dirs)} galleries to delete:")
+    for i, (dir_url, dir_path) in enumerate(all_dirs):
+        logger.info(f"  [{i+1}] {dir_path}")
+
+    # Step 3: Delete from newest to oldest
+    for dir_url, dir_path in all_dirs:
+        if os.path.isdir(dir_path):
+            logger.info(f"Deleting: {dir_path}")
+            _delete_gallery_content(dir_path, logger)
+        else:
+            logger.debug(f"Already deleted: {dir_path}")
+
+    logger.info("Delete completed")

ex_cd/tools/latest_meta.py

@@ -0,0 +1,24 @@
+from ..common import get_gallery_one_metadata
+from ..history import get_latest_url
+
+
+def get_latest_gallery_metadata(url, config, logger):
+    """Get metadata of the latest version of a gallery
+
+    Args:
+        url: URL of the gallery (can be any version in the history chain)
+        config: Configuration dict
+        logger: Logger instance
+
+    Returns:
+        tuple: (latest_url, gallery_dir, metadata)
+    """
+    # Step 1: Get the latest URL
+    latest_url, gallery_dir = get_latest_url(url, config, logger)
+    logger.info(f"Latest gallery: {latest_url} -> {gallery_dir}")
+
+    # Step 2: Get metadata
+    metadata = get_gallery_one_metadata(latest_url, gallery_dir, config, logger)
+    logger.info(f"Got metadata for gid={metadata.get('gid')}, title={metadata.get('title')}")
+
+    return latest_url, gallery_dir, metadata

ex_cd/validate.py

@@ -0,0 +1,80 @@
+import os
+import re
+import hashlib
+from .common import META_FOLDER
+from .meta import _valid_gallery_meta, _get_image_tokens
+
+
+VALIDATE_COMPLETED_FILE = 'ValidateCompleted'
+DOWNLOAD_RESUME_FILE = 'DownloadResume'
+
+
+def _validate_gallery(url, gallery_dir, config, logger):
+    """validate the gallery"""
+    ok_file = os.path.join(gallery_dir, META_FOLDER, VALIDATE_COMPLETED_FILE)
+    if os.path.isfile(ok_file):  # if valid
+        return True  # exit
+
+    # check if has enough metadata json files
+    if not _valid_gallery_meta(url, gallery_dir, config, logger):
+        return False
+    site, gid, image_tokens, metafiles = _get_image_tokens(url, gallery_dir, config, logger)
+
+    # check if has enough image files
+    images = []
+    for img in os.listdir(gallery_dir):
+        if img == META_FOLDER:
+            continue
+        images.append(img)
+
+    resume_file = os.path.join(gallery_dir, META_FOLDER, DOWNLOAD_RESUME_FILE)
+    start_from = None
+    try:
+        with open(resume_file, "r", encoding="utf8") as fp:
+            exist_resume_url = fp.readline()
+            start_from_re = re.findall(fr"^https://e[-x]hentai.org/s/[0-9a-z]+/{gid}-([0-9]+)$", exist_resume_url)
+            if len(start_from_re) > 0:
+                start_from = int(start_from_re[0])
+    except:
+        pass
+
+    resume_url = url
+    ok = True
+    # check if image content SHA1 match image_token
+    for i, (image_token, metafile) in enumerate(zip(image_tokens, metafiles)):
+        img = metafile[0:-5]
+        if img not in images:
+            logger.error(f"Invalid {gallery_dir}: no image {img} for {metafile}")
+            resume_url = f"{site}/s/{image_token}/{gid}-{i+1}"
+            ok = False
+            break
+        # check resume
+        if start_from is not None:
+            if i+1 < start_from:
+                logger.debug(f"Skip validate {img}: start from {start_from}, current {i+1}")
+                continue
+        # compare image_token
+        imgfile = os.path.join(gallery_dir, img)
+        try:
+            with open(imgfile, mode="rb") as fp:
+                sha1 = hashlib.sha1(fp.read()).hexdigest()
+            if image_token != sha1[0:10]:
+                logger.error(f"Invalid {imgfile}: image token not match, {image_token} != {sha1}, delete the image")
+                os.remove(imgfile)
+                resume_url = f"{site}/s/{image_token}/{gid}-{i+1}"
+                ok = False
+                break
+        except Exception as e:
+            logger.error(f"Invalid {imgfile}: cannot compare token, {e}, delete the image")
+            os.remove(imgfile)
+            resume_url = f"{site}/s/{image_token}/{gid}-{i+1}"
+            ok = False
+            break
+    if ok:
+        with open(ok_file, "w", encoding='utf8'):
+            return True  # record that this gallery has been validated
+    else:
+        with open(resume_file, "w", encoding='utf8') as fp:
+            fp.write(resume_url)
+            logger.error(f"Invalid {gallery_dir}: no enough images, should resume from {resume_url}")
+        return False

ex_cd-1.17.0.dist-info/METADATA

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: ex_cd
+Version: 1.17.0
+Summary: 高效下载E站gallery的所有历史数据
+Author-email: yindaheng98 <yindaheng98@163.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yindaheng98/ex-cd
+Project-URL: Repository, https://github.com/yindaheng98/ex-cd
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: gallery-dl
+Dynamic: license-file
+
+# ex-cd
+
+高效下载E站gallery的所有历史数据
+
+* 尽量避免集中数据库，能放进文件夹的数据尽量放进文件夹
+* 尽量减少请求操作，能只用读文件的尽量只读文件
+* 尽量减少文件读写操作，能只用读文件列表的尽量只读文件列表
+
+## Usage
+
+```sh
+python -m ex_cd -c .vscode/config.json https://exhentai.org/g/2635845/ecbc9d9681/
+```
+
+```sh
+python -m ex_cd -c <a json string> https://exhentai.org/g/2635845/ecbc9d9681/
+```
+
+You can see the example config file: `.vscode/config.json`
+
+You can also set an `EXCD_CONFIG_FILE` env to specify a file, and the config in this file will be overridden by the config specified by `-c`:
+
+```sh
+export EXCD_CONFIG_FILE=".vscode/config.json"
+python -m ex_cd -c <a json string> https://exhentai.org/g/2635845/ecbc9d9681/
+```
+
+You can see the example command line: `.vscode/launch.json`
+
+## How does it work?
+
+### URL更新
+
+```mermaid
+flowchart TD
+
+UrlCheck1[输入URL] --> UrlCheck2(从URL中提取目标文件夹路径\ngallery-dl --dump-json '%s' --range 0\n< gallery_path >)
+UrlCheck2 --> UrlCheck3(检查是否是过时内容\n< gallery_path >/metadata/child.url是否存在)
+UrlCheck3 --> UrlCheck4{child.url存在 ?}
+UrlCheck4 -->|是| UrlCheck5(按照child.url更新URL为最新) --> UrlCheck1
+UrlCheck4 -->|否| MetaCheck1[结束\n返回最新URL] --> OldPlacehold[后台执行\n过时元数据占位]
+```
+
+### 过时元数据占位
+
+```mermaid
+flowchart TD
+
+UrlCheck1[输入URL] --> UrlCheck2(从URL中提取目标文件夹路径\ngallery-dl --dump-json '%s' --range 0\n< gallery_path >) --> MetaCheck1(检查元数据文件存在性\n< gallery_path >/metadata/*.json 文件存在)
+MetaCheck1 --> MetaCheck2{元数据文件存在 ?}
+MetaCheck2 -->|是| MetaCheck3(检查parent存在性\n元数据文件中存在parent字段) --> MetaCheck4{parent字段存在 ?} -->|是| UrlCheck3(按照parent字段更新URL为过时URL) --> UrlCheck1
+UrlCheck3 --> OldPlacehold1(从URL中提取目标文件夹路径) --> OldPlacehold2[在目标文件夹路径下放置child.url]
+MetaCheck2 -->|否| MetaCheck5(下载一个元数据\ngallery-dl -v '%s' --no-download --range 0)
+MetaCheck4 -->|否| MetaCheck5 --> MetaCheck1
+```
+
+### 元数据下载
+
+```mermaid
+flowchart TD
+
+UrlCheck1[输入URL] --> URL更新 --> UrlCheck2(从URL中提取目标文件夹路径\ngallery-dl --dump-json '%s' --range 0\n< gallery_path >) --> MetaCheck1(检查元数据文件存在性\n< gallery_path >/metadata/*.json 文件存在)
+MetaCheck1 --> MetaCheck2{元数据文件存在 ?}
+MetaCheck2 -->|是| MetaCheck4(检查元数据完整性\n< gallery_path >/metadata/*.json 每个文件都可json解析\n其中 'filecount' 值和 < gallery_path >/metadata/*.json 文件数相等)
+MetaCheck4 --> MetaCheck5{元数据文件完整 ?}
+MetaCheck5 -->|否| MetaCheck3
+MetaCheck2 -->|否| MetaCheck3(下载元数据 gallery-dl -v '%s' --no-download) --> MetaCheck1
+MetaCheck5 -->|是| MetaCheck6[结束]
+MetaCheck3 --> MetaCheck6
+```
+
+### 图片下载
+
+!!!!!!!!! TODO: 确定是最新之后，元数据下载和图片下载同时进行 !!!!!!!!!
+
+```mermaid
+flowchart TD
+UrlCheck1[输入URL] --> UrlCheck2[URL更新] --> ImgCheck1(检查图片文件存在性: \n< gallery_path >/metadata/*.json 对应的每一个图片文件都存在) --> ImgCheck2{图片文件均存在 ?} -->|是| ImgCheck3(检查图片文件内容: \n< gallery_path >/metadata/*.json 对应的图片文件的SHA1值都与< image_token >字段值相符) --> ImgCheck4{图片文件内容均符合image_token ?} -->|是| ImgCheck5[结束]
+ImgCheck2 -->|否| Download(调用gallery-dl下载)
+ImgCheck4 -->|否| Download
+Download --> ImgCheck5
+```

ex_cd-1.17.0.dist-info/RECORD

@@ -0,0 +1,22 @@
+ex_cd/__init__.py,sha256=v5oliHtuQqbpMTgJM2tpDB6_pRHaiCvU-bKEfwjFd3U,989
+ex_cd/__main__.py,sha256=RFTiY-4W5PRgmFW-vTX36xXpg0zkat1kPOgnuicj8dk,78
+ex_cd/collect.py,sha256=ZMVGiPhi_T05MqSb-aT4RIcjGgsjPD6RknHiQmH3YSI,2375
+ex_cd/common.py,sha256=q2VJAfPyQKkJi_LM-vhmk1MlLbCsCDKY7nVMLR1bD6k,3544
+ex_cd/config.py,sha256=UpbE0WIN81U_llVSFZBuBzssWiQpR46WXMpkTGmHRKU,2903
+ex_cd/deprecate.py,sha256=96PWa88jaa4e6tkb8cLDHZfcfbyFpDBr6YKNIOAEvBU,2023
+ex_cd/download.py,sha256=CVTT6dIdCnflry4BlB-1f-uFRRe41C1AXqY6H4th_7g,4061
+ex_cd/gallery_dl_exec.py,sha256=czIO6ea_9spFdt0i5Vrb_9DKxOh5k36qA-WFh8wLdRw,517
+ex_cd/history.py,sha256=JjJzSRDjuUiOVlP1cqbhrlXuIf2QyAZFvye936w8ChU,3270
+ex_cd/meta.py,sha256=mQKEWBAgsmhiojBPfkwE9xL6sUlW9ach4mbmpX0p1YY,5062
+ex_cd/output.py,sha256=eOoWIsYEypxDcZncf-jrm-9HODRi_CnVWbaJNHOLrB4,1052
+ex_cd/validate.py,sha256=Y2ApFzrSUaQMryV1gRuiBXMECKO5dvxPRrC3O60Rh6Q,3046
+ex_cd/tools/__init__.py,sha256=ARvxJXlhJ0kgV4vhCGNgFpV32s-Xp6sO87Piwr4qjrs,1053
+ex_cd/tools/__main__.py,sha256=yhxacDeHmwg_y9Xn_U3G4rTOlqIKfQ6xREEPdWXMY5k,91
+ex_cd/tools/config.py,sha256=uwr2ngbfkvl6Dcc1GuhXJrSjo3YSXWX9V5sW5uaXklA,1552
+ex_cd/tools/delete.py,sha256=xisoPW7Hcv4SEiHVh8SyI93GIFFlwOHjq5BoPillw14,4692
+ex_cd/tools/latest_meta.py,sha256=-NdmUuCSLrdeS0_tnlPaR0dFCBCXoo76DMbpGMALfqI,833
+ex_cd-1.17.0.dist-info/licenses/LICENSE,sha256=-OPEaaNL-VWb8CSDMMCDftVBnZkSlWIN9zn9BnqKld8,1067
+ex_cd-1.17.0.dist-info/METADATA,sha256=U9Q9dou5fd4t5R40kajcynq6cPnC1pD4Cmd-t7SAuxs,4245
+ex_cd-1.17.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ex_cd-1.17.0.dist-info/top_level.txt,sha256=MIjfJbCr3rAXXTqGS9pAN1nALoq1hNP4VFivF78A_z0,6
+ex_cd-1.17.0.dist-info/RECORD,,

ex_cd-1.17.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ex_cd-1.17.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Howard Yin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ex_cd-1.17.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ex_cd