From 260359468fba05b5fc84ab43118e9ee31c6f533d Mon Sep 17 00:00:00 2001
From: Todd Birchard <toddbirchard@gmail.com>
Date: Wed, 7 Aug 2024 18:46:53 -0400
Subject: [PATCH] Bring repo to functionality and usability standards.

---
 .env.example                             |   4 ++
 Makefile                                 |   2 +-
 README.md                                |  23 +++---
 config.py                                |  26 +++++--
 files/peas.jpg                           | Bin 32835 -> 0 bytes
 files/test.csv                           |  15 ----
 googlecloud_storage_tutorial/__init__.py |  19 +++--
 googlecloud_storage_tutorial/storage.py  |  85 +++++++++++++----------
 poetry.lock                              |  55 ++++++++++++++-
 pyproject.toml                           |   2 +
 10 files changed, 157 insertions(+), 74 deletions(-)
 create mode 100644 .env.example
 delete mode 100644 files/peas.jpg
 delete mode 100644 files/test.csv

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..97237e2
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,4 @@
+GCP_BUCKET_URL="https://console.cloud.google.com/storage/browser/[BUCKET_NAME]"
+GCP_BUCKET_NAME="[BUCKET_NAME]"
+GCP_BUCKET_FOLDER_NAME="foo/bar"
+GOOGLE_APPLICATION_CREDENTIALS="gcloud.json"
\ No newline at end of file
diff --git a/Makefile b/Makefile
index 033b9ec..c801821 100644
--- a/Makefile
+++ b/Makefile
@@ -35,7 +35,7 @@ $(VIRTUAL_ENV):
 
 .PHONY: run
 run: env
-	$(LOCAL_PYTHON) -m main:init_script
+	$(LOCAL_PYTHON) -m main
 
 
 .PHONY: install
