golf-mcp 0.1.20__py3-none-any.whl → 0.2.1__py3-none-any.whl

golf/examples/api_key/tools/users/get.py

@@ -1,82 +0,0 @@
-"""Get GitHub user information."""
-
-from typing import Annotated, Any
-
-import httpx
-from pydantic import BaseModel, Field
-
-from golf.auth import get_api_key
-
-
-class Output(BaseModel):
-    """User information result."""
-
-    found: bool
-    user: dict[str, Any] | None = None
-
-
-async def get(
-    username: Annotated[
-        str | None,
-        Field(description="GitHub username (if not provided, gets authenticated user)"),
-    ] = None,
-) -> Output:
-    """Get information about a GitHub user.
-
-    If no username is provided, returns information about the authenticated user.
-    This is useful for testing if authentication is working correctly.
-    """
-    github_token = get_api_key()
-
-    # Determine the API endpoint
-    if username:
-        url = f"https://api.github.com/users/{username}"
-    else:
-        # Get authenticated user - requires token
-        if not github_token:
-            return Output(found=False)
-        url = "https://api.github.com/user"
-
-    # Prepare headers
-    headers = {
-        "Accept": "application/vnd.github.v3+json",
-        "User-Agent": "Golf-GitHub-MCP-Server",
-    }
-    if github_token:
-        headers["Authorization"] = f"Bearer {github_token}"
-
-    try:
-        async with httpx.AsyncClient() as client:
-            response = await client.get(url, headers=headers, timeout=10.0)
-
-            response.raise_for_status()
-            user_data = response.json()
-
-            return Output(
-                found=True,
-                user={
-                    "login": user_data["login"],
-                    "name": user_data.get("name", ""),
-                    "email": user_data.get("email", ""),
-                    "bio": user_data.get("bio", ""),
-                    "company": user_data.get("company", ""),
-                    "location": user_data.get("location", ""),
-                    "public_repos": user_data.get("public_repos", 0),
-                    "followers": user_data.get("followers", 0),
-                    "following": user_data.get("following", 0),
-                    "created_at": user_data["created_at"],
-                    "url": user_data["html_url"],
-                },
-            )
-
-    except httpx.HTTPStatusError as e:
-        if e.response.status_code in [401, 404]:
-            return Output(found=False)
-        else:
-            return Output(found=False)
-    except Exception:
-        return Output(found=False)
-
-
-# Export the function to be used as the tool
-export = get

golf/examples/basic/.env

@@ -1,5 +0,0 @@
-GITHUB_CLIENT_ID="Ov23liPVrFkEzGhXro5A"
-GITHUB_CLIENT_SECRET="4f050336d569559705963d88cf8ec8b3ce10441a"
-JWT_SECRET="example-jwt-secret-for-development-only"
-OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318/v1/traces"
-OTEL_SERVICE_NAME="golf-mcp"

golf/examples/basic/pre_build.py

@@ -1,28 +0,0 @@
-"""Pre-build configuration for the basic example.
-
-This file is executed before the build process starts.
-It configures GitHub OAuth authentication for the example.
-"""
-
-from golf.auth import ProviderConfig, configure_auth
-
-# Create GitHub OAuth provider configuration
-github_provider = ProviderConfig(
-    provider="github",
-    client_id_env_var="GITHUB_CLIENT_ID",
-    client_secret_env_var="GITHUB_CLIENT_SECRET",
-    jwt_secret_env_var="JWT_SECRET",
-    authorize_url="https://github.com/login/oauth/authorize",
-    token_url="https://github.com/login/oauth/access_token",
-    userinfo_url="https://api.github.com/user",
-    scopes=["read:user", "user:email"],
-    issuer_url="http://127.0.0.1:3000",  # This should be your Golf server's accessible URL
-    callback_path="/auth/callback",  # Golf's callback path
-    token_expiration=3600,  # 1 hour
-)
-
-# Configure authentication with the provider
-configure_auth(
-    provider=github_provider,
-    required_scopes=["read:user"],  # Require read:user scope for protected endpoints
-)

golf/examples/basic/tools/github_user.py

