python-flask-dev 0.0.1__py3-none-any.whl

app.py

@@ -0,0 +1,246 @@
+from flask import Flask
+from python_flask_dev.formatting_data import get_filtered_key_vals
+# from data.users import get_users
+app = Flask(__name__)
+
+# sample_data = get_users()
+sample_data = [
+    {
+        "id": 1,
+        "name": "Leanne Graham",
+        "username": "Bret",
+        "email": "Sincere@april.biz",
+        "address": {
+            "street": "Kulas Light",
+            "suite": "Apt. 556",
+            "city": "Gwenborough",
+            "zipcode": "92998-3874",
+            "geo": {
+                "lat": "-37.3159",
+                "lng": "81.1496"
+            }
+        },
+        "phone": "1-770-736-8031 x56442",
+        "website": "hildegard.org",
+        "company": {
+            "name": "Romaguera-Crona",
+            "catchPhrase": "Multi-layered client-server neural-net",
+            "bs": "harness real-time e-markets"
+        }
+    },
+    {
+        "id": 2,
+        "name": "Ervin Howell",
+        "username": "Antonette",
+        "email": "Shanna@melissa.tv",
+        "address": {
+            "street": "Victor Plains",
+            "suite": "Suite 879",
+            "city": "Wisokyburgh",
+            "zipcode": "90566-7771",
+            "geo": {
+                "lat": "-43.9509",
+                "lng": "-34.4618"
+            }
+        },
+        "phone": "010-692-6593 x09125",
+        "website": "anastasia.net",
+        "company": {
+            "name": "Deckow-Crist",
+            "catchPhrase": "Proactive didactic contingency",
+            "bs": "synergize scalable supply-chains"
+        }
+    },
+    {
+        "id": 3,
+        "name": "Clementine Bauch",
+        "username": "Samantha",
+        "email": "Nathan@yesenia.net",
+        "address": {
+            "street": "Douglas Extension",
+            "suite": "Suite 847",
+            "city": "McKenziehaven",
+            "zipcode": "59590-4157",
+            "geo": {
+                "lat": "-68.6102",
+                "lng": "-47.0653"
+            }
+        },
+        "phone": "1-463-123-4447",
+        "website": "ramiro.info",
+        "company": {
+            "name": "Romaguera-Jacobson",
+            "catchPhrase": "Face to face bifurcated interface",
+            "bs": "e-enable strategic applications"
+        }
+    },
+    {
+        "id": 4,
+        "name": "Patricia Lebsack",
+        "username": "Karianne",
+        "email": "Julianne.OConner@kory.org",
+        "address": {
+            "street": "Hoeger Mall",
+            "suite": "Apt. 692",
+            "city": "South Elvis",
+            "zipcode": "53919-4257",
+            "geo": {
+                "lat": "29.4572",
+                "lng": "-164.2990"
+            }
+        },
+        "phone": "493-170-9623 x156",
+        "website": "kale.biz",
+        "company": {
+            "name": "Robel-Corkery",
+            "catchPhrase": "Multi-tiered zero tolerance productivity",
+            "bs": "transition cutting-edge web services"
+        }
+    },
+    {
+        "id": 5,
+        "name": "Chelsey Dietrich",
+        "username": "Kamren",
+        "email": "Lucio_Hettinger@annie.ca",
+        "address": {
+            "street": "Skiles Walks",
+            "suite": "Suite 351",
+            "city": "Roscoeview",
+            "zipcode": "33263",
+            "geo": {
+                "lat": "-31.8129",
+                "lng": "62.5342"
+            }
+        },
+        "phone": "(254)954-1289",
+        "website": "demarco.info",
+        "company": {
+            "name": "Keebler LLC",
+            "catchPhrase": "User-centric fault-tolerant solution",
+            "bs": "revolutionize end-to-end systems"
+        }
+    },
+    {
+        "id": 6,
+        "name": "Mrs. Dennis Schulist",
+        "username": "Leopoldo_Corkery",
+        "email": "Karley_Dach@jasper.info",
+        "address": {
+            "street": "Norberto Crossing",
+            "suite": "Apt. 950",
+            "city": "South Christy",
+            "zipcode": "23505-1337",
+            "geo": {
+                "lat": "-71.4197",
+                "lng": "71.7478"
+            }
+        },
+        "phone": "1-477-935-8478 x6430",
+        "website": "ola.org",
+        "company": {
+            "name": "Considine-Lockman",
+            "catchPhrase": "Synchronised bottom-line interface",
+            "bs": "e-enable innovative applications"
+        }
+    },
+    {
+        "id": 7,
+        "name": "Kurtis Weissnat",
+        "username": "Elwyn.Skiles",
+        "email": "Telly.Hoeger@billy.biz",
+        "address": {
+            "street": "Rex Trail",
+            "suite": "Suite 280",
+            "city": "Howemouth",
+            "zipcode": "58804-1099",
+            "geo": {
+                "lat": "24.8918",
+                "lng": "21.8984"
+            }
+        },
+        "phone": "210.067.6132",
+        "website": "elvis.io",
+        "company": {
+            "name": "Johns Group",
+            "catchPhrase": "Configurable multimedia task-force",
+            "bs": "generate enterprise e-tailers"
+        }
+    },
+    {
+        "id": 8,
+        "name": "Nicholas Runolfsdottir V",
+        "username": "Maxime_Nienow",
+        "email": "Sherwood@rosamond.me",
+        "address": {
+            "street": "Ellsworth Summit",
+            "suite": "Suite 729",
+            "city": "Aliyaview",
+            "zipcode": "45169",
+            "geo": {
+                "lat": "-14.3990",
+                "lng": "-120.7677"
+            }
+        },
+        "phone": "586.493.6943 x140",
+        "website": "jacynthe.com",
+        "company": {
+            "name": "Abernathy Group",
+            "catchPhrase": "Implemented secondary concept",
+            "bs": "e-enable extensible e-tailers"
+        }
+    },
+    {
+        "id": 9,
+        "name": "Glenna Reichert",
+        "username": "Delphine",
+        "email": "Chaim_McDermott@dana.io",
+        "address": {
+            "street": "Dayna Park",
+            "suite": "Suite 449",
+            "city": "Bartholomebury",
+            "zipcode": "76495-3109",
+            "geo": {
+                "lat": "24.6463",
+                "lng": "-168.8889"
+            }
+        },
+        "phone": "(775)976-6794 x41206",
+        "website": "conrad.com",
+        "company": {
+            "name": "Yost and Sons",
+            "catchPhrase": "Switchable contextually-based project",
+            "bs": "aggregate real-time technologies"
+        }
+    },
+    {
+        "id": 10,
+        "name": "Clementina DuBuque",
+        "username": "Moriah.Stanton",
+        "email": "Rey.Padberg@karina.biz",
+        "address": {
+            "street": "Kattie Turnpike",
+            "suite": "Suite 198",
+            "city": "Lebsackbury",
+            "zipcode": "31428-2261",
+            "geo": {
+                "lat": "-38.2386",
+                "lng": "57.2232"
+            }
+        },
+        "phone": "024-648-3804",
+        "website": "ambrose.net",
+        "company": {
+            "name": "Hoeger LLC",
+            "catchPhrase": "Centralized empowering task-force",
+            "bs": "target end-to-end models"
+        }
+    }
+]
+
+@app.route('/')
+def hello_world():  # put application's code here
+    return 'Hello World!'
+
+
+if __name__ == '__main__':
+    app.run()

