Skip to content

Meta Info Utils

delete_fake_files()

Recursively searches for and handles files with a specific version substring within the target repository. Empty files are deleted, while non-empty ones are renamed to their original filenames, effectively restoring previous versions. Informative messages are printed detailing each file action.

This method recursively searches for files ending with a specific substring (defined by latest_verison_substring) within the target repository directory. If a corresponding original file exists, it's deleted. Empty fake files are removed, and non-empty ones are renamed to their original names. Prints messages indicating deleted or recovered files.

Returns:

Type Description

None
Source code in repo_agent/utils/meta_info_utils.py 
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
def delete_fake_files():
    """
    Recursively searches for and handles files with a specific version substring within the target repository. Empty files are deleted, while non-empty ones are renamed to their original filenames, effectively restoring previous versions. Informative messages are printed detailing each file action.

    This method recursively searches for files ending with a specific substring
    (defined by `latest_verison_substring`) within the target repository directory.
    If a corresponding original file exists, it's deleted. Empty fake files are removed,
    and non-empty ones are renamed to their original names.  Prints messages indicating
    deleted or recovered files.

    Args:
        None

    Returns:
        None

    """

    setting = SettingsManager.get_setting()

    def gci(filepath):
        files = os.listdir(filepath)
        for fi in files:
            fi_d = os.path.join(filepath, fi)
            if os.path.isdir(fi_d):
                gci(fi_d)
            elif fi_d.endswith(latest_verison_substring):
                origin_name = fi_d.replace(latest_verison_substring, ".py")
                if os.path.exists(origin_name):
                    os.remove(origin_name)
                if os.path.getsize(fi_d) == 0:
                    print(
                        f"{Fore.LIGHTRED_EX}[Deleting Temp File]: {Style.RESET_ALL}{fi_d[len(str(setting.project.target_repo)):]}, {origin_name[len(str(setting.project.target_repo)):]}"
                    )
                    os.remove(fi_d)
                else:
                    print(
                        f"{Fore.LIGHTRED_EX}[Recovering Latest Version]: {Style.RESET_ALL}{origin_name[len(str(setting.project.target_repo)):]} <- {fi_d[len(str(setting.project.target_repo)):]}"
                    )
                    os.rename(fi_d, origin_name)

    gci(setting.project.target_repo)

make_fake_files()

Generates temporary copies of modified or deleted Python files and identifies untracked Python files, providing a mapping between original and latest version paths.

This method first deletes any existing fake files, then identifies untracked .py files and unstaged additions/modifications/deletions. It renames or creates temporary versions of modified/deleted files with a version suffix, effectively creating "fake" copies for documentation purposes. It also skips untracked Python files.

Returns:

Name Type Description
tuple

A tuple containing a dictionary mapping original file paths to their corresponding latest version paths and a list of skipped untracked .py files.
Source code in repo_agent/utils/meta_info_utils.py 
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
def make_fake_files():
    """
    Generates temporary copies of modified or deleted Python files and identifies untracked Python files, providing a mapping between original and latest version paths.

    This method first deletes any existing fake files, then identifies
    untracked .py files and unstaged additions/modifications/deletions. It
    renames or creates temporary versions of modified/deleted files with a
    version suffix, effectively creating "fake" copies for documentation
    purposes.  It also skips untracked Python files.

    Args:
        None

    Returns:
        tuple: A tuple containing a dictionary mapping original file paths to
               their corresponding latest version paths and a list of skipped
               untracked .py files.


    """

    delete_fake_files()
    setting = SettingsManager.get_setting()
    repo = git.Repo(setting.project.target_repo)
    unstaged_changes = repo.index.diff(None)
    untracked_files = repo.untracked_files
    jump_files = []
    for file_name in untracked_files:
        if file_name.endswith(".py"):
            print(
                f"{Fore.LIGHTMAGENTA_EX}[SKIP untracked files]: {Style.RESET_ALL}{file_name}"
            )
            jump_files.append(file_name)
    for diff_file in unstaged_changes.iter_change_type("A"):
        if diff_file.a_path.endswith(latest_verison_substring):
            logger.error(
                "FAKE_FILE_IN_GIT_STATUS detected! suggest to use `delete_fake_files` and re-generate document"
            )
            exit()
        jump_files.append(diff_file.a_path)
    file_path_reflections = {}
    for diff_file in itertools.chain(
        unstaged_changes.iter_change_type("M"), unstaged_changes.iter_change_type("D")
    ):
        if diff_file.a_path.endswith(latest_verison_substring):
            logger.error(
                "FAKE_FILE_IN_GIT_STATUS detected! suggest to use `delete_fake_files` and re-generate document"
            )
            exit()
        now_file_path = diff_file.a_path
        if now_file_path.endswith(".py"):
            raw_file_content = diff_file.a_blob.data_stream.read().decode("utf-8")
            latest_file_path = now_file_path[:-3] + latest_verison_substring
            if os.path.exists(os.path.join(setting.project.target_repo, now_file_path)):
                os.rename(
                    os.path.join(setting.project.target_repo, now_file_path),
                    os.path.join(setting.project.target_repo, latest_file_path),
                )
                print(
                    f"{Fore.LIGHTMAGENTA_EX}[Save Latest Version of Code]: {Style.RESET_ALL}{now_file_path} -> {latest_file_path}"
                )
            else:
                print(
                    f"{Fore.LIGHTMAGENTA_EX}[Create Temp-File for Deleted(But not Staged) Files]: {Style.RESET_ALL}{now_file_path} -> {latest_file_path}"
                )
                try:
                    with open(
                        os.path.join(setting.project.target_repo, latest_file_path),
                        "w",
                        encoding="utf-8",
                    ) as writer:
                        pass
                except:
                    pass
            try:
                with open(
                    os.path.join(setting.project.target_repo, now_file_path),
                    "w",
                    encoding="utf-8",
                ) as writer:
                    writer.write(raw_file_content)
            except:
                pass
            file_path_reflections[now_file_path] = latest_file_path
    return (file_path_reflections, jump_files)