ruby_aem 4.0.2 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 538155af1ac911c997632a8e2eaeb3bafaf6a76de3411149703c818e894cce99
-  data.tar.gz: 924f0979becab02b071cab7687e2f29c9a9d0ff800b0a53c944a1fb34082e558
+  metadata.gz: 364f15252d0e15d5109deb5162c2e68a064436f754fda9839ad0bee7d69a4dbd
+  data.tar.gz: bb40460d828167a6b44b3bb921a3cc79621ca063f498a180a9a5b269cc243031
 SHA512:
-  metadata.gz: d63a8b1ef4052bf8db88ddbb59eed544475636c631c37a435e5519d698493a013c3470c4abd730e15414e0e683faeaf6a5ae41babb13c8c745a9227381d0bd2a
-  data.tar.gz: 16b6b5b2a9c156a217c185553cd45808eacdd2488aefeef2ad175889ec631b637eceb3b723e208aaf6daf74bb2b14a6faf6f5eeea01a90fd0fd1d70f680fbb97
+  metadata.gz: dfab4aa798fbed53e5fe4b705324db3ba770b1d7b673b6e9508c59d7481fe59d2493ea22c49b6dfd17959062491d6c7693722de6f333f382ac38f833f0847d0c
+  data.tar.gz: 394b101dad00b640afb6d207ef0d5e6666b72fc9f1c891b30a2fccdd2a39603b41e3011640eaf3cc872ed61becd07c4dc9eb5f2e9b7f80a1a31e3dcdbf5fbc1e

data/conf/gem.yaml

@@ -1,2 +1,2 @@
 ---
-version: 4.0.2
+version: 4.1.0

data/conf/spec.yaml

@@ -1,3 +1,13 @@
+---
+# Message, path and URI templates are kept on one line, wrapping them risks
+# changing their parsed values.
+# yamllint disable rule:line-length
+
+# Optional param names must match the opts keys of the swagger_aem / swagger_aem_osgi
+# generated *_api.rb methods exactly, unknown keys are silently ignored by the client.
+# e.g. swagger_aem 4.0.0 renamed jcrcontent_* to jcr_content_*, reppassword to rep_password,
+# and operation to _operation (plain :operation is overwritten by the generated client).
+# test/unit/spec_yaml_spec.rb checks these names against the installed gems.
 aem:
   actions:
     get_login_page:
@@ -16,7 +26,7 @@ aem:
         required:
         optional:
           tags: '%{tags}'
-          combinetagsor: '%{combine_tags_or}'
+          combine_tags_or: '%{combine_tags_or}'
       responses:
         200:
           handler: json_aem_health_check
@@ -102,7 +112,7 @@ authorizablekeystore:
         optional:
           new_password: '%{password}'
           re_password: '%{password}'
-          operation: createStore
+          _operation: createStore
       responses:
         200:
           handler: simple
@@ -164,7 +174,7 @@ authorizablekeystore:
           path: '%{intermediate_path}/%{authorizable_id}/keystore'
           name: store.p12
         optional:
-          operation: delete
+          _operation: delete
       responses:
         200:
           handler: simple
@@ -348,29 +358,29 @@ flushagent:
           runmode: '%{run_mode}'
           name: '%{name}'
         optional:
-          jcrprimary_type: cq:Page
-          jcrcontent_cqname: '%{name}'
-          jcrcontent_jcrtitle: '%{title}'
-          jcrcontent_jcrdescription: '%{description}'
-          jcrcontent_slingresource_type: cq/replication/components/agent
-          jcrcontent_transport_uri: '%{dest_base_url}/dispatcher/invalidate.cache'
-          jcrcontent_alias_update: '%{alias_update}'
-          jcrcontent_log_level: '%{log_level}'
-          jcrcontent_no_versioning: true
-          jcrcontent_protocol_http_headers:
+          jcr_primary_type: cq:Page
+          jcr_content_cq_name: '%{name}'
+          jcr_content_jcr_title: '%{title}'
+          jcr_content_jcr_description: '%{description}'
+          jcr_content_sling_resource_type: cq/replication/components/agent
+          jcr_content_transport_uri: '%{dest_base_url}/dispatcher/invalidate.cache'
+          jcr_content_alias_update: '%{alias_update}'
+          jcr_content_log_level: '%{log_level}'
+          jcr_content_no_versioning: true
+          jcr_content_protocol_http_headers:
             - 'CQ-Action:{action}'
             - 'CQ-Handle:{path}'
             - 'CQ-Path:{path}'