python_flask_dev/custom_exceptions.py

@@ -0,0 +1,10 @@
+class CustomError(Exception):
+    """Exception raised for custom error in the application."""
+    # ATT this function doesn't accept printf for the message arg; a printf string needs to be assigned to a var
+    def __init__(self, message, error_code):
+        self.message = message
+        self.error_code = error_code
+        super().__init__(message)
+
+    def __str__(self):
+        return f"{self.message} (Error Code: {self.error_code})"

python_flask_dev/data_source.py

@@ -0,0 +1,34 @@
+# TODO: coffee finish this create data_source pkg to avoid import error
+import argparse
+import pandas as pd
+import os
+from pathlib import Path
+# from ..custom_exceptions import CustomError
+
+# ENV VARS
+PROJECT_ROOT = Path(os.getenv('VIRTUAL_ENV')).parent.absolute()
+
+# ENV VARS SET FROM PARSER
+parser = argparse.ArgumentParser()
+parser.add_argument('-f', '--filename')      # option that takes a value
+args = parser.parse_args()
+FILENAME = args.filename if args.filename else f"{PROJECT_ROOT}/data/users.json"
+
+class DataSource:
+    def __init__(self, filename=FILENAME):
+        self.filename = filename
+
+    def get_accepted_filetypes(self):
+        return ['json', 'csv']
+
+    def convert_to_dict(self):
+        accepted_filetypes = ['json', 'csv']
+        filetype = Path(self.filename).suffix
+
+        if filetype == "json":
+            return pd.read_json(self.filename).to_dict()
+        elif filetype == "csv":
+            return pd.read_csv(self.filename).to_dict()
+        # else:
+        #     err_msg = f"Accepted filetypes: {str(accepted_filetypes)}"
+        #     raise CustomError(err_msg, 401)

