prompt_manager 0.4.1 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91badda19121014eee4d6c28b1cb882347d951af971d9afb021b00e558cb3fdc
-  data.tar.gz: 500c401e8ced2be25adacaf374a6e18e73c42ec811e7bb632155de9d5626370c
+  metadata.gz: 6c566743ba6741a0787db6ea680e77676ab18282013e3475cad1c30b85b9ce1b
+  data.tar.gz: 1e9e57eecaf97d05799d6b173b1ce90518dc02abeeddbd50eed90c34c376509f
 SHA512:
-  metadata.gz: 89c274000ee45ddb047eb33ab232d0e300fab51be512b1181e6d9d9dbf6abe5213013229bfd0450e948b78b09aa00aab882131ed066c7529e27c5865b8251647
-  data.tar.gz: 4fc94add6f43ab7b0f289849e68c3c6c9f35ca24a90983a459cd2ea9043de03b8b2f9ed6701a3a614be7efecd1fc5557ab0fb0d252e84dc628d38f9f80d2d9ba
+  metadata.gz: e1bcda6797d895b4dd78baf6c6c6cd2b83e2f06bb3446f9112795a6d216eb9450af9f1c2d0b3f762d4f21ee40a1257fec8610eadec33f7f19dabf078e7a859bf
+  data.tar.gz: f69ed112a2b22801dc830d87b11f0a231755141fa4eccded5ee2dc8019343cf6cf61705af560fed211866869940029bbde88cca7c821423da245593839515e03

data/.irbrc

@@ -0,0 +1,14 @@
+require_relative 'lib/prompt_manager'
+require_relative 'lib/prompt_manager/storage/file_system_adapter'
+
+HERE = Pathname.new __dir__
+
+PromptManager::Storage::FileSystemAdapter.config do |config|
+  config.prompts_dir        = HERE + 'examples/prompts_dir'
+  # config.search_proc      = nil     # default
+  # config.prompt_extension = '.txt'  # default
+  # config.parms+_extension = '.json' # default
+end
+
+PromptManager::Prompt.storage_adapter = PromptManager::Storage::FileSystemAdapter.new
+

data/CHANGELOG.md

@@ -1,27 +1,34 @@
-## [0.4.1] = 2023-12-29
+## Unreleased
+
+## Released
+
+### [0.4.2] = 2024-10-26
+- Added configurable parameter_regex to customize keyword pattern
+
+### [0.4.1] = 2023-12-29
 - Changed @directives from Hash to an Array
 - Fixed keywords not being substituted in directives
 
-## [0.4.0] = 2023-12-19
+### [0.4.0] = 2023-12-19
 - Add "//directives param(s)" with keywords just like the prompt text.
 
-## [0.3.3] = 2023-12-01
+### [0.3.3] = 2023-12-01
 - Added example of using the `search_proc` config parameter with the FileSystemAdapter.
 
-## [0.3.2] = 2023-12-01
+### [0.3.2] = 2023-12-01
 
 - The ActiveRecordAdapter is passing its unit tests
 - Dropped the concept of an sqlite3 adapter since active record can be used to access sqlite3 databases as well as the big boys.
 