-          jcrcontent_protocol_http_headers_type_hint: String[]
-          jcrcontent_protocol_http_method: GET
-          jcrcontent_retry_delay: '%{retry_delay}'
-          jcrcontent_serialization_type: flush
-          jcrcontent_jcrmixin_types: cq:ReplicationStatus
-          jcrcontent_trigger_receive: true
-          jcrcontent_trigger_specific: true
-          jcrcontent_cqtemplate: /libs/cq/replication/templates/agent
-          jcrcontent_enabled: true
-          jcrcontent_ssl: '%{ssl}'
+          jcr_content_protocol_http_headers_type_hint: String[]
+          jcr_content_protocol_http_method: GET
+          jcr_content_retry_delay: '%{retry_delay}'
+          jcr_content_serialization_type: flush
+          jcr_content_jcr_mixin_types: cq:ReplicationStatus
+          jcr_content_trigger_receive: true
+          jcr_content_trigger_specific: true
+          jcr_content_cq_template: /libs/cq/replication/templates/agent
+          jcr_content_enabled: true
+          jcr_content_ssl: '%{ssl}'
       responses:
         200:
           handler: simple
@@ -386,7 +396,7 @@ flushagent:
           runmode: '%{run_mode}'
           name: '%{name}'
         optional:
-          operation: delete
+          _operation: delete
       responses:
         200:
           handler: simple
@@ -522,7 +532,7 @@ node:
       params:
         required:
           path: '%{path}'
-          jcrprimary_type: '%{type}'
+          jcr_primary_type: '%{type}'
           name: '%{name}'
       responses:
         201:
@@ -536,7 +546,7 @@ node:
           path: '%{path}'
           name: '%{name}'
         optional:
-          operation: delete
+          _operation: delete
       responses:
         200:
           handler: simple
@@ -574,7 +584,7 @@ package:
           group_name: '%{group_name}'
           package_name: '%{package_name}'
           package_version: '%{package_version}'
-          charset: utf-8
+          _charset_: utf-8
       responses:
         200:
           handler: json_package_service
@@ -591,7 +601,7 @@ package:
           path: '/etc/packages/%{group_name}/%{package_name}-%{package_version}.zip'
         optional:
           filter: '%{filter}'
-          charset: utf-8
+          _charset_: utf-8
       responses:
         200:
           handler: json_package_service
@@ -720,7 +730,7 @@ path:
           path: '%{path}'
           name: '%{name}'
         optional:
-          operation: delete
+          _operation: delete
       responses:
         200:
           handler: simple
@@ -748,6 +758,8 @@ configproperty:
         201:
           handler: simple
           message: 'Set %{config_node_name} config %{type} property %{name}=%{value}'
+    # TODO: remove the create<config> actions below, unused since a170df6 (2020, #31) when
+    # ConfigProperty#create switched to the generic create action (postConfigProperty)
     createapachefelixjettybasedhttpservice:
       api: sling
       operation: postConfigApacheFelixJettyBasedHttpService
@@ -765,7 +777,10 @@ configproperty:
           - org_apache_felix_https_keystore_key_password
           - org_apache_felix_https_keystore_key_password_type_hint
           - org_apache_felix_https_truststore
