Skip to content

tabular_editor

This has a Tabular_Editor class which will download TE2 from a default location.

Or you can input your own location.

TabularEditor

Setting Tabular_Editor Class for future work.

Mainly runs download_tabular_editor()

Source code in pytabular/tabular_editor.py 
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
class TabularEditor:
    """Setting Tabular_Editor Class for future work.

    Mainly runs `download_tabular_editor()`
    """

    def __init__(self, exe_file_path: str = "Default") -> None:
        """Init for `TabularEditor()` class.

        This is mostly a placeholder right now.
        But useful if you want an easy way to download TE2.

        Args:
            exe_file_path (str, optional): File path where TE2 lives. Defaults to "Default".
                If "Default", it will run `download_tabular_editor()`
                and download from github.
        """
        logger.debug(f"Initializing Tabular Editor Class:: {exe_file_path}")
        if exe_file_path == "Default":
            self.exe: str = download_tabular_editor()
        else:
            self.exe: str = exe_file_path
        pass

__init__(exe_file_path='Default')

Init for TabularEditor() class.

This is mostly a placeholder right now. But useful if you want an easy way to download TE2.

Parameters:

Name Type Description Default
exe_file_path str

File path where TE2 lives. Defaults to "Default". If "Default", it will run download_tabular_editor() and download from github.

 'Default'
Source code in pytabular/tabular_editor.py 
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
def __init__(self, exe_file_path: str = "Default") -> None:
    """Init for `TabularEditor()` class.

    This is mostly a placeholder right now.
    But useful if you want an easy way to download TE2.

    Args:
        exe_file_path (str, optional): File path where TE2 lives. Defaults to "Default".
            If "Default", it will run `download_tabular_editor()`
            and download from github.
    """
    logger.debug(f"Initializing Tabular Editor Class:: {exe_file_path}")
    if exe_file_path == "Default":
        self.exe: str = download_tabular_editor()
    else:
        self.exe: str = exe_file_path
    pass

download_tabular_editor(download_location='https://github.com/TabularEditor/TabularEditor/releases/download/2.16.7/TabularEditor.Portable.zip', folder='Tabular_Editor_2', auto_remove=True)

Runs a request.get() to retrieve the zip file from web.

Will unzip response and store in directory. Will also register the removal of the new directory and files when exiting program.

Parameters:

Name Type Description Default
download_location str

File path for zip of Tabular Editor 2. See code args for default download url.

 'https://github.com/TabularEditor/TabularEditor/releases/download/2.16.7/TabularEditor.Portable.zip'
folder str

New Folder Location. Defaults to "Tabular_Editor_2".

 'Tabular_Editor_2'
auto_remove bool

Boolean to determine auto removal of files once script exits. Defaults to True.

 True

Returns:

Name Type Description
str str

File path of TabularEditor.exe
Source code in pytabular/tabular_editor.py 
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
def download_tabular_editor(
    download_location: str = (
        "https://github.com/TabularEditor/TabularEditor/releases/download/2.16.7/TabularEditor.Portable.zip"  # noqa: E501
    ),
    folder: str = "Tabular_Editor_2",
    auto_remove=True,
) -> str:
    """Runs a request.get() to retrieve the zip file from web.

    Will unzip response and store in directory.
    Will also register the removal of the new directory
    and files when exiting program.

    Args:
            download_location (str, optional): File path for zip of Tabular Editor 2.
                    See code args for default download url.
            folder (str, optional): New Folder Location. Defaults to "Tabular_Editor_2".
            auto_remove (bool, optional): Boolean to determine auto
                    removal of files once script exits. Defaults to True.

    Returns:
            str: File path of TabularEditor.exe
    """
    logger.info("Downloading Tabular Editor 2...")
    logger.info(f"From... {download_location}")
    folder_location = os.path.join(os.getcwd(), folder)
    response = r.get(download_location)
    file_location = f"{os.getcwd()}\\{download_location.split('/')[-1]}"
    with open(file_location, "wb") as te2_zip:
        te2_zip.write(response.content)
    with z.ZipFile(file_location) as zipper:
        zipper.extractall(path=folder_location)
    logger.debug("Removing Zip File...")
    os.remove(file_location)
    logger.info(f"Tabular Editor Downloaded and Extracted to {folder_location}")
    if auto_remove:
        logger.debug(f"Registering removal on termination... For {folder_location}")
        atexit.register(remove_folder_and_contents, folder_location)
    return f"{folder_location}\\TabularEditor.exe"