pygooglecloud 0.0.3__tar.gz → 0.0.4__tar.gz

pygooglecloud-0.0.4/.gitignore

@@ -0,0 +1,163 @@
+# generated
+/build/
+/toolchain/
+/dist/
+/target/
+/out/
+*.out
+/.mypy_cache/
+
+# folders to git ignore
+/*.gi
+
+# gems
+/gems/
+
+# hive
+derby.log
+dfs/
+metastore_db/
+
+# c, c++ stuff
+*.o
+*.so
+*.a
+*.dis
+/Makefile.bak
+*.o.ur-safe
+*.oo
+*.elf
+*.dep
+/core.*
+lib*.so.*
+*.gch
+*.pchi
+*.gcda
+
+# kernel stuff
+*.ko
+# *.mod
+*.mod.c
+*.mod.cmd
+.*.o.cmd
+.*.ko.cmd
+.*.o.tmp
+.*.o.d
+.tmp_versions
+Module.symvers
+modules.order
+*.objdump
+/src/kernel/.*.tmp
+.modules.*.cmd
+.Module.*.cmd
+/flags.cfg
+# device tree binary files and binary overlay files
+*.dtb
+*.dtbo
+
+# sphinx
+/docs/_build/
+/docs/.doctrees/environment.pickle
+
+# installations
+/external/
+/install/
+*.tar.gz
+
+# python
+__pycache__/
+*.py[oc]
+/wheel/
+/.venv/
+.coverage
+.coverage.*
+coverage.xml
+*.egg-info/
+
+# mine
+/.pydmt.build.errors
+/.pydmt/
+*.stamp
+*.stamp.*
+
+# java
+*.class
+*.jar
+*.war
+*.ear
+*.jsa
+/.mtj.tmp/
+/hs_err_pid*
+
+# node modules
+node_modules/
+
+# ppt, pdf
+/doc/odp/*.pdf
+/doc/odp/*.ppt
+
+# intel compiler pgo
+*.dyn
+*.dpi
+# *.lock
+
+# dwarf dynamic debug info
+*.dwo
+
+# locks by open office
+.~lock.*
+
+# haskell
+*.hi
+
+# repositries of deb packages
+/deb/mypackage/DEBIAN/control
+
+# generic
+*.log
+
+# scons
+.sconsign.dblite
+
+# DS_Store
+.DS_Store
+
+# Java stuff
+.gradle/
+target/
+build/
+
+# Jupyter notebooks
+.ipynb_checkpoints/
+
+# c#
+**/obj/
+**/bin/
+
+# vscode
+.vscode/
+
+# qemu
+*.qcow2
+*.iso
+
+# jetbrains and eclipse
+.cache
+.settings
+.classpath
+.project
+.project.xml
+.idea/
+build.properties
+
+# spark
+spark-warehouse/
+
+# terraform
+.terraform*
+terraform.tfstate
+terraform.tfstate.backup
+
+# scala
+target/
+project/

