SnipForge is a powerful command-line interface (CLI) tool that utilizes OpenAI's GPT technology to generate code snippets for various programming and tooling languages based on a given description. It aims to save time and effort for developers by providing a convenient way to generate code on-demand.
- Leverages OpenAI's GPT technology for intelligent code snippet generation
- Supports multiple programming and tooling languages
- Matches your specific needs with customizable options
- Guides you through the code generation process in interactive mode step-by-step
- Outputs code snippets to
stdoutor saves them to a file
- Download the appropriate binary for your operating system from the latest release page.
- Extract the downloaded archive and place the
snipforgebinary in a directory that is included in your system'sPATH. - Open a terminal and type
snipforge versionto confirm the installation was successful.
If you prefer to run SnipForge from source, follow these steps:
- Clone the repository:
$ git clone https://github.com/peetya/snipforge-cli.git- Change into the
snipforge-clidirectory:
$ cd snipforge-cli- Install the necessary dependencies:
$ go mod download- Run:
$ go run main.go versionTo get started with SnipForge, install the CLI tool and run the generate command, providing the required flags and
options. Alternatively, you can start the interactive mode by running the generate command without any flags, which
will guide you through the code generation process step-by-step.
$ snipforge generate [flags]For more information on available commands and flags, refer to the help output by running:
$ snipforge generate --helpHere's a detailed explanation of the available flags for the generate command:
-d, --dry-run do not generate a code snippet, only print the generated description
-g, --goal string the functionality description for the code snippet
-h, --help help for generate
-l, --language string the programming or tooling language to generate code in (e.g. PHP, Golang, etc...)
-v, --language-version string the version of the programming or tooling language to generate code for (if applicable)
-k, --openai-key string the OpenAI API key
--openai-max-tokens int the maximum number of tokens to generate
-m, --openai-model string the OpenAI model to use
--openai-temperature float32 the sampling temperature for the OpenAI model (between 0.0 and 2.0)
-o, --output string the output file path for the generated code snippet
-q, --quiet suppress all output except for the generated code snippet
--stdout print the generated code snippet to isStdout instead of saving to a file
Here's a basic example of how to use SnipForge to generate a Python code snippet for sorting a list of numbers:
$ snipforge generate --language python --language-version 3.11 --goal "sort a list of numbers" --output sorted_numbers.pyThis command will generate a Python code snippet in the sorted_numbers.py file, with the goal of sorting a list of
numbers.
numbers = [3, 1, 4, 1, 5, 9, 2, 6, 5, 3, 5]
numbers.sort()
print(numbers)Here's an advanced example demonstrating how to use SnipForge to generate a PHP code snippet that fulfills more complex goals. In this example, we'll use SnipForge in interactive mode.
$ snipforge generateFirst, we need to define a set of goals that will be used to generate the snippet.
What are your goals?
┃ 1 A controller that returns a list of users via the "/api/v1/users" endpoint
┃ 2 The output format can be changed via content negotiaton
┃ 3 Support pagination using the page and limit query parameters
┃ 4 Read the users from the injected UserRepositoryInterface
┃ 5 The controller must follow PSR-4 and PSR-12 standards
Next, we need to define the programming language and version to generate the snippet for.
Which programming or tooling language do you want to use?
> Symfony
Which version of PHP do you want to use? (optional)
> 6
Then we need to define the output path:
Where do you want to save the snippet?
> src/Controller/Api/V1/UserController.php
Then it will generate the following code snippet for you in src/Controller/Api/V1/UserController.php:
<?php
// src/Controller/Api/V1/UserController.php
namespace App\Controller\Api\V1;
use App\Repository\UserRepositoryInterface;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;
#[Route('/api/v1/users')]
class UserController extends AbstractController
{
public function __construct(private UserRepositoryInterface $userRepository)
{
}
#[Route('', name: 'api_v1_users_index', methods: ['GET'])]
public function index(Request $request): Response
{
$page = $request->query->getInt('page', 1);
$limit = $request->query->getInt('limit', 10);
$users = $this->userRepository->getPaginatedUsers($page, $limit);
$serializer = $this->container->get('serializer');
$content = $serializer->serialize(['data' => $users], $request->getPreferredFormat(), ['groups' => ['user']]
return new Response($content, 200, ['Content-Type' => $request->getMimeType($request->getPreferredFormat())]);
}
}While SnipForge does its best to generate accurate and functional code snippets, it's crucial to review the generated output before using it in your projects. AI-generated code may sometimes contain errors or inconsistencies, so always double-check the results to ensure correctness.
SnipForge is an open-source project, and we welcome contributions from developers like you! Feel free to submit issues, suggest new features, or create pull requests to help improve the project. We appreciate your support and collaboration. :heart:
SnipForge is released under the MIT License.