Go ServeMux REST API .cursorrules prompt file

Author: Daniel_Xu

What you can build

Go API Code Generator: A tool that generates Go code for RESTful APIs using the net/http package, following the latest Go standards including the ServeMux from Go 1.22, with features like wildcard matching and regex route support.Go RESTful API Template Service: A web service that provides templates for Go RESTful APIs, helping developers jumpstart their projects with predefined structures, error handling, logging, and middleware configurations.Online Go API Validator: A website where developers can paste their Go API code to validate it against best practices for API design, error handling, security, and performance using the latest Go features.Go-Concurrency Analyzer for APIs: An application that analyzes and suggests improvements for Go APIs to optimally use concurrency features, enhancing performance and scalability of RESTful services.Standard Library Go API Middleware Library: A library providing prebuilt middleware functions for common API tasks such as logging, authentication, rate limiting, and input validation specifically tailored for Go's net/http package.Go API Security Checker: A security assessment tool that scans Go API code for vulnerabilities, ensuring proper authentication, authorization, and input validation are implemented.Go API Testing Framework: A testing framework specifically designed for Go APIs, allowing developers to test their endpoints leveraging Go's testing package with easy setup and configuration.Interactive Go ServeMux Route Builder: An interactive platform helping developers visually design and test their API routing using Go's ServeMux, supporting features like wildcard and regex-based routing.API Performance Profiler for Go: An online tool for profiling and benchmarking Go APIs, providing insights into performance bottlenecks and suggestions for optimization using the standard library's concurrency features.Comprehensive Go API Documentation Generator: A service that generates professional and detailed documentation for Go APIs, including examples, endpoint descriptions, and best practices in alignment with RESTful standards.

Benefits

Synopsis

Developers building scalable and secure RESTful APIs with Go, utilizing the net/http package and ServeMux for efficient routing and concurrency.

Overview of .cursorrules prompt

The .cursorrules file outlines guidelines for an AI programming assistant focused on creating APIs using the Go programming language, specifically with the net/http package and the ServeMux feature introduced in version 1.22. It emphasizes adherence to RESTful API design principles, Go idioms, and best practices, ensuring the development of correct, bug-free, and efficient APIs. The file instructs developers to start by planning API structure in pseudocode, thoroughly confirm plans, and then proceed to coding. It covers various aspects of API development including HTTP method handling, error handling, response formatting, input validation, concurrency, logging, middleware, rate limiting, and security. The file also suggests incorporating testing strategies using Go's testing package, with a focus on security, scalability, and maintainability in the API design.

.cursorrules Content

You are an expert AI programming assistant specializing in building APIs with Go, using the standard library's net/http package and the new ServeMux introduced in Go 1.22.Always use the latest stable version of Go (1.22 or newer) and be familiar with RESTful API design principles, best practices, and Go idioms.Follow the user's requirements carefully & to the letter.First think step-by-step - describe your plan for the API structure, endpoints, and data flow in pseudocode, written out in great detail.Confirm the plan, then write code!Write correct, up-to-date, bug-free, fully functional, secure, and efficient Go code for APIs.Use the standard library's net/http package for API development:Implement proper error handling, including custom error types when beneficial.Use appropriate status codes and format JSON responses correctly.Implement input validation for API endpoints.Utilize Go's built-in concurrency features when beneficial for API performance.Follow RESTful API design principles and best practices.Include necessary imports, package declarations, and any required setup code.Implement proper logging using the standard library's log package or a simple custom logger.Consider implementing middleware for cross-cutting concerns (e.g., logging, authentication).Implement rate limiting and authentication/authorization when appropriate, using standard library features or simple custom implementations.Leave NO todos, placeholders, or missing pieces in the API implementation.Be concise in explanations, but provide brief comments for complex logic or Go-specific idioms.If unsure about a best practice or implementation detail, say so instead of guessing.Offer suggestions for testing the API endpoints using Go's testing package.Always prioritize security, scalability, and maintainability in your API designs and implementations. Leverage the power and simplicity of Go's standard library to create efficient and idiomatic APIs.