githubtakeout 0.1.14__tar.gz → 0.1.16__tar.gz

{githubtakeout-0.1.14/src/githubtakeout.egg-info → githubtakeout-0.1.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: githubtakeout
-Version: 0.1.14
+Version: 0.1.16
 Summary: Backup and archive Git Repos and Gists from GitHub
 Author: Corey Goldberg
 Maintainer: Corey Goldberg
@@ -21,15 +21,18 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: GitPython==3.1.45
 Requires-Dist: PyGithub==2.8.1
+Requires-Dist: python-dotenv==1.2.1
 Requires-Dist: rich==14.2.0
 Dynamic: license-file
 
 # githubtakeout
 
-## Backup and archive Git Repos and Gists from GitHub
+### Backup and archive Git Repos and Gists from GitHub
 
 ---
 
+[![Supported Python Versions](https://img.shields.io/pypi/pyversions/githubtakeout)](https://pypi.org/project/githubtakeout)
+
 - Copyright (c) 2015-2025 [Corey Goldberg][github-home]
 - Development: [GitHub][github-repo]
 - Download/Install: [PyPI][pypi-githubtakeout]
@@ -55,6 +58,10 @@ Archives are saved in compressed zip format (`.zip`) by default. You can also
 save as tarballs (`.tar.gz`) using the `--format=tar` option, or skip archiving
 using the `--format=none` option.
 
+If a repo with history exists from a previous run, it will pull new changes.
+Otherwise, it will clone the repo. Use the `--keep` if you don't want repos
+deleted after an archive is created.
+
 ## Requirements:
 
 - Python 3.12+
@@ -81,26 +88,37 @@ can set the `GITHUB_TOKEN` environment variable:
 $ export GITHUB_TOKEN=<access token>
 ```
 
+You can also set this in an `.env` file in the current directory. It should
+contain:
+
+```
+GITHUB_TOKEN=<access token>
+```
+
 If you prefer to be prompted for your token each time you run the program, use
 the `--token` argument.
 
 ## CLI Options:
 
 ```
-usage: githubtakeout [-h] [--dir DIR] [--pattern PATTERN] [--format {tar,zip,none}] [--gists] [--history] [--list] [--token] username
+usage: githubtakeout [-h] [--dir DIR] [--pattern PATTERN] [--format {tar,zip,none}]
+                     [--gists] [--history] [--keep] [--list] [--token]
+                     username
 
 positional arguments:
-  username                 github username
+  username                    github username
 
 options:
-  -h, --help               show this help message and exit
-  --dir DIR                output directory (default: .)
-  --pattern PATTERN        regex matching repo names (default: .*)
-  --format {tar,zip,none}  archive format (default: zip)
-  --gists                  include gists
-  --history                include commit history and branches (.git directory)
-  --list                   list repos only
-  --token                  prompt for auth token
+  -h, --help                  show this help message and exit
+  --dir DIR                   output directory (default: .)
+  --pattern PATTERN           regex matching repo names to include
+  --skip_pattern PATTERN      regex matching repo names to skip
+  --format {tar,zip,none}     archive format (default: zip)
+  --gists                     include gists
+  --history                   include commit history and branches (.git directory)
+  --keep                      keep repos after archiving
+  --list                      list repos only
+  --token                     prompt for auth token
 ```
 
 ## Usage Examples:
@@ -124,7 +142,7 @@ githubtakeout <github username>
 ```
 
 [github-home]: https://github.com/cgoldberg
-[github-repo]: https://github.com/cgoldberg/sudokubot
+[github-repo]: https://github.com/cgoldberg/githubtakeout
 [github-pat]: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens
 [pypi-githubtakeout]: https://pypi.org/project/githubtakeout
 [mit-license]: https://raw.githubusercontent.com/cgoldberg/githubtakeout/refs/heads/master/LICENSE

{githubtakeout-0.1.14 → githubtakeout-0.1.16}/README.md

@@ -1,9 +1,11 @@
 # githubtakeout
 
-## Backup and archive Git Repos and Gists from GitHub
+### Backup and archive Git Repos and Gists from GitHub
 
 ---
 
+[![Supported Python Versions](https://img.shields.io/pypi/pyversions/githubtakeout)](https://pypi.org/project/githubtakeout)
+
 - Copyright (c) 2015-2025 [Corey Goldberg][github-home]
 - Development: [GitHub][github-repo]
 - Download/Install: [PyPI][pypi-githubtakeout]
@@ -29,6 +31,10 @@ Archives are saved in compressed zip format (`.zip`) by default. You can also
 save as tarballs (`.tar.gz`) using the `--format=tar` option, or skip archiving
 using the `--format=none` option.
 
+If a repo with history exists from a previous run, it will pull new changes.
+Otherwise, it will clone the repo. Use the `--keep` if you don't want repos
+deleted after an archive is created.
+
 ## Requirements:
 
 - Python 3.12+
@@ -55,26 +61,37 @@ can set the `GITHUB_TOKEN` environment variable:
 $ export GITHUB_TOKEN=<access token>
 ```
 
+You can also set this in an `.env` file in the current directory. It should
+contain:
+
+```
+GITHUB_TOKEN=<access token>
+```
+
 If you prefer to be prompted for your token each time you run the program, use
 the `--token` argument.
 
 ## CLI Options:
 
 ```
-usage: githubtakeout [-h] [--dir DIR] [--pattern PATTERN] [--format {tar,zip,none}] [--gists] [--history] [--list] [--token] username
+usage: githubtakeout [-h] [--dir DIR] [--pattern PATTERN] [--format {tar,zip,none}]
+                     [--gists] [--history] [--keep] [--list] [--token]
+                     username
 
 positional arguments:
-  username                 github username
+  username                    github username
 
 options:
-  -h, --help               show this help message and exit
-  --dir DIR                output directory (default: .)
-  --pattern PATTERN        regex matching repo names (default: .*)
-  --format {tar,zip,none}  archive format (default: zip)
-  --gists                  include gists
-  --history                include commit history and branches (.git directory)
-  --list                   list repos only
-  --token                  prompt for auth token
+  -h, --help                  show this help message and exit
+  --dir DIR                   output directory (default: .)
+  --pattern PATTERN           regex matching repo names to include
+  --skip_pattern PATTERN      regex matching repo names to skip
+  --format {tar,zip,none}     archive format (default: zip)
+  --gists                     include gists
+  --history                   include commit history and branches (.git directory)
+  --keep                      keep repos after archiving
+  --list                      list repos only
+  --token                     prompt for auth token
 ```
 
 ## Usage Examples:
@@ -98,7 +115,7 @@ githubtakeout <github username>
 ```
 
 [github-home]: https://github.com/cgoldberg
-[github-repo]: https://github.com/cgoldberg/sudokubot
+[github-repo]: https://github.com/cgoldberg/githubtakeout
 [github-pat]: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens
 [pypi-githubtakeout]: https://pypi.org/project/githubtakeout
 [mit-license]: https://raw.githubusercontent.com/cgoldberg/githubtakeout/refs/heads/master/LICENSE

{githubtakeout-0.1.14 → githubtakeout-0.1.16}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "githubtakeout"
-version = "0.1.14"
+version = "0.1.16"
 description = "Backup and archive Git Repos and Gists from GitHub"
 license = "MIT"
 license-files = ["LICENSE"]
@@ -25,6 +25,7 @@ classifiers = [
 dependencies = [
     "GitPython==3.1.45",
     "PyGithub==2.8.1",
+    "python-dotenv==1.2.1",
     "rich==14.2.0",
 ]
 
@@ -45,6 +46,9 @@ lint = [
     "refurb",
     "ruff",
 ]
+test = [
+    "pytest",
+]
 validate = [
     "packaging",
     "validate-pyproject",
@@ -53,6 +57,10 @@ validate = [
 [tool.setuptools]
 package-dir = {"" = "src"}
 
+[tool.pytest.ini_options]
+addopts = "-vv" # extra verbose
+tmp_path_retention_policy = "none"
+
 [tool.black]
 line-length = 120
 target-version = [

{githubtakeout-0.1.14 → githubtakeout-0.1.16/src/githubtakeout.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: githubtakeout
-Version: 0.1.14
+Version: 0.1.16
 Summary: Backup and archive Git Repos and Gists from GitHub
 Author: Corey Goldberg
 Maintainer: Corey Goldberg
@@ -21,15 +21,18 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: GitPython==3.1.45
 Requires-Dist: PyGithub==2.8.1
+Requires-Dist: python-dotenv==1.2.1
 Requires-Dist: rich==14.2.0
 Dynamic: license-file
 
 # githubtakeout
 
-## Backup and archive Git Repos and Gists from GitHub
+### Backup and archive Git Repos and Gists from GitHub
 
 ---
 
+[![Supported Python Versions](https://img.shields.io/pypi/pyversions/githubtakeout)](https://pypi.org/project/githubtakeout)
+
 - Copyright (c) 2015-2025 [Corey Goldberg][github-home]
 - Development: [GitHub][github-repo]
 - Download/Install: [PyPI][pypi-githubtakeout]
@@ -55,6 +58,10 @@ Archives are saved in compressed zip format (`.zip`) by default. You can also
 save as tarballs (`.tar.gz`) using the `--format=tar` option, or skip archiving
 using the `--format=none` option.
 
+If a repo with history exists from a previous run, it will pull new changes.
+Otherwise, it will clone the repo. Use the `--keep` if you don't want repos
+deleted after an archive is created.
+
 ## Requirements:
 
 - Python 3.12+
@@ -81,26 +88,37 @@ can set the `GITHUB_TOKEN` environment variable:
 $ export GITHUB_TOKEN=<access token>
 ```
 
+You can also set this in an `.env` file in the current directory. It should
+contain:
+
+```
+GITHUB_TOKEN=<access token>
+```
+
 If you prefer to be prompted for your token each time you run the program, use
 the `--token` argument.
 
 ## CLI Options:
 
 ```
-usage: githubtakeout [-h] [--dir DIR] [--pattern PATTERN] [--format {tar,zip,none}] [--gists] [--history] [--list] [--token] username
+usage: githubtakeout [-h] [--dir DIR] [--pattern PATTERN] [--format {tar,zip,none}]
+                     [--gists] [--history] [--keep] [--list] [--token]
+                     username
 
 positional arguments:
-  username                 github username
+  username                    github username
 
 options:
-  -h, --help               show this help message and exit
-  --dir DIR                output directory (default: .)
-  --pattern PATTERN        regex matching repo names (default: .*)
-  --format {tar,zip,none}  archive format (default: zip)
-  --gists                  include gists
-  --history                include commit history and branches (.git directory)
-  --list                   list repos only
-  --token                  prompt for auth token
+  -h, --help                  show this help message and exit
+  --dir DIR                   output directory (default: .)
+  --pattern PATTERN           regex matching repo names to include
+  --skip_pattern PATTERN      regex matching repo names to skip
+  --format {tar,zip,none}     archive format (default: zip)
+  --gists                     include gists
+  --history                   include commit history and branches (.git directory)
+  --keep                      keep repos after archiving
+  --list                      list repos only
+  --token                     prompt for auth token
 ```
 
 ## Usage Examples:
@@ -124,7 +142,7 @@ githubtakeout <github username>
 ```
 
 [github-home]: https://github.com/cgoldberg
-[github-repo]: https://github.com/cgoldberg/sudokubot
+[github-repo]: https://github.com/cgoldberg/githubtakeout
 [github-pat]: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens
 [pypi-githubtakeout]: https://pypi.org/project/githubtakeout
 [mit-license]: https://raw.githubusercontent.com/cgoldberg/githubtakeout/refs/heads/master/LICENSE

{githubtakeout-0.1.14 → githubtakeout-0.1.16}/src/githubtakeout.egg-info/SOURCES.txt

@@ -8,4 +8,5 @@ src/githubtakeout.egg-info/SOURCES.txt
 src/githubtakeout.egg-info/dependency_links.txt
 src/githubtakeout.egg-info/entry_points.txt
 src/githubtakeout.egg-info/requires.txt
-src/githubtakeout.egg-info/top_level.txt
+src/githubtakeout.egg-info/top_level.txt
+tests/test_githubtakeout.py

{githubtakeout-0.1.14 → githubtakeout-0.1.16}/src/githubtakeout.egg-info/requires.txt

@@ -1,3 +1,4 @@
 GitPython==3.1.45
 PyGithub==2.8.1
+python-dotenv==1.2.1
 rich==14.2.0

{githubtakeout-0.1.14 → githubtakeout-0.1.16}/src/githubtakeout.py

@@ -20,6 +20,7 @@ from timeit import default_timer
 
 import git
 import github
+from dotenv import load_dotenv
 
 from progress import GitProgress
 
@@ -104,7 +105,25 @@ def clone(repo_url, local_repo_dir, include_history):
             pass
 
 
-def clone_and_archive_repo(repo_url, local_repo_dir, archive_format, include_history, is_gist=False):
+def pull(local_repo_dir):
+    try:
+        repo = git.Repo(local_repo_dir)
+        origin = repo.remotes.origin
+        origin.fetch()
+        origin.pull(progress=GitProgress())
+    except git.GitCommandError as e:
+        logger.error(e)
+        sys.exit("error: failed pulling changes in repo")
+    finally:
+        try:
+            # release resources
+            repo.close()
+        except UnboundLocalError:
+            # this occurs if we catch a signal while pulling
+            pass
+
+
+def get_and_archive_repo(repo_url, local_repo_dir, archive_format, include_history, keep, is_gist=False):
     def remove_readonly(func, path, _):
         # This is necessary so rmtree() doesn't fail if there are any readonly
         # dirs/files when trying to delete. This seems to happen after cloning on
@@ -118,19 +137,27 @@ def clone_and_archive_repo(repo_url, local_repo_dir, archive_format, include_his
         # try again
         func(path)
 
-    try:
-        # delete repo if it already exists
-        shutil.rmtree(local_repo_dir, onexc=remove_readonly)
-    except FileNotFoundError:
-        pass
     repo_name = urllib.parse.urlparse(repo_url).path.lstrip("/")
-    logger.info(f"cloning repo: {repo_name} to {local_repo_dir}")
+    # we can only pull if the local repo exists and has a .git directory
+    if Path(local_repo_dir, ".git").exists():
+        needs_clone = False
+    else:
+        needs_clone = True
+        try:
+            shutil.rmtree(local_repo_dir, onexc=remove_readonly)
+        except FileNotFoundError:
+            pass
     start = default_timer()
-    clone(repo_url, local_repo_dir, include_history)
+    if needs_clone:
+        logger.info(f"cloning repo: {repo_name} to: {local_repo_dir}")
+        clone(repo_url, local_repo_dir, include_history)
+    else:
+        logger.info(f"pulling changes from repo: {repo_name} to: {local_repo_dir}")
+        pull(local_repo_dir)
     if not include_history:
         # delete the .git directory if we are not saving history
         try:
-            git_dir = os.path.join(local_repo_dir, ".git")
+            git_dir = Path(local_repo_dir, ".git")
             shutil.rmtree(git_dir, onexc=remove_readonly)
         except FileNotFoundError:
             pass
@@ -138,12 +165,13 @@ def clone_and_archive_repo(repo_url, local_repo_dir, archive_format, include_his
     if archive_path:
         size = convert_size(os.path.getsize(archive_path))
         logger.info(f"archive size: {size}")
-        logger.info("deleting repo")
-        try:
-            # delete repo after archive is created
-            shutil.rmtree(local_repo_dir, onexc=remove_readonly)
-        except FileNotFoundError:
-            pass
+        if not keep:
+            logger.info("deleting repo")
+            try:
+                # delete repo after archive is created
+                shutil.rmtree(local_repo_dir, onexc=remove_readonly)
+            except FileNotFoundError:
+                pass
     elapsed = default_timer() - start
     base_name = os.path.basename(local_repo_dir)
     logger.info(f"successfully backed up '{base_name}' repo in {elapsed:.3f} secs\n")
@@ -188,6 +216,8 @@ def get_token(prompt_for_token):
         if not token:
             sys.exit("error: auth token cannot be empty")
     else:
+        # populate environment variable via .env file if it exists
+        load_dotenv()
         token = os.getenv("GITHUB_TOKEN")
     return token
 
@@ -196,39 +226,53 @@ def run(
     username,
     base_dir,
     pattern,
+    skip_pattern,
     archive_format,
     include_gists,
     include_history,
+    keep,
     list_only,
     prompt_for_token,
 ):
     working_dir = os.path.join(base_dir, "backups")
     token = get_token(prompt_for_token)
     repos, gists = get_repos(username, token, include_gists)
-    num_repos = len([repo for repo in repos if re.match(pattern, repo.name)])
+    num_repos = len(
+        [
+            repo
+            for repo in repos
+            if re.match(pattern, repo.name) and not (re.match(skip_pattern, repo.name) if skip_pattern else False)
+        ]
+    )
     if not list_only:
         logger.info(f"creating archives in: {working_dir}\n")
     logger.info(f"found {num_repos} repos for user '{username}':\n")
     for repo in repos:
-        if re.match(pattern, repo.name):
+        if re.match(pattern, repo.name) and not (re.match(skip_pattern, repo.name) if skip_pattern else False):
             local_repo_dir = os.path.join(working_dir, repo.name)
             url = add_creds(repo.clone_url, username, token)
             if list_only:
                 logger.info(f"{username}/{repo.name}")
             else:
-                clone_and_archive_repo(url, local_repo_dir, archive_format, include_history)
+                get_and_archive_repo(url, local_repo_dir, archive_format, include_history, keep)
     if gists is not None:
-        num_gists = len([gist for gist in gists if re.match(pattern, gist.id)])
+        num_gists = len(
+            [
+                gist
+                for gist in gists
+                if re.match(pattern, gist.id) and not (re.match(skip_pattern, gist.id) if skip_pattern else False)
+            ]
+        )
         logger.info("")
         logger.info(f"found {num_gists} gists for user '{username}':\n")
         for gist in gists:
-            if re.match(pattern, gist.id):
+            if re.match(pattern, gist.id) and not (re.match(skip_pattern, gist.id) if skip_pattern else False):
                 local_repo_dir = os.path.join(working_dir, gist.id)
                 url = add_creds(gist.git_pull_url, username, token)
                 if list_only:
                     logger.info(f"{username}/{gist.id}\n  - {gist.description}")
                 else:
-                    clone_and_archive_repo(url, local_repo_dir, archive_format, include_history, is_gist=True)
+                    get_and_archive_repo(url, local_repo_dir, archive_format, include_history, keep, is_gist=True)
 
 
 def main():
@@ -248,7 +292,12 @@ def main():
     parser.add_argument(
         "--pattern",
         default=".*",
-        help="regex matching repo names (default: .*)",
+        help="regex matching repo names to include",
+    )
+    parser.add_argument(
+        "--skip_pattern",
+        metavar="PATTERN",
+        help="regex matching repo names to skip",
     )
     parser.add_argument(
         "--format",
@@ -263,6 +312,7 @@ def main():
         default=False,
         help="include commit history and branches (.git directory)",
     )
+    parser.add_argument("--keep", action="store_true", default=False, help="keep repos after archiving")
     parser.add_argument("--list", action="store_true", default=False, help="list repos only")
     parser.add_argument("--token", action="store_true", default=False, help="prompt for auth token")
     args = parser.parse_args()
@@ -271,9 +321,11 @@ def main():
             username=args.username,
             base_dir=args.dir,
             pattern=args.pattern,
+            skip_pattern=args.skip_pattern,
             archive_format=args.format,
             include_gists=args.gists,
             include_history=args.history,
+            keep=args.keep,
             list_only=args.list,
             prompt_for_token=args.token,
         )

githubtakeout-0.1.16/tests/test_githubtakeout.py

@@ -0,0 +1,246 @@
+import os
+import re
+from pathlib import Path
+
+import pytest
+from dotenv import load_dotenv
+
+import githubtakeout
+
+USER = "cgoldberg"
+
+
+@pytest.fixture(autouse=True, scope="session")
+def require_token():
+    load_dotenv()
+    required = "GITHUB_TOKEN"
+    if not os.getenv(required):
+        pytest.skip(reason=f"{required} environment variable or .env file is required to avoid rate limiting")
+
+
+@pytest.mark.skipif(os.getenv("GITHUB_TOKEN"), reason="GITHUB_TOKEN required to avoid rate limiting")
+def test_run_list_1_match(tmp_path, caplog):
+    caplog.set_level("INFO")
+    repo = "githubtakeout"
+    githubtakeout.run(
+        username=USER,
+        base_dir=tmp_path,
+        pattern=repo,
+        skip_pattern=None,
+        archive_format="none",
+        include_gists=False,
+        include_history=False,
+        keep=False,
+        list_only=True,
+        prompt_for_token=False,
+    )
+    assert "creating archives" not in caplog.text
+    assert f"found 1 repos for user '{USER}'" in caplog.text
+    assert "gists" not in caplog.text
+    assert f"{USER}/{repo}" in caplog.text
+    assert not Path(tmp_path / "backups" / repo).exists()
+
+
+def test_run_list_0_match(tmp_path, caplog):
+    caplog.set_level("INFO")
+    repo = "this_repo_does_not_exist"
+    githubtakeout.run(
+        username=USER,
+        base_dir=tmp_path,
+        pattern=repo,
+        skip_pattern=None,
+        archive_format="none",
+        include_gists=False,
+        include_history=False,
+        keep=False,
+        list_only=True,
+        prompt_for_token=False,
+    )
+    assert "creating archives" not in caplog.text
+    assert f"found 0 repos for user '{USER}'" in caplog.text
+    assert "gists" not in caplog.text
+    assert not Path(tmp_path / "backups" / repo).exists()
+
+
+def test_run_list_0_match_with_gists(tmp_path, caplog):
+    caplog.set_level("INFO")
+    repo = "this_repo_does_not_exist"
+    githubtakeout.run(
+        username=USER,
+        base_dir=tmp_path,
+        pattern=repo,
+        skip_pattern=None,
+        archive_format="none",
+        include_gists=True,
+        include_history=False,
+        keep=False,
+        list_only=True,
+        prompt_for_token=False,
+    )
+    assert "creating archives" not in caplog.text
+    assert f"found 0 repos for user '{USER}'" in caplog.text
+    assert f"found 0 gists for user '{USER}'" in caplog.text
+    assert not Path(tmp_path / "backups" / repo).exists()
+
+
+def test_run_list_skip_all(tmp_path, caplog):
+    caplog.set_level("INFO")
+    githubtakeout.run(
+        username=USER,
+        base_dir=tmp_path,
+        pattern=".*",
+        skip_pattern=".",
+        archive_format="none",
+        include_gists=False,
+        include_history=False,
+        keep=False,
+        list_only=True,
+        prompt_for_token=False,
+    )
+    assert "creating archives" not in caplog.text
+    assert f"found 0 repos for user '{USER}'" in caplog.text
+
+
+@pytest.mark.parametrize("archive_format", ["zip", "tar"])
+def test_run_archive_1_match(archive_format, tmp_path, caplog):
+    caplog.set_level("INFO")
+    backup_dir = "backups"
+    repo = "githubtakeout"
+    githubtakeout.run(
+        username=USER,
+        base_dir=tmp_path,
+        pattern=repo,
+        skip_pattern=None,
+        archive_format=archive_format,
+        include_gists=False,
+        include_history=False,
+        keep=False,
+        list_only=False,
+        prompt_for_token=False,
+    )
+    assert re.search(f"creating archives in: .*{backup_dir}", caplog.text)
+    assert f"found 1 repos for user '{USER}'" in caplog.text
+    assert "gists" not in caplog.text
+    assert re.search(f"cloning repo: {USER}/{repo}.git to: .*{backup_dir}", caplog.text)
+    assert "creating archive:" in caplog.text
+    assert "archive size:" in caplog.text
+    assert "deleting repo" in caplog.text
+    assert f"successfully backed up '{repo}' repo" in caplog.text
+    assert not Path(tmp_path / backup_dir / repo).exists()
+    if archive_format == "tar":
+        extension = "tar.gz"
+    else:
+        extension = archive_format
+    assert Path(tmp_path / backup_dir / f"{repo}.{extension}").exists()
+
+
+def test_run_no_archive_1_match_with_history(tmp_path, caplog):
+    caplog.set_level("INFO")
+    backup_dir = "backups"
+    repo = "githubtakeout"
+    githubtakeout.run(
+        username=USER,
+        base_dir=tmp_path,
+        pattern=repo,
+        skip_pattern=None,
+        archive_format="none",
+        include_gists=False,
+        include_history=True,
+        keep=False,
+        list_only=False,
+        prompt_for_token=False,
+    )
+    assert re.search(f"creating archives in: .*{backup_dir}", caplog.text)
+    assert f"found 1 repos for user '{USER}'" in caplog.text
+    assert "gists" not in caplog.text
+    assert re.search(f"cloning repo: {USER}/{repo}.git to: .*{backup_dir}", caplog.text)
+    assert "creating archive:" not in caplog.text
+    assert "archive size:" not in caplog.text
+    assert "deleting repo" not in caplog.text
+    assert f"successfully backed up '{repo}' repo" in caplog.text
+    assert Path(tmp_path / backup_dir / repo).exists()
+    assert Path(tmp_path / backup_dir / repo / ".git").exists()
+    for extension in ("tar.gz", "zip"):
+        assert not Path(tmp_path / backup_dir / f"{repo}.{extension}").exists()
+
+
+def test_run_no_archive_1_match_without_history(tmp_path, caplog):
+    caplog.set_level("INFO")
+    backup_dir = "backups"
+    repo = "githubtakeout"
+    githubtakeout.run(
+        username=USER,
+        base_dir=tmp_path,
+        pattern=repo,
+        skip_pattern=None,
+        archive_format="none",
+        include_gists=False,
+        include_history=False,
+        keep=False,  # this doesn't matter when archive_format is "none"
+        list_only=False,
+        prompt_for_token=False,
+    )
+    assert re.search("creating archives in: .*backups", caplog.text)
+    assert f"found 1 repos for user '{USER}'" in caplog.text
+    assert "gists" not in caplog.text
+    assert re.search(f"cloning repo: {USER}/{repo}.git to: .*backups", caplog.text)
+    assert "creating archive:" not in caplog.text
+    assert "archive size:" not in caplog.text
+    assert "deleting repo" not in caplog.text
+    assert f"successfully backed up '{repo}' repo" in caplog.text
+    assert Path(tmp_path / backup_dir / repo).exists()
+    assert not Path(tmp_path / backup_dir / repo / ".git").exists()
+    for extension in ("tar.gz", "zip"):
+        assert not Path(tmp_path / backup_dir / f"{repo}.{extension}").exists()
+
+
+def test_run_archive_1_match_with_history_pull_with_keep(tmp_path, caplog):
+    caplog.set_level("INFO")
+    backup_dir = "backups"
+    repo = "githubtakeout"
+    githubtakeout.run(
+        username=USER,
+        base_dir=tmp_path,
+        pattern=repo,
+        skip_pattern=None,
+        archive_format="none",
+        include_gists=False,
+        include_history=True,
+        keep=True,
+        list_only=False,
+        prompt_for_token=False,
+    )
+    assert f"found 1 repos for user '{USER}'" in caplog.text
+    assert "gists" not in caplog.text
+    assert re.search(f"cloning repo: {USER}/{repo}.git to: .*backups", caplog.text)
+    assert "pulling changes" not in caplog.text
+    assert "creating archive:" not in caplog.text
+    assert "archive size:" not in caplog.text
+    assert "deleting repo" not in caplog.text
+    assert f"successfully backed up '{repo}' repo" in caplog.text
+    assert Path(tmp_path / backup_dir / repo).exists()
+    assert Path(tmp_path / backup_dir / repo / ".git").exists()
+    caplog.clear()
+    githubtakeout.run(
+        username=USER,
+        base_dir=tmp_path,
+        pattern=repo,
+        skip_pattern=None,
+        archive_format="zip",
+        include_gists=False,
+        include_history=True,
+        keep=True,
+        list_only=False,
+        prompt_for_token=False,
+    )
+    assert f"found 1 repos for user '{USER}'" in caplog.text
+    assert "gists" not in caplog.text
+    assert not re.search(f"cloning repo: {USER}/{repo}.git to: .*backups", caplog.text)
+    assert re.search(f"pulling changes from repo: {USER}/{repo}.git to: .*backups", caplog.text)
+    assert "creating archive:" in caplog.text
+    assert "archive size:" in caplog.text
+    assert "deleting repo" not in caplog.text
+    assert f"successfully backed up '{repo}' repo" in caplog.text
+    assert Path(tmp_path / backup_dir / repo).exists()
+    assert Path(tmp_path / backup_dir / repo / ".git").exists()
+    assert Path(tmp_path / backup_dir / f"{repo}.zip").exists()