geminize 0.1.0 → 1.0.0

data/lib/geminize/rails/app/helpers/geminize_helper.rb

@@ -1,125 +0,0 @@
-# frozen_string_literal: true
-
-module GeminizeHelper
-  # Render the Gemini conversation as HTML
-  # @param conversation [Geminize::Models::Conversation, nil] Conversation to render (defaults to current_gemini_conversation)
-  # @param options [Hash] Optional rendering options
-  # @option options [String] :user_class CSS class for user messages
-  # @option options [String] :ai_class CSS class for AI messages
-  # @option options [Boolean] :include_timestamps Include message timestamps
-  # @return [String] HTML representation of the conversation
-  def render_gemini_conversation(conversation = nil, options = {})
-    conversation ||= current_gemini_conversation if respond_to?(:current_gemini_conversation)
-    return content_tag(:div, "No conversation available", class: "gemini-empty-conversation") unless conversation
-
-    content_tag(:div, class: "gemini-conversation") do
-      conversation.messages.map do |message|
-        render_gemini_message(message, options)
-      end.join.html_safe
-    end
-  end
-
-  # Render a single message from the conversation
-  # @param message [Geminize::Models::Message] The message to render
-  # @param options [Hash] Optional rendering options
-  # @return [String] HTML representation of the message
-  def render_gemini_message(message, options = {})
-    is_user = message.role == "user"
-
-    message_class = if is_user
-      options[:user_class] || "gemini-user-message"
-    else
-      options[:ai_class] || "gemini-ai-message"
-    end
-
-    content_tag(:div, class: "gemini-message #{message_class}") do
-      output = []
-
-      # Add the role label
-      output << content_tag(:div, is_user ? "You" : "AI", class: "gemini-message-role")
-
-      # Add the message content (convert newlines to <br> tags)
-      output << content_tag(:div, simple_format(message.parts.first["text"]), class: "gemini-message-content")
-
-      # Add timestamp if requested
-      if options[:include_timestamps] && message.respond_to?(:timestamp) && message.timestamp
-        timestamp = message.timestamp.is_a?(Time) ? message.timestamp : Time.parse(message.timestamp.to_s)
-        output << content_tag(:div, timestamp.strftime("%Y-%m-%d %H:%M:%S"), class: "gemini-message-timestamp")
-      end
-
-      output.join.html_safe
-    end
-  end
-
-  # Create a chat form that handles submitting messages to Gemini
-  # @param options [Hash] Form options
-  # @option options [String] :submit_text Text for the submit button (default: "Send")
-  # @option options [String] :placeholder Placeholder text (default: "Type your message...")
-  # @option options [String] :form_class CSS class for the form
-  # @option options [String] :input_class CSS class for the input field
-  # @option options [String] :submit_class CSS class for the submit button
-  # @option options [String] :url URL to submit the form to (default: current URL)
-  # @return [String] HTML form
-  def gemini_chat_form(options = {})
-    default_options = {
-      submit_text: "Send",
-      placeholder: "Type your message...",
-      form_class: "gemini-chat-form",
-      input_class: "gemini-chat-input",
-      submit_class: "gemini-chat-submit",
-      url: request.path
-    }
-
-    opts = default_options.merge(options)
-
-    form_tag(opts[:url], method: :post, class: opts[:form_class]) do
-      output = []
-      output << text_area_tag(:message, nil, placeholder: opts[:placeholder], class: opts[:input_class])
-      output << submit_tag(opts[:submit_text], class: opts[:submit_class])
-      output.join.html_safe
-    end
-  end
-
-  # Render Markdown text as HTML
-  # @param text [String] Markdown text to render
-  # @param options [Hash] Options for rendering
-  # @return [String] HTML content
-  def markdown_to_html(text, options = {})
-    return "" if text.blank?
-
-    # Check if the markdown gem is available
-    if defined?(Redcarpet)
-      renderer = Redcarpet::Render::HTML.new(hard_wrap: true, filter_html: false)
-      markdown = Redcarpet::Markdown.new(renderer, options)
-      markdown.render(text).html_safe
-    else
-      # Fall back to simple formatting if Redcarpet is not available
-      simple_format(text)
-    end
-  end
-
-  # Add syntax highlighting to code blocks
-  # @param html [String] HTML content that may contain code blocks
-  # @return [String] HTML with syntax highlighting applied
-  def highlight_code(html)
-    return html unless defined?(Rouge)
-
-    formatter = Rouge::Formatters::HTML.new
-
-    # Find all code blocks and apply syntax highlighting
-    doc = Nokogiri::HTML::DocumentFragment.parse(html)
-    doc.css("pre code").each do |code|
-      lang = code["class"]&.sub("language-", "") || "text"
-      lexer = Rouge::Lexer.find(lang) || Rouge::Lexers::PlainText.new
-
-      # Get the code content and format it
-      code_text = code.text
-      highlighted = formatter.format(lexer.lex(code_text))
-
-      # Replace the original code block with the highlighted version
-      code.parent.replace("<pre class=\"highlight #{lang}\">#{highlighted}</pre>")
-    end
-
-    doc.to_html.html_safe
-  end
-end