-          - org_apache_felix_https_truststore_key_type_hint
+          # org.apache.felix.https.truststore@TypeHint, read as org_apache_felix_https_truststore_type_hint:
+          # https://github.com/shinesolutions/swagger-aem/blob/4.0.0/specification/swagger-aem.yml#L257
+          # https://github.com/shinesolutions/swagger-aem/blob/4.0.0/clients/ruby/generated/lib/swagger_aem/api/sling_api.rb#L1457
+          - org_apache_felix_https_truststore_type_hint
           - org_apache_felix_https_truststore_password
           - org_apache_felix_https_truststore_password_type_hint
           - org_apache_felix_https_clientcertificate
@@ -774,8 +789,11 @@ configproperty:
           - org_apache_felix_https_enable_type_hint
           - org_osgi_service_http_port_secure
           - org_osgi_service_http_port_secure_type_hint
-          - json_maximumresults
-          - json_maximumresults_type_hint
+          # json_maximumresults and json_maximumresults_type_hint were removed from this action:
+          # postConfigApacheFelixJettyBasedHttpService has no json.maximumresults parameter in any
+          # swagger_aem release (1.0.0 to 4.0.0), so they were never sent. They were copied from the
+          # Sling GET servlet action in ruby_aem a626c5d (2017) and stay on createapacheslinggetservlet.
+          # https://github.com/shinesolutions/swagger-aem/blob/4.0.0/specification/swagger-aem.yml#L198-L306
       responses:
         200:
           handler: simple
@@ -789,6 +807,9 @@ configproperty:
       params:
         required:
         optional:
+          # json.maximumresults and json.maximumresults@TypeHint:
+          # https://github.com/shinesolutions/swagger-aem/blob/4.0.0/specification/swagger-aem.yml#L311-L320
+          # https://github.com/shinesolutions/swagger-aem/blob/4.0.0/clients/ruby/generated/lib/swagger_aem/api/sling_api.rb#L1683-L1684
           - json_maximumresults
           - json_maximumresults_type_hint
           - enable_html
@@ -920,7 +941,10 @@ configproperty:
           - name_id_format
           - name_id_format_type_hint
           - digest_method
-          - digestMethod_type_hint
+          # digestMethod@TypeHint, read as digest_method_type_hint:
+          # https://github.com/shinesolutions/swagger-aem/blob/4.0.0/specification/swagger-aem.yml#L1517
+          # https://github.com/shinesolutions/swagger-aem/blob/4.0.0/clients/ruby/generated/lib/swagger_aem/api/sling_api.rb#L1350
+          - digest_method_type_hint
           - signature_method
           - signature_method_type_hint
           - user_intermediate_path
@@ -971,20 +995,20 @@ replicationagent:
           runmode: '%{run_mode}'
           name: '%{name}'
         optional:
-          jcrprimary_type: cq:Page
-          jcrcontent_cqname: '%{name}'
-          jcrcontent_jcrtitle: '%{title}'
-          jcrcontent_jcrdescription: '%{description}'
-          jcrcontent_slingresource_type: cq/replication/components/agent
-          jcrcontent_serialization_type: durbo
-          jcrcontent_transport_uri: '%{dest_base_url}/bin/receive?sling:authRequestLogin=1'
-          jcrcontent_transport_user: '%{transport_user}'
-          jcrcontent_transport_password: '%{transport_password}'
-          jcrcontent_log_level: '%{log_level}'
-          jcrcontent_retry_delay: '%{retry_delay}'
-          jcrcontent_cqtemplate: /libs/cq/replication/templates/agent
-          jcrcontent_enabled: true
-          jcrcontent_ssl: '%{ssl}'
+          jcr_primary_type: cq:Page
+          jcr_content_cq_name: '%{name}'
+          jcr_content_jcr_title: '%{title}'
+          jcr_content_jcr_description: '%{description}'
+          jcr_content_sling_resource_type: cq/replication/components/agent
+          jcr_content_serialization_type: durbo
+          jcr_content_transport_uri: '%{dest_base_url}/bin/receive?sling:authRequestLogin=1'
+          jcr_content_transport_user: '%{transport_user}'
+          jcr_content_transport_password: '%{transport_password}'
+          jcr_content_log_level: '%{log_level}'
+          jcr_content_retry_delay: '%{retry_delay}'
+          jcr_content_cq_template: /libs/cq/replication/templates/agent
+          jcr_content_enabled: true
+          jcr_content_ssl: '%{ssl}'
       responses:
         200:
           handler: simple
