func_bot 0.1.3 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c00ad5a2b3aea12bced2b60da8ffe88910c0413ba5a56163f8f08dee540b3e0
-  data.tar.gz: 2c91552073019309fc23ae95046763143f1a7f403bd9ee78493201303fe9a592
+  metadata.gz: dec89531581e54e3e4c5fb9db21095ab99919347c0f34193eb58c4db0295f558
+  data.tar.gz: 51dca7a8ba3d57e22f8873ba16afba9b22671cc50a3f065d561d3b493a3fba1b
 SHA512:
-  metadata.gz: 3397880c0ff9482c56653bc3f9b552cdd747f946d13e5091dffa5cc004127506e1c49b2a409daf03c1699fd6368f884d42fd07c4f1fa9b0ca546ea17127c5923
-  data.tar.gz: d7139064f6ec1dd6546356be3ff93a2a31a0c12307d426e0ffe686db40fca419564d944c30d426cb03d26f093918df411a10d7503f6cdf1f825f63917ad5f880
+  metadata.gz: 3f9395775b04bbf6794c30147c7112589611b7c887c2d708819f073f3ff89e674fbfab8bdd5fb318fdef9a0cbafbb474c83f99d2402017b64abc150d3f3c9252
+  data.tar.gz: 2efacabefb1a867d761de2ee0614a5be5c7c66b834ddb36c20a41363b006987d6662cd351aa201400597942486492119312550d04859525166f085e3c70cb7c3

data/README.md

