brownLlama Pip Package

Overview

brownllama-pip (or brownllama when imported in Python) is a utility library designed to provide common functionalities and standardized components for VNP's Python projects. It aims to reduce code duplication and promote best practices across different projects.

Modules

The package currently includes the following modules:

bigquery.py:
- Provides the BigQueryController class for simplified interaction with Google BigQuery.
- Supports creating tables, checking table existence, loading data from JSON, loading data from Google Cloud Storage (GCS), and executing queries.
- Offers methods for schema inference from JSON data and efficient data loading via GCS staging.
logger.py:
- Provides the get_logger function for obtaining configured logger instances.
- Standardizes logging format and setup across projects.
- Configures both root logger and common third-party library loggers to ensure consistent logging behavior.
secret_manager.py
- Provides the get_secret function for retrieving secrets from Google Secret Manager.
- Enables to get, create, delete and lists the secrets.
storage.py:
- Provides the StorageManager class for managing Google Cloud Storage operations.
- Supports uploading data (dictionaries, lists of dictionaries, Pandas DataFrames) to GCS as JSON files.
- Includes functionality for deleting files from GCS.

Building and Publishing

To build and publish the package, follow these steps:

Install build dependencies:
```
uv add build twine
```
Change the version number in pyproject.toml file
```
version = "0.1.XXX"
```
Build the package:
```
uv build
```
Publish the package in PyPI
```
uvx twine upload --verbose dist/*
```
NOTE: PyPI is public and should not be used for sensitive information. Also, you need to setup ~/.pypirc with your PyPI credentials.

Versioning Error:

If there is some error on versioning, then you simply delete dist directory and run uv build again.

Usage

After installation, you can import and use the modules and classes provided by brownllama in your Python projects.

Example (using BigQueryController):

from brownllama.bigquery import BigQueryController

bq_controller = BigQueryController(bigquery_payload=bigquery_payload, key_path=key_path)

# Example: Export JSON data to BigQuery via GCS
gcs_uri = bq_controller.export_to_bq_via_gcs(json_data=data)
print(f"Data loaded to BigQuery via GCS: {gcs_uri}")

Refer to the individual module files (bigquery.py, logger.py, storage.py) for detailed class and function documentation and usage examples.

Metadata

Release files for brownllama 0.1.50

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for brownllama 0.1.50
File	Size	Uploaded
brownllama-0.1.50.tar.gz	76.7 kB	Jul 27, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for brownllama 0.1.50
File	Interpreter	ABI	Platform	Reset
brownllama-0.1.50-py3-none-any.whl 20.9 kB Jul 27, 2026	Python 3	none	any	Details

Total release size: 97.6 kB

Release files / brownllama-0.1.50.tar.gz

Download URL	brownllama-0.1.50.tar.gz
Size	76.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`a9cc7323bbc349431631afb57815a15fc7b1a0c8624fdb3fa0357fcc27390e0a`
BLAKE2b-256 checksum How to use checksums	`5a385e8c9e98bf4d370b758d210a2b45f8d8b1a343200072206bae8520e3b8bb`
Upload date	Jul 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.9`

Release files / brownllama-0.1.50-py3-none-any.whl

Download URL	brownllama-0.1.50-py3-none-any.whl
Size	20.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3efb2c0bd2c6d231de4bc59f1c3ebc2ebc309140711e1d20aeab5682aa1c7496`
BLAKE2b-256 checksum How to use checksums	`75a5dbb589f82527fe8bae61ab0ef0081b86fdc7cb00786ebf5a7c970b2e5e09`
Upload date	Jul 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.9`