localhost 1.4.2 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2c43cbd483ba75df04398b4a6e534ec13a4456faa6b373ee1629a6673e6bd133
-  data.tar.gz: 53e8080f450ce450e76d4085427fc41c9cd56eced5965672c1766798ebfd709d
+  metadata.gz: cb2af90326b97a7ed35c40f67354cd551fc7f7087b3988752be1ce84346b5d33
+  data.tar.gz: 7d3e6cfe20a573d193ab7d54128af846481287423f058705ec1c7e7267d2093d
 SHA512:
-  metadata.gz: 3869a071d7ee5bd45c5e2ea41edd7a164dba4b4aca54ea46b2618b90ffaeb354761b89c1c3398fc0f39917b2342c63648dbd99e320e49d3ce0f94473e7b90ec0
-  data.tar.gz: 823506611fb8b34a2152eeeee30a641e5027333973c7ed2fcde5ef0ada9c60650196101c10b4aa05d8a6a1e296fce2fae770fd1857308c106e516eb1d57f0702
+  metadata.gz: 8c6c85bff1973b4637c03031a73f4f0a77974eb7f9def2db89b7213586ff051f2c3d4d214732a052d6334f6253b9c54282427bf99c321d3a8c125f02bae07493
+  data.tar.gz: e35941e8efbae8f94b00f2738b7425cfbc4046dca06971c9a970747146e5eef22de7e17e41a185cd15cae9f44f602e5dccee705d01da19508292511f872d1d1b

data/lib/localhost/issuer.rb

@@ -29,12 +29,15 @@ module Localhost
 			return issuer
 		end
 		
+		# The default certificate issuer name.
+		NAME = "development"
+		
 		# Initialize the issuer with the given name.
 		# 
 		# @parameter name [String] The common name to use for the certificate.
 		# @parameter path [String] The path path for loading and saving the certificate.
-		def initialize(name = "development", path: State.path)
-			@name = name
+		def initialize(name = nil, path: State.path)
+			@name = name || NAME
 			@path = path
 			
 			@subject = nil

data/lib/localhost/system/darwin.rb

@@ -5,10 +5,14 @@
 
 module Localhost
 	module System
+		# Darwin specific system operations.
 		module Darwin
+			# Install a certificate into the system trust store.
+			#
+			# @parameter certificate [String] The path to the certificate file.
 			def self.install(certificate)
 				login_keychain = File.expand_path("~/Library/Keychains/login.keychain-db")
-
+				
 				system(
 					"security", "add-trusted-cert",
 					"-d", "-r", "trustRoot",

data/lib/localhost/system/linux.rb

@@ -3,11 +3,13 @@
 # Released under the MIT License.
 # Copyright, 2025, by Samuel Williams.
 
-require "etc"
-
 module Localhost
 	module System
-		module Darwin
+		# Linux specific system operations.
+		module Linux
+			# Install a certificate into the system trust store.
+			#
+			# @parameter certificate [String] The path to the certificate file.
 			def self.install(certificate)
 				filename = File.basename(certificate)
 				destination = "/usr/local/share/ca-certificates/localhost-#{filename}"

data/lib/localhost/system.rb

@@ -4,14 +4,16 @@
 # Copyright, 2025, by Samuel Williams.
 
 module Localhost
+	# @namespace
 	module System
+		# @return [Class] The  best system class for the current platform.
 		def self.current
 			case RUBY_PLATFORM
 			when /darwin/
-				require 'localhost/system/darwin'
+				require "localhost/system/darwin"
 				Darwin
 			when /linux/
-				require 'localhost/system/linux'
+				require "localhost/system/linux"
 				Linux
 			else
 				raise NotImplementedError, "Unsupported platform: #{RUBY_PLATFORM}"

data/lib/localhost/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2018-2024, by Samuel Williams.
 
 module Localhost
-	VERSION = "1.4.2"
+	VERSION = "1.5.0"
 end

data/readme.md

@@ -16,8 +16,6 @@ Please see the [project documentation](https://socketry.github.io/localhost/) fo
 
   - [Getting Started](https://socketry.github.io/localhost/guides/getting-started/index) - This guide explains how to use `localhost` for provisioning local TLS certificates for development.
 
-  - [Browser Configuration](https://socketry.github.io/localhost/guides/browser-configuration/index) - This guide explains how to configure your local browser in order to avoid warnings about insecure self-signed certificates.
-
   - [Example Server](https://socketry.github.io/localhost/guides/example-server/index) - This guide demonstrates how to use <code class="language-ruby">Localhost::Authority</code> to implement a simple HTTPS client & server.
 
 ## Releases

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: localhost
 version: !ruby/object:Gem::Version
-  version: 1.4.2
+  version: 1.5.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -46,7 +46,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2025-03-25 00:00:00.000000000 Z
+date: 2025-04-12 00:00:00.000000000 Z
 dependencies: []
 executables: []
 extensions: []