nsj-gcf-utils

What it is and what it does

nsj-gcf-utils is a collection of utility modules designed to simplify building Google Cloud Functions. It provides pre-built components for common GCF patterns: structured logging, API key validation via X-API-Key headers, database communication adapters, HTTP clients with retry logic, OAuth/Keycloak authentication, Bearer token introspection, and a decorator-based router that mimics traditional web frameworks like Spring or Symfony.

The package bundles utilities for JSON serialization with native date handling, IBAN manipulation, and token validation using RFC 7662 token introspection. It depends on requests, sqlparams, pydantic, and python_dateutil, and is distributed as a pure-Python wheel with low install friction. The package is classified as Alpha and has not been updated in 270 days, though the repository remains active.

Use it for:

• Set up standardized logging in a Google Cloud Function without boilerplate configuration.
• Validate incoming API requests using X-API-Key headers or Bearer token introspection.
• Communicate with a database through a pre-built adapter layer in a GCF.
• Implement OAuth/Keycloak authentication for a GCF acting as an OAuth client.
• Route HTTP requests within a GCF using decorators similar to Flask or Spring.
• Handle JSON serialization with automatic date formatting and Decimal-to-string conversion.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides utility modules for building Google Cloud Functions, including logging, authentication, database adapters, HTTP clients, and routing decorators.

Yes, with conditions. The package offers genuine utility for Google Cloud Functions development and has low install friction. However, the unclear license status requires verification before use in proprietary contexts, and the Alpha classification plus 270-day maintenance gap suggest it may not be actively developed. Suitable for internal or experimental projects; verify license and maintenance expectations before adopting in production.

Install

nsj-gcf-utils on PyPI

pip install nsj-gcf-utils

uv add nsj-gcf-utils

poetry add nsj-gcf-utils

Installing nsj-gcf-utils

Before you install

Low install friction with a pure-Python wheel. Maintenance status is aging—last release was 270 days ago, though the repository remains active and the package supports current Python versions.

License in practice

License treatment is unclear; no SPDX identifier or raw license text is declared. Verify the actual license terms in the repository before using in proprietary or commercial projects.

Quickstart

pip install nsj-gcf-utils

from nsj_gcf_utils.app_logger import setup_logger
from nsj_gcf_utils.authentication_service import validate_api_key

logger = setup_logger()
logger.info('GCF utility loaded')

Requires Python 3.4 or later; runtime dependencies are requests, sqlparams, pydantic, and python_dateutil.

Verify before relying

• Whether the package is actively maintained or in maintenance-only mode given the 270-day gap since last release.
• Actual license terms, since license_treatment is marked unclear with no SPDX or raw text provided.
• Production readiness: Development Status classifier shows Alpha, but real-world usage signal is unclear.

Package facts

Evidence: nsj_gcf_utils-1.1.0-py3-none-any.whl

Tags

More Build Tools packages