weather-mcp-rust 0.2.0

A simple weather forecaster over MCP
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

# Gemini Workspace for `cloudrun-rust`

You are a Rust Developer working with Google Cloud.
You should follow Rust Best practices.
The recommended language level for rust is 2024 do not suggest 2021.

This document provides a developer-focused overview of the `weather-rust` project, tailored for use with Gemini.

## Project Overview

`weather-rust` is a basic "Hello, World!" web server that gets weather information written in Rust, designed to be deployed as a containerized application on Google Cloud Run.

### Key Technologies

*   **Language:** [Rust](https://www.rust-lang.org/)
*   **Web Framework:** [Hyper](https://hyper.rs/)
*   **Containerization:** [Docker](https://www.docker.com/)
*   **Deployment:** [Google Cloud Run](https://cloud.google.com/run)
*   **CI/CD:** [Google Cloud Build](https://cloud.google.com/build)

## Getting Started

This project uses a `Makefile` to simplify common development tasks.

### Prerequisites

*   [Rust Toolchain](https://www.rust-lang.org/tools/install)
*   [Docker](https://docs.docker.com/get-docker/)
*   [Google Cloud SDK](https://cloud.google.com/sdk/docs/install)

### Initial Setup

1.  **Install Dependencies:**
    ```bash
    cargo build
    ```

2.  **Run the application locally:**
    ```bash
    make run
    ```
    The server will start on port `8080`.

## Development Workflow

The `Makefile` provides targets for common development tasks.

### Building the Project

*   **Development Build:**
    ```bash
    make build
    ```
*   **Release Build:**
    ```bash
    make release
    ```

### Running Locally

```bash
make run
```

### Code Quality

*   **Formatting:**
    ```bash
    make format
    ```
*   **Linting:**
    ```bash
    make clippy
    ```

### Testing

```bash
make test
```

## Deployment

Deployment is handled by Google Cloud Build and defined in `cloudbuild.yaml`.

### Manual Deployment

To manually trigger a deployment, run:

```bash
make deploy
```

This command submits a build to Google Cloud Build, which will:

1.  Build the Docker image (as defined in `Dockerfile`).
2.  Push the image to Google Container Registry (GCR).
3.  Deploy the new image to the `cloudrun-rust` service in the `us-central1` region.

### Deployment Process

*   **`Dockerfile`**: A multi-stage Dockerfile is used to create a minimal, secure production image.
    1.  **Builder Stage:** The Rust code is compiled in a `rust` builder image.
    2.  **Final Stage:** The compiled binary is copied to a minimal `gcr.io/distroless/cc-debian12` image.
*   **`cloudbuild.yaml`**: This file defines the Cloud Build pipeline. It takes care of building, pushing, and deploying the container image.

## Interacting with Gemini

You can use Gemini to help you with various tasks in this project. Here are some examples:

*   "Add a new endpoint to `main.rs` that returns the current time."
*   "Write a unit test for the new endpoint."
*   "Explain the `Dockerfile` to me."
*   "What does the `clippy` command do?"