@@ -1,65 +0,0 @@
-"""Tool for fetching GitHub user information."""
-
-import httpx
-from pydantic import BaseModel
-
-from golf.auth import get_provider_token
-
-
-class GitHubUserResponse(BaseModel):
-    """Response model for GitHub user information."""
-
-    login: str
-    id: int
-    name: str | None = None
-    email: str | None = None
-    avatar_url: str | None = None
-    location: str | None = None
-    bio: str | None = None
-    public_repos: int = 0
-    followers: int = 0
-    following: int = 0
-    message: str | None = None
-
-
-async def get_github_user() -> GitHubUserResponse:
-    """Fetch authenticated user's GitHub profile information."""
-    try:
-        # Get GitHub token using our abstraction
-        github_token = get_provider_token()
-
-        if not github_token:
-            return GitHubUserResponse(
-                login="anonymous",
-                id=0,
-                message="Not authenticated. Please login first.",
-            )
-
-        # Call GitHub API to get user info
-        async with httpx.AsyncClient() as client:
-            response = await client.get(
-                "https://api.github.com/user",
-                headers={
-                    "Authorization": f"Bearer {github_token}",
-                    "Accept": "application/vnd.github.v3+json",
-                },
-            )
-
-            if response.status_code == 200:
-                data = response.json()
-                return GitHubUserResponse(**data)
-            else:
-                return GitHubUserResponse(
-                    login="error",
-                    id=0,
-                    message=f"GitHub API error: {response.status_code} - {response.text[:100]}",
-                )
-
-    except Exception as e:
-        return GitHubUserResponse(
-            login="error", id=0, message=f"Error fetching GitHub data: {str(e)}"
-        )
-
-
-# Export the tool
-export = get_github_user

golf/examples/basic/tools/hello.py

@@ -1,34 +0,0 @@
-"""Hello World tool {{project_name}}."""
-
-from typing import Annotated
-
-from pydantic import BaseModel, Field
-
-
-class Output(BaseModel):
-    """Response from the hello tool."""
-
-    message: str
-
-
-async def hello(
-    name: Annotated[
-        str, Field(description="The name of the person to greet")
-    ] = "World",
-    greeting: Annotated[str, Field(description="The greeting phrase to use")] = "Hello",
-) -> Output:
-    """Say hello to the given name.
-
-    This is a simple example tool that demonstrates the basic structure
-    of a tool implementation in GolfMCP.
-    """
-    # The framework will add a context object automatically
-    # You can log using regular print during development
-    print(f"{greeting} {name}...")
-
-    # Create and return the response
-    return Output(message=f"{greeting}, {name}!")
-
-
-# Designate the entry point function
-export = hello

golf/examples/basic/tools/payments/charge.py

@@ -1,70 +0,0 @@
-"""Charge payment tool"""
-
-from typing import Annotated
-
-from pydantic import BaseModel, Field
-
-from .common import payment_client
-
-
-class Output(BaseModel):
-    """Response from the charge payment tool."""
-
-    success: bool
-    charge_id: str
-    message: str
-
-
-async def charge(
-    amount: Annotated[
-        float,
-        Field(
-            description="Amount to charge in USD",
-            gt=0,  # Must be greater than 0
-            le=10000,  # Maximum charge limit
-        ),
-    ],
-    card_token: Annotated[
-        str,
-        Field(
-            description="Tokenized payment card identifier",
-            pattern=r"^tok_[a-zA-Z0-9]+$",  # Validate token format
-        ),
-    ],
-    description: Annotated[
-        str,
-        Field(
-            description="Optional payment description for the charge", max_length=200
-        ),
-    ] = "",
-) -> Output:
-    """Process a payment charge.
-
-    This example demonstrates nested directory organization where related tools
-    are grouped in subdirectories (tools/payments/charge.py).
-
-    The resulting tool ID will be: charge-payments
-
-    Args:
-        amount: Amount to charge in USD
-        card_token: Tokenized payment card
-        description: Optional payment description
-    """
-    # The framework will add a context object automatically
-    # You can log using regular print during development
-    print(f"Processing charge for ${amount:.2f}...")
-
-    # Use the shared payment client from common.py
-    charge_result = await payment_client.create_charge(
-        amount=amount, token=card_token, description=description
-    )
-
-    # Create and return the response
-    return Output(
-        success=True,
-        charge_id=charge_result["id"],
-        message=f"Successfully charged ${amount:.2f}",
-    )
-
-
-export = charge