diff --git a/README.md b/README.md
index adba279..9ff5fb9 100644
--- a/README.md
+++ b/README.md
@@ -13,18 +13,25 @@ Source for the accompanying tutorial here: [https://hackersandslackers.com/googl
 
 ## Getting Started
 
-Installation is recommended via Makefile
+Get set up locally in two steps:
 
-```shell
-$ git clone https://github.com/hackersandslackers/googlecloud-storage-tutorial.git
-$ cd googlecloud-storage-tutorial
-$ make install
-```
+### Environment Variables
+
+Replace the values in **.env.example** with your values and rename this file to **.env**:
+
+* `GCP_BUCKET_URL`: URL of your Google Cloud Storage bucket.
+* `GCP_BUCKET_NAME`: Name of your Google Cloud Storage bucket.
+* `GCP_BUCKET_FOLDER_NAME`: Directory within your bucket to store and modify files.
+* `GOOGLE_APPLICATION_CREDENTIALS`: Path to your Google Cloud Platform service account key file.
+
+### Installation
 
-### Usage
+Get up and running with `make run`:
 
 ```shell
-$ make run
+git clone https://github.com/hackersandslackers/googlecloud-storage-tutorial.git
+cd googlecloud-storage-tutorial
+make run
 ```
 
 -----
diff --git a/config.py b/config.py
index ea104a5..e9ae96d 100644
--- a/config.py
+++ b/config.py
@@ -1,10 +1,22 @@
 """Google Cloud Storage Configuration."""
-from os import environ
 
-# Google Cloud Storage
-bucket_url = environ.get("GCP_BUCKET_URL")
-bucket_name = environ.get("GCP_BUCKET_NAME")
-bucket_dir = environ.get("GCP_BUCKET_FOLDER_NAME")
+from os import environ, getenv, path
 
-# Data
-local_dir = environ.get("LOCAL_FOLDER")
+from dotenv import load_dotenv
+
+# Resolve local directory
+BASE_DIR: str = path.abspath(path.dirname(__file__))
+
+# Google Cloud Storage Secrets
+environ["GOOGLE_APPLICATION_CREDENTIALS"] = "gcloud.json"
+load_dotenv(path.join(BASE_DIR, ".env"))
+
+BUCKET_URL = getenv("GCP_BUCKET_URL")
+BUCKET_NAME = getenv("GCP_BUCKET_NAME")
+BUCKET_DIR = getenv("GCP_BUCKET_FOLDER_NAME")
+
+# Example local files
+LOCAL_DIR = path.join(BASE_DIR, "files")
+SAMPLE_CSV = path.join(BASE_DIR, "sample_csv.csv")
+SAMPLE_IMG = path.join(BASE_DIR, "sample_image.jpg")
+SAMPLE_TXT = path.join(BASE_DIR, "sample_text.txt")
diff --git a/files/peas.jpg b/files/peas.jpg
deleted file mode 100644
index 3e9e02fe1ddeee667a532bc899bb59536da36601..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 32835
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

diff --git a/files/test.csv b/files/test.csv
deleted file mode 100644
index 3a5d95a..0000000
--- a/files/test.csv
+++ /dev/null
@@ -1,15 +0,0 @@
-id,initiated,hiredate,email,firstname,lastname,title,department,location,country,type
-100035435,2015-12-11T09:16:20.722-08:00,3/22/67,GretchenRMorrow@jourrapide.com,Gretchen,Morrow,Power plant operator,Physical Product,Britling Cafeterias,United Kingdom,Employee
-100056435,2015-12-15T10:11:24.604-08:00,6/22/99,ElizabethLSnow@armyspy.com,Elizabeth,Snow,Oxygen therapist,Physical Product,Grade A Investment,United States of America,Employee
-100037955,2015-12-16T14:31:32.765-08:00,5/31/74,AlbertMPeterson@einrot.com,Albert,Peterson,Psychologist,Physical Product,Grass Roots Yard Services,United States of America,Employee
-100035435,2016-01-20T11:15:47.249-08:00,9/9/69,JohnMLynch@dayrep.com,John,Lynch,Environmental hydrologist,Physical Product,Waccamaw's Homeplace,United States of America,Employee
-100057657,2016-01-21T12:45:38.261-08:00,4/9/83,TheresaJCahoon@teleworm.us,Theresa,Cahoon,Personal chef,Physical Product,Cala Foods,United States of America,Employee
-100056747,2016-02-01T11:25:39.317-08:00,6/26/98,KennethHPayne@dayrep.com,Kenneth,Payne,Central office operator,Frontline,Magna Consulting,United States of America,Employee
-100035435,2016-02-01T11:28:11.953-08:00,4/16/82,LeifTSpeights@fleckens.hu,Leif,Speights,Staff development director,Frontline,Rivera Property Maintenance,United States of America,Employee
-100035435,2016-02-01T12:21:01.756-08:00,8/6/80,JamesSRobinson@teleworm.us,James,Robinson,Scheduling clerk,Frontline,Discount Furniture Showcase,United States of America,Employee
-100074688,2016-02-01T13:29:19.147-08:00,12/14/74,AnnaDMoberly@jourrapide.com,Anna,Moberly,Playwright,Physical Product,The Wiz,United States of America,Employee
-100665778,2016-02-04T14:40:05.223-08:00,9/13/66,MarjorieBCrawford@armyspy.com,Marjorie,Crawford,"Court, municipal, and license clerk",Physical Product,The Serendipity Dip,United Kingdom,Employee
-100876876,2016-02-24T12:39:25.872-08:00,12/19/67,LyleCHackett@fleckens.hu,Lyle,Hackett,Airframe mechanic,Physical Product,Infinity Investment Plan,United States of America,Employee
-100658565,2016-02-29T15:52:12.933-08:00,11/17/83,MaryJDensmore@jourrapide.com,Mary,Densmore,Employer relations representative,Frontline,One-Up Realtors,United States of America,Employee
-100766547,2016-03-01T12:32:53.357-08:00,10/1/87,CindyRDiaz@armyspy.com,Cindy,Diaz,Student affairs administrator,Physical Product,Mr. AG's,United States of America,Employee
-100045677,2016-03-02T12:07:44.264-08:00,8/16/65,AndreaTLigon@einrot.com,Andrea,Ligon,Railroad engineer,Central Growth,Robinson Furniture,United States of America,Employee
diff --git a/googlecloud_storage_tutorial/__init__.py b/googlecloud_storage_tutorial/__init__.py
index 8bde4d9..af211bc 100644
--- a/googlecloud_storage_tutorial/__init__.py
+++ b/googlecloud_storage_tutorial/__init__.py
@@ -1,5 +1,8 @@
 """Initialize script demonstration"""
-from config import bucket_dir, bucket_name, local_dir
+
+from faker import Faker
+
+from config import BUCKET_DIR, BUCKET_NAME, LOCAL_DIR
 from googlecloud_storage_tutorial.storage import (
     delete_file,
     download_random_file,
@@ -8,10 +11,14 @@
     upload_files,
 )
 
+fake = Faker()
+
 
 def init_script():
-    print(upload_files(bucket_name))
-    print(list_files(bucket_name))
-    print(download_random_file(bucket_name, bucket_dir, local_dir))
-    print(rename_file(bucket_name, bucket_dir, "test.csv", "sample_test.csv"))
-    print(delete_file(bucket_name, bucket_dir, "sample_text.txt"))
+    """Initialize script demonstration."""
+    print(upload_files(BUCKET_NAME, BUCKET_DIR, LOCAL_DIR))
+    print(list_files())
+    print(download_random_file(LOCAL_DIR))
+    print(rename_file(fake.unique.first_name()))
+    print(delete_file(BUCKET_NAME))
+    upload_files(BUCKET_NAME, BUCKET_DIR, LOCAL_DIR)
diff --git a/googlecloud_storage_tutorial/storage.py b/googlecloud_storage_tutorial/storage.py
index b9f033a..4182c5e 100644
--- a/googlecloud_storage_tutorial/storage.py
+++ b/googlecloud_storage_tutorial/storage.py
@@ -1,50 +1,49 @@
 """Programmatically interact with a Google Cloud Storage bucket."""
+
 from os import listdir
 from os.path import isfile, join
 from random import randint
-from typing import List, Optional
+from typing import List, Optional, Tuple
 
 from google.cloud import storage
+from google.cloud.storage.blob import Blob
 
-from config import bucket_dir, bucket_name, local_dir
+from config import BUCKET_DIR, BUCKET_NAME
 
+# Initialize Google Cloud Storage client
 storage_client = storage.Client()
-bucket = storage_client.get_bucket(bucket_name)
+bucket = storage_client.get_bucket(BUCKET_NAME)
 
 
-def upload_files(bucket_name: str, bucket_dir: str, local_dir: str) -> str:
+def list_files() -> List[Optional[str]]:
     """
-    Upload files to GCP bucket.
+    List all objects with file extension in a GCP bucket.
 
     :param str bucket_name: Human-readable GCP bucket name.
     :param str bucket_dir: Bucket directory in which object exists.
-    :param str local_dir: Local file path to upload/download files.
 
-    :returns: str
+    :returns: List[Optional[str]]
     """
-    files = [f for f in listdir(local_dir) if isfile(join(local_dir, f))]
-    for file in files:
-        local_file = local_dir + file
-        blob = bucket.blob(bucket_dir + file)
-        blob.upload_from_filename(local_file)
-    return f"Uploaded {files.join(', ')} to '{bucket_name}' bucket."
+    blobs = bucket.list_blobs(prefix=BUCKET_DIR)
+    blob_file_list = [blob.name for blob in blobs if "." in blob.name]
+    return blob_file_list
 
 
-def list_files(bucket_dir: str) -> List[Optional[str]]:
+def pick_random_file() -> str:
     """
-    List all objects with file extension in a GCP bucket.
+    Pick a `random` file from GCP bucket.
 
     :param str bucket_name: Human-readable GCP bucket name.
-    :param str bucket_dir: Bucket directory in which object exists.
 
-    :returns: List[Optional[str]]
+    :returns: str
     """
-    files = bucket.list_blobs(prefix=bucket_dir)
-    file_list = [file.name for file in files if "." in file.name]
-    return file_list
+    blobs = list_files()
+    rand = randint(0, len(blobs) - 1)
+    blob = bucket.blob(blobs[rand])
+    return blob, blob.name
 
 
-def download_random_file(bucket_name: str, local_dir: str) -> str:
+def download_random_file(local_dir: str) -> Tuple[Blob, str]:
     """
     Download random file from GCP bucket.
 
@@ -54,15 +53,12 @@ def download_random_file(bucket_name: str, local_dir: str) -> str:
 
     :returns: str
     """
-    fileList = list_files(bucket_name)
-    rand = randint(0, len(fileList) - 1)
-    blob = bucket.blob(fileList[rand])
-    file_name = blob.name.split("/")[-1]
-    blob.download_to_filename(local_dir + file_name)
-    return f"{file_name} downloaded from bucket."
+    blob, blob_filename = pick_random_file()
+    blob.download_to_filename(f"{local_dir}/{blob.name.split('/')[-1]}")
+    return blob, blob_filename
 
 
-def delete_file(bucket_name: str, bucket_dir: str) -> str:
+def delete_file(bucket_name: str) -> str:
     """
     Delete file from GCP bucket.
 
@@ -71,13 +67,12 @@ def delete_file(bucket_name: str, bucket_dir: str) -> str:
 
     :returns: str
     """
-    blob = bucket.blob(bucket_dir + file_name)
-    file_name = blob.name.split("/")[-1]
-    bucket.delete_blob(bucket_name + file_name)
-    return f"{file_name} deleted from bucket: {bucket_name}."
+    blob, blob_filename = pick_random_file()
+    bucket.delete_blob(blob_filename)
+    return f"{blob_filename} deleted from bucket: {bucket_name}."
 
 
-def rename_file(bucket_dir: str, new_filename: str) -> str:
+def rename_file(new_filename: str) -> str:
     """
     Rename a file in GCP bucket.
 
@@ -87,7 +82,25 @@ def rename_file(bucket_dir: str, new_filename: str) -> str:
 
     :returns: str
     """
-    blob = bucket.blob(bucket_dir + file_name)
-    file_name = blob.name.split("/")[-1]
+    blob, blob_filename = pick_random_file()
     bucket.rename_blob(blob, new_name=new_filename)
-    return f"{file_name} renamed to {new_filename}."
+    return f"{blob_filename} renamed to {new_filename}."
+
+
+def upload_files(bucket_name: str, bucket_dir: str, local_dir: str) -> str:
+    """
+    Upload files to GCP bucket.
+
+    :param str bucket_name: Human-readable GCP bucket name.
+    :param str bucket_dir: Bucket directory in which object exists.
+    :param str local_dir: Local file path to upload/download files.
+
+    :returns: str
+    """
+    files = [f for f in listdir(local_dir) if isfile(join(local_dir, f))]
+    for file in files:
+        local_file = f"{local_dir}/{file}"
+        print(f"local file = {local_file}\n")
+        blob = bucket.blob(f"{bucket_dir}/{file}")
+        blob.upload_from_filename(local_file)
+    return f"Uploaded {files} to '{bucket_name}' bucket."
diff --git a/poetry.lock b/poetry.lock
index eca8bfc..1154f7b 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -489,6 +489,20 @@ files = [
 [package.extras]
 test = ["pytest (>=6)"]
 
+[[package]]
+name = "faker"
+version = "26.2.0"
+description = "Faker is a Python package that generates fake data for you."
+optional = false
+python-versions = ">=3.8"
+files = [
+    {file = "Faker-26.2.0-py3-none-any.whl", hash = "sha256:7b123090774deff5f2cd3eb92a84dcbbf1e163f30a6d07321b7852c11bfe6a75"},
+    {file = "Faker-26.2.0.tar.gz", hash = "sha256:81768de19012147521140f0d8bf5353e501ac42c1065d25e0cac455d3615c0a7"},
+]
+
+[package.dependencies]
+python-dateutil = ">=2.4"
+
 [[package]]
 name = "fastjsonschema"
 version = "2.20.0"
@@ -1260,6 +1274,34 @@ tomli = {version = ">=1", markers = "python_version < \"3.11\""}
 [package.extras]
 dev = ["argcomplete", "attrs (>=19.2)", "hypothesis (>=3.56)", "mock", "pygments (>=2.7.2)", "requests", "setuptools", "xmlschema"]
 
+[[package]]
+name = "python-dateutil"
+version = "2.9.0.post0"
+description = "Extensions to the standard Python datetime module"
+optional = false
+python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,>=2.7"
+files = [
+    {file = "python-dateutil-2.9.0.post0.tar.gz", hash = "sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3"},
+    {file = "python_dateutil-2.9.0.post0-py2.py3-none-any.whl", hash = "sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427"},
+]
+
+[package.dependencies]
+six = ">=1.5"
+
+[[package]]
+name = "python-dotenv"
+version = "1.0.1"
+description = "Read key-value pairs from a .env file and set them as environment variables"
+optional = false
+python-versions = ">=3.8"
+files = [
+    {file = "python-dotenv-1.0.1.tar.gz", hash = "sha256:e324ee90a023d808f1959c46bcbc04446a10ced277783dc6ee09987c37ec10ca"},
+    {file = "python_dotenv-1.0.1-py3-none-any.whl", hash = "sha256:f7b63ef50f1b690dddf550d03497b66d609393b40b564ed0d674909a68ebf16a"},
+]
+
+[package.extras]
+cli = ["click (>=5.0)"]
+
 [[package]]
 name = "pywin32-ctypes"
 version = "0.2.2"
@@ -1451,6 +1493,17 @@ files = [
     {file = "shellingham-1.5.4.tar.gz", hash = "sha256:8dbca0739d487e5bd35ab3ca4b36e11c4078f3a234bfce294b0a0291363404de"},
 ]
 
+[[package]]
+name = "six"
+version = "1.16.0"
+description = "Python 2 and 3 compatibility utilities"
+optional = false
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*"
+files = [
+    {file = "six-1.16.0-py2.py3-none-any.whl", hash = "sha256:8abb2f1d86890a2dfb989f9a77cfcfd3e47c2a354b01111771326f8aa26e0254"},
+    {file = "six-1.16.0.tar.gz", hash = "sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926"},
+]
+
 [[package]]
 name = "tomli"
 version = "2.0.1"
@@ -1623,4 +1676,4 @@ test = ["big-O", "importlib-resources", "jaraco.functools", "jaraco.itertools",
 [metadata]
 lock-version = "2.0"
 python-versions = ">=3.10,<4.0"
-content-hash = "9a11e88ae48f48e4a8e386fe9e9fbbba235760dfa7e40277fa305c384622f1dc"
+content-hash = "83c584ed145d4af9403e4bd68e561e37aeedcacc47b7783a947eb49ea5135bbe"
diff --git a/pyproject.toml b/pyproject.toml
index dc540c2..c196aa7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -20,6 +20,8 @@ isort = "*"
 flake8 = "*"
 gunicorn = "*"
 poetry-plugin-export = "^1.8.0"
+faker = "^26.2.0"
+python-dotenv = "^1.0.1"
 
 [tool.poetry.scripts]
 run = "main:init_script"