@@ -1000,7 +1024,7 @@ replicationagent:
           runmode: '%{run_mode}'
           name: '%{name}'
         optional:
-          operation: delete
+          _operation: delete
       responses:
         200:
           handler: simple
@@ -1042,20 +1066,20 @@ outboxreplicationagent:
           runmode: '%{run_mode}'
           name: '%{name}'
         optional:
-          jcrprimary_type: cq:Page
-          jcrcontent_cqname: '%{name}'
-          jcrcontent_jcrtitle: '%{title}'
-          jcrcontent_jcrdescription: '%{description}'
-          jcrcontent_slingresource_type: cq/replication/components/agent
-          jcrcontent_transport_uri: repo://var/replication/outbox
-          jcrcontent_no_versioning: true
-          jcrcontent_log_level: '%{log_level}'
-          jcrcontent_cqtemplate: /libs/cq/replication/templates/agent
-          jcrcontent_enabled: true
-          jcrcontent_trigger_distribute: true
-          jcrcontent_trigger_modified: false
-          jcrcontent_trigger_specific: true
-          jcrcontent_user_id: '%{user_id}'
+          jcr_primary_type: cq:Page
+          jcr_content_cq_name: '%{name}'
+          jcr_content_jcr_title: '%{title}'
+          jcr_content_jcr_description: '%{description}'
+          jcr_content_sling_resource_type: cq/replication/components/agent
+          jcr_content_transport_uri: repo://var/replication/outbox
+          jcr_content_no_versioning: true
+          jcr_content_log_level: '%{log_level}'
+          jcr_content_cq_template: /libs/cq/replication/templates/agent
+          jcr_content_enabled: true
+          jcr_content_trigger_distribute: true
+          jcr_content_trigger_modified: false
+          jcr_content_trigger_specific: true
+          jcr_content_user_id: '%{user_id}'
       responses:
         200:
           handler: simple
@@ -1071,7 +1095,7 @@ outboxreplicationagent:
           runmode: '%{run_mode}'
           name: '%{name}'
         optional:
-          operation: delete
+          _operation: delete
       responses:
         200:
           handler: simple
@@ -1113,20 +1137,20 @@ reversereplicationagent:
           runmode: '%{run_mode}'
           name: '%{name}'
         optional:
-          jcrprimary_type: cq:Page
-          jcrcontent_cqname: '%{name}'
-          jcrcontent_jcrtitle: '%{title}'
-          jcrcontent_jcrdescription: '%{description}'
-          jcrcontent_slingresource_type: cq/replication/components/agent
-          jcrcontent_serialization_type: durbo
-          jcrcontent_transport_uri: '%{dest_base_url}/bin/receive?sling:authRequestLogin=1'
-          jcrcontent_transport_user: '%{transport_user}'
-          jcrcontent_transport_password: '%{transport_password}'
-          jcrcontent_log_level: '%{log_level}'
-          jcrcontent_retry_delay: '%{retry_delay}'
-          jcrcontent_cqtemplate: /libs/cq/replication/templates/agent
-          jcrcontent_enabled: true
-          jcrcontent_reverse_replication: true
+          jcr_primary_type: cq:Page
+          jcr_content_cq_name: '%{name}'
+          jcr_content_jcr_title: '%{title}'
+          jcr_content_jcr_description: '%{description}'
+          jcr_content_sling_resource_type: cq/replication/components/agent
+          jcr_content_serialization_type: durbo
+          jcr_content_transport_uri: '%{dest_base_url}/bin/receive?sling:authRequestLogin=1'
+          jcr_content_transport_user: '%{transport_user}'
+          jcr_content_transport_password: '%{transport_password}'
+          jcr_content_log_level: '%{log_level}'
+          jcr_content_retry_delay: '%{retry_delay}'
+          jcr_content_cq_template: /libs/cq/replication/templates/agent
+          jcr_content_enabled: true
+          jcr_content_reverse_replication: true
       responses:
         200:
           handler: simple