golf/examples/basic/tools/payments/common.py

@@ -1,36 +0,0 @@
-"""Payments shared functionality.
-
-This common.py file demonstrates the recommended pattern for
-sharing functionality across multiple tools in a directory.
-"""
-
-import os
-
-# Read configuration from environment variables
-PAYMENT_API_KEY = os.environ.get("PAYMENT_API_KEY", "mock_key")
-PAYMENT_API_URL = os.environ.get("PAYMENT_API_URL", "https://api.example.com/payments")
-
-
-class PaymentClient:
-    """Mock payment provider client."""
-
-    def __init__(
-        self, api_key: str = PAYMENT_API_KEY, api_url: str = PAYMENT_API_URL
-    ) -> None:
-        self.api_key = api_key
-        self.api_url = api_url
-
-    async def create_charge(self, amount: float, token: str, **kwargs):
-        """Create a charge (mock implementation)."""
-        # In a real implementation, this would make an API request
-        # using the configured API key and URL
-        return {"id": f"ch_{int(amount * 100)}_{hash(token) % 10000:04d}"}
-
-    async def create_refund(self, charge_id: str, amount: float, **kwargs):
-        """Create a refund (mock implementation)."""
-        # In a real implementation, this would make an API request
-        return {"id": f"ref_{charge_id}_{int(amount * 100)}"}
-
-
-# Create a shared payment client that can be imported by all tools in this directory
-payment_client = PaymentClient()

golf/examples/basic/tools/payments/refund.py

@@ -1,61 +0,0 @@
-"""Refund payment tool"""
-
-from typing import Annotated
-
-from pydantic import BaseModel, Field
-
-from .common import payment_client
-
-
-class Output(BaseModel):
-    """Response from the refund payment tool."""
-
-    success: bool
-    refund_id: str
-    message: str
-
-
-async def refund(
-    charge_id: Annotated[
-        str,
-        Field(
-            description="The ID of the charge to refund", pattern=r"^ch_[a-zA-Z0-9]+$"
-        ),
-    ],
-    amount: Annotated[
-        float | None,
-        Field(
-            description="Amount to refund in USD. If not specified, refunds the full charge amount",
-            gt=0,
-            default=None,
-        ),
-    ] = None,
-    reason: Annotated[
-        str, Field(description="Reason for the refund", min_length=3, max_length=200)
-    ] = "Customer request",
-) -> Output:
-    """Process a payment refund.
-
-    This example demonstrates nested directory organization where related tools
-    are grouped in subdirectories (tools/payments/refund.py).
-
-    The resulting tool ID will be: refund-payments
-    """
-    # The framework will add a context object automatically
-    # You can log using regular print during development
-    print(f"Processing refund for charge {charge_id}...")
-
-    # Use the shared payment client from common.py
-    refund_result = await payment_client.create_refund(
-        charge_id=charge_id, amount=amount, reason=reason
-    )
-
-    # Create and return the response
-    return Output(
-        success=True,
-        refund_id=refund_result["id"],
-        message=f"Successfully refunded charge {charge_id}",
-    )
-
-
-export = refund

golf_mcp-0.1.20.dist-info/RECORD