pygooglecloud-0.0.4/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: pygooglecloud
+Version: 0.0.4
+Summary: pygooglecloud helps you with command line interaction with gcp
+Project-URL: Homepage, https://github.com/veltzer/pygooglecloud
+Project-URL: Bug Tracker, https://github.com/veltzer/pygooglecloud/issues
+Project-URL: Documentation, https://veltzer.github.io/pygooglecloud
+Project-URL: Download, https://pypi.org/project/pygooglecloud/
+Project-URL: Repository, https://github.com/veltzer/pygooglecloud
+Author-email: Mark Veltzer <mark.veltzer@gmail.com>
+Maintainer-email: Mark Veltzer <mark.veltzer@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: gae,gcp,python,shell,utilities
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: google-auth
+Requires-Dist: pylogconf
+Requires-Dist: pytconf
+Description-Content-Type: text/markdown
+
+# *pygooglecloud* project by Mark Veltzer
+
+description: pygooglecloud helps you with command line interaction with gcp
+
+project website: https://veltzer.github.io/pygooglecloud
+
+author: Mark Veltzer
+
+version: 0.0.4
+
+![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)
+
+## github
+
+![License](https://img.shields.io/github/license/veltzer/pygooglecloud)
+
+## build
+
+![build](https://github.com/veltzer/pygooglecloud/workflows/build/badge.svg)
+
+## pypi
+
+![PyPI - Status](https://img.shields.io/pypi/status/pygooglecloud)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pygooglecloud)
+![PyPI - License](https://img.shields.io/pypi/l/pygooglecloud)
+![PyPI - Package Name](https://img.shields.io/pypi/v/pygooglecloud)
+![PyPI - Format](https://img.shields.io/pypi/format/pygooglecloud)
+
+## pypi download
+
+![PyPI - Downloads](https://img.shields.io/pypi/dd/pygooglecloud)
+![PyPI - Downloads](https://img.shields.io/pypi/dw/pygooglecloud)
+![PyPI - Downloads](https://img.shields.io/pypi/dm/pygooglecloud)
+
+
+
+## contact me
+[mailto](mailto:mark.veltzer@gmail.com)
+![gitter](https://img.shields.io/gitter/room/veltzer/mark.veltzer)
+![discord](https://img.shields.io/discord/719336281624281119)
+![discord](https://img.shields.io/discord/719336282194444302)
+
+Mark Veltzer, Copyright © 2024, 2025

pygooglecloud-0.0.4/README.md

@@ -0,0 +1,43 @@
+# *pygooglecloud* project by Mark Veltzer
+
+description: pygooglecloud helps you with command line interaction with gcp
+
+project website: https://veltzer.github.io/pygooglecloud
+
+author: Mark Veltzer
+
+version: 0.0.4
+
+![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)
+
+## github
+
+![License](https://img.shields.io/github/license/veltzer/pygooglecloud)
+
+## build
+
+![build](https://github.com/veltzer/pygooglecloud/workflows/build/badge.svg)
+
+## pypi
+
+![PyPI - Status](https://img.shields.io/pypi/status/pygooglecloud)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pygooglecloud)
+![PyPI - License](https://img.shields.io/pypi/l/pygooglecloud)
+![PyPI - Package Name](https://img.shields.io/pypi/v/pygooglecloud)
+![PyPI - Format](https://img.shields.io/pypi/format/pygooglecloud)
+
+## pypi download
+
+![PyPI - Downloads](https://img.shields.io/pypi/dd/pygooglecloud)
+![PyPI - Downloads](https://img.shields.io/pypi/dw/pygooglecloud)
+![PyPI - Downloads](https://img.shields.io/pypi/dm/pygooglecloud)
+
+
+
+## contact me
+[mailto](mailto:mark.veltzer@gmail.com)
+![gitter](https://img.shields.io/gitter/room/veltzer/mark.veltzer)
+![discord](https://img.shields.io/discord/719336281624281119)
+![discord](https://img.shields.io/discord/719336282194444302)
+
+Mark Veltzer, Copyright © 2024, 2025

pygooglecloud-0.0.4/pyproject.toml

@@ -0,0 +1,86 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pygooglecloud"
+version = "0.0.4"
+requires-python = ">=3.12"
+authors = [
+	{ name = "Mark Veltzer", email = "mark.veltzer@gmail.com" }
+]
+maintainers = [
+	{ name = "Mark Veltzer", email = "mark.veltzer@gmail.com" }
+]
+description = "pygooglecloud helps you with command line interaction with gcp"
+readme = "README.md"
+license = "MIT"
+keywords=[
+    "gcp",
+    "gae",
+    "python",
+    "shell",
+    "utilities",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Utilities",
+    "License :: OSI Approved :: MIT License",
+]
+dependencies = [
+    "pylogconf",
+    "pytconf",
+    "google-auth",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/veltzer/pygooglecloud"
+"Bug Tracker" = "https://github.com/veltzer/pygooglecloud/issues"
+"Documentation" = "https://veltzer.github.io/pygooglecloud"
+"Download" = "https://pypi.org/project/pygooglecloud/"
+"Repository" = "https://github.com/veltzer/pygooglecloud"
+
+[project.scripts]
+pygooglecloud = "pygooglecloud.main:main"
+
+[tool.ruff]
+line-length = 130
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pygooglecloud"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/pygooglecloud/",
+    "README.md",
+    "LICENSE",
+    "pyproject.toml"
+]
+exclude = [
+    ".gitignore",
+    ".github/",
+    "tests/",
+    "docs/",
+    "config/",
+    "*.md",
+]
+
+[tool.mypy]
+python_version = "3.12"
+warn_return_any = true
+warn_unused_configs = true
+
+[tool.hatch.envs.default]
+installer = "uv"
+
+[tool.uv.pip]
+prerelease = "disallow"

pygooglecloud-0.0.4/src/pygooglecloud/__init__.py

@@ -0,0 +1,3 @@
+"""
+Initialize the module
+"""

pygooglecloud-0.0.4/src/pygooglecloud/main.py

@@ -0,0 +1,146 @@
+"""
+The default group of operations that pygooglecloud has
+"""
+import configparser
+import json
+import os
+import sys
+
+import pylogconf.core
+from pytconf import register_endpoint, register_main, config_arg_parse_and_launch
+import google.auth._cloud_sdk
+
+from pygooglecloud.static import APP_NAME, DESCRIPTION, VERSION_STR
+
+# Per-repo file (at the git root) naming the gcloud configuration to use.
+GCP_CONF_FILE = ".gcp.conf"
+GCP_CONF_KEY = "gcp_configuration_name"
+
+_LOGIN_HINT = "Run: gcloud auth application-default login"
+
+
+def _die(message: str) -> None:
+    """Print a short, clear, single-line error to stderr and exit non-zero.
+
+    No traceback: this command is meant to be called from shell startup
+    (e.g. an auto-enter hook), so a wall of Python stack trace is just noise.
+    """
+    print(f"pygooglecloud: {message}", file=sys.stderr)
+    raise SystemExit(1)
+
+
+def _read_configuration_name() -> str:
+    """Return the gcloud configuration name from ./.gcp.conf at the git root.
+
+    The file is a flat key=value file, e.g.:
+        gcp_configuration_name=machines
+    """
+    if not os.path.isfile(GCP_CONF_FILE):
+        _die(f"no {GCP_CONF_FILE} found in the current directory (the git root).")
+    # configparser needs a section header; .gcp.conf has none, so synthesize one.
+    parser = configparser.ConfigParser()
+    with open(GCP_CONF_FILE, encoding="utf-8") as stream:
+        parser.read_string("[gcp]\n" + stream.read())
+    name = parser["gcp"].get(GCP_CONF_KEY, "").strip()
+    if not name:
+        _die(f"{GCP_CONF_FILE} does not set {GCP_CONF_KEY}.")
+    return name
+
+
+def _read_project_from_configuration(name: str) -> str:
+    """Return the [core] project from the gcloud configuration named `name`.
+
+    Reads the on-disk gcloud configuration file directly (an INI file). This is
+    a pure file read with no network call and no dependency on the gcloud CLI,
+    which keeps invocation from a shell startup hook instant.
+    """
+    config_dir = google.auth._cloud_sdk.get_config_path()
+    config_file = os.path.join(config_dir, "configurations", f"config_{name}")
+    if not os.path.isfile(config_file):
+        _die(f"gcloud configuration '{name}' not found at {config_file}.")
+    parser = configparser.ConfigParser()
+    parser.read(config_file, encoding="utf-8")
+    project = parser.get("core", "project", fallback="").strip()
+    if not project:
+        _die(f"gcloud configuration '{name}' has no project set.")
+    return project
+
+
+@register_endpoint(
+    description="get the current project id",
+    configs=[],
+)
+def get_project_id() -> None:
+    """
+    Print the GCP project id for this repository.
+
+    The project is resolved purely from local files (no network, no ADC):
+    1. read ./.gcp.conf (at the git root) for the gcloud configuration name
+    2. read that gcloud configuration's [core] project
+
+    Failures are reported as short one-line messages, no traceback.
+    """
+    name = _read_configuration_name()
+    print(_read_project_from_configuration(name))
+
+
+def _is_valid_json_file(path: str) -> bool:
+    """Return True if `path` is a file containing parseable JSON."""
+    try:
+        with open(path, encoding="utf-8") as stream:
+            json.load(stream)
+    except (OSError, ValueError):
+        return False
+    return True
+
+
+@register_endpoint(
+    description="check that Google credentials are present and well-formed",
+    configs=[],
+)
+def check_credentials() -> None:
+    """
+    Verify that local Google credentials are present and well-formed.
+
+    This is a pure local-file check with NO network call, so it is safe to run
+    from a shell startup hook without slowing down directory changes. It does
+    not (and cannot, without the network) detect a key that has been disabled
+    or revoked server-side; it catches the common cases of a missing or
+    corrupt credentials file.
+
+    Two credential styles, with advice tailored to each:
+    - service-account key: GOOGLE_APPLICATION_CREDENTIALS points at a JSON key
+      file (as set per-repo from the .gcp.conf project). A missing or malformed
+      file means the key needs to be (re)placed.
+    - user login: no GOOGLE_APPLICATION_CREDENTIALS; the gcloud Application
+      Default Credentials file is used, refreshed via `gcloud auth ... login`.
+    """
+    sa_key = os.environ.get("GOOGLE_APPLICATION_CREDENTIALS")
+    if sa_key:
+        if not os.path.isfile(sa_key):
+            _die(f"service-account key not found at {sa_key}.")
+        if not _is_valid_json_file(sa_key):
+            _die(f"service-account key at {sa_key} is not valid JSON.")
+        print("credentials OK")
+        return
+
+    adc_path = google.auth._cloud_sdk.get_application_default_credentials_path()
+    if not os.path.isfile(adc_path):
+        _die(f"no Google credentials found. {_LOGIN_HINT}")
+    if not _is_valid_json_file(adc_path):
+        _die(f"Google credentials at {adc_path} are malformed. {_LOGIN_HINT}")
+    print("credentials OK")
+
+
+@register_main(
+    main_description=DESCRIPTION,
+    app_name=APP_NAME,
+    version=VERSION_STR,
+)
+def main():
+    pylogconf.core.setup()
+    config_arg_parse_and_launch()
+
+
+if __name__ == "__main__":
+    main()

{pygooglecloud-0.0.3 → pygooglecloud-0.0.4/src}/pygooglecloud/static.py

@@ -1,5 +1,5 @@
 """ version which can be consumed from within the module """
-VERSION_STR = "0.0.3"
+VERSION_STR = "0.0.4"
 DESCRIPTION = "pygooglecloud helps you with command line interaction with gcp"
 APP_NAME = "pygooglecloud"
 LOGGER_NAME = "pygooglecloud"

pygooglecloud-0.0.3/PKG-INFO

@@ -1,45 +0,0 @@
-Metadata-Version: 2.1
-Name: pygooglecloud
-Version: 0.0.3
-Summary: pygooglecloud helps you with command line interaction with gcp
-Home-page: https://veltzer.github.io/pygooglecloud
-Download-URL: https://github.com/veltzer/pygooglecloud
-Author: Mark Veltzer
-Author-email: mark.veltzer@gmail.com
-Maintainer: Mark Veltzer
-Maintainer-email: mark.veltzer@gmail.com
-License: MIT
-Keywords: gcp,gae,python,shell,utilities
-Platform: python3
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Topic :: Utilities
-Classifier: License :: OSI Approved :: MIT License
-Description-Content-Type: text/x-rst
-License-File: LICENSE
-Requires-Dist: pylogconf
-Requires-Dist: pytconf
-Requires-Dist: google-auth
-
-===============
-*pygooglecloud*
-===============
-
-.. image:: https://img.shields.io/pypi/v/pygooglecloud
-
-.. image:: https://img.shields.io/github/license/veltzer/pygooglecloud
-
-.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
-
-project website: https://veltzer.github.io/pygooglecloud
-
-author: Mark Veltzer
-
-version: 0.0.3
-
-	Mark Veltzer <mark.veltzer@gmail.com>, Copyright © 2024

pygooglecloud-0.0.3/README.rst

@@ -1,17 +0,0 @@
-===============
-*pygooglecloud*
-===============
-
-.. image:: https://img.shields.io/pypi/v/pygooglecloud
-
-.. image:: https://img.shields.io/github/license/veltzer/pygooglecloud
-
-.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
-
-project website: https://veltzer.github.io/pygooglecloud
-
-author: Mark Veltzer
-
-version: 0.0.3
-
-	Mark Veltzer <mark.veltzer@gmail.com>, Copyright © 2024

pygooglecloud-0.0.3/pygooglecloud/main.py

@@ -1,37 +0,0 @@
-"""
-The default group of operations that pygooglecloud has
-"""
-import pylogconf.core
-from pytconf import register_endpoint, register_main, config_arg_parse_and_launch
-import google.auth
-
-from pygooglecloud.static import APP_NAME, DESCRIPTION, VERSION_STR
-
-
-@register_endpoint(
-    description="get the current project id",
-    configs=[],
-)
-def get_project_id() -> None:
-    """
-    This will go to ~/.config/gcloud/configurtions/config_default unless
-    GOOGLE_APPLICATION_CREDENTIALS environment variable points to something else
-    if ~/.config/gcloud/configurtions/config_default is missing this will throw an exception.
-    """
-    _, project_id = google.auth.default()
-    assert project_id is not None, "Could not find a project configured"
-    print(project_id)
-
-
-@register_main(
-    main_description=DESCRIPTION,
-    app_name=APP_NAME,
-    version=VERSION_STR,
-)
-def main():
-    pylogconf.core.setup()
-    config_arg_parse_and_launch()
-
-
-if __name__ == '__main__':
-    main()

pygooglecloud-0.0.3/pygooglecloud.egg-info/PKG-INFO

@@ -1,45 +0,0 @@
-Metadata-Version: 2.1
-Name: pygooglecloud
-Version: 0.0.3
-Summary: pygooglecloud helps you with command line interaction with gcp
-Home-page: https://veltzer.github.io/pygooglecloud
-Download-URL: https://github.com/veltzer/pygooglecloud
-Author: Mark Veltzer
-Author-email: mark.veltzer@gmail.com
-Maintainer: Mark Veltzer
-Maintainer-email: mark.veltzer@gmail.com
-License: MIT
-Keywords: gcp,gae,python,shell,utilities
-Platform: python3
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Topic :: Utilities
-Classifier: License :: OSI Approved :: MIT License
-Description-Content-Type: text/x-rst
-License-File: LICENSE
-Requires-Dist: pylogconf
-Requires-Dist: pytconf
-Requires-Dist: google-auth
-
-===============
-*pygooglecloud*
-===============
-
-.. image:: https://img.shields.io/pypi/v/pygooglecloud
-
-.. image:: https://img.shields.io/github/license/veltzer/pygooglecloud
-
-.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
-
-project website: https://veltzer.github.io/pygooglecloud
-
-author: Mark Veltzer
-
-version: 0.0.3
-
-	Mark Veltzer <mark.veltzer@gmail.com>, Copyright © 2024

pygooglecloud-0.0.3/pygooglecloud.egg-info/SOURCES.txt

@@ -1,14 +0,0 @@
-LICENSE
-README.rst
-setup.cfg
-setup.py
-pygooglecloud/__init__.py
-pygooglecloud/configs.py
-pygooglecloud/main.py
-pygooglecloud/static.py
-pygooglecloud.egg-info/PKG-INFO
-pygooglecloud.egg-info/SOURCES.txt
-pygooglecloud.egg-info/dependency_links.txt
-pygooglecloud.egg-info/entry_points.txt
-pygooglecloud.egg-info/requires.txt
-pygooglecloud.egg-info/top_level.txt

pygooglecloud-0.0.3/pygooglecloud.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

pygooglecloud-0.0.3/pygooglecloud.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-pygooglecloud = pygooglecloud.main:main

pygooglecloud-0.0.3/pygooglecloud.egg-info/requires.txt

@@ -1,3 +0,0 @@
-pylogconf
-pytconf
-google-auth

pygooglecloud-0.0.3/pygooglecloud.egg-info/top_level.txt

@@ -1 +0,0 @@
-pygooglecloud

pygooglecloud-0.0.3/setup.cfg

@@ -1,10 +0,0 @@
-[bdist_wheel]
-universal = 0
-
-[pycodestyle]
-max-line-length = 130
-
-[egg_info]
-tag_build = 
-tag_date = 0
-

pygooglecloud-0.0.3/setup.py

@@ -1,56 +0,0 @@
-import setuptools
-
-
-def get_readme():
-    with open("README.rst") as f:
-        return f.read()
-
-
-setuptools.setup(
-    # the first three fields are a must according to the documentation
-    name="pygooglecloud",
-    version="0.0.3",
-    packages=[
-        "pygooglecloud",
-    ],
-    # from here all is optional
-    description="pygooglecloud helps you with command line interaction with gcp",
-    long_description=get_readme(),
-    long_description_content_type="text/x-rst",
-    author="Mark Veltzer",
-    author_email="mark.veltzer@gmail.com",
-    maintainer="Mark Veltzer",
-    maintainer_email="mark.veltzer@gmail.com",
-    keywords=[
-        "gcp",
-        "gae",
-        "python",
-        "shell",
-        "utilities",
-    ],
-    url="https://veltzer.github.io/pygooglecloud",
-    download_url="https://github.com/veltzer/pygooglecloud",
-    license="MIT",
-    platforms=[
-        "python3",
-    ],
-    install_requires=[
-        "pylogconf",
-        "pytconf",
-        "google-auth",
-    ],
-    classifiers=[
-        "Development Status :: 4 - Beta",
-        "Environment :: Console",
-        "Operating System :: OS Independent",
-        "Programming Language :: Python",
-        "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3 :: Only",
-        "Programming Language :: Python :: 3.11",
-        "Topic :: Utilities",
-        "License :: OSI Approved :: MIT License",
-    ],
-    entry_points={"console_scripts": [
-        "pygooglecloud=pygooglecloud.main:main",
-    ]},
-)