Shared library templates

Author: Shipra-Singh-Asd

templates/libs/go/README.md

@@ -0,0 +1,103 @@
+# {{name}}
+
+A shared Go module generated by create-polyglot for cross-service utilities and models.
+
+## Installation
+
+### Add to Go Module
+
+```bash
+# From your service directory
+go mod edit -require={{name}}@v0.1.0
+go mod edit -replace={{name}}=../packages/{{name}}
+```
+
+### Usage in Services
+
+```go
+package main
+
+import (
+    "fmt"
+    "{{name}}"
+)
+
+func main() {
+    // Use shared utilities
+    response := {{name}}.FormatResponse(map[string]string{"key": "value"}, "success", nil)
+    
+    // Use shared models
+    health := {{name}}.NewServiceHealth("api", "healthy")
+    
+    // Use utility functions
+    config := map[string]interface{}{
+        "database_url": "localhost:5432",
+        "api_key": "secret",
+    }
+    isValid := {{name}}.ValidateConfig(config, []string{"database_url", "api_key"})
+    newID := {{name}}.GenerateID()
+    
+    fmt.Printf("Response: %+v\n", response)
+    fmt.Printf("Health: %s\n", health)
+    fmt.Printf("Config Valid: %v\n", isValid)
+    fmt.Printf("Generated ID: %s\n", newID)
+}
+```
+
+## Development
+
+### Install Dependencies
+
+```bash
+go mod tidy
+```
+
+### Running Tests
+
+```bash
+go test ./...
+```
+
+### Build
+
+```bash
+go build
+```
+
+## Structure
+
+- `go.mod` - Go module definition
+- `{{name}}.go` - Main package with shared utilities and models
+- `README.md` - This file
+
+## Adding to Services
+
+To use this shared module in your Go services:
+
+1. Add the module dependency:
+   ```bash
+   go mod edit -require={{name}}@v0.1.0
+   go mod edit -replace={{name}}=../packages/{{name}}
+   ```
+
+2. Import and use in your service code:
+   ```go
+   import "{{name}}"
+   ```
+
+## Types and Functions
+
+### Types
+
+- `Response` - Standardized API response structure
+- `ServiceHealth` - Service health status model  
+- `ErrorResponse` - Standardized error response structure
+
+### Functions
+
+- `FormatResponse(data, status, message)` - Create standardized API response
+- `ValidateConfig(config, requiredKeys)` - Validate configuration keys
+- `SafeJSONUnmarshal(data, v, defaultValue)` - Safe JSON unmarshaling with fallback
+- `GenerateID()` - Generate new UUID string
+- `NewServiceHealth(serviceName, status)` - Create new ServiceHealth instance
+- `NewErrorResponse(code, message, details)` - Create new ErrorResponse instance

templates/libs/go/go.mod

@@ -0,0 +1,7 @@
+module {{name}}
+
+go 1.21
+
+require (
+	github.com/google/uuid v1.4.0
+)

templates/libs/go/{{name}}.go

@@ -0,0 +1,103 @@
+// Package {{name}} provides shared utilities and models for create-polyglot monorepo
+package {{name}}
+
+import (
+	"encoding/json"
+	"fmt"
+	"time"
+	
+	"github.com/google/uuid"
+)
+
+// Response represents a standardized API response
+type Response struct {
+	Status    string      `json:"status"`
+	Timestamp string      `json:"timestamp"`
+	Data      interface{} `json:"data"`
+	Message   *string     `json:"message,omitempty"`
+}
+
+// ServiceHealth represents the health status of a service
+type ServiceHealth struct {
+	ID          string     `json:"id"`
+	ServiceName string     `json:"service_name"`
+	Status      string     `json:"status"` // "healthy", "degraded", "unhealthy"
+	Version     *string    `json:"version,omitempty"`
+	Uptime      *float64   `json:"uptime,omitempty"`
+	LastCheck   *time.Time `json:"last_check,omitempty"`
+	CreatedAt   time.Time  `json:"created_at"`
+	UpdatedAt   time.Time  `json:"updated_at"`
+}
+
+// ErrorResponse represents a standardized error response
+type ErrorResponse struct {
+	ID           string                 `json:"id"`
+	ErrorCode    string                 `json:"error_code"`
+	ErrorMessage string                 `json:"error_message"`
+	Details      map[string]interface{} `json:"details,omitempty"`
+	CreatedAt    time.Time              `json:"created_at"`
+	UpdatedAt    time.Time              `json:"updated_at"`
+}
+
+// FormatResponse creates a standardized API response
+func FormatResponse(data interface{}, status string, message *string) Response {
+	return Response{
+		Status:    status,
+		Timestamp: time.Now().UTC().Format(time.RFC3339),
+		Data:      data,
+		Message:   message,
+	}
+}
+
+// ValidateConfig checks that all required keys exist in the configuration map
+func ValidateConfig(config map[string]interface{}, requiredKeys []string) bool {
+	for _, key := range requiredKeys {
+		if _, exists := config[key]; !exists {
+			return false
+		}
+	}
+	return true
+}
+
+// SafeJSONUnmarshal safely unmarshals JSON with fallback to default value
+func SafeJSONUnmarshal(data []byte, v interface{}, defaultValue interface{}) interface{} {
+	if err := json.Unmarshal(data, v); err != nil {
+		return defaultValue
+	}
+	return v
+}
+
+// GenerateID generates a new UUID string
+func GenerateID() string {
+	return uuid.New().String()
+}
+
+// NewServiceHealth creates a new ServiceHealth instance
+func NewServiceHealth(serviceName, status string) ServiceHealth {
+	now := time.Now().UTC()
+	return ServiceHealth{
+		ID:          GenerateID(),
+		ServiceName: serviceName,
+		Status:      status,
+		CreatedAt:   now,
+		UpdatedAt:   now,
+	}
+}
+
+// NewErrorResponse creates a new ErrorResponse instance
+func NewErrorResponse(errorCode, errorMessage string, details map[string]interface{}) ErrorResponse {
+	now := time.Now().UTC()
+	return ErrorResponse{
+		ID:           GenerateID(),
+		ErrorCode:    errorCode,
+		ErrorMessage: errorMessage,
+		Details:      details,
+		CreatedAt:    now,
+		UpdatedAt:    now,
+	}
+}
+
+// String returns a string representation of the ServiceHealth
+func (sh ServiceHealth) String() string {
+	return fmt.Sprintf("ServiceHealth{ID: %s, Service: %s, Status: %s}", sh.ID, sh.ServiceName, sh.Status)
+}