data/lib/geminize/rails/controller_additions.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-module Geminize
-  module Rails
-    # Module for adding Geminize functionality to controllers
-    # Provides methods that make it easy to include Geminize controller concerns.
-    #
-    # This module is automatically included in ActionController::Base
-    # when the gem is used in a Rails application.
-    #
-    # @example Including in a specific controller
-    #   class ChatController < ApplicationController
-    #     geminize_controller
-    #
-    #     def create
-    #       @response = send_gemini_message(params[:message])
-    #       render :show
-    #     end
-    #   end
-    module ControllerAdditions
-      # Add Geminize functionality to a controller
-      # This method includes the Geminize::Controller concern in your controller,
-      # which provides methods for working with the Gemini API.
-      #
-      # @return [void]
-      # @example
-      #   class ApplicationController < ActionController::Base
-      #     include Geminize::Rails::ControllerAdditions
-      #     geminize_controller
-      #   end
-      def geminize_controller
-        include Geminize::Controller
-      end
-    end
-  end
-end
-
-# Add the module to ActionController::Base if it exists
-ActiveSupport.on_load(:action_controller) do
-  include Geminize::Rails::ControllerAdditions
-end

data/lib/geminize/rails/engine.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-module Geminize
-  module Rails
-    # Rails engine for Geminize
-    # Provides Rails integration for the Gemini API.
-    class Engine < ::Rails::Engine
-      isolate_namespace Geminize
-
-      initializer "geminize.configure" do |app|
-        # Set up configuration if needed
-      end
-
-      initializer "geminize.load_concerns" do
-        ActiveSupport.on_load(:action_controller) do
-          require "geminize/rails/app/controllers/concerns/geminize/controller"
-        end
-
-        ActiveSupport.on_load(:action_view) do
-          require "geminize/rails/app/helpers/geminize_helper"
-        end
-      end
-
-      config.to_prepare do
-        # Load any dependencies that need to be available
-      end
-    end
-  end
-end

data/lib/geminize/rails/helper_additions.rb

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-module Geminize
-  module Rails
-    # Module for adding Geminize view helpers to Rails applications
-    # Provides methods to simplify the inclusion of Geminize helpers in views.
-    #
-    # This module is automatically included in ActionView::Base
-    # when the gem is used in a Rails application.
-    #
-    # @example Using Geminize helpers in a view
-    #   <%# After including the helpers in ApplicationHelper %>
-    #   <%= render_gemini_conversation %>
-    #   <%= gemini_chat_form %>
-    module HelperAdditions
-      # Add Geminize helpers to views
-      # This method includes the GeminizeHelper module in your view context,
-      # providing helper methods for rendering Gemini conversations, chat forms,
-      # and formatting responses.
-      #
-      # @return [void]
-      # @example
-      #   module ApplicationHelper
-      #     include Geminize::Rails::HelperAdditions
-      #     geminize_helper
-      #   end
-      def geminize_helper
-        include GeminizeHelper
-      end
-    end
-  end
-end
-
-# Add our helpers module to ActionView::Base if it exists
-ActiveSupport.on_load(:action_view) do
-  include Geminize::Rails::HelperAdditions
-end

data/lib/geminize/rails.rb

@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-
-require "geminize/rails/engine" if defined?(::Rails::Engine)
-require "geminize/railtie" if defined?(::Rails::Railtie)
-require "geminize/rails/controller_additions" if defined?(::ActionController::Base)
-require "geminize/rails/helper_additions" if defined?(::ActionView::Base)
-
-module Geminize
-  # Rails integration module for Geminize
-  # Provides Rails integration for the Google Gemini API.
-  #
-  # The integration includes:
-  # - A Rails engine to load all required components
-  # - Controller concerns with helper methods for Gemini operations
-  # - View helpers for rendering conversations and responses
-  # - Generators for creating configuration files
-  #
-  # @example Setting up in a Rails application
-  #   # In config/initializers/geminize.rb (created by the generator)
-  #   Geminize.configure do |config|
-  #     config.api_key = ENV.fetch("GEMINI_API_KEY")
-  #   end
-  #
-  #   # In app/controllers/chat_controller.rb
-  #   class ChatController < ApplicationController
-  #     geminize_controller
-  #
-  #     def create
-  #       @response = send_gemini_message(params[:message])
-  #       redirect_to chat_path
-  #     end
-  #   end
-  #
-  #   # In app/views/chat/show.html.erb
-  #   <%= render_gemini_conversation %>
-  #   <%= gemini_chat_form %>
-  module Rails
-    # Returns true if running in a Rails environment
-    # Useful for conditionally executing code only in Rails apps.
-    #
-    # @return [Boolean] true if Rails is defined
-    # @example
-    #   if Geminize::Rails.rails?
-    #     # Rails-specific code
-    #   end
-    def self.rails?
-      defined?(::Rails)
-    end
-  end
-end