python_flask_dev/filtering_data.py

@@ -0,0 +1,280 @@
+from flask import Flask
+import pandas as pd
+import logging
+from pathlib import Path
+import importlib.util
+import sys
+import os
+from importing_modules import get_imported_project_module
+
+test_data = [
+    {
+        "id": 1,
+        "name": "Leanne Graham",
+        "username": "Bret",
+        "email": "Sincere@april.biz",
+        "address": {
+            "street": "Kulas Light",
+            "suite": "Apt. 556",
+            "city": "Gwenborough",
+            "zipcode": "92998-3874",
+            "geo": {
+                "lat": "-37.3159",
+                "lng": "81.1496"
+            }
+        },
+        "phone": "1-770-736-8031 x56442",
+        "website": "hildegard.org",
+        "company": {
+            "name": "Romaguera-Crona",
+            "catchPhrase": "Multi-layered client-server neural-net",
+            "bs": "harness real-time e-markets"
+        }
+    },
+    {
+        "id": 2,
+        "name": "Ervin Howell",
+        "username": "Antonette",
+        "email": "Shanna@melissa.tv",
+        "address": {
+            "street": "Victor Plains",
+            "suite": "Suite 879",
+            "city": "Wisokyburgh",
+            "zipcode": "90566-7771",
+            "geo": {
+                "lat": "-43.9509",
+                "lng": "-34.4618"
+            }
+        },
+        "phone": "010-692-6593 x09125",
+        "website": "anastasia.net",
+        "company": {
+            "name": "Deckow-Crist",
+            "catchPhrase": "Proactive didactic contingency",
+            "bs": "synergize scalable supply-chains"
+        }
+    },
+    {
+        "id": 3,
+        "name": "Clementine Bauch",
+        "username": "Samantha",
+        "email": "Nathan@yesenia.net",
+        "address": {
+            "street": "Douglas Extension",
+            "suite": "Suite 847",
+            "city": "McKenziehaven",
+            "zipcode": "59590-4157",
+            "geo": {
+                "lat": "-68.6102",
+                "lng": "-47.0653"
+            }
+        },
+        "phone": "1-463-123-4447",
+        "website": "ramiro.info",
+        "company": {
+            "name": "Romaguera-Jacobson",
+            "catchPhrase": "Face to face bifurcated interface",
+            "bs": "e-enable strategic applications"
+        }
+    },
+    {
+        "id": 4,
+        "name": "Patricia Lebsack",
+        "username": "Karianne",
+        "email": "Julianne.OConner@kory.org",
+        "address": {
+            "street": "Hoeger Mall",
+            "suite": "Apt. 692",
+            "city": "South Elvis",
+            "zipcode": "53919-4257",
+            "geo": {
+                "lat": "29.4572",
+                "lng": "-164.2990"
+            }
+        },
+        "phone": "493-170-9623 x156",
+        "website": "kale.biz",
+        "company": {
+            "name": "Robel-Corkery",
+            "catchPhrase": "Multi-tiered zero tolerance productivity",
+            "bs": "transition cutting-edge web services"
+        }
+    },
+    {
+        "id": 5,
+        "name": "Chelsey Dietrich",
+        "username": "Kamren",
+        "email": "Lucio_Hettinger@annie.ca",
+        "address": {
+            "street": "Skiles Walks",
+            "suite": "Suite 351",
+            "city": "Roscoeview",
+            "zipcode": "33263",
+            "geo": {
+                "lat": "-31.8129",
+                "lng": "62.5342"
+            }
+        },
+        "phone": "(254)954-1289",
+        "website": "demarco.info",
+        "company": {
+            "name": "Keebler LLC",
+            "catchPhrase": "User-centric fault-tolerant solution",
+            "bs": "revolutionize end-to-end systems"
+        }
+    },
+    {
+        "id": 6,
+        "name": "Mrs. Dennis Schulist",
+        "username": "Leopoldo_Corkery",
+        "email": "Karley_Dach@jasper.info",
+        "address": {
+            "street": "Norberto Crossing",
+            "suite": "Apt. 950",
+            "city": "South Christy",
+            "zipcode": "23505-1337",
+            "geo": {
+                "lat": "-71.4197",
+                "lng": "71.7478"
+            }
+        },
+        "phone": "1-477-935-8478 x6430",
+        "website": "ola.org",
+        "company": {
+            "name": "Considine-Lockman",
+            "catchPhrase": "Synchronised bottom-line interface",
+            "bs": "e-enable innovative applications"
+        }
+    },
+    {
+        "id": 7,
+        "name": "Kurtis Weissnat",
+        "username": "Elwyn.Skiles",
+        "email": "Telly.Hoeger@billy.biz",
+        "address": {
+            "street": "Rex Trail",
+            "suite": "Suite 280",
+            "city": "Howemouth",
+            "zipcode": "58804-1099",
+            "geo": {
+                "lat": "24.8918",
+                "lng": "21.8984"
+            }
+        },
+        "phone": "210.067.6132",
+        "website": "elvis.io",
+        "company": {
+            "name": "Johns Group",
+            "catchPhrase": "Configurable multimedia task-force",
+            "bs": "generate enterprise e-tailers"
+        }
+    },
+    {
+        "id": 8,
+        "name": "Nicholas Runolfsdottir V",
+        "username": "Maxime_Nienow",
+        "email": "Sherwood@rosamond.me",
+        "address": {
+            "street": "Ellsworth Summit",
+            "suite": "Suite 729",
+            "city": "Aliyaview",
+            "zipcode": "45169",
+            "geo": {
+                "lat": "-14.3990",
+                "lng": "-120.7677"
+            }
+        },
+        "phone": "586.493.6943 x140",
+        "website": "jacynthe.com",
+        "company": {
+            "name": "Abernathy Group",
+            "catchPhrase": "Implemented secondary concept",
+            "bs": "e-enable extensible e-tailers"
+        }
+    },
+    {
+        "id": 9,
+        "name": "Glenna Reichert",
+        "username": "Delphine",
+        "email": "Chaim_McDermott@dana.io",
+        "address": {
+            "street": "Dayna Park",
+            "suite": "Suite 449",
+            "city": "Bartholomebury",
+            "zipcode": "76495-3109",
+            "geo": {
+                "lat": "24.6463",
+                "lng": "-168.8889"
+            }
+        },
+        "phone": "(775)976-6794 x41206",
+        "website": "conrad.com",
+        "company": {
+            "name": "Yost and Sons",
+            "catchPhrase": "Switchable contextually-based project",
+            "bs": "aggregate real-time technologies"
+        }
+    },
+    {
+        "id": 10,
+        "name": "Clementina DuBuque",
+        "username": "Moriah.Stanton",
+        "email": "Rey.Padberg@karina.biz",
+        "address": {
+            "street": "Kattie Turnpike",
+            "suite": "Suite 198",
+            "city": "Lebsackbury",
+            "zipcode": "31428-2261",
+            "geo": {
+                "lat": "-38.2386",
+                "lng": "57.2232"
+            }
+        },
+        "phone": "024-648-3804",
+        "website": "ambrose.net",
+        "company": {
+            "name": "Hoeger LLC",
+            "catchPhrase": "Centralized empowering task-force",
+            "bs": "target end-to-end models"
+        }
+    }
+]
+
+app = Flask(__name__)
+logger = logging.getLogger(__name__)
+
+# def get_imported_project_module(module_name, module_path):
+#     project_root = Path(os.getenv('VIRTUAL_ENV')).parent.absolute()
+#
+#     # Create the module object from the spec
+#     module_spec = importlib.util.spec_from_file_location(module_name, Path(f"{project_root}/{module_path}"))
+#
+#     # Load the module
+#     custom_module = importlib.util.module_from_spec(module_spec)
+#     sys.modules[module_name] = custom_module
+#     module_spec.loader.exec_module(custom_module)
+#     return custom_module
+
+def get_filtered_key_vals(key, dictionary = None, filepath = None):
+    # data_source = get_imported_project_module("data_source", "./src/python_flask_dev/data_source.py")
+    data_source = get_imported_project_module(("data_source", ))
+    if dictionary:
+        dataframe = pd.DataFrame(dictionary)
+    elif filepath:
+        data = data_source.DataSource.convert_to_dict(filepath)
+        dataframe = pd.DataFrame(data)
+    # else:
+    #     err_msg = "No data source provided. Please provide either a dictionary or a filepath to a JSON file."
+    #     raise CustomError(err_msg, 400)
+
+    return list(dataframe.to_dict().get(key).values())
+
+if __name__ == "__main__":
+    logging.basicConfig(level=logging.INFO)
+    # filtered_data = get_filtered_key_vals('id', dictionary=test_data)
+    # # filtered_data = get_filtered_key_vals('id')
+    # logger.info(f"filtered_data: {filtered_data}")
+
+    project_root = Path(os.getenv('VIRTUAL_ENV')).parent.absolute()
+
+    logger.info(f"Testing data source import: {project_root}")