-## [0.3.0] = 2023-11-28
+### [0.3.0] = 2023-11-28
 
 - **Breaking change** The value of the parameters Hash for a keyword is now an Array instead of a single value.  The last value in the Array is always the most recent value used for the given keyword.  This was done to support the use of a Readline::History object editing in the [aia](https://github.com/MadBomber/aia) CLI tool
 
-## [0.2.0] - 2023-11-21
+### [0.2.0] - 2023-11-21
 
 - **Breaking change to FileSystemAdapter config process**
 - added list and path as extra methods in FileSystemAdapter
 
-## [0.1.0] - 2023-11-16
+### [0.1.0] - 2023-11-16
 
 - Initial release using the FileSystemAdapter

data/README.md

@@ -70,10 +70,16 @@ The prompt_manager uses a regular expression to identify these keywords within t
 
 #### What does a keyword look like?
 
-The current hard-coded REGEX for a [KEYWORD] identifies any all [UPPERCASE_TEXT] enclosed in square brackets as a keyword. [KEYWORDS CAN ALSO HAVE SPACES] as well as the underscore character.
+By default, any text matching `[UPPERCASE_TEXT]` enclosed in square brackets is treated as a keyword. [KEYWORDS CAN ALSO HAVE SPACES] as well as the underscore character.
 
-This is just the initial convention adopted by prompt_manager. It is intended that this REGEX be configurable so that the prompt_manager can be used with other conventions.
+You can customize the keyword pattern by setting a different regular expression:
 
+```ruby
+# Use {{param}} style instead of [PARAM]
+PromptManager::Prompt.parameter_regex = /(\{\{[A-Za-z_]+\}\})/
+```
+
+The regex must include capturing parentheses () to extract the keyword. The default regex is `/(\[[A-Z _|]+\])/`.
 #### All about directives
 
 A directive is a line in the prompt text that starts with the two characters '//' - slash slash - just like in the old days of IBM JCL - Job Control Language.  A prompt can have zero or more directives.  Directives can have parameters and can make use of keywords.

data/Rakefile

@@ -8,7 +8,6 @@ end
 
 Tocer::Rake::Register.call
 
-
 require "bundler/gem_tasks"
 require "rake/testtask"
 

data/examples/directives.rb

@@ -0,0 +1,98 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+# frozen_string_literal: true
+# warn_indent: true
+##########################################################
+###
+##  File: directives.rb
+##  Desc: Demo of the PromptManager and FileStorageAdapter
+##  By:   Dewayne VanHoozer (dvanhoozer@gmail.com)
+##
+#
+
+param1 = "param_one"
+param2 = "param_two"
+
+
+class MyDirectives
+  def self.good_directive(*args)
+    puts "inside #{__method__} with these parameters:"
+    puts args.join(",\n")
+  end
+end
+
+def concept_break = print "\n------------------------\n\n\n"
+
+require_relative '../lib/prompt_manager'
+require_relative '../lib/prompt_manager/storage/file_system_adapter'
+
+require 'amazing_print'
+require 'pathname'
+
+require 'debug_me'
+include DebugMe
+
+HERE        = Pathname.new( __dir__ )
+PROMPTS_DIR = HERE + "prompts_dir"
+
+
+######################################################
+# Main
+
+at_exit do
+  puts
+  puts "Done."
+  puts
+end
+
+# Configure the Storage Adapter to use
+PromptManager::Storage::FileSystemAdapter.config do |config|
+  config.prompts_dir        = PROMPTS_DIR
+  # config.search_proc      = nil     # default
+  # config.prompt_extension = '.txt'  # default
+  # config.parms+_extension = '.json' # default
+end
+
+PromptManager::Prompt.storage_adapter = PromptManager::Storage::FileSystemAdapter.new
+
+# Use {parameter name} brackets to define a parameter
+PromptManager::Prompt.parameter_regex =  /\{[A-Za-z _|]+\}/ 
+
+# Retrieve a prompt
+prompt = PromptManager::Prompt.get(id: 'directive_example')
+
+# Shows prompt without comments or directives
+# It still has its parameter placeholders
+puts prompt
+concept_break
+
+puts "Directives in the prompt:"
+ap prompt.directives
+
+puts "Processing directives ..."
+prompt.directives.each do |entry|
+  if MyDirectives.respond_to? entry.first.to_sym
+    ruby = "MyDirectives.#{entry.first}(#{entry.last.gsub(' ', ',')})"
+    eval "#{ruby}"
+  else
+    puts "ERROR: there is no method: #{entry.first}"
+  end
+end
+
+concept_break
+
+
+
+puts "Parameters in the prompt:"
+ap prompt.parameters
+puts "-"*16
+
+puts "keywords:"
+ap prompt.keywords
+concept_break
+
+prompt.parameters['{language}'] << 'French'
+
+puts "After Substitution"
+puts prompt
+

data/examples/prompts_dir/directive_example.txt

@@ -0,0 +1,14 @@
+# directive_example.txt
+# Desc: Shows how directives work
+
+//good_directive  param1 param2
+//bad_directive   param3 param4
+
+say hello to me in {language} as well as English.
+
+# The default parameter is delimited by square brackets
+# and is all uppercase
+
+write a [PROGRAMMING LANGUAGE] program that predicts the lottery.
+
+

data/examples/using_search_proc.rb

@@ -10,9 +10,6 @@
 ##
 #
 
-require 'debug_me'
-include DebugMe
-
 require 'prompt_manager'
 require 'prompt_manager/storage/file_system_adapter'
 

data/lib/prompt_manager/prompt.rb

@@ -21,11 +21,12 @@
 class PromptManager::Prompt
   COMMENT_SIGNAL    = '#'   # lines beginning with this are a comment
   DIRECTIVE_SIGNAL  = '//'  # Like the old IBM JCL
-  PARAMETER_REGEX   = /(\[[A-Z _|]+\])/
+  DEFAULT_PARAMETER_REGEX = /(\[[A-Z _|]+\])/
   @storage_adapter  = nil
+  @parameter_regex  = DEFAULT_PARAMETER_REGEX
 
   class << self
-    attr_accessor :storage_adapter
+    attr_accessor :storage_adapter, :parameter_regex
 
     alias_method :get, :new
 
@@ -123,7 +124,7 @@ class PromptManager::Prompt
   # the comments.
   #  
   def build
-    @prompt = text.gsub(PARAMETER_REGEX) do |match|
+    @prompt = text.gsub(self.class.parameter_regex) do |match|
                 param_name = match
                 Array(parameters[param_name]).last || match
               end
@@ -142,7 +143,7 @@ class PromptManager::Prompt
   private
 
   def update_keywords
-    @keywords = @text.scan(PARAMETER_REGEX).flatten.uniq
+    @keywords = @text.scan(self.class.parameter_regex).flatten.uniq
     @keywords.each do |kw|
       @parameters[kw] = [] unless @parameters.has_key?(kw)
     end

data/lib/prompt_manager/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PromptManager
-  VERSION = "0.4.1"
+  VERSION = "0.4.2"
 end

data/lib/prompt_manager.rb

@@ -2,6 +2,8 @@
 #
 # frozen_string_literal: true
 
+require 'ostruct'
+
 require_relative "prompt_manager/version"
 require_relative "prompt_manager/storage"
 require_relative "prompt_manager/prompt"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: prompt_manager
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.4.2
 platform: ruby
 authors:
 - Dewayne VanHoozer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-12-29 00:00:00.000000000 Z
+date: 2024-10-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -66,6 +66,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: tocer
   requirement: !ruby/object:Gem::Requirement
@@ -80,8 +94,36 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: "Manage the parameterized prompts (text) used in generative AI (aka chatGPT,
-  \nOpenAI, et.al.) using storage adapters such as FileSystemAdapter, \nSqliteAdapter
+  \nOpenAI, et.al.) using storage adapters such as FileSystemAdapter, \nSqliteAdapter,
   and ActiveRecordAdapter.\n"
 email:
 - dvanhoozer@gmail.com
@@ -90,11 +132,14 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".envrc"
+- ".irbrc"
 - CHANGELOG.md
 - LICENSE
 - LICENSE.txt
 - README.md
 - Rakefile
+- examples/directives.rb
+- examples/prompts_dir/directive_example.txt
 - examples/prompts_dir/todo.json
 - examples/prompts_dir/todo.txt
 - examples/prompts_dir/toy/8-ball.txt
@@ -130,7 +175,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Manage prompts for use with gen-AI processes