gpt_helpr

== 🏴‍☠️ GptHelpr == Helping to dig your codebase and cook GPT-XX instructions

What is GptHelpr?

It is sometime necessary to provide context and explanations for your code. Instead of manually copying and formatting code snippets, GPT-Helpr automates the process with an interactive cli, generating a well-structured Markdown output, which can be copied to your clipboard or printed to file.

Features

• Interactive Mode: Easily specify file paths and ranges interactively.
• Line Numbers: Option to include line numbers in the output.
• Completion Support: Supports tab completion for file paths.
• Output to File: Option to write the generated output to a file.

Installation

• Add the Gem to Your Gemfile

  gem 'gpt_helpr'
  

• Install the Gem

  bundle install
  

• Or Install Directly via Gem Command

  gem install gpt_helpr
  

Usage

Basic Usage

Run the tool in interactive mode:

gpt_helpr -i -ln

Command-Line Arguments

You can also provide file paths and instructions directly via command-line arguments:

gpt_helpr <file1> <instructions> / <file2> <instructions>

Options

• --interactive or -i: Run the tool in interactive mode.
• --file or -f: Write the output to a file.
• --line-numbers or -ln: Include line numbers in the output.

Examples

Interactive Mode

• Run the tool in interactive mode:

  # note lmk is an alias for gpt_helpr -i -ln
  $ lmk
  == 🏴‍☠️ GptHelpr 0.2.2 == Helping to dig your codebase and cook GPT-XX instructions [current directory /Users/etozzato/WorkSpace/_AINZ/pizzatarians.com]
  
  File Path (optional :start:end): TAB ->
  favicon.ico                 hey.md                      js                          random-acts-of-pizza.md
  _config.yml                 _site                       draft                       fonts
  images                      kneading-baking-academy.md  _exe                        academy
  favicon.gif                 hands-in-dough.md           index.md                    parties-and-events.md
  
  File Path (optional :start:end): hey.md 1:22
  Instructions: can you improve this text? Do you see any issues with the template?
  File Path (optional :start:end):
  
  # this is the generated output (also copied to the clipboard)
  ==== file source  `hey.md 1:22`
  
  1: ---
  2: title: Hey, hello!
  3: layout: default
  4: ---
  5:
  6: # {{ page.title }}
  7: ----
  8:
  9: <div class="row">
  10:   <div class="col-md-12">
  11:     <p class='justin'>
  12:       Nice to meet you, I am *Mek*!
  13:     </p>
  14:     <p class='listo'>
  15:       I am a self-proclaimed pizza guru and I am here to teach & learn. Originally from Venice, Italy you can find me in San Diego, CA.
  16:     </p>
  17:     <p class='listo'>
  18:       In my spare time, I write code @ PlayStation!
  19:     </p>
  20:   </div>
  21: </div>
  22:
  
  can you improve this text? Do you see any issues with the template?
  
  ==== end of  `hey.md`
  

• You can add more files and instructions in the same way.

• Profit!

Command-Line Mode

• Generate output for specified files:

  gpt_helpr app/controllers/pos_controller.rb:10:20 "Describe the controller logic" / app/views/pos/index.html.erb "Explain the view template"
  

• Write the output to a file:

  gpt_helpr app/controllers/pos_controller.rb:10:20 "Describe the controller logic" / app/views/pos/index.html.erb "Explain the view template" --file
  

Contributing

Contributions are welcome! If you have suggestions for improvements or find any issues, please open an issue or create a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.