ptrack

commit 1b80b36aa234b1be35ba6513c0e2ece734791476

Author: Connor Etherington <[email protected]>

Date:   Tue Sep 19 23:12:10 2023 +0200

    Auto-Commit Update - 20230919

---

 PKGBUILD                             |   4 +-

 README.md                            |   2 +-

 build/lib/ptrack/__init__.py         |  16 +++

 build/lib/ptrack/main.py             | 215 +++++++++++++++++++++++++++++++++++

 build/lib/ptrack/methods.py          | 147 ++++++++++++++++++++++++

 dist/ptrack-1.0.0-py3-none-any.whl   | Bin 0 -> 6744 bytes

 dist/ptrack-1.0.0.tar.gz             | Bin 0 -> 6921 bytes

 ptrack.egg-info/PKG-INFO             |  13 +++

 ptrack.egg-info/SOURCES.txt          |  12 ++

 ptrack.egg-info/dependency_links.txt |   1 +

 ptrack.egg-info/entry_points.txt     |   5 +

 ptrack.egg-info/requires.txt         |   6 +

 ptrack.egg-info/top_level.txt        |   1 +

 ptrack/__init__.py                   |   2 +-

 ptrack/main.py                       |   5 +

 ptrack/methods.py                    |   9 +-

 recipe/meta.yaml                     |   2 +-

 setup.py                             |   2 +-

 18 files changed, 435 insertions(+), 7 deletions(-)

diff --git a/PKGBUILD b/PKGBUILD

index 49eabb5..41df404 100644

--- a/PKGBUILD

+++ b/PKGBUILD

@@ -1,7 +1,7 @@

 # Maintainer: Connor Etherington <[email protected]>

 # ---

 pkgname=ptrack

-pkgver=0.2.5

+pkgver=1.0.0

 pkgrel=1

 pkgdesc="A simple CLI utility for asthetically tracking progress when copying, moving or downloading files."

 arch=(x86_64)

