सामग्री पर जाएं

के लिए संदर्भ ultralytics/utils/files.py

नोट

यह फ़ाइल यहाँ उपलब्ध है https://github.com/ultralytics/ultralytics/बूँद/मुख्य/ultralytics/utils/files.py का उपयोग करें। यदि आप कोई समस्या देखते हैं तो कृपया पुल अनुरोध का योगदान करके इसे ठीक करने में मदद करें 🛠️। 🙏 धन्यवाद !



ultralytics.utils.files.WorkingDirectory

का रूप: ContextDecorator

उपयोग: @WorkingDirectory (dir) डेकोरेटर या 'WorkingDirectory (dir) के साथ:' संदर्भ प्रबंधक।

में स्रोत कोड ultralytics/utils/files.py
13 बांग्लादेश बांग्लादेश 13 बांग्लादेश 15 16 17 18192021 22 2324252627
class WorkingDirectory(contextlib.ContextDecorator):
    """Usage: @WorkingDirectory(dir) decorator or 'with WorkingDirectory(dir):' context manager."""

    def __init__(self, new_dir):
        """Sets the working directory to 'new_dir' upon instantiation."""
        self.dir = new_dir  # new dir
        self.cwd = Path.cwd().resolve()  # current dir

    def __enter__(self):
        """Changes the current directory to the specified directory."""
        os.chdir(self.dir)

    def __exit__(self, exc_type, exc_val, exc_tb):  # noqa
        """Restore the current working directory on context exit."""
        os.chdir(self.cwd)

__enter__()

वर्तमान निर्देशिका को निर्दिष्ट निर्देशिका में परिवर्तित करता है.

में स्रोत कोड ultralytics/utils/files.py
def __enter__(self):
    """Changes the current directory to the specified directory."""
    os.chdir(self.dir)

__exit__(exc_type, exc_val, exc_tb)

संदर्भ निकास पर वर्तमान कार्यशील निर्देशिका को पुनर्स्थापित करें।

में स्रोत कोड ultralytics/utils/files.py
def __exit__(self, exc_type, exc_val, exc_tb):  # noqa
    """Restore the current working directory on context exit."""
    os.chdir(self.cwd)

__init__(new_dir)

कार्य निर्देशिका को तत्काल 'new_dir' पर सेट करता है।

में स्रोत कोड ultralytics/utils/files.py
def __init__(self, new_dir):
    """Sets the working directory to 'new_dir' upon instantiation."""
    self.dir = new_dir  # new dir
    self.cwd = Path.cwd().resolve()  # current dir



ultralytics.utils.files.spaces_in_path(path)

संदर्भ प्रबंधक उनके नाम में रिक्त स्थान के साथ पथ को संभालने के लिए। यदि किसी पथ में रिक्त स्थान हैं, तो यह उन्हें अंडरस्कोर करता है, फ़ाइल/निर्देशिका को नए पथ पर कॉपी करता है, संदर्भ कोड ब्लॉक निष्पादित करता है, फिर फ़ाइल/निर्देशिका को उसके मूल स्थान पर वापस लाएं।

पैरामीटर:

नाम प्रकार विवरण: __________ चूक
path str | Path

मूल पथ।

आवश्यक

पैदावार:

प्रकार विवरण: __________
Path

रिक्त स्थान के साथ अस्थायी पथ अंडरस्कोर द्वारा प्रतिस्थापित किया गया है यदि रिक्त स्थान मौजूद थे, अन्यथा मूल पथ।

उदाहरण
with ultralytics.utils.files import spaces_in_path

with spaces_in_path('/path/with spaces') as new_path:
    # Your code here
में स्रोत कोड ultralytics/utils/files.py
30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 5152 53 54 5556575859 60 61 62 6364 65 66 67 68 69 70 71 72 737475 76777879 808182
@contextmanager
def spaces_in_path(path):
    """
    Context manager to handle paths with spaces in their names. If a path contains spaces, it replaces them with
    underscores, copies the file/directory to the new path, executes the context code block, then copies the
    file/directory back to its original location.

    Args:
        path (str | Path): The original path.

    Yields:
        (Path): Temporary path with spaces replaced by underscores if spaces were present, otherwise the original path.

    Example:
        ```python
        with ultralytics.utils.files import spaces_in_path

        with spaces_in_path('/path/with spaces') as new_path:
            # Your code here
        ```
    """

    # If path has spaces, replace them with underscores
    if " " in str(path):
        string = isinstance(path, str)  # input type
        path = Path(path)

        # Create a temporary directory and construct the new path
        with tempfile.TemporaryDirectory() as tmp_dir:
            tmp_path = Path(tmp_dir) / path.name.replace(" ", "_")

            # Copy file/directory
            if path.is_dir():
                # tmp_path.mkdir(parents=True, exist_ok=True)
                shutil.copytree(path, tmp_path)
            elif path.is_file():
                tmp_path.parent.mkdir(parents=True, exist_ok=True)
                shutil.copy2(path, tmp_path)

            try:
                # Yield the temporary path
                yield str(tmp_path) if string else tmp_path

            finally:
                # Copy file/directory back
                if tmp_path.is_dir():
                    shutil.copytree(tmp_path, path, dirs_exist_ok=True)
                elif tmp_path.is_file():
                    shutil.copy2(tmp_path, path)  # Copy back the file

    else:
        # If there are no spaces, just yield the original path
        yield path