templates/libs/python/README.md

@@ -0,0 +1,74 @@
+# {{name}}
+
+A shared Python library generated by create-polyglot for cross-service utilities and models.
+
+## Installation
+
+### Development Install
+
+```bash
+# From the monorepo root
+pip install -e packages/{{name}}
+```
+
+### Usage in Services
+
+```python
+from {{name}} import format_response, ServiceHealth
+from {{name}}.utils import validate_config, generate_id
+
+# Use shared utilities
+response = format_response({"key": "value"}, "success", "Operation completed")
+
+# Use shared models
+health = ServiceHealth(service_name="api", status="healthy", version="1.0.0")
+
+# Use utility functions
+config_valid = validate_config(config_dict, ["database_url", "api_key"])
+new_id = generate_id()
+```
+
+## Development
+
+### Install Development Dependencies
+
+```bash
+pip install -e ".[dev]"
+```
+
+### Running Tests
+
+```bash
+pytest
+```
+
+### Code Formatting
+
+```bash
+black .
+flake8 .
+mypy .
+```
+
+## Structure
+
+- `{{name}}/` - Main package directory
+  - `__init__.py` - Package initialization and exports
+  - `utils.py` - Shared utility functions
+  - `models.py` - Shared data models and classes
+- `pyproject.toml` - Package configuration
+- `README.md` - This file
+
+## Adding to Services
+
+To use this shared library in your Python services:
+
+1. Add the dependency to your service's `requirements.txt`:
+   ```
+   -e ../packages/{{name}}
+   ```
+
+2. Import and use in your service code:
+   ```python
+   from {{name}} import format_response
+   ```

templates/libs/python/__init__.py

@@ -0,0 +1,8 @@
+"""
+{{name}} - A shared Python library for create-polyglot monorepo
+"""
+
+__version__ = "0.1.0"
+
+from .utils import *
+from .models import *

templates/libs/python/models.py

@@ -0,0 +1,39 @@
+"""
+Shared data models for {{name}}
+"""
+
+from typing import Optional
+from dataclasses import dataclass
+import datetime
+
+
+@dataclass
+class BaseModel:
+    """Base model with common fields."""
+    id: Optional[str] = None
+    created_at: Optional[datetime.datetime] = None
+    updated_at: Optional[datetime.datetime] = None
+
+    def __post_init__(self):
+        if self.created_at is None:
+            self.created_at = datetime.datetime.utcnow()
+        if self.updated_at is None:
+            self.updated_at = datetime.datetime.utcnow()
+
+
+@dataclass
+class ServiceHealth(BaseModel):
+    """Model for service health status."""
+    service_name: str
+    status: str  # "healthy", "degraded", "unhealthy"
+    version: Optional[str] = None
+    uptime: Optional[float] = None
+    last_check: Optional[datetime.datetime] = None
+
+
+@dataclass 
+class ErrorResponse(BaseModel):
+    """Model for standardized error responses."""
+    error_code: str
+    error_message: str
+    details: Optional[dict] = None

templates/libs/python/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "{{name}}"
+version = "0.1.0"
+description = "A shared Python library for create-polyglot monorepo"
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [
+    {name = "Generated by create-polyglot"}
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+]
+dependencies = [
+    "typing-extensions>=4.0.0"
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "black>=22.0.0",
+    "flake8>=4.0.0",
+    "mypy>=0.950"
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["{{name}}*"]
+
+[tool.black]
+line-length = 88
+target-version = ["py38"]
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true