port_of_call 0.1.0.alpha1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5f861789c53684db6036135fcb5eb0057c90ea56c95aedd7fabd4cc85c9c0b2
-  data.tar.gz: 0eab14311169be6984ed29ac0a531b0c0ac0f1da8a403dc7af2561a098969267
+  metadata.gz: bbeb66e086b05f2a7d9c8515d91c481c92fb9e488d9cdb9560448f48be955ea5
+  data.tar.gz: a711f3987939e88e5599f36dc81bd20f7bc12584a06a3dd8e12380cf387bb0aa
 SHA512:
-  metadata.gz: 984c62a2c7dec18962070b1dd51b7a0149a21f4caa57c39a42832e5e460671f4ccc55a82445158102d26eb29a27a27f98a99ab7270ec1af9ac5fd900c71427cd
-  data.tar.gz: fcf8f557fa7763042ef1f0aae10f416d101d83413f9d9c5ec869266e217d3931b31dc7dc33afad5ef3cbfbc7f0bb107f9fb2943ae740945dd418a8f3fc59a878
+  metadata.gz: f9b50b4755ed3ba80c0576139ea85c46a8131144485a774c4dc665fed1bcaad46b8f5a44f10fd2ce00275b3dc46e65db42eeaef54112ae02d7f85590e9deb0f9
+  data.tar.gz: d7066319108e1fb19b787b0d36f3886c6db7e5c10eefdd6b1ab3114e44b81d8262474968a2c2e5ec0fc0f590c4bdafeff6f6f24e2488265895ea5f30d3bdb6df

data/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.0] - 2025-09-18
+
+### Changed
+- Graduated to stable 1.0.0 release
+- Public API is now considered stable
+
+## [0.1.0.alpha2] - 2025-03-25
+
+### Fixed
+- Improved Rails environment detection in CLI commands
+- Fixed CI workflow issues
+- Better error handling when not in a Rails environment
+- Added upper bound to Rails dependency version
+
 ## [0.1.0.alpha1] - 2025-03-25
 
 ### Added

data/README.md

@@ -12,10 +12,10 @@ Rails developers who tend to work on multiple applications simultaneously
 =============================
 Port of Call deterministically assigns port numbers to Rails applications:
 
-1. It extracts your application's name from Git or directory name
-2. It creates a hash of the name using SHA256
-3. It maps this hash to a port number within your configured range (default: 3000-3999)
-4. It automatically sets this port when you start your Rails server
+1. It **extracts your application's name** from Git or directory name
+2. It **creates a hash** of the name using SHA256
+3. It **maps this hash to a port number** within your configured range (default: 3000-3999)
+4. It **automatically sets this port** when you start your Rails server
 
 The same app always gets the same port on any machine, avoiding conflicts!
 
@@ -54,33 +54,35 @@ Rake Tasks:
 - `rake port_of_call:start` - Start Rails server
 - `rake poc` - Shorthand for starting the server
 
+
+## Development
+
+- After checking out the repo,
+- run `bin/setup` to install dependencies.
+- Then, run `rake spec` to run the tests.
+- You can also run `bin/console` for an interactive prompt.
+
 ⛵️⛵️⛵️⛵️⛵️ Extras
 =============================
-Configuration:
+
+## Configuration:
 ```ruby
 # In config/initializers/port_of_call.rb
 PortOfCall.configure do |config|
   # Change port range (default: 3000..3999)
   config.port_range = 4000..4999
-  
+
   # Set custom project name
   config.project_name = "my_unique_app_name"
-  
+
   # Avoid specific ports
   config.reserved_ports = [4567, 5000]
 end
 ```
 
-Troubleshooting:
+## Troubleshooting:
 - If your port is already in use, Port of Call will warn you
 - To check port availability: `rake port_of_call:check`
 - For detailed info: `rake port_of_call:info`
 
