functions_framework 1.4.2 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72dfd786bcd5b46663c5bb00f78fd6eed556f8cb9419f7aebeb1fc16421d61b4
-  data.tar.gz: 16ef142b7cc6c98b0eb42c5e6df6fb9d8deceee28d582b2bc0a859b20ef0b97b
+  metadata.gz: 7dc90045c947a92ef29d14a88cccc1a31c82969912b7eca410ff7423bea52cc1
+  data.tar.gz: f678ef25e7883451be774b9dffacb8538971cd6d2211dfeac6a9f7886803ca5f
 SHA512:
-  metadata.gz: 1f1eeb41025962565b9e6920848d0eb117467a60ccea937c415a963281014c35762d6c66966bd281d2e3e2c9937e9d5d2772884ed79d43ce1da690428c3380da
-  data.tar.gz: be1032875299ba2e18a189d142b4a654bb338ec0d9455757c11088baf0c6d5b71d189a166552c9243f14b562fe1d649ca4839bcb24a3a3ac75eca84df3006c2d
+  metadata.gz: c148723f894e7b341780fd43f32938e96fa8de48fca7e8e60f25def589de0fcd05433508e25c756617bcf7bcd58a98793cd0a8112974fd4d4c9cc65aceaa728f
+  data.tar.gz: b0913575ae419000ca0ea74b9f70cea6ecd96126955b27ffb27887b55d90f3abf5f84e5bfafd87c419f960cb683a92118c62252394c79be631cd407057ae43d9

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+### 1.5.0 (2025-01-03)
+
+#### Features
+
+* Support pidfile in CLI & Server (defaults to puma.pid) ([#178](https://github.com/GoogleCloudPlatform/functions-framework-ruby/issues/178)) 
+
 ### 1.4.2 (2024-09-18)
 
 #### Bug Fixes

data/README.md

@@ -4,8 +4,7 @@ An open source framework for writing lightweight, portable Ruby functions that
 run in a serverless environment. Functions written to this Framework will run
 in many different environments, including:
 
- *  [Google Cloud Functions](https://cloud.google.com/functions)
- *  [Google Cloud Run](https://cloud.google.com/run)
+ *  [Google Cloud Run functions](https://cloud.google.com/functions)
  *  Any other [Knative](https://github.com/knative)-based environment
  *  Your local development machine
 
@@ -113,8 +112,7 @@ These guides provide additional getting-started information.
     functions server.
  *  **[Deploying Functions](https://googlecloudplatform.github.io/functions-framework-ruby/latest/file.deploying-functions.html)**
     : How to deploy functions to
-    [Google Cloud Functions](https://cloud.google.com/functions) or
-    [Google Cloud Run](https://cloud.google.com/run).
+    [Google Cloud Run functions](https://cloud.google.com/functions)
 
 The library reference documentation can be found at:
 https://googlecloudplatform.github.io/functions-framework-ruby

data/lib/functions_framework/cli.rb

@@ -36,6 +36,7 @@ module FunctionsFramework
       @source = ::ENV["FUNCTION_SOURCE"] || ::FunctionsFramework::DEFAULT_SOURCE
       @env = nil
       @port = nil
+      @pidfile = nil
       @bind = nil
       @min_threads = nil
       @max_threads = nil
@@ -67,6 +68,12 @@ module FunctionsFramework
     #
     attr_reader :error_message
 
+    ##
+    # @return [String] The pidfile.
+    # @return [nil] if not running.
+    #
+    attr_reader :pidfile
+
     ##
     # Parse the given command line arguments.
     # Exits if argument parsing failed.
@@ -89,6 +96,9 @@ module FunctionsFramework
               "Supported values are 'http' and 'cloudevent'." do |val|
           @signature_type = val
         end
+        op.on "-P", "--pidfile PIDFILE", "Set the pidfile for the server (defaults to puma.pid)" do |val|
+          @pidfile = val
+        end
         op.on "-p", "--port PORT", "Set the port to listen to (defaults to 8080)" do |val|
           @port = val.to_i
         end
@@ -218,6 +228,7 @@ module FunctionsFramework
       ::FunctionsFramework.start function do |config|
         config.rack_env = @env
         config.port = @port
+        config.pidfile = @pidfile
         config.bind_addr = @bind
         config.show_error_details = @detailed_errors
         config.min_threads = @min_threads

data/lib/functions_framework/server.rb

@@ -152,6 +152,24 @@ module FunctionsFramework
       @server&.thread&.alive?
     end
 
+    ##
+    # Returns pidfile if server is currently running
+    #
+    # @return [String, nil]
+    #
+    def pidfile
+      @config.pidfile if running?
+    end
+
+    ##
+    # Returns whether pidfile is present.
+    #
+    # @return [Boolean]
+    #
+    def pidfile?
+      !!@config.pidfile && running?
+    end
+
     ##
     # Cause this server to respond to SIGTERM, SIGINT, and SIGHUP by shutting
     # down gracefully.
@@ -214,6 +232,7 @@ module FunctionsFramework
         self.rack_env = nil
         self.bind_addr = nil
         self.port = nil
+        self.pidfile = nil
         self.min_threads = nil
         self.max_threads = nil
         self.show_error_details = nil
@@ -245,6 +264,14 @@ module FunctionsFramework
         @port = (port || ::ENV["PORT"] || 8080).to_i
       end
 
+      ##
+      # Set the pidfile string, or `nil` to use the default.
+      # @param path [String,nil]
+      #
+      def pidfile= path
+        @pidfile = (path || ::ENV["PIDFILE"] || "puma.pid").to_s
+      end
+
       ##
       # Set the minimum number of worker threads, or `nil` to use the default.
       # @param min_threads [Integer,nil]
@@ -306,6 +333,14 @@ module FunctionsFramework
         @port
       end
 
+      ##
+      # Returns the current pidfile string.
+      # @return [String]
+      #
+      def pidfile
+        @pidfile
+      end
+
       ##
       # Returns the minimum number of worker threads in the thread pool.
       # @return [Integer]

data/lib/functions_framework/version.rb

@@ -17,5 +17,5 @@ module FunctionsFramework
   # Version of the Ruby Functions Framework
   # @return [String]
   #
-  VERSION = "1.4.2".freeze
+  VERSION = "1.5.0".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: functions_framework
 version: !ruby/object:Gem::Version
-  version: 1.4.2
+  version: 1.5.0
 platform: ruby
 authors:
 - Daniel Azuma
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-01 00:00:00.000000000 Z
+date: 2025-01-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cloud_events
@@ -106,10 +106,10 @@ homepage: https://github.com/GoogleCloudPlatform/functions-framework-ruby
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://googlecloudplatform.github.io/functions-framework-ruby/v1.4.2/file.CHANGELOG.html
+  changelog_uri: https://googlecloudplatform.github.io/functions-framework-ruby/v1.5.0/file.CHANGELOG.html
   source_code_uri: https://github.com/GoogleCloudPlatform/functions-framework-ruby
   bug_tracker_uri: https://github.com/GoogleCloudPlatform/functions-framework-ruby/issues
-  documentation_uri: https://googlecloudplatform.github.io/functions-framework-ruby/v1.4.2
+  documentation_uri: https://googlecloudplatform.github.io/functions-framework-ruby/v1.5.0
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -125,7 +125,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.6
+rubygems_version: 3.5.23
 signing_key: 
 specification_version: 4
 summary: Functions Framework for Ruby