@@ -1142,7 +1166,7 @@ reversereplicationagent:
           runmode: '%{run_mode}'
           name: '%{name}'
         optional:
-          operation: delete
+          _operation: delete
       responses:
         200:
           handler: simple
@@ -1270,7 +1294,7 @@ truststore:
         optional:
           new_password: '%{password}'
           re_password: '%{password}'
-          operation: createStore
+          _operation: createStore
       responses:
         200:
           handler: simple
@@ -1308,7 +1332,7 @@ truststore:
           path: etc/truststore
           name: truststore.p12
         optional:
-          operation: delete
+          _operation: delete
       responses:
         200:
           handler: simple
@@ -1355,7 +1379,7 @@ user:
           intermediate_path: '%{path}'
         optional:
           create_user: 'true'
-          reppassword: '%{password}'
+          rep_password: '%{password}'
       responses:
         201:
           handler: html_authorizable_id

data/lib/ruby_aem/client.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/error.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -18,6 +18,11 @@ module RubyAem
   class Error < StandardError
     attr_accessor :result
 
+    # Initialise an error.
+    #
+    # @param message error message
+    # @param result RubyAem::Result
+    # @return new RubyAem::Error instance
     def initialize(message, result)
       super(message)
       self.result = result

data/lib/ruby_aem/handlers/file.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/handlers/html.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -109,6 +109,7 @@ module RubyAem
     # @param html HTML response body string
     # @param regex Ruby regular expression, all regex matches will be replaced
     # @param replacement all existence of the regex will be replaced with this string
+    # @return sanitised HTML string
     def self._sanitise_html(html, regex, replacement)
       if regex.match?(html)
         html.gsub!(regex, replacement)

data/lib/ruby_aem/handlers/json.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -144,8 +144,8 @@ module RubyAem
       result
     end
 
-    # Authorizable keystore payload handler, checks for the existence of certificate within
-    # AEM Truststore, identified by cert_alias call parameter.
+    # Authorizable keystore payload handler, checks for the existence of certificate chain within
+    # AEM Authorizable Keystore, identified by private_key_alias call parameter.
     #
     # @param response HTTP response containing status_code, body, and headers
     # @param response_spec response specification as configured in conf/spec.yaml

data/lib/ruby_aem/handlers/simple.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/handlers/xml.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/aem.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/aem_configmgr.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -23,7 +23,7 @@ module RubyAem
       # Initialise an AEM instance.
       #
       # @param client RubyAem::Client
-      # @return new RubyAem::Resources::Aem instance
+      # @return new RubyAem::Resources::AemConfigMgr instance
       def initialize(client)
         @client = client
         @call_params = {}

data/lib/ruby_aem/resources/authorizable_keystore.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -26,7 +26,7 @@ module RubyAem
       # @param client RubyAem::Client
       # @param intermediate_path AEM User home path
       # @param authorizable_id AEM User id
-      # @return new RubyAem::Resources::AuhtorizableKeystore instance
+      # @return new RubyAem::Resources::AuthorizableKeystore instance
       def initialize(client, intermediate_path, authorizable_id)
         @client = client
         @call_params = {
@@ -50,7 +50,6 @@ module RubyAem
       #
       # @param old_password Current password for the authorizable keystore
       # @param new_password New password for the authorizable keystore
-
       # @return RubyAem::Result
       def change_password(old_password, new_password)
         @call_params[:old_password] = old_password

data/lib/ruby_aem/resources/bundle.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/certificate.rb

@@ -105,6 +105,10 @@ module RubyAem
         @client.call(self.class, __callee__.to_s, @call_params)
       end
 
+      # Retrieve the alias of the certificate from AEM Truststore info,
+      # the certificate is identified by its serial number.
+      #
+      # @return the certificate's alias, nil if the certificate does not exist in AEM Truststore
       def _get_alias
         truststore_info = @truststore.info.data
         cert_alias = nil

data/lib/ruby_aem/resources/certificate_chain.rb

@@ -28,7 +28,7 @@ module RubyAem
       # @param private_key_alias Alias of the private key associated to this certificate chain
       # @param keystore_intermediate_path AEM User home path
       # @param keystore_authorizable_id AEM User id
-      # @return new RubyAem::Resources::AuhtorizableKeystore instance
+      # @return new RubyAem::Resources::CertificateChain instance
       def initialize(client, private_key_alias, keystore_intermediate_path, keystore_authorizable_id)
         @client = client
         @truststore = RubyAem::Resources::Truststore.new(client)

data/lib/ruby_aem/resources/config_property.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/flush_agent.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/group.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/node.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/outbox_replication_agent.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/package.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/path.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/replication_agent.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/repository.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/reverse_replication_agent.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/saml.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/resources/truststore.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -43,6 +43,8 @@ module RubyAem
       # and convert it to PKCS12 Truststore object.
       #
       # @param file_path path to Truststore file
+      # @param password Password for AEM Truststore
+      # @return OpenSSL::PKCS12 Truststore object
       def read(file_path, password)
         truststore_raw = File.read file_path
         OpenSSL::PKCS12.new(truststore_raw, password)

data/lib/ruby_aem/resources/user.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/response.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/result.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem/swagger.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/ruby_aem.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2021 Shine Solutions Group
+# Copyright 2016-2026 Shine Solutions Group
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -98,6 +98,8 @@ module RubyAem
     end
 
     # Set default configuration values and handle numeric/boolean String values
+    #
+    # @param conf configuration hash, the hash will be modified with the sanitised values
     def sanitise_conf(conf)
       conf[:username] ||= 'admin'
       conf[:password] ||= 'admin'
@@ -122,7 +124,7 @@ module RubyAem
 
     # Create an AEM ConfigMgr instance.
     #
-    # @return new RubyAem::Resources::Aem instance
+    # @return new RubyAem::Resources::AemConfigMgr instance
     def aem_configmgr
       RubyAem::Resources::AemConfigMgr.new(@client)
     end
@@ -143,12 +145,12 @@ module RubyAem
       RubyAem::Resources::Certificate.new(@client, serial_number)
     end
 
-    # # Create a certificate chain instance.
-    # #
+    # Create a certificate chain instance.
+    #
     # @param private_key_alias Alias of the private key associated to this certificate chain
     # @param keystore_intermediate_path AEM User home path
     # @param keystore_authorizable_id AEM User id
-    # # @return new RubyAem::Resources::CertificateChain instance
+    # @return new RubyAem::Resources::CertificateChain instance
     def certificate_chain(private_key_alias, keystore_intermediate_path, keystore_authorizable_id)
       RubyAem::Resources::CertificateChain.new(@client, private_key_alias, keystore_intermediate_path, keystore_authorizable_id)
     end
@@ -183,7 +185,9 @@ module RubyAem
 
     # Create a Keystore instance for given authorizable id.
     #
-    # @return new RubyAem::Resources::AuhtorizableKeystore instance
+    # @param intermediate_path AEM User home path
+    # @param authorizable_id AEM User id
+    # @return new RubyAem::Resources::AuthorizableKeystore instance
     def authorizable_keystore(intermediate_path, authorizable_id)
       RubyAem::Resources::AuthorizableKeystore.new(@client, intermediate_path, authorizable_id)
     end
@@ -258,7 +262,7 @@ module RubyAem
 
     # Create a SSL instance.
     #
-    # @return new RubyAem::Resources::Saml instance
+    # @return new RubyAem::Resources::Ssl instance
     def ssl
       RubyAem::Resources::Ssl.new(@client)
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_aem
 version: !ruby/object:Gem::Version
-  version: 4.0.2
+  version: 4.1.0
 platform: ruby
 authors:
 - Shine Solutions