@@ -2,77 +2,6 @@
 
 FuncBot is a Rails gem built on top of the [ruby-openai](https://github.com/alexrudall/ruby-openai) gem. It allows you to easily create chatbots that can answer questions by calling on functions you define. It's goal is to provide a simple interface to consume [OpenAI's Function Calling API](https://openai.com/blog/function-calling-and-other-api-updates?ref=upstract.com).
 
-## Usage
-
-- Generate a new function
-
-```bash
-rails g func_bot:function <function_name>
-```
-
-- Update the function in `app/lib/func_bot/functions/<function_name>.rb`
-
-  - A function can be as simple or as complex as you need it to be. Your bot will process the results and express them to the user.
-  - All functions must have an `execute` method.
-  - Here's a sample function that returns the current weather for the given location.
-
-    ```ruby
-    module FuncBot
-      module Functions
-        class WeatherFunction < BaseFunction
-          def execute
-            weather_info = {
-              location: parsed_response["location"],
-              temperature: 98,
-              forecast: ["sunny", "windy"]
-            }
-
-            JSON.dump(weather_info)
-          end
-        end
-      end
-    end
-    ```
-
-  - The `parsed_response` and `response` methods are available to all functions.
-    - `parsed_response` is a hash that contains the response relevant to your function from OpenAI.
-    - `response` is the raw response from OpenAI.
-  - Functions also have access to the `bot` attribute which returns the instance of the bot that called the function.
-
-    - This is useful if you need to access the bot's history or other methods.
-    - There might be times when you need to ask gpt a question from within a function, but you don't want to trigger the function again. You can set the `bot.include_functions` attribute to false before asking the question and then set it back to true after.
-
-    ```ruby
-    module FuncBot
-      module Functions
-        class SomeFunction < BaseFunction
-          def execute
-            bot.include_functions = false
-            response = bot.ask "Some question that you don't want to trigger any functions for"
-            bot.include_functions = true
-            do_something_with_response(response)
-            ....
-          end
-        end
-      end
-    end
-    ```
-
-- Update your new function in the list of functions in `app/lib/func_bot/functions/list.yml`.
-  - This list of functions will be available to the bot with every request.
-  - Adding good descriptions to the functions will help the bot infer when to use which function.
-- If the user asks a question that is not related to a function in your list, the bot will just ask ChatGPT.
-
-`bin/rails c`
-
-```ruby
-irb(main):001:0> bot = FuncBot::Bot.new
-=> #<FuncBot::Bot:0x0000000105ecd8e8 @history=#<FuncBot::Bots::History:0x0000000105ecd848 @history=[]>>
-irb(main):002:0> bot.ask "What's the weather like in Miami, FL?"
-=> "The current weather in Miami, FL is sunny and windy with a temperature of 98 degrees."
-irb(main):003:0>
-```
-
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -107,6 +36,62 @@ openai:
   api_key: your-private-key
 ```
 
+## Usage
+
+- Generate a new function
+
+```bash
+rails g func_bot:function <function_name>
+```
+
+- Update your new function in the list of functions in `app/lib/func_bot/functions/list.yml`.
+  - This list of functions will be available to the bot with every request.
+  - Adding good descriptions to the functions will help the bot infer when to use which function.
+- If the user asks a question that is not related to a function in your list, the bot will just ask ChatGPT.
+- A function can be as simple or as complex as you need it to be. Your bot will process the results and express them to the user.
+- All functions must have an `execute` method.
+- Here's a sample function that returns the current weather for the given location.
+
+  ```ruby
+  module FuncBot
+    module Functions
+      class WeatherFunction < BaseFunction
+        def execute
+          weather_info = {
+            location: parsed_response["location"],
+            temperature: 98,
+            forecast: ["sunny", "windy"]
+          }
+
+          JSON.dump(weather_info)
+        end
+      end
+    end
+  end
+  ```
+
+  - The `parsed_response` and `response` methods are available to all functions.
+    - `parsed_response` is a hash that contains the response relevant to your function from OpenAI.
+    - `response` is the raw response from OpenAI.
+  - Functions also have access to the `bot` attribute which returns the instance of the bot that called the function.
+
+    - This is useful if you need to access the bot's history or other methods.
+    - There might be times when you need to ask gpt a question from within a function, but you don't want to trigger the functions again. You can set the `bot.include_functions` attribute to false before asking the question and then set it back to true after.
+
+`bin/rails c`
+
+```ruby
+irb(main):001:0> bot = FuncBot::Bot.new
+=> #<FuncBot::Bot:0x0000000105ecd8e8 @history=#<FuncBot::Bots::History:0x0000000105ecd848 @history=[]>>
+irb(main):002:0> bot.ask "What's the weather like in Miami, FL?"
+=> "The current weather in Miami, FL is sunny and windy with a temperature of 98 degrees."
+irb(main):003:0>
+irb(main):006:0> bot.include_functions = false
+=> false
+irb(main):007:0> bot.ask "What's the weather like in Miami, FL today?"
+=> "I'm sorry, I cannot provide real-time information as my responses are generated based on pre-existing data. Please check a reliable weather source for the most up-to-date information on the weather in Miami, FL."
+```
+
 ## Testing
 
 ```bash

data/lib/func_bot/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FuncBot
-  VERSION = "0.1.3"
+  VERSION = "0.1.5"
 end

data/lib/generators/func_bot/function_generator.rb

@@ -4,6 +4,8 @@ module FuncBot
 
     def generate_function
       template "function.rb", "app/lib/func_bot/functions/#{file_name}_function.rb"
+      template "function_spec.rb", "spec/models/func_bot/functions/#{file_name}_function_spec.rb" if defined?(RSpec)
+      puts "Update the function list file at lib/func_bot/functions/list.yml with the details of your new function."
     end
 
     def append_to_functions_list

data/lib/generators/func_bot/templates/function.rb.tt

@@ -2,9 +2,8 @@ module FuncBot
   module Functions
     class <%= class_name %>Function < BaseFunction
       def execute
-        # Add your function logic here.
-        # eg. data = {some: "data"}
-        # JSON.dump(data)
+        data = {key: "value"}
+        JSON.dump(data)
       end
     end
   end

data/lib/generators/func_bot/templates/function_spec.rb.tt

@@ -0,0 +1,31 @@
+require "rails_helper"
+
+RSpec.describe FuncBot::Functions::<%= class_name %>Function do
+  let(:bot) { FuncBot::Bot.new }
+  let(:function_response) { described_class.new(bot).execute }
+  let(:function_arguments) do
+    {
+      "choices" => [
+        {
+          "message" => {
+            "function_call" => {
+              "arguments" => JSON.dump({key: "value"})
+            }
+          }
+        }
+      ]
+    }
+  end
+
+  before do
+    bot.response = function_arguments
+  end
+
+  describe "#execute" do
+    describe "FuncBot::Functions::<%= class_name %>Function" do
+      it "returns the expected data" do
+        expect(JSON.parse(function_response)["key"]).to eq("value")
+      end
+    end
+  end
+end

data/lib/generators/func_bot/templates/weather_function.rb

@@ -7,7 +7,6 @@ module FuncBot
   module Functions
     class WeatherFunction < BaseFunction
       def execute
-        bot.include_functions = false
         weather_info = {
           location: parsed_response["location"],
           temperature: 98,

data/lib/tasks/func_bot_tasks.rake

@@ -3,8 +3,8 @@ namespace :func_bot do
   task install: :environment do
     command = "rails g func_bot:install setup"
     system(command)
-    puts "Your setup was successful!"
-    puts "You can now run `rails g func_bot:function <function_name>` to generate a new function."
-    puts "Please update the function list file at lib/func_bot/functions/list.yml with the functions you want to include."
+    puts "FuncBot successfully installed."
+    puts "♪┏(°.°)┛┗(°.°)┓┗(°.°)┛┏(°.°)┓ ♪"
+    puts "Run `rails g func_bot:function <function_name>` to generate a new function."
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: func_bot
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.5
 platform: ruby
 authors:
 - lbp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-06-20 00:00:00.000000000 Z
+date: 2023-06-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -227,6 +227,7 @@ files:
 - lib/generators/func_bot/function_generator.rb
 - lib/generators/func_bot/install_generator.rb
 - lib/generators/func_bot/templates/function.rb.tt
+- lib/generators/func_bot/templates/function_spec.rb.tt
 - lib/generators/func_bot/templates/list.yml
 - lib/generators/func_bot/templates/openai.rb
 - lib/generators/func_bot/templates/weather_function.rb