5 releases

0.1.7 Dec 29, 2024
0.1.6 Apr 14, 2024
0.1.2 Jan 14, 2024
0.1.1 Jan 6, 2024
0.1.0 Jan 6, 2024

#375 in Command line utilities

Download history 6/week @ 2024-09-18 13/week @ 2024-09-25 2/week @ 2024-12-04 5/week @ 2024-12-11 94/week @ 2024-12-25 12/week @ 2025-01-01

113 downloads per month

BSD-3-Clause

67KB
1.5K SLoC

Go 1K SLoC // 0.1% comments Rust 322 SLoC // 0.0% comments Templ 142 SLoC // 0.0% comments JavaScript 48 SLoC // 0.1% comments SQL 25 SLoC // 0.3% comments TypeScript 8 SLoC

Gospin - GO Boilerplate Initiator

Gospin is a simple command-line tool designed to help developers kickstart a new Go project instantly. With Gospin, you can quickly generate boilerplate code tailored to your project's needs, saving you time and effort. Whether you're building a REST API, a project with database integration, or a WebSocket-based application, Gospin has got you covered.


Features

  • Generate boilerplate Go projects instantly.
  • Support for optional database integration.
  • Easy setup for WebSocket-enabled applications.
  • Ability to specify a custom HTTP port.
  • GitHub username integration for project initialization.

Installation

To install Gospin, ensure you have Cargo installed, and run the following command:

cargo install gospin

Usage

To create a new Go project using Gospin, use the following command:

gospin [OPTIONS] [PROJECT]

Arguments

  • [PROJECT]: The name of the Go project to be generated. This is optional; if not provided, Gospin will use a default name.

Options

  • -u, --username <GHU>: Specify your GitHub username. This will include your GitHub username in the project's metadata.
  • -p, --port <PORT>: Set the HTTP port for the project. Defaults to 8080 if not specified.
  • -d, --database: Include boilerplate code for database integration.
  • -w, --websockets: Include boilerplate code for WebSocket functionality.
  • -h, --help: Print the help message and exit.
  • -V, --version: Print the version of Gospin and exit.

Examples

Basic Project Initialization

Generate a basic Go project:

gospin my-project

Custom Port

Generate a project with a custom HTTP port:

gospin -p 3000 my-project

Include Database Integration

Generate a project with boilerplate code for database integration:

gospin -d my-project

Include WebSocket Support

Generate a project with WebSocket support:

gospin -w my-project

GitHub Username

Include your GitHub username in the project metadata:

gospin -u myusername my-project

Combined Options

Generate a project with database integration, WebSocket support, and a custom port:

gospin -d -w -p 5000 my-project

Contributing

Contributions are welcome! Feel free to submit issues or pull requests to improve Gospin.


License

Gospin is open-source and available under the BSD 3-Clause License.

Dependencies

~3–12MB
~127K SLoC