@@ -32,7 +32,7 @@ package() {

   cd "$srcdir/${pkgname}-${pkgver}-${pkgrel}-${arch}" ||

   cd "$srcdir/${pkgname}"

-  python3 ./setup.py install --root="$pkgdir" --prefix=/usr --optimize=1

+  pip3 install --root="${pkgdir}" --no-deps --ignore-installed ${pkgname}

   install -Dm644 LICENSE "${pkgdir}/usr/share/licenses/${pkgname}/LICENSE"

   install -Dm644 README.md "${pkgdir}/usr/share/doc/${pkgname}/README.md"

diff --git a/README.md b/README.md

index 7943082..dd55b8b 100644

--- a/README.md

+++ b/README.md

@@ -3,7 +3,7 @@

 ### Welcome to ptrack, a powerful and user-friendly CLI utility for tracking the progress of your file operations.

 ### Designed to be as concise, efficient and performance-optimized, ptrack works swiftly and accurately, while providing insight into the progress of the task at hand.

-*Version: 0.2.5*

+*Version: 1.0.0*

 ***

diff --git a/build/lib/ptrack/__init__.py b/build/lib/ptrack/__init__.py

new file mode 100644

index 0000000..bf11915

--- /dev/null

+++ b/build/lib/ptrack/__init__.py

@@ -0,0 +1,16 @@

+import argparse

+version="1.0.0"

+

+parser = argparse.ArgumentParser(description='A simple CLI utility for asthetically tracking progress when copying or moving files.')

+parser.add_argument('-v', '--verbose', action='store_true', help='verbose output')

+parser.add_argument('-c', '--copy', action='store_true', help='copy files (You can use `ptc` instead of `ptrack -c`)')

+parser.add_argument('-m', '--move', action='store_true', help='move files (You can use `ptm` instead of `ptrack -m`)')

+parser.add_argument('-d', '--download', action='store_true', help='download files (You can use `ptd` instead of `ptrack -d`)')

+parser.add_argument('-V', '--version', action='version', version='%(prog)s' + version)

+

+args, unknown = parser.parse_known_args()

+

+verbose = args.verbose

+copy = args.copy

+move = args.move

+download = args.download

diff --git a/build/lib/ptrack/main.py b/build/lib/ptrack/main.py

new file mode 100644

index 0000000..44e9aa6

--- /dev/null

+++ b/build/lib/ptrack/main.py

@@ -0,0 +1,215 @@

+import os

+import re

+import sys

+import ptrack

+from ptrack.methods import format_file_size, regular_copy, verbose_copy, hlp, getTotalSize, CustomFileSizeColumn

+from rich.progress import Progress, BarColumn, TextColumn, TimeRemainingColumn, FileSizeColumn

+from rich.console import Console

+from datetime import timedelta

+import shutil

+import requests

+import validators

+

+verbose = ptrack.verbose

+argCopy = ptrack.copy

+argMove = ptrack.move

+argDownload = ptrack.download

+

+

+def run(process):

+    console = Console()

+

+    if len(sys.argv) < 3:

+        hlp()

+        if process == "Copying":

+            console.print("[bold cyan]Usage: ptc [OPTIONS] SOURCE... DESTINATION[/bold cyan]")

+        elif process == "Moving":

+            console.print("[bold cyan]Usage: ptm [OPTIONS] SOURCE... DESTINATION[/bold cyan]")

+        sys.exit(1)

+

+    src_paths = sys.argv[1:-1]

+    dst = sys.argv[-1]

+    srcPaths = []

+

+    for path in src_paths:

+        if path.endswith('/'):

+            path = path[:-1]

+        srcPaths.append(path)

+

+    if os.path.isdir(dst):

+        dst_dir = dst

+        new_name = None

+    else:

+        dst_dir = os.path.dirname(dst)

+        new_name = os.path.basename(dst)

+

+    total_files = sum(len(files) for path in srcPaths for r, d, files in os.walk(path) if os.path.isdir(path)) + sum(1 for path in srcPaths if os.path.isfile(path))

+    total_size = getTotalSize(srcPaths)

+    destination_path = os.path.join(dst_dir, os.path.basename(srcPaths[0]) if not new_name else new_name)

+

+    current_file = 1

+

+    if total_files > 1:

+        console.print(f"\n[#ea2a6f]{process}:[/#ea2a6f] [bold cyan]{total_files} files[/bold cyan]\n")

+    else:

+        for src_path in srcPaths:

+            if os.path.isfile(src_path):

+                console.print(f"\n[#ea2a6f]{process}:[/#ea2a6f] [bold cyan] {os.path.basename(src_path)} [/bold cyan]\n")

+

+    if verbose:

+        for src_path in srcPaths:

+            if os.path.isfile(src_path):

+                dst_path = os.path.join(dst_dir, os.path.basename(src_path) if not new_name else new_name)

+                terminate = verbose_copy(src_path, dst_path, console, current_file, total_files, file_name=os.path.basename(src_path))

+                current_file += 1

+                if terminate == 'c':

+                    console.print("\n[bold red]\[-][/bold red][bold white] Operation cancelled by user.[/bold white]\n")

+                    sys.exit(1)

+            else:

+                for root, dirs, files in os.walk(src_path):

+                    for file in files:

+                        src_file_path = os.path.join(root, file)

+                        relative_path = os.path.relpath(src_file_path, start=src_path)

+                        dst_file_path = os.path.join(dst_dir, os.path.basename(src_path) if not new_name else new_name, relative_path)

+                        os.makedirs(os.path.dirname(src_file_path), exist_ok=True)

+                        terminate = verbose_copy(src_file_path, dst_file_path, console, current_file, total_files, file_name=file)

+                        current_file += 1

+                        if terminate == 'c':

+                            console.print("\n[bold red]\[-][/bold red][bold white] Operation cancelled by user.[/bold white]\n")

+                            sys.exit(1)

+    else:

+        with Progress(

+            BarColumn(bar_width=50),

+            "[progress.percentage]{task.percentage:>3.0f}%",

+            TimeRemainingColumn(),

+            "[#ea2a6f][[/#ea2a6f]",

+            FileSizeColumn(),

+            "[#ea2a6f]/[/#ea2a6f]",

+            TextColumn("[bold cyan]{task.fields[total_size]}[/bold cyan]"),

+            "[#ea2a6f]][/#ea2a6f]",

+            TextColumn("-[bold yellow] {task.fields[current_file_name]}[/bold yellow]"),

+            console=console,

+            auto_refresh=False

+        ) as progress:

+            task = progress.add_task("", total=total_size, total_size=format_file_size(total_size), current_file_name="Initializing...")

+

+            try:

+                for src_path in srcPaths:

+                    if os.path.isfile(src_path):

+                        src_file_path = src_path

+                        dst_file_path = os.path.join(dst_dir, os.path.basename(src_path) if not new_name else new_name)

+                        file_premissions = os.stat(src_file_path).st_mode

+                        progress.update(task, current_file_name=os.path.basename(src_path), refresh=True)  # Force refresh

+                        terminate = regular_copy(src_path, dst_file_path, console, task, progress, file_name=os.path.basename(src_path))

+                        if terminate == 'c':

+                            console.print("\n[bold red]\[-][/bold red][bold white] Operation cancelled by user.[/bold white]\n")

+                            sys.exit(1)

+                        else:

+                            os.chmod(dst_file_path, file_premissions)

+

+                    else:

+                        for root, dirs, files in os.walk(src_path):

+                            for file in files:

+                                src_file_path = os.path.join(root, file)

+                                relative_path = os.path.relpath(src_file_path, start=src_path)

+                                dst_file_path = os.path.join(dst_dir, os.path.basename(src_path) if not new_name else new_name, relative_path)

+                                os.makedirs(os.path.dirname(dst_file_path), exist_ok=True)

+                                progress.update(task, current_file_name=file, refresh=True)  # Force refresh

+                                regular_copy(src_file_path, dst_file_path, console, task, progress, file_name=file)

+

+            except KeyboardInterrupt:

+                console.print("\n[bold red]\[-][/bold red][bold white] Operation cancelled by user.[/bold white]\n")

+                sys.exit(1)

+

+    return srcPaths

+

+

+def download():

+    console = Console()

+    urls = sys.argv[1:]

+

+    if len(urls) == 0:

+        console.print("\n[bold red][-][/bold red] No URL provided.\n")

+        sys.exit()

+

+    num_urls = len(urls)

+    for url in urls:

+        if url.startswith('-'):

+            num_urls -= 1

+        elif not validators.url(url):

+            console.print(f"\n[bold red][-][/bold red] Invalid URL: [bold yellow]{url}[/bold yellow]\n")

+            sys.exit()

+

+    console.print(f"\n[#ea2a6f]Downloading:[/#ea2a6f] [bold yellow]{num_urls}[/bold yellow] [bold cyan]files[/bold cyan]\n")

+

+    errors = []

+    for url in urls:

+        try:

+            if url.startswith('-'):

+                continue

+

+            response = requests.get(url, stream=True, allow_redirects=True)

+            total_size_in_bytes = int(response.headers.get('content-length', 0))

+            content_disposition = response.headers.get('content-disposition')

+            destination_path = re.findall('filename="(.+)"', content_disposition)[0] if content_disposition and re.findall('filename="(.+)"', content_disposition) else os.path.basename(url)

+

+            with Progress(

+                BarColumn(bar_width=50),

+                "[progress.percentage]{task.percentage:>3.0f}%",

+                TimeRemainingColumn(),

+                "[#ea2a6f][[/#ea2a6f]",

+                CustomFileSizeColumn(),

+                "[#ea2a6f]][/#ea2a6f]",

+                f" {destination_path}",  # This line will print the filename at the end

+                console=console,

+                auto_refresh=True

+            ) as progress:

+                task_id = progress.add_task("Downloading", total=total_size_in_bytes)

+                block_size = 1024  # 1 Kibibyte

+                with open(destination_path, 'wb') as file:

+                    for data in response.iter_content(block_size):

+                        file.write(data)

+                        progress.update(task_id, advance=block_size)

+        except KeyboardInterrupt:

+            console.print("\n[bold red]\[-][/bold red][bold white] Operation cancelled by user.[/bold white]\n")

+            sys.exit(1)

+

+        except Exception as e:

+            console.print(f"\n[bold red]\[-][/bold red][bold white] Could not download file: [bold yellow]{url}[/bold yellow]\n")

+            print(e)

+            errors.append(url)

+

+    if len(errors) == 0:

+        console.print("\n[bold green]Download completed![/bold green]\n")

+    else:

+        console.print("[bold red]The following files could not be downloaded:[/bold red]\n")

+        for error in errors:

+            console.print(f"[bold red]   -[/bold red][bold yellow]{error}[/bold yellow]\n")

+

+

+def copy():

+    run('Copying')

+

+

+def move():

+    src_paths = run('Moving')

+    for src_path in src_paths:

+        if os.path.isfile(src_path):

+            os.remove(src_path)

+        else:

+            shutil.rmtree(src_path)

+

+

+def main():

+    if argMove:

+        move()

+    elif argCopy:

+        copy()

+    elif argDownload:

+        download()

+    else:

+        hlp()

+

+

+if __name__ == "__main__":

+    main()

diff --git a/build/lib/ptrack/methods.py b/build/lib/ptrack/methods.py

new file mode 100644

index 0000000..01a2d63

--- /dev/null

+++ b/build/lib/ptrack/methods.py

@@ -0,0 +1,147 @@

+import os

+import sys

+import requests

+from rich.console import Console

+from rich.progress import Progress, TextColumn, BarColumn, TimeRemainingColumn, FileSizeColumn, Task, DownloadColumn, TimeElapsedColumn

+from rich.text import Text

+from datetime import timedelta

+from humanize import naturalsize

+import shutil

+

+console = Console()

+operation_cancelled = False

+

+

+def getTotalSize(srcPaths):

+    total_size = 0

+    for path in srcPaths:

+        if os.path.isfile(path):

+            total_size += os.path.getsize(path)

+        else:

+            for r, d, files in os.walk(path):

+                for f in files:

+                    fp = os.path.join(r, f)

+                    total_size += os.path.getsize(fp)

+    return total_size

+

+

+def format_file_size(file_size):

+    if file_size >= 1000 ** 4:  # Terabyte

+        return f"{round(file_size / (1000 ** 4))} TB"

+    elif file_size >= 1000 ** 3:  # Gigabyte

+        return f"{round(file_size / (1000 ** 3))} GB"

+    elif file_size >= 1000 ** 2:  # Megabyte

+        return f"{round(file_size / (1000 ** 2))} MB"

+    elif file_size >= 1000:  # Kilobyte

+        return f"{round(file_size / 1000)} kB"

+    else:  # Byte

+        return f"{file_size} bytes"

+

+

+

+def regular_copy(src, dst, console, task, progress, file_name):

+

+    global operation_cancelled

+

+    try:

+        with open(src, 'rb') as fsrc, open(dst, 'wb') as fdst:

+            while True:

+                buf = fsrc.read(1024*1024)

+                if not buf or operation_cancelled:

+                    break

+                filePremissions = os.stat(src).st_mode

+                fdst.write(buf)

+                progress.update(task, advance=len(buf))

+                progress.refresh()

+

+                os.chmod(dst, filePremissions)

+

+    except KeyboardInterrupt:

+        operation_cancelled = True

+        progress.stop()

+        return "c"

+

+

+def verbose_copy(src, dst, console, current, total_files, file_name):

+    operation_cancelled = False

+    file_size = os.path.getsize(src)

+

+    with Progress(

+        BarColumn(bar_width=50),

+        "[progress.percentage]{task.percentage:>3.0f}%",

+        TimeRemainingColumn(),

+        "[#ea2a6f][[/#ea2a6f]",

+        FileSizeColumn(),

+        "[#ea2a6f]/[/#ea2a6f]",

+        TextColumn(f"[bold cyan]{format_file_size(file_size)}[/bold cyan]"),

+        "[#ea2a6f]][/#ea2a6f]",

+        f"({current} of {total_files}) - {file_name}",

+        console=console,

+        auto_refresh=False

+    ) as progress:

+        task = progress.add_task("", total=file_size, file_size=format_file_size(file_size))

+

+        try:

+            with open(src, 'rb') as fsrc, open(dst, 'wb') as fdst:

+                while not progress.finished:

+                    buf = fsrc.read(1024*1024)

+                    if not buf or operation_cancelled:

+                        break

+                    fdst.write(buf)

+                    progress.update(task, advance=len(buf))

+                    progress.refresh()

+

+                    shutil.copystat(src, dst)

+

+        except KeyboardInterrupt:

+            operation_cancelled = True

+            progress.stop()

+            return "c"

+

+

+def hlp():

+    print("""

+usage: ptrack [-h] [-v] [-c] [-m] [-d] [-V]

+

+A simple CLI utility for asthetically tracking progress when copying or moving files.

+

+options:

+  -h, --help      show this help message and exit

+  -v, --verbose   verbose output

+  -c, --copy      copy files (You can use `ptc` instead of `ptrack -c`)

+  -m, --move      move files (You can use `ptm` instead of `ptrack -m`)

+  -d, --download  download files (You can use `ptd` instead of `ptrack -d`)

+  -V, --version   show program's version number and exit

+""")

+

+

+class CustomFileSizeColumn(FileSizeColumn, TimeElapsedColumn):

+    def render(self, task):

+        completed = task.completed

+        total = task.total

+        elapsed = task.elapsed

+

+        if elapsed > 0.0:  # Prevent division by zero

+            download_speed = completed / elapsed  # calculate download rate

+        else:

+            download_speed = 0

+

+        if total:

+            size = Text.assemble(

+                (f"{self._human_readable_size(completed)}", "green"),  # completed

+                (" / ", "none"),  # separator

+                (f"{self._human_readable_size(total)}", "red"),  # total

+                (" [", "none"),  # opening square bracket

+                (f"{self._human_readable_size(download_speed)}/s", "blue"),  # download rate

+                ("]", "none"),  # closing square bracket

+            )

+        else:

+            size = Text(str(self._human_readable_size(completed)))

+        return size

+

+    def _human_readable_size(self, size: int) -> str:

+        for unit in ['B', 'KB', 'MB', 'GB', 'TB']:

+            if abs(size) < 1024.0:

+                return f"{size:.1f}{unit}"

+            size /= 1024.0

+        return f"{size:.1f}PB"

diff --git a/dist/ptrack-1.0.0-py3-none-any.whl b/dist/ptrack-1.0.0-py3-none-any.whl

new file mode 100644

index 0000000..c1fa573

Binary files /dev/null and b/dist/ptrack-1.0.0-py3-none-any.whl differ

diff --git a/dist/ptrack-1.0.0.tar.gz b/dist/ptrack-1.0.0.tar.gz

new file mode 100644

index 0000000..c127219

Binary files /dev/null and b/dist/ptrack-1.0.0.tar.gz differ

diff --git a/ptrack.egg-info/PKG-INFO b/ptrack.egg-info/PKG-INFO

new file mode 100644

index 0000000..e28cefc

--- /dev/null

+++ b/ptrack.egg-info/PKG-INFO

@@ -0,0 +1,13 @@

+Metadata-Version: 2.1

+Name: ptrack

+Version: 1.0.0

+Summary: A simple CLI utility for asthetically tracking progress when copying, moving or downloading files.

+Author: Connor Etherington

+Author-email: [email protected]

+License-File: LICENSE

+Requires-Dist: rich

+Requires-Dist: argparse

+Requires-Dist: requests

+Requires-Dist: validators

+Requires-Dist: setuptools

+Requires-Dist: humanize

diff --git a/ptrack.egg-info/SOURCES.txt b/ptrack.egg-info/SOURCES.txt

new file mode 100644

index 0000000..086a784

--- /dev/null

+++ b/ptrack.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@

+LICENSE

+README.md

+setup.py

+ptrack/__init__.py

+ptrack/main.py

+ptrack/methods.py

+ptrack.egg-info/PKG-INFO

+ptrack.egg-info/SOURCES.txt

+ptrack.egg-info/dependency_links.txt

+ptrack.egg-info/entry_points.txt

+ptrack.egg-info/requires.txt

+ptrack.egg-info/top_level.txt

diff --git a/ptrack.egg-info/dependency_links.txt b/ptrack.egg-info/dependency_links.txt

new file mode 100644

index 0000000..8b13789

--- /dev/null

+++ b/ptrack.egg-info/dependency_links.txt

@@ -0,0 +1 @@

+

diff --git a/ptrack.egg-info/entry_points.txt b/ptrack.egg-info/entry_points.txt

new file mode 100644

index 0000000..ea851b3

--- /dev/null

+++ b/ptrack.egg-info/entry_points.txt

@@ -0,0 +1,5 @@

+[console_scripts]

+ptc = ptrack.main:copy

+ptd = ptrack.main:download

+ptm = ptrack.main:move

+ptrack = ptrack.main:main

diff --git a/ptrack.egg-info/requires.txt b/ptrack.egg-info/requires.txt

new file mode 100644

index 0000000..d19a378

--- /dev/null

+++ b/ptrack.egg-info/requires.txt

@@ -0,0 +1,6 @@

+rich

+argparse

+requests

+validators

+setuptools

+humanize

diff --git a/ptrack.egg-info/top_level.txt b/ptrack.egg-info/top_level.txt

new file mode 100644

index 0000000..c003217

--- /dev/null

+++ b/ptrack.egg-info/top_level.txt

@@ -0,0 +1 @@

+ptrack

diff --git a/ptrack/__init__.py b/ptrack/__init__.py

index a329509..bf11915 100644

--- a/ptrack/__init__.py

+++ b/ptrack/__init__.py

@@ -1,5 +1,5 @@

 import argparse

-version="0.2.5"

+version="1.0.0"

 parser = argparse.ArgumentParser(description='A simple CLI utility for asthetically tracking progress when copying or moving files.')

 parser.add_argument('-v', '--verbose', action='store_true', help='verbose output')

diff --git a/ptrack/main.py b/ptrack/main.py

index a0b26dc..44e9aa6 100644

--- a/ptrack/main.py

+++ b/ptrack/main.py

@@ -96,12 +96,17 @@ def run(process):

             try:

                 for src_path in srcPaths:

                     if os.path.isfile(src_path):

+                        src_file_path = src_path

                         dst_file_path = os.path.join(dst_dir, os.path.basename(src_path) if not new_name else new_name)

+                        file_premissions = os.stat(src_file_path).st_mode

                         progress.update(task, current_file_name=os.path.basename(src_path), refresh=True)  # Force refresh

                         terminate = regular_copy(src_path, dst_file_path, console, task, progress, file_name=os.path.basename(src_path))

                         if terminate == 'c':

                             console.print("\n[bold red]\[-][/bold red][bold white] Operation cancelled by user.[/bold white]\n")

                             sys.exit(1)

+                        else:

+                            os.chmod(dst_file_path, file_premissions)

+

                     else:

                         for root, dirs, files in os.walk(src_path):

                             for file in files:

diff --git a/ptrack/methods.py b/ptrack/methods.py

index 2e9677e..01a2d63 100644

--- a/ptrack/methods.py

+++ b/ptrack/methods.py

@@ -6,6 +6,7 @@ from rich.progress import Progress, TextColumn, BarColumn, TimeRemainingColumn,

 from rich.text import Text

 from datetime import timedelta

 from humanize import naturalsize

+import shutil

 console = Console()

 operation_cancelled = False

@@ -45,13 +46,16 @@ def regular_copy(src, dst, console, task, progress, file_name):

     try:

         with open(src, 'rb') as fsrc, open(dst, 'wb') as fdst:

             while True:

-                buf = fsrc.read(1024 * 128)  # Reduced buffer size for more frequent checks

+                buf = fsrc.read(1024*1024)

                 if not buf or operation_cancelled:

                     break

+                filePremissions = os.stat(src).st_mode

                 fdst.write(buf)

                 progress.update(task, advance=len(buf))

                 progress.refresh()

+                os.chmod(dst, filePremissions)

+

     except KeyboardInterrupt:

         operation_cancelled = True

         progress.stop()

@@ -86,6 +90,9 @@ def verbose_copy(src, dst, console, current, total_files, file_name):

                     fdst.write(buf)

                     progress.update(task, advance=len(buf))

                     progress.refresh()

+

+                    shutil.copystat(src, dst)

+

         except KeyboardInterrupt:

             operation_cancelled = True

             progress.stop()

diff --git a/recipe/meta.yaml b/recipe/meta.yaml

index 62dc45a..45860df 100644

--- a/recipe/meta.yaml

+++ b/recipe/meta.yaml

@@ -1,6 +1,6 @@

 package:

   name: ptrack

-  version: 0.2.5

+  version: 1.0.0

 source:

   path: ..

diff --git a/setup.py b/setup.py

index 2c8aa5c..1bfa98a 100644

--- a/setup.py

+++ b/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages

 setup(

     name='ptrack',

-    version="0.2.5",

+    version="1.0.0",

     description='A simple CLI utility for asthetically tracking progress when copying, moving or downloading files.',

     author='Connor Etherington',

     author_email='[email protected]',