DevCortex Development Tools - Feature Guide

This document provides an overview of the tools available in the DevCortex Development Tools extension for VS Code.

1. Generators

Generate Random UUID

• Description: Generates a new version 4 (random) UUID and copies it directly to your clipboard.
• How to use: Run the command from the DevCortex Tools menu. A notification will confirm that the UUID has been copied.
• Example Output: 123e4567-e89b-12d3-a456-426614174000

Start Mock API from Selection

• Description: Quickly starts a local mock API server based on a JSON structure you've selected in your editor. This is great for front-end development when the back-end is not ready yet.

• How to use:

  1. Create a JSON object in your editor that defines the API endpoints.
  2. Select the entire JSON text.
  3. Run the "Start Mock API from Selection" command.
  4. The extension will start a server and provide you with the local URL.

• Example JSON Structure:

  !Start Mock API Example

  {
      "/users": {
          "GET": {
              "response": [
                  {
                      "userId": "uuid",
                      "fullName": "fullName",
                      "email": "email"
                  }
              ]
          }
      },
      "/products/{id}": {
          "GET": {
              "response": {
                  "productId": "number",
                  "productName": "string",
                  "price": 123.45
              }
          }
      }
  }
  

2. Converters

Paste JSON as Code

• Description: Converts a JSON object from your clipboard into typed classes or structs for various programming languages.

• How to use:

  1. Copy a valid JSON object to your clipboard.
  2. Run the "Paste JSON as Code" command.
  3. Select the target language (e.g., C#, TypeScript, Go, Java).
  4. The generated code will be pasted into your active editor.

  

• Example:

  • JSON Input (in clipboard):

    {
      "name": "John Doe",
      "age": 30
    }
    

  • TypeScript Output:

    export interface Root {
        name: string;
        age:  number;
    }
    

JSON to C# (Selection)

• Description: Converts the selected JSON text directly into C# classes.

• How to use:

  1. Select a valid JSON object in your editor.
  2. Run the "JSON to C# (Selection)" command.
  3. A new editor tab will open with the generated C# code.

  !JSON to C# Example

• Example:

  • JSON Input (selected):

    {
      "product_id": 123,
      "product_name": "Awesome Gadget"
    }
    

  • C# Output:

    // Generated by Devcortex.ai
    namespace Devcortex.Generated
    {
        using System;
        using System.Collections.Generic;
        using System.Globalization;
        using Newtonsoft.Json;
        using Newtonsoft.Json.Converters;
    
        public partial class Root
        {
            [JsonProperty("product_id")]
            public long ProductId { get; set; }
    
            [JsonProperty("product_name")]
            public string ProductName { get; set; }
        }
    }
    

3. Encoders / Decoders

Base64 Encoder / Decoder

• Description: Encodes the selected text to Base64 or decodes a Base64 string back to its original form.

• How to use: Select the text you want to process and run the command. Choose "Encode" or "Decode" from the options. The result will replace your selection.

• Example:

  

  • Encode: Select Hello World -> SGVsbG8gV29ybGQ=
  • Decode: Select SGVsbG8gV29ybGQ= -> Hello World

URL Encoder / Decoder

• Description: Encodes or decodes text for safe use within a URL (percent-encoding).
• How to use: Select the text you want to process and run the command. Choose "Encode" or "Decode". The result will replace your selection.
• Example:
  • Encode: Select a url with spaces & symbols -> a%20url%20with%20spaces%20%26%20symbols
  • Decode: Select a%20url%20with%20spaces -> a url with spaces

JWT Decoder

• Description: Decodes a JSON Web Token (JWT) from your clipboard to inspect its header and payload.

• How to use: Copy a JWT to your clipboard and run the command. A new editor tab will open with the decoded JSON.

  !JWT Decoder Example

• Example:

  • JWT Input (in clipboard): eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
  • Output:

    {
      "header": {
        "alg": "HS256",
        "typ": "JWT"
      },
      "payload": {
        "sub": "1234567890",
        "name": "John Doe",
        "iat": 1516239022
      }
    }
    

4. Hashing & Cryptography

Hash Generator

• Description: Generates a hash of the selected text using various algorithms.

• How to use: Select the text you want to hash, run the command, and choose the desired algorithm (MD5, SHA1, SHA256, SHA512). The hash is copied to your clipboard.

  !Hash Generator Example

• Example:

  • Input Text: devcortex
  • Algorithm: SHA256
  • Output (in clipboard): 2d8c8630d3e92189390725287a285655841453051715283547143a5180a1a568

HMAC Generator

• Description: Generates a Hash-based Message Authentication Code (HMAC) for the selected text.
• How to use: Select the text, run the command, and provide a secret key when prompted. The HMAC-SHA256 signature will be copied to your clipboard.
• Example:
  • Input Text: message
  • Secret Key: secret
  • Output (in clipboard): 6e9ef29b75ffc5b7ab9f3b7854491064b973f754ab7945542382958564643e97

Bcrypt

• Description: A tool for working with bcrypt hashes. You can either generate a new hash for a string or verify a string against an existing bcrypt hash.
• How to use:
  • Generate: Run the command, choose "Generate", and enter the string to hash. The hash is copied to your clipboard.
  • Verify: Run the command, choose "Verify", enter the plain text string, and then enter the bcrypt hash to compare against. A notification will show if they match.
• Example:
  • Generate Input: password123
  • Generate Output (in clipboard): $2a$10$somesalt/.somehashvalue... (example format)