-GitHub: [github.com/jonathanpberger/port-of-call](https://github.com/jonathanpberger/port-of-call)
-
-License: MIT with additional [disclaimer](LICENSE.txt)
-```
-
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt.
+[![Conforms to README.lint](https://img.shields.io/badge/README.lint-conforming-brightgreen)](https://github.com/discoveryworks/readme-dot-lint)

data/lib/port_of_call/cli.rb

@@ -57,27 +57,29 @@ module PortOfCall
         exit 1
       end
       
+      # Check if Rails is available
+      if !rails_available?
+        puts "ERROR: Rails environment not detected"
+        puts "Calculated port for #{project_name}: #{port}"
+        exit 1
+      end
+      
       # Construct server command
-      if defined?(Rails) && defined?(Rails::Server)
-        puts "Port of Call - Starting Rails server for #{project_name} on port #{port}"
+      puts "Port of Call - Starting Rails server for #{project_name} on port #{port}"
+        
+      # Add -p option if not already specified
+      unless args.include?("-p") || args.include?("--port")
+        args.unshift("-p", port.to_s)
+      end
         
-        # Add -p option if not already specified
-        unless args.include?("-p") || args.include?("--port")
-          args.unshift("-p", port.to_s)
-        end
+      # Start server
+      server_class = Object.const_get("Rails::Server")
+      server_class.new(args).tap do |server|
+        # Set port in server options
+        server.options[:Port] = port if server.options[:Port].nil?
         
         # Start server
-        Rails::Server.new(args).tap do |server|
-          # Set port in server options
-          server.options[:Port] = port if server.options[:Port].nil?
-          
-          # Start server
-          server.start
-        end
-      else
-        # Fallback when not running in a Rails context
-        puts "Port of Call - Rails environment not detected"
-        puts "Calculated port for #{project_name}: #{port}"
+        server.start
       end
     end
     
@@ -98,13 +100,13 @@ module PortOfCall
     # Set the calculated port as the default in development.rb
     # @return [void]
     def set_default_port
-      if defined?(Rails) && defined?(Rails.root)
-        # Use rake task for this
-        system("rake", "port_of_call:set_default")
-      else
+      if !rails_available?
         puts "ERROR: Rails environment not detected"
         exit 1
       end
+      
+      # Use rake task for this
+      system("rake", "port_of_call:set_default")
     end
     
     # Show version information
@@ -134,5 +136,11 @@ module PortOfCall
           port_of_call set        # Set the calculated port as the default
       HELP
     end
+    
+    # Check if Rails is available
+    # @return [Boolean] true if Rails is available
+    def rails_available?
+      defined?(Rails) && Rails.respond_to?(:application)
+    end
   end
 end

data/lib/port_of_call/version.rb

@@ -3,5 +3,5 @@
 module PortOfCall
   # Version number for the gem
   # Following Semantic Versioning (https://semver.org/)
-  VERSION = "0.1.0.alpha1"
+  VERSION = "1.0.0"
 end

data/lib/port_of_call.rb

@@ -4,9 +4,13 @@ require "socket"
 require_relative "port_of_call/version"
 require_relative "port_of_call/configuration"
 require_relative "port_of_call/port_calculator"
-require_relative "port_of_call/railtie" if defined?(Rails)
 require_relative "port_of_call/cli"
 
+# Only require Rails-specific code if Rails is defined
+if defined?(Rails) && Rails.respond_to?(:application)
+  require_relative "port_of_call/railtie"
+end
+
 # Port of Call is a Ruby gem that assigns each Rails application a consistent,
 # deterministic port number based on the application's name or repository.
 # This solves the common conflict of multiple Rails apps all defaulting to port 3000.

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: port_of_call
 version: !ruby/object:Gem::Version
-  version: 0.1.0.alpha1
+  version: 1.0.0
 platform: ruby
 authors:
 - JPB
 bindir: exe
 cert_chain: []
-date: 2025-03-26 00:00:00.000000000 Z
+date: 2025-09-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -16,6 +16,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -23,6 +26,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement