fripa 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c4b9a552724de9440ae408046a6e38c16f8d384726525ad589ba864dce04ae14
-  data.tar.gz: 4330ef7308fd8302b2c513b6f899ebdde194baea527b6d9c93eb633e1bf9e12b
+  metadata.gz: 60749fcd7e07c8fa7d130e5a1b93933efc6e4d8b245fb9901f8f28c882b9a413
+  data.tar.gz: 1016bdc948602416a33524777e3707902b386a1bdbe2953c8d14fd4def294c5f
 SHA512:
-  metadata.gz: 27f407fe7b2e73c25c3800b2caddfe6e2c249895aeaec1a1a2fb7bf8435207d5084b051b024bff153addc0908391b3971e49a233398e9ca253ac4159e9497c1a
-  data.tar.gz: e45bda9e4d673f372421f8ed90173d83f153ae7d7a074d741750f3dd00b6057b09079e82d314f5987695331b983d80456625ff04fe7b00fb7f535b31a8bf60b3
+  metadata.gz: 94be9bf349433e13e1063c17f73431c929fdd9c61e44552d4f1542b53f97ba8b5c8ab898ebcbf07914fd50303e9cf2d69dfc1cea2fd8c5cfa4aaf3b4b3a3f13e
+  data.tar.gz: 6b751211e984596207e58872a2745d6ab12a22bac7ad5e64d0dfdb6538ff170938f3e2d5523db678ffe5e686ae014ab258e168fb9a2502fd01100bd3fe2a8d64

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.1.2] - 2025-11-14
+
+### Fixed
+- Fixed `Fripa.configure` block syntax not working due to missing required `host` parameter in Configuration initializer
+- Configuration validation now happens at usage time instead of initialization time
+
 ## [0.1.0] - 2025-10-07
 
 Initial release of Fripa - A Ruby client for the FreeIPA JSON-RPC API.

data/README.md

@@ -4,6 +4,9 @@ A Ruby client for the FreeIPA JSON-RPC API.
 
 Docs: [FreeIPA JSON-RPC API](https://freeipa.readthedocs.io/en/latest/api/json-rpc.html)
 
+## What is FreeIPA
+FreeIPA (Free Identity, Policy, Audit) is an open-source identity management system for Linux/Unix environments. It provides centralized authentication, authorization, and account information by integrating LDAP, Kerberos, DNS, and certificate management. Essentially, it helps organizations manage users, groups, and access policies in a secure and unified way.
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -33,7 +36,9 @@ Configure your FreeIPA server settings globally. These settings are shared acros
 ```ruby
 Fripa.configure do |config|
   config.host = 'ipa.example.com'
-  config.verify_ssl = true  # default: true
+  config.port = 8443         # optional, default: 443 (standard HTTPS port)
+  config.scheme = 'https'    # optional, default: 'https' (use 'http' for local development)
+  config.verify_ssl = true   # default: true
 end
 ```
 
@@ -42,6 +47,8 @@ end
 ```ruby
 Fripa.config = {
   host: 'ipa.example.com',
+  port: 8443,        # optional
+  scheme: 'https',   # optional
   verify_ssl: true
 }
 ```
@@ -51,6 +58,8 @@ Fripa.config = {
 ```ruby
 config = Fripa::Configuration.new(
   host: 'ipa.example.com',
+  port: 8443,        # optional
+  scheme: 'https',   # optional
   verify_ssl: true
 )
 Fripa.config = config
@@ -60,9 +69,24 @@ Fripa.config = config
 
 ```ruby
 Fripa.config.host = 'ipa.example.com'
+Fripa.config.port = 8443      # optional
+Fripa.config.scheme = 'https' # optional
 Fripa.config.verify_ssl = false
 ```
 
+### Local development example
+
+For local FreeIPA instances running on HTTP:
+
+```ruby
+Fripa.configure do |config|
+  config.host = 'localhost'
+  config.port = 8080
+  config.scheme = 'http'
+  config.verify_ssl = false
+end
+```
+
 ## Usage
 
 ### Creating a Client

data/lib/fripa/configuration.rb

@@ -6,23 +6,34 @@ require "uri"
 module Fripa
   # Configuration for Fripa
   class Configuration
-    attr_accessor :host, :verify_ssl
+    attr_accessor :host, :port, :scheme, :verify_ssl
 
-    def initialize(host: nil, verify_ssl: true)
+    def initialize(host: nil, port: nil, scheme: "https", verify_ssl: true)
       @host = host
+      @port = port
+      @scheme = scheme
       @verify_ssl = verify_ssl
     end
 
     def base_url
-      URI::HTTPS.build(host: host)
+      build_uri
     end
 
     def login_url
-      URI::HTTPS.build(host: host, path: "/ipa/session/login_password")
+      build_uri(path: "/ipa/session/login_password")
     end
 
     def api_url
-      URI::HTTPS.build(host: host, path: "/ipa/session/json")
+      build_uri(path: "/ipa/session/json")
+    end
+
+    private
+
+    def build_uri(path: nil)
+      raise ArgumentError, "host is required" if host.nil? || host.empty?
+
+      uri_class = scheme == "https" ? URI::HTTPS : URI::HTTP
+      uri_class.build(host: host, port: port, path: path)
     end
   end
 

data/lib/fripa/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fripa
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fripa
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Bruno Costanzo