data/lib/geminize/railtie.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-module Geminize
-  # Railtie for lightweight Rails integration
-  # Provides basic Rails integration when the full engine is not required.
-  # This is automatically loaded when the gem is used in a Rails application.
-  #
-  # @example Basic usage in a Rails application
-  #   # No additional setup needed - Railtie is loaded automatically
-  #   # In your controller:
-  #   class ExamplesController < ApplicationController
-  #     def example
-  #       @response = Geminize.generate_text("What is Ruby on Rails?").text
-  #     end
-  #   end
-  class Railtie < ::Rails::Railtie
-    # Configure Geminize when used in a Rails application
-    # @return [void]
-    initializer "geminize.configure" do |app|
-      # Set up configuration for Geminize when used in a Rails app
-      Geminize.configure do |config|
-        # Set conversations path to Rails tmp directory by default
-        config.conversations_path = Rails.root.join("tmp", "conversations") if config.conversations_path.nil?
-      end
-    end
-
-    # Set up any rake tasks if needed
-    # @return [void]
-    rake_tasks do
-      # Define rake tasks here if needed
-    end
-  end
-end

data/lib/generators/geminize/install_generator.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-require "rails/generators/base"
-
-module Geminize
-  module Generators
-    # Generator for installing Geminize Rails integration
-    # This generator creates an initializer with default configuration
-    class InstallGenerator < Rails::Generators::Base
-      source_root File.expand_path("templates", __dir__)
-      desc "Creates a Geminize initializer for Rails."
-
-      def create_initializer_file
-        template "initializer.rb", "config/initializers/geminize.rb"
-      end
-
-      def show_readme
-        readme "README" if behavior == :invoke
-      end
-    end
-  end
-end

data/lib/generators/geminize/templates/README

@@ -1,31 +0,0 @@
-===============================================================================
-
-Geminize has been successfully installed!
-
-A configuration initializer has been created at:
-  config/initializers/geminize.rb
-
-You need to edit the initializer and add your Google Gemini API key.
-You can get an API key from https://ai.google.dev/
-
-===============================================================================
-
-Usage Examples:
-
-# Basic text generation
-text = Geminize.generate_text("What is Ruby on Rails?").text
-puts text
-
-# Create a chat session
-chat = Geminize.create_chat("My Support Chat")
-response = Geminize.chat("How can I create a Ruby gem?", chat)
-puts response.text
-
-# Follow-up question (keeps conversation context)
-response = Geminize.chat("What about adding a Rails engine to my gem?", chat)
-puts response.text
-
-# For more examples, see the documentation at:
-# https://github.com/nhlongnguyen/geminize
-
-===============================================================================

data/lib/generators/geminize/templates/initializer.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-# Geminize Configuration
-#
-# This file contains the configuration for the Geminize gem.
-# It is used to set up the Google Gemini API integration.
-
-Geminize.configure do |config|
-  # Your Google Gemini API key
-  # You can get one from https://ai.google.dev/
-  # Can also be set via GEMINI_API_KEY environment variable
-  # config.api_key = ENV.fetch("GEMINI_API_KEY", nil)
-
-  # The API version to use (default: v1beta)
-  # config.api_version = "v1beta"
-
-  # The default model to use (default: gemini-2.0-flash)
-  # config.default_model = "gemini-2.0-flash"
-
-  # The base URL for the Gemini API (default: https://generativelanguage.googleapis.com)
-  # config.api_base_url = "https://generativelanguage.googleapis.com"
-
-  # Logging level for Geminize (default: :info)
-  # Valid values: :debug, :info, :warn, :error, :fatal
-  # config.log_level = Rails.env.production? ? :info : :debug
-
-  # Where to store conversation data (default: Rails.root.join("tmp", "conversations"))
-  # Only applicable when using FileConversationRepository
-  # config.conversations_path = Rails.root.join("tmp", "conversations")
-
-  # Default parameters for text generation
-  # config.generation_defaults = {
-  #   temperature: 0.7,
-  #   max_tokens: 500,
-  #   top_p: 0.95,
-  #   top_k: 40
-  # }
-end