python_flask_dev/formatting_data.py

@@ -0,0 +1,2 @@
+# TODO: create a function for dictionary comprehension; e.g., a list of dicts can be transformed into a dict of dicts; there might be an existing function or library that does this
+# dictionary comprehension:

python_flask_dev/importing_modules.py

@@ -0,0 +1,64 @@
+import os
+import sys
+import importlib.util
+from pathlib import Path
+import site
+import logging
+
+
+logger = logging.getLogger(__name__)
+logging.basicConfig(level=logging.INFO)
+
+def get_imported_project_module(module_name, module_path = None, add_to_import_system = False):
+    logger.info(f"##### module_path: {module_path}")
+    # Create the module object from the spec
+    module_spec = importlib.util.spec_from_file_location(module_name, Path(module_path))
+    logger.info(f"##### module_spec: {module_spec}")
+    # Load the module
+    custom_module = importlib.util.module_from_spec(module_spec)
+
+    # Optionally add the module to sys.modules so it's treated as a normal import
+    if add_to_import_system:
+        sys.modules[module_name] = custom_module
+
+    module_spec.loader.exec_module(custom_module)
+
+    # The module  is callable: `custom_module.some_function()`
+    return custom_module
+
+# Note that, typically, this is not recommended for python projects; Modules located within the directory that is added to the search path can be imported.
+def modify_venv_pythonpath(*, pth_filename = "imported-project-modules.pth", absolute_pkg_path = None, installed_pkg_name = None):
+    site_dir = site.getsitepackages()[0]
+    logger.info(f"########## site_dir: {site_dir}")
+
+    if absolute_pkg_path:
+        pkg_path = absolute_pkg_path
+    elif installed_pkg_name:
+        pkg_path = f"{site_dir}/{installed_pkg_name}"
+    else:
+        raise Exception("ERROR: absolute_pkg_path or installed_pkg_name is required")
+
+    # Create/write to a .pth file, listing the path of the package to import:
+    site_pkgs_pth_filepath = f"{site_dir}/{pth_filename}"
+    try:
+        with open(site_pkgs_pth_filepath, 'r') as file:
+            lines = [line.strip() for line in file]
+    except Exception as e:
+        logger.error(e)
+        lines = []
+
+    logger.info(f"########## pkg_path: {pkg_path}")
+    logger.info(f"########## lines: {lines}")
+
+    if pkg_path not in lines:
+        with open(site_pkgs_pth_filepath, 'a') as file:
+            if pkg_path not in lines:
+                logger.info(f"########## writing to site-pkgs .pth; pkg_path: {pkg_path}")
+                file.write(pkg_path + '\n')
+
+    # Add the package:
+    known_paths = set(sys.path)
+    logger.info(f"########## known_paths: {known_paths}")
+    site.addpackage(site_dir, site_pkgs_pth_filepath, known_paths)
+    if pkg_path in os.listdir(site_dir):
+        logger.info(f"########## `{pkg_path}` package added to the Python packages search system path")