ultralytics.utils.files.increment_path(path, exist_ok=False, sep='', mkdir=False)

एक फ़ाइल या निर्देशिका पथ को बढ़ाता है, यानी रन/एक्सपी --> रन/एक्सपी{सितंबर}2, रन/एक्सपी{सितंबर}3, ... आदि।

यदि पथ मौजूद है और exist_ok True पर सेट नहीं है, तो पथ को एक संख्या और sep को जोड़कर बढ़ाया जाएगा रास्ते का अंत। यदि पथ एक फ़ाइल है, तो फ़ाइल एक्सटेंशन संरक्षित किया जाएगा। यदि पथ एक निर्देशिका है, तो नंबर सीधे पथ के अंत में जोड़ा जाएगा। यदि mkdir को True पर सेट किया गया है, तो पथ को एक के रूप में बनाया जाएगा निर्देशिका यदि यह पहले से मौजूद नहीं है।

पैरामीटर:

नाम प्रकार विवरण: __________ चूक
path (str, Path)

वेतन वृद्धि का मार्ग।

आवश्यक
exist_ok bool

यदि सत्य है, तो पथ को बढ़ाया नहीं जाएगा और जैसा है वैसा ही लौटाया जाएगा। डिफ़ॉल्ट रूप से गलत है.

False
sep str

पथ और वृद्धि संख्या के बीच उपयोग करने के लिए विभाजक। '' के लिए डिफ़ॉल्ट।

''
mkdir bool

यदि कोई निर्देशिका मौजूद नहीं है तो उसे बनाएँ. डिफ़ॉल्ट रूप से गलत है.

False

देता:

प्रकार विवरण: __________
Path

बढ़ा हुआ पथ।

में स्रोत कोड ultralytics/utils/files.py
85 86 87 88 89 90 91 92 93 94 95 96 97 98  99 100 101 102 103 104 105  106 107   108  109  110 111  112 113 114 115 116 117  
def increment_path(path, exist_ok=False, sep="", mkdir=False):
    """
    Increments a file or directory path, i.e. runs/exp --> runs/exp{sep}2, runs/exp{sep}3, ... etc.

    If the path exists and exist_ok is not set to True, the path will be incremented by appending a number and sep to
    the end of the path. If the path is a file, the file extension will be preserved. If the path is a directory, the
    number will be appended directly to the end of the path. If mkdir is set to True, the path will be created as a
    directory if it does not already exist.

    Args:
        path (str, pathlib.Path): Path to increment.
        exist_ok (bool, optional): If True, the path will not be incremented and returned as-is. Defaults to False.
        sep (str, optional): Separator to use between the path and the incrementation number. Defaults to ''.
        mkdir (bool, optional): Create a directory if it does not exist. Defaults to False.

    Returns:
        (pathlib.Path): Incremented path.
    """
    path = Path(path)  # os-agnostic
    if path.exists() and not exist_ok:
        path, suffix = (path.with_suffix(""), path.suffix) if path.is_file() else (path, "")

        # Method 1
        for n in range(2, 9999):
            p = f"{path}{sep}{n}{suffix}"  # increment path
            if not os.path.exists(p):
                break
        path = Path(p)

    if mkdir:
        path.mkdir(parents=True, exist_ok=True)  # make directory

    return path



ultralytics.utils.files.file_age(path=__file__)

अंतिम फ़ाइल अद्यतन के बाद से वापसी के दिन।

में स्रोत कोड ultralytics/utils/files.py
120 121 122 123
def file_age(path=__file__):
    """Return days since last file update."""
    dt = datetime.now() - datetime.fromtimestamp(Path(path).stat().st_mtime)  # delta
    return dt.days  # + dt.seconds / 86400  # fractional days



ultralytics.utils.files.file_date(path=__file__)

मानव-पठनीय फ़ाइल संशोधन तिथि, यानी '2021-3-26' लौटाएं।

में स्रोत कोड ultralytics/utils/files.py
126 127 128 129
def file_date(path=__file__):
    """Return human-readable file modification date, i.e. '2021-3-26'."""
    t = datetime.fromtimestamp(Path(path).stat().st_mtime)
    return f"{t.year}-{t.month}-{t.day}"



ultralytics.utils.files.file_size(path)

फ़ाइल/dir आकार (MB) लौटाएं।

में स्रोत कोड ultralytics/utils/files.py
132 133 134 135 136 137 138139 140 141 
def file_size(path):
    """Return file/dir size (MB)."""
    if isinstance(path, (str, Path)):
        mb = 1 << 20  # bytes to MiB (1024 ** 2)
        path = Path(path)
        if path.is_file():
            return path.stat().st_size / mb
        elif path.is_dir():
            return sum(f.stat().st_size for f in path.glob("**/*") if f.is_file()) / mb
    return 0.0



ultralytics.utils.files.get_latest_run(search_dir='.')

/runs में सबसे हाल के 'last.pt' के लिए वापसी पथ (यानी --से फिर से शुरू)।

में स्रोत कोड ultralytics/utils/files.py
144 145 146 147
def get_latest_run(search_dir="."):
    """Return path to most recent 'last.pt' in /runs (i.e. to --resume from)."""
    last_list = glob.glob(f"{search_dir}/**/last*.pt", recursive=True)
    return max(last_list, key=os.path.getctime) if last_list else ""





2023-11-12 बनाया गया, अपडेट किया गया 2023-11-25
लेखक: ग्लेन-जोचर (3), लाफिंग-क्यू (1)