@@ -1,60 +0,0 @@
-golf/__init__.py,sha256=8XalsVoLEfXslFvdtUEmkNOuYShzOzYOcFbgmOz1oSk,23
-golf/auth/__init__.py,sha256=Rj4yUngJklk6xrDCrxqLTtoDAMzF1HcTvy_l8wREeao,4103
-golf/auth/api_key.py,sha256=LiIraLiH2v7s3yavidaI6BDlAEfK8XnWF15QmaJn9G4,2378
-golf/auth/helpers.py,sha256=ZogdcHM7J2PN6cL6F6OLZ3gyoUR3dwAFDxOJQ2DW_bc,6526
-golf/auth/oauth.py,sha256=-TYcMA4ULWNQacmUvzek2uQVMJpRT3hXC_d5D2k9c44,31156
-golf/auth/provider.py,sha256=3loeYrkNwIRDvyUkf8gbcCRJSiKiVXgE_rMGCSCr5mk,3802
-golf/cli/__init__.py,sha256=R8Y8KdD2C8gDo24fXGq-fdWWNeaq3MYjrbaSB8Hb-Hg,45
-golf/cli/main.py,sha256=3qexjKNL8vYg-48ATYcwW4-Wv45l3VxntW-mSqDAbEc,13958
-golf/commands/__init__.py,sha256=GKtIEm7EPQWRgot73RPZPWegwN7Zm0bHtUJbR63FNiw,83
-golf/commands/build.py,sha256=jhdxB5EwwCC_8PgqdXLUKuBpnycjh0gft3_7EuTo6ro,2319
-golf/commands/init.py,sha256=DUAvGqOUapWdF2cgWPscqHRvyOZDiajR0F0Wkn_jm-k,10355
-golf/commands/run.py,sha256=xsiG5LZw4qVt3cRTTfIoWP4Bf4AxNBBJKx0NNfoua40,2884
-golf/core/__init__.py,sha256=4bKeskJ2fPaZqkz2xQScSa3phRLLrmrczwSL632jv-o,52
-golf/core/builder.py,sha256=06BccMHR6BFMsdyL-3YJJFqLHVLE-NYSQriVyPFzL6s,59657
-golf/core/builder_auth.py,sha256=nGgyMTiRAqaNfh1FSvoFe6oTVq9RgfMf9JoFGAv2_do,14050
-golf/core/builder_metrics.py,sha256=j6Gtgd867o46JbDfSNGNsHt1QtV1XHKUJs1z8r4siQM,8830
-golf/core/builder_telemetry.py,sha256=jobFgRSspLQLuitL4ytk6asSUdTqYcDxGY3sTjkrZd4,2654
-golf/core/config.py,sha256=6yPtwzVTJauufEnrfUbxsz69H8jC0Ra427oDaRM0-xE,7397
-golf/core/parser.py,sha256=BQRus1O9zmzSmyavwLVfN8BpYFkbrWUDrgQ7yrYfAKw,42457
-golf/core/platform.py,sha256=y8-yhRPfvm-Eu44p_kN9wg74n1kB2HweRgRYy-Gu1c4,6473
-golf/core/telemetry.py,sha256=CjZ7urbizaRjyFiVBjfGW8V4PmNCG1_quk3FvbVTcjw,15772
-golf/core/transformer.py,sha256=_0nM42M41oM9zw_XxPVVS6MErdBSw2B5lULC7_UFLfU,5287
-golf/examples/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-golf/examples/api_key/.env,sha256=15dewTdeJEMAIuzQmh1SFc1zEN6PwryWgAc14IV02lY,90
-golf/examples/api_key/.env.example,sha256=fvM_r9xLoiJ_41ZbcDc_EQ48uyxwb7zf0gP_bhQroEY,29
-golf/examples/api_key/README.md,sha256=wRcgwYArwiRcjL6GKEOkPVQal7L37WnREa_rwhrIE10,2892
-golf/examples/api_key/golf.json,sha256=V7atsB5T706bBlkZ5iVBPIhAA6_3Ba3dN6NOyVaV06g,214
-golf/examples/api_key/pre_build.py,sha256=-12HGLV70sQcPhgN51zx25uN2o48JeFvTByzF2ayYp4,471
-golf/examples/api_key/tools/issues/create.py,sha256=51X0uGaisUMfMkmJCskArpefpnxZ4fnT4T_f7HhqQdU,2721
-golf/examples/api_key/tools/issues/list.py,sha256=Egl2o1YVSU8Iigu8XO_iK1-Pn1OnFL3j6LOzaG10rTI,2720
-golf/examples/api_key/tools/repos/list.py,sha256=9JTRLFzA7GwMYAaLjpOD85uXxv0JI4HdV1gEkLVuVKE,3410
-golf/examples/api_key/tools/search/code.py,sha256=3quEIzrl0i_DM1fjszTcrzaAqMC7p0TZY99NL5GceKY,2993
-golf/examples/api_key/tools/users/get.py,sha256=VF-hdUkba2_DqKSC_F7vqtbx0EXAK06wUFBEluKqLIA,2470
-golf/examples/basic/.env,sha256=CqdcvPXopWppurJ3bBjT2dODlKUrLv629BHnOy8zBkM,247
-golf/examples/basic/.env.example,sha256=fqMyaQ7pc9KHFcT4vChBO4AEGrbW7PVXOfqbrCO6j9Q,157
-golf/examples/basic/README.md,sha256=-mY3R6AAnkXT9FPkALDrJtdf9IyKDvuqjsrLAMTLRYI,2663
-golf/examples/basic/golf.json,sha256=8DiRIXmWolrILmbHzEG2tK-ZVwu1W2qBXRLz75XEjAs,166
-golf/examples/basic/pre_build.py,sha256=AG1N_sKd1UUtHPL7sw1v3YGOcZPQvoa9xcL79S9qjGI,1037
-golf/examples/basic/prompts/welcome.py,sha256=Qs_OsXdyPNw_cDZU7cnG4a0ZMzka6LF7vmPfax4cmKM,790
-golf/examples/basic/resources/current_time.py,sha256=hxhV7vGoiOv-DMXVNSVax_jkPoYR3CR9q5PpWYkdliI,1157
-golf/examples/basic/resources/info.py,sha256=LxHzg_TmwonSu1vSkuNcpUq5JrBu-9yzoGaARE1f2KU,727
-golf/examples/basic/resources/weather/common.py,sha256=8Nu_hQJZxlWRjwBDG1fmai5l0E5g0UWg2j076_f1eYk,1804
-golf/examples/basic/resources/weather/current.py,sha256=Y0LfMu7eBDwDDcNBuWBN8GgzoflekQraYMjg_DZgwLk,958
-golf/examples/basic/resources/weather/forecast.py,sha256=ClofuMB9GFMz1EfCEQddYcv2Ca90xeVYR8BKYCmB1HE,1015
-golf/examples/basic/tools/github_user.py,sha256=cAlXNkViR0XRc1cjLJgZ44KuAiN7DHQug-HJX3Zi2sw,1874
-golf/examples/basic/tools/hello.py,sha256=s7Soiq9Wn7oKIvA6Hid8UKB14iyR7HZppIbIT4g80Mc,872
-golf/examples/basic/tools/payments/charge.py,sha256=PIYdFV90hu35H1veLI8ueuYwebzrr5SCTX-x6lxRmU4,1800
-golf/examples/basic/tools/payments/common.py,sha256=hfyuQRIjrQfSqGjyY55W6pZSD5jL6O0geCE0DGx0v10,1302
-golf/examples/basic/tools/payments/refund.py,sha256=Qpl4GWvUw-L06oGQMbBzG8pikfCWfBCFcpkRiDOzmyQ,1607
-golf/metrics/__init__.py,sha256=O91y-hj_E9R06gqV8pDZrzHxOIl-1T415Hj9RvFAp3o,283
-golf/metrics/collector.py,sha256=iyRszP8TAAigyOsUFTGdKN8Xeob36LhUvXW9tntJrbA,7617
-golf/metrics/registry.py,sha256=mXQE4Pwf3PopGYjcUu4eGgPDAe085YWcsvcvWk0ny8Q,310
-golf/telemetry/__init__.py,sha256=ESGCg5HKwTCIfID1e_K7EE0bOWkSzMidlLtdqQgBd0w,396
-golf/telemetry/instrumentation.py,sha256=t0iuoIuY3mmtcdNAlUvbUgUfpRkH0mZoYg2C6qm8g2s,45320
-golf_mcp-0.1.20.dist-info/licenses/LICENSE,sha256=5_j2f6fTJmvfmUewzElhkpAaXg2grVoxKouOA8ihV6E,11348
-golf_mcp-0.1.20.dist-info/METADATA,sha256=erjB5udWAGp_OQa3MiPhwbpi0R7zZAJeTMpSqnl67Rg,12820
-golf_mcp-0.1.20.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-golf_mcp-0.1.20.dist-info/entry_points.txt,sha256=5y7rHYM8jGpU-nfwdknCm5XsApLulqsnA37MO6BUTYg,43
-golf_mcp-0.1.20.dist-info/top_level.txt,sha256=BQToHcBUufdyhp9ONGMIvPE40jMEtmI20lYaKb4hxOg,5
-golf_mcp-0.1.20.dist-info/RECORD,,