python_flask_dev/packaging/incremental_versioning.py

@@ -0,0 +1,107 @@
+import logging
+import requests
+import tomllib
+import tomli_w
+import argparse
+
+
+
+# ENV VARS
+PYPI_BASE_URL = "https://pypi.org/simple/"
+VERSIONING = "manual"
+
+# ARGS
+parser = argparse.ArgumentParser()
+parser.add_argument('-v', '--versioning', default="manual", help='Options: "automatic", "dynamic", "manual"')
+args = parser.parse_args()
+
+# LOGGING
+logger = logging.getLogger(__name__)
+logging.basicConfig(level=logging.INFO)
+
+def get_pypi_repository_data(toml_data):
+    # Retrieve latest version from PyPI API data
+    # TODO: [START] replace
+    # project_name = toml_data["project"]["name"]
+    project_name = "my_simple_test"
+    # TODO: [END] replace
+    pypi_project_url = f"{PYPI_BASE_URL}{project_name}"
+    resp = requests.get(pypi_project_url, headers={"Accept": "application/vnd.pypi.simple.v1+json"}).json()
+    logging.info(f"########################## pypi_project_url: {pypi_project_url}")
+
+    project_versions = resp["versions"]
+    project_versions.sort(reverse=True)
+    project_latest_version = project_versions[0]
+
+    return {"project_name": project_name, "pypi_project_url": pypi_project_url, "project_versions": project_versions, "project_latest_version": project_latest_version}
+
+def update_pyproject_config(toml_data):
+    with open("pyproject.toml", "wb") as f:
+        tomli_w.dump(toml_data, f)
+
+def set_version_manually(toml_data):
+    if "version" in toml_data["project"]["dynamic"]:
+        toml_data["project"]["dynamic"].remove("version")
+        update_pyproject_config(toml_data)
+
+    logging.info("Manual versioning selected. Please update the version number in pyproject.toml manually.")
+
+def set_version_dynamically(toml_data):
+    if "version" in toml_data["project"]:
+        del toml_data["project"]["version"]
+        update_pyproject_config(toml_data)
+
+    if "version" not in toml_data["project"]["dynamic"]:
+        toml_data["project"]["dynamic"].append("version")
+        update_pyproject_config(toml_data)
+
+    logging.info("Dynamic versioning selected. Please set the version number in the 'version.txt' file.")
+
+def set_version_automatically(toml_data):
+    project_name, pypi_project_url, project_versions, project_latest_version = get_pypi_repository_data(toml_data).values()
+
+    # Change the version number
+    project_versioning_list = project_latest_version.split(".")
+    project_versioning_list[2] = f"{int(project_versioning_list[2]) + 1}"
+    logger.info(f"############## project_versioning_list: {project_versioning_list}")
+    new_project_version = '.'.join(project_versioning_list)
+    logger.info(f"############## new_project_version: {new_project_version}")
+
+    # Write the new version number
+    toml_data["project"]["version"] = new_project_version
+    if "version" in toml_data["project"]["dynamic"]:
+        toml_data["project"]["dynamic"].remove("version")
+    update_pyproject_config(toml_data)
+    logging.info(f"Automatic versioning selected. Version number updated to {new_project_version} in pyproject.toml.")
+
+def incremental_versioning(versioning):
+    # Read project data from pyproject.toml
+    with open("pyproject.toml", "rb") as f:
+        toml_data = tomllib.load(f)
+        logger.info(f"############ toml_data: {toml_data}")
+
+        if "version" not in toml_data["project"]:
+            toml_data["project"]["version"] = []
+            update_pyproject_config(toml_data)
+
+        if "dynamic" not in toml_data["project"]:
+            toml_data["project"]["dynamic"] = []
+            update_pyproject_config(toml_data)
+
+    logging.info(f"######## Project: {get_pypi_repository_data(toml_data)['project_name']}")
+    logging.info(f"######## Version: {get_pypi_repository_data(toml_data)['project_latest_version']}")
+
+    if versioning == "manual":
+        set_version_manually(toml_data)
+    elif versioning == "dynamic":
+        set_version_dynamically(toml_data)
+    elif versioning == "automatic":
+        set_version_automatically(toml_data)
+    else:
+        set_version_manually(toml_data)
+        logging.info("Defaulting to manual versioning. Options: 'automatic', 'dynamic', 'manual'")
+
+if __name__ == "__main__":
+    # TODO: replace in python-flask-dev pkg; passed in as var
+    versioning = args.versioning
+    incremental_versioning(versioning)

python_flask_dev/path_retrieval.py

@@ -0,0 +1,11 @@
+import os
+from pathlib import Path
+
+
+# Get project root
+project_root = Path(os.getenv('VIRTUAL_ENV')).parent.absolute()
+
+# Filter for subfolders
+def filter_for_subfolders(folder, filter_str=""):
+    subfolders = [ f.path for f in os.scandir(folder) if f.is_dir() and f.name.endswith(filter_str) ]
+    return subfolders

python_flask_dev-0.0.1.dist-info/METADATA

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: python-flask-dev
+Version: 0.0.1
+Summary: Package containing modules with 'helper' functions to support the development of Python Flask applications.
+Author-email: Dani <daniasestan@gmail.com>
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Framework :: Flask
+Requires-Python: >=3.12.3
+Description-Content-Type: text/markdown
+Requires-Dist: Flask==3.1.2
+Requires-Dist: numpy==2.4.2
+Requires-Dist: pandas==3.0.1
+Requires-Dist: build==1.4.0
+Requires-Dist: twine==6.2.0
+
+## Python Flask Dev
+
+## Table of contents
+
+1. Project description
+2. Project setup
+3. Contributing guidelines
+4. Project documentation
+5. Links to support resources
+6. Terms of use
+
+## Project description
+
+### What kind of software is this?
+
+Package containing modules with 'helper' functions to support the development of Python Flask applications.
+
+__________________
+
+### Who can use this app?
+
+Python Flask App Developer
+
+__________________
+
+### Project overview
+
+Language(s): [Python](https://www.python.org/)
+
+Framework(s): [Python Flask Framework](https://flask.palletsprojects.com/en/stable/)
+
+Style guide(s):
+[Python PEP 8](https://www.python.org/dev/peps/pep-0008)
+
+## Project setup
+
+### Pre-requisites
+
+Before using {Project name}, install necessary pkgs:
+
+* [PKG_NAME](https://www.python.org/downloads/)
+* [...]
+
+### Requirements
+
+GitHub will automatically not push any tokens.
+
+However, to commit any changes the .gitignore file must include any files that contain credentials.
+
+If the Markdown Changelog Generator is used, it needs to include  'changelog_generator.toml' because it lists your GitHub repo's PAT (Personal Access Token). 
+
+#### Install Python Flask Dev
+
+1. {Write the step here.}
+
+   {Explanatory text here}
+
+   {Optional: Include a code sample or screenshot that helps your users complete this step}
+
+2. {Write the step here.}
+
+   a. {Substep 1}
+
+   b. {Substep 2}
+
+#### Configure Python Flask Dev
+
+1. {Write the step here.}
+2. {Write the step here.}
+
+#### Run Python Flask Dev
+
+1. {Write the step here.}
+2. {Write the step here.}
+
+#### Troubleshoot Python Flask Dev
+
+1. {Write the step here.}
+2. {Write the step here.}
+
+<table>
+  <tr>
+   <td>
+    Issue
+   </td>
+   <td>
+    Solution
+   </td>
+  </tr>
+  <tr>
+   <td>
+    {Describe the issue here}
+   </td>
+   <td>
+    {Write solution here}
+   </td>
+  </tr>
+  <tr>
+   <td>
+    {Describe the issue here}
+   </td>
+   <td>
+    {Write solution here}
+   </td>
+  </tr>
+  <tr>
+   <td>
+    {Describe the issue here}
+   </td>
+   <td>
+    {Write solution here}
+   </td>
+  </tr>
+</table>
+
+Other troubleshooting support:
+
+* {Link to FAQs}
+* {Link to runbooks}
+* {Link to other relevant support information}
+
+### Recommendations
+
+* When working through a smaller project such as a program or a software application, a Changelog is recommended.
+
+Changelog entries typically follow a basic format that includes information about the code that was added to enhance a project, removed for any purpose, and modified to resolve errors.
+
+Changelog entries are entered in the CHANGELOG file once code is committed to the main branch:
+
+### [VERSION #] - [TIMESTAMP]
+
+#### [ADDED || REMOVED || FIXED]
+
+\<DESCRIPTION\>
+
+___
+
+### Version Control Process
+I. **Create a Feature Branch**
+Any code updates for a version change -- [Major].[Minor].[Patch] -- should be on a separate branch, referred to as a 'feature' branch.
+
+Once work on the branch is completed, a pull-request can be created to merge the branch into `dev`, a staging/pre-release branch, where those changes are tested.
+
+Once the staging branch is tested, stable code can be merged into `main` a production/release branch.
+
+________________
+##### Maintaining repos
+
+###### Branch Naming Conventions
+
+`<VERSION-RELEASE-#>/<FEATURE_NAME>/<CONTRIBUTOR>`
+
+- `<VERSION-RELEASE-#>`: Refer to [SemVer](https://semver.org/) for details
+
+- `<FEATURE_NAME>`: Descriptive title for the feature
+
+- `<CONTRIBUTOR>`: GitHub account name, e.g., https://github.com/<NAME>
+
+IV. **Documenting changes**
+
+Maintaining a CHANGELOG file is always recommended for a quick overview of how the project is progressing.
+1. Checkout main locally.
+2. From a terminal session, run the commands to use the GitHub ChangeLog Generator.
+3. Commit the CHANGELOG file to the remote branch.
+
+`changelog-generator-md`
+
+## Project documentation
+
+### Standard project docs are located in the `{PROJECT_ROOT}` folder.
+
+- README
+- LICENSE
+- CHANGELOG
+    - Refer to the Project dependencies section of the README for more information on generating a CHANGELOG file
+
+## Links
+
+* [<LINK>](<URL>): <LINK_DESC>
+* [...]
+
+## Terms of use
+
+Python Flask Dev is licensed under [MIT](https://commons.wikimedia.org/wiki/Template:X11)

python_flask_dev-0.0.1.dist-info/RECORD

@@ -0,0 +1,16 @@
+__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+app.py,sha256=-C1PWJ1n-wBA-tiePmkPIupFodGgELwNHP0hujKCNVw,7113
+data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_flask_dev/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_flask_dev/custom_exceptions.py,sha256=VYcq3LAv-Xohe_EoP7YJsXQAIvDhiyHsyRAxj0VfR_c,443
+python_flask_dev/data_source.py,sha256=QtBSlleKoGqAq751xNh2G2ZIQwEIzHpre5jDvGzJszA,1109
+python_flask_dev/filtering_data.py,sha256=hB6M-anMztg1Nhi6ilxGBYMEpqUMKGmmGoS0vkeNx2o,8583
+python_flask_dev/formatting_data.py,sha256=bGTNnvRaACn_E44-03CoQ9Fc_oK3_aISROaLLJZLdKg,209
+python_flask_dev/importing_modules.py,sha256=rsRPM46WdeNGiVlp_xbpMucRWLLaE6fA37gFqo3Y9R0,2532
+python_flask_dev/path_retrieval.py,sha256=8jmSCJ5SKKvtjI6lQtr9gQH6RIFDU9_ouiL2GsaXb00,319
+python_flask_dev/packaging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_flask_dev/packaging/incremental_versioning.py,sha256=LasMc3G1YFFG5qJnjDOj6-5BM9fQrB1v9r6q7MeMYHI,4243
+python_flask_dev-0.0.1.dist-info/METADATA,sha256=zqohdrLvKgsXeZNd5OTAmhyv9Wu4yGhGoRkkSZX3n70,4775
+python_flask_dev-0.0.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+python_flask_dev-0.0.1.dist-info/top_level.txt,sha256=LhLe2esd0pDfth_R0Ai8vfZMgucbwmfJAEpJla6Vk8w,35
+python_flask_dev-0.0.1.dist-info/RECORD,,

python_flask_dev-0.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

python_flask_dev-0.0.1.dist-info/top_level.txt

@@ -0,0 +1,4 @@
+__init__
+app
+data
+python_flask_dev