cf-perm-test-helpers 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6c5098d775ca87a09c66e1b2c5f35d5627a616c3
+  data.tar.gz: e4ac24532aac9085bd6d11a4161dc7267cea5cfc
+SHA512:
+  metadata.gz: 7e511820e65a378c729f17584500da42bc15023dab0a89c99a211312ddc04f66744a0d75e54f2a4d55e49794e9e7410ff651c9ad4792297ce80da09618e01d37
+  data.tar.gz: e039df1098bf1e9a7a22d417324141d25242cbdb48996ca3f86b6892d9c862b03c97e7e4ca1b73d393e67795ba324f0b7e9396313539ab427cf0ae11e357b948

data/LICENSE

@@ -0,0 +1,177 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

data/NOTICE

@@ -0,0 +1,15 @@
+perm-rb
+
+Copyright (c) 2017 CloudFoundry.org Foundation, Inc. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.md

@@ -0,0 +1 @@
+# Perm Gem

data/lib_test_helpers/fixtures/certs/tls.crt

@@ -0,0 +1,22 @@
+-----BEGIN CERTIFICATE-----
+MIIDbzCCAlegAwIBAgIUTadXn91P5E0yWFHz8uKTkkgzZ2MwDQYJKoZIhvcNAQEL
+BQAwEjEQMA4GA1UEAwwHcGVybS1jYTAeFw0xNzA5MjgyMTM0MjZaFw0yNzA5MjYy
+MTM0MjZaMBQxEjAQBgNVBAMMCWxvY2FsaG9zdDCCASIwDQYJKoZIhvcNAQEBBQAD
+ggEPADCCAQoCggEBAPsA/65ee9JgHs8+T/rvxUF5PDzQrO2sm+wSU/BKbWN9MFcR
+IRueTLhSG20C1ZU51g2aGQaPlX0mHMjmrVuj+bqcQvedFPiyfXyfzwHZuZLofH4P
+rLJ6Cnn4oUEboLa3te2dVd8qQqHD8F98vKbpjhyPVbp6DbEmw+/VqBwmdLdX+uTe
+myzxsxSuvgdfowSFt5tPU8s7XySqnbAHkjxRAL2Y+e8jlnEUjHAaQi87c8JsdnM/
+P0I+qS0mbHU2gZHoK7kbx5oeTPhCj1UPmiMe3cC7jZS61MNnQEQ4cdZM3xZrv2hT
+iILtuI6mP5Yepx9Chdnxw0FaoC8PButZzTsusZECAwEAAaOBujCBtzAdBgNVHQ4E
+FgQU/gPT7uM6aLH/bTFtfMeHtCxHN2MwGgYDVR0RBBMwEYIJbG9jYWxob3N0hwR/
+AAABMB0GA1UdJQQWMBQGCCsGAQUFBwMCBggrBgEFBQcDATBNBgNVHSMERjBEgBRz
+9xCzFVxcyurPIith+0xfVi8FJKEWpBQwEjEQMA4GA1UEAwwHcGVybS1jYYIUChcA
+OUh3Faghz7ewM/UE5wGk0ZYwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOC
+AQEA2b147bcC3NX/g/JL5Li2wRx+L895wB3XjMj/TaIBxlTmvOS7oBrmXXn+QEfn
+igQFLKHhI3KGf8754QW1UiGQ2vBBDS1AumbWY0929JlDIZuDlibJ89sT4Xh8Y3x8
+eW5arqlM+2VoZ5wFOJXYqMGwCTrhRlQohsGyYw3G6IlF1RvCXq95mYXAn1JwZtYs
+Smz1qHof5NK3H0HjPzyJr0ka54nRtNOtstEoOd/w3mSA//dTWBG2HWRJ/tGXK2du
+MUVhhTaCxkNcHCMfHvLZkVB1mQGKUFBOkNsgeo1zHhUrIVlL8uIyS5aD4HCCwCE6
+yD2vYdmqGJfQudWGJSmHzwZoxw==
+-----END CERTIFICATE-----
+

data/lib_test_helpers/fixtures/certs/tls.key

@@ -0,0 +1,28 @@
+-----BEGIN RSA PRIVATE KEY-----
+MIIEpAIBAAKCAQEA+wD/rl570mAezz5P+u/FQXk8PNCs7ayb7BJT8EptY30wVxEh
+G55MuFIbbQLVlTnWDZoZBo+VfSYcyOatW6P5upxC950U+LJ9fJ/PAdm5kuh8fg+s
+snoKefihQRugtre17Z1V3ypCocPwX3y8pumOHI9VunoNsSbD79WoHCZ0t1f65N6b
+LPGzFK6+B1+jBIW3m09TyztfJKqdsAeSPFEAvZj57yOWcRSMcBpCLztzwmx2cz8/
+Qj6pLSZsdTaBkegruRvHmh5M+EKPVQ+aIx7dwLuNlLrUw2dARDhx1kzfFmu/aFOI
+gu24jqY/lh6nH0KF2fHDQVqgLw8G61nNOy6xkQIDAQABAoIBAQC6sux7W4YIXjys
+dDHzeeMkJzQ6HBF0m/5CYwOSaRnidZy+NlyE+YMhWtlRhVkurR1dcrCIo8ZSl0Wz
+3Xk2/8niFxbsrSeLMOCMESZdvv/8mPb4oVoYSxR90wTGs/Ef15f3zR6xZvK29lJW
+BCcik/iDn83pbZ2/lhEJ1Mc9YRFRySMVvDymv5ONx0fnFRd08G3pa0urztKqz/ya
+YknIml+KA0QZpHEg6qwPMlkblHB0ntGxl1bWxBRLcxzdqUsV9CLjxuixAVTftuTU
+Dxn6a/gy41hS9OI3J1DNxC2ru8GsP+/noHB8bzFOn4v7S5ZHxLS4uX0Uud4p8tKd
+e7ENrgnBAoGBAP91mpfZNDgo8ufQsK9j8htjHMMMvVDmM7nrloOtfhtECLuaKe75
+QO0e9WcHK1dcPZX38vtUogMVquUdzSjAXLkPYuYiLnhOFpnyi1rnqRVEeviPyr7B
+mnDjOSKseRr2OvYlKmhIud7pdkXR76StQIiWiYPpVh51eOcio7jPce55AoGBAPuI
++ykjhMrxY/1WDnhklo6iaP9xMQHAmdukI7s523YEnHlQLXpsVPmI9LUwEZoqDljH
+Ku0HgLRmSo5JBsqZOFeSBdMl1/fS8O7SEPlctqnZJnsDAmhs72xy37VBS10xukx0
+ega56arYC3KTOaVys3hREMcYwHT++zA29jsGALXZAoGALOl+LmgveBgq7HqSNaO6
+svnv2pLozcpLGcrDgY8E9sI1TtZBvRPxSD8DIgPuqMM8yJr5CxrMCQLMMs/Ue++l
+3ZtI5fDofpor+xDbUzYbUfPiMsUE/hiHkIVCTEhKWmUj5JaQKBlxJDGja48HNMqI
+5/qfXqOtUlmQ0gITCrDd9PECgYAuouQmaX56fi0S0HzYV5YOlhAvpFX4xDQCpDk3
+wm9tP0efunzkIOfUaE8utN3enoOQdEUCM4zqZbjXDrUipSvsGJfZ4T9cpJClRu98
+vHLlpOxcjF9K6z+s9NODcLq/abPn7wSc8KVhVrMwqBldEpox6Z3ZvD4asxfxhY87
+vE4vaQKBgQDpDk1XMuQsNtNNCoHkEAzLFjD5jCm1jOsclAYyezoo4t6klwyDoJ0m
+sLQqHW3w0X1ZNwUDr7NOD/jYskq6xS5YnsGkDTb5ZctyETbAT2mMqX+nKlPjCQmp
+tRaHQbFam23APnURyXacAbJrO+lcMBKKmGi+ZFEkcgiMtuo11i0drg==
+-----END RSA PRIVATE KEY-----
+

data/lib_test_helpers/fixtures/certs/tls_ca.crt

@@ -0,0 +1,20 @@
+-----BEGIN CERTIFICATE-----
+MIIDNDCCAhygAwIBAgIUChcAOUh3Faghz7ewM/UE5wGk0ZYwDQYJKoZIhvcNAQEL
+BQAwEjEQMA4GA1UEAwwHcGVybS1jYTAeFw0xNzA5MjgyMTMzNDVaFw0yNzA5MjYy
+MTMzNDVaMBIxEDAOBgNVBAMMB3Blcm0tY2EwggEiMA0GCSqGSIb3DQEBAQUAA4IB
+DwAwggEKAoIBAQDp581GW7dj47/Qt77ffS290PJpE0N2ymE6OHFLjJOsUIla4QyK
+CmIyOlj1vgE2/hA4fB8Eijz0EXb52gCUi2Hr3M0LKRIzjjOirX9bW7XvrbJwYA7b
+fYI+ltyO7AA4CGD1SuIykSNQ/NkwVHQXxfIxQuRiY7hOX5QnL0L+q/h29YNZuiLv
+2Nsp6zQsJnK+yyxVyl2H9PnDTD/rRUxdhz5HKlhjL6NKyxsALjQwa3aGygUKeRAA
+t8pMUKmyQd9CbN/x4Pla0UtksXSABLsleUFSbDiQ74cq73AiVTrtJR9RUbOl6dh7
+G90uMi8ASqR6/aKi6aBL2yIOVqQ69hjKBouvAgMBAAGjgYEwfzAdBgNVHQ4EFgQU
+c/cQsxVcXMrqzyIrYftMX1YvBSQwTQYDVR0jBEYwRIAUc/cQsxVcXMrqzyIrYftM
+X1YvBSShFqQUMBIxEDAOBgNVBAMMB3Blcm0tY2GCFAoXADlIdxWoIc+3sDP1BOcB
+pNGWMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBANaZaQsCBFxb
+t9YMRUAmosOZ0iN04NRH3YydaWIf5mEQN8AlkCGBwcHujf26+k9fsevgAs6yK6ku
+fpet6ZhlZBUJK+bCPvN9q5CSDrXHe5J7i/Sadh2bKJ7PplngyD6gnGk5HGJdGt5m
+c9TE+i1oVdr4armUPtVunfRII5GF/T+KJIk1578HYPobXvNZUriG5Te+NJ5AoPP1
+HagFePCC73xEdIJUxPsSILhRCU5+Zync3n/8PxF9lMFmngElPMqpm6a/8jSqXNs0
+02tYCqRZxkDunXQxiQWPdPvH4Le0aw1FqZTx9Fgoa+Sy1PjRoCIaOim1/MlAugUZ
+FtJ142A5d3I=
+-----END CERTIFICATE-----

data/lib_test_helpers/perm_test_helpers.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'perm_test_helpers/version'
+require 'perm_test_helpers/server_runner'

data/lib_test_helpers/perm_test_helpers/server_runner.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+require 'mysql'
+require 'securerandom'
+require 'socket'
+require 'subprocess'
+
+module CloudFoundry
+  module PermTestHelpers
+    # rubocop:disable Metrics/ClassLength
+    class ServerRunner
+      attr_reader :hostname, :port, :tls_ca, :tls_ca_path
+
+      # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/AbcSize, Metrics/MethodLength
+      def initialize(opts = {})
+        cwd = File.dirname(__FILE__)
+        cert_path = File.join(cwd, '..', 'fixtures', 'certs')
+
+        @hostname = opts[:hostname] || ENV['PERM_TEST_HOSTNAME'] || 'localhost'
+        @port = opts[:port] || ENV['PERM_TEST_PORT'] || random_port
+        @perm_path = opts[:perm_path] || ENV['PERM_TEST_PATH'] || 'perm'
+        @log_level = opts[:log_level] || ENV['PERM_TEST_LOG_LEVEL'] || 'fatal'
+        @tls_cert = opts[:tls_cert_path] || ENV['PERM_TEST_TLS_CERT_PATH'] || File.join(cert_path, 'tls.crt')
+        @tls_key = opts[:tls_key_path] || ENV['PERM_TEST_TLS_KEY_PATH'] || File.join(cert_path, 'tls.key')
+        @tls_ca_path = opts[:tls_ca_path] || ENV['PERM_TEST_TLS_CA_PATH'] || File.join(cert_path, 'tls_ca.crt')
+        @audit_file_path = opts[:audit_file_path] || ENV['PERM_TEST_AUDIT_FILE_PATH'] || '/dev/null'
+        @tls_ca = File.open(tls_ca_path).read
+
+        opts[:db] ||= {}
+        @db_driver = opts[:db][:driver] || ENV['PERM_TEST_SQL_DB_DRIVER'] || 'mysql'
+        @db_schema = opts[:db][:schema] || ENV['PERM_TEST_SQL_DB_SCHEMA'] || random_schema
+        @db_host = opts[:db][:host] || ENV['PERM_TEST_SQL_DB_HOST'] || 'localhost'
+        @db_port = opts[:db][:port] || ENV['PERM_TEST_SQL_DB_PORT'] || '3306'
+        @db_socket = opts[:db][:socket] || ENV['PERM_TEST_SQL_DB_SOCKET'] || Mysql::MYSQL_UNIX_PORT
+        @db_username = opts[:db][:username] || ENV['PERM_TEST_SQL_DB_USERNAME'] || 'perm'
+        @db_password = opts[:db][:password] || ENV['PERM_TEST_SQL_DB_PASSWORD'] || ''
+
+        @stdout = opts[:stdout] || ENV['PERM_TEST_STDOUT_PATH'] || STDOUT
+        @stderr = opts[:stderr] || ENV['PERM_TEST_STDERR_PATH'] || STDERR
+      end
+      # rubocop:enable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/AbcSize
+
+      def start
+        create_db
+        migrate_db
+        @process ||= start_perm
+      end
+
+      def stop
+        drop_db
+        @process&.terminate
+        @process = nil
+      end
+
+      private
+
+      attr_writer :port
+      attr_reader :perm_path, :log_level, :process, :tls_cert, :tls_key, :audit_file_path
+      attr_reader :db_connection, :db_driver, :db_schema, :db_host, :db_port, :db_socket, :db_username, :db_password
+      attr_reader :stdout, :stderr
+
+      def create_db
+        @db_connection = Mysql.connect(db_host, db_username, db_password, nil, db_port, db_socket)
+
+        stmt = @db_connection.prepare("create database #{db_schema}")
+        stmt.execute
+      end
+
+      def migrate_db
+        cmd = [
+          perm_path,
+          'migrate',
+          'up',
+          '--log-level', log_level,
+          '--sql-db-driver', db_driver,
+          '--sql-db-schema', db_schema,
+          '--sql-db-host', db_host,
+          '--sql-db-port', db_port,
+          '--sql-db-username', db_username,
+          '--sql-db-password', db_password
+        ]
+
+        Subprocess.check_call(cmd, stdout: stdout, stderr: stderr)
+      end
+
+      def drop_db
+        stmt = @db_connection.prepare("drop database #{db_schema}")
+        stmt.execute
+      end
+
+      # rubocop:disable Metrics/AbcSize
+      def start_perm
+        retries = 0
+        process = nil
+
+        begin
+          listen_port = port || random_port
+          cmd = [
+            perm_path,
+            'serve',
+            '--listen-hostname', hostname,
+            '--listen-port', listen_port.to_s,
+            '--log-level', log_level,
+            '--tls-certificate', tls_cert,
+            '--tls-key', tls_key,
+            '--sql-db-driver', db_driver,
+            '--sql-db-schema', db_schema,
+            '--sql-db-host', db_host,
+            '--sql-db-port', db_port,
+            '--sql-db-username', db_username,
+            '--sql-db-password', db_password,
+            '--audit-file-path', audit_file_path
+          ]
+
+          process = Subprocess.popen(cmd, stdout: stdout, stderr: stderr)
+          wait_for_server(process.pid)
+          @port = listen_port
+
+          process
+        rescue Errno::ESRCH => e
+          # Retry in case the random port is taken
+          retries += 1
+          process.terminate
+
+          retry if retries < 3
+          raise e
+        rescue Errno::ENOENT
+          raise 'perm_path must point to server executable'
+        end
+      end
+      # rubocop:enable Metrics/MethodLength, Metrics/AbcSize
+
+      def random_schema
+        # Dashes are invalid in DB names
+        "perm-#{SecureRandom.uuid}".tr('-', '_')
+      end
+
+      def random_port
+        rand(65_000 - 1024) + 1024
+      end
+
+      # Wait for the server to actually start accepting connections
+      def wait_for_server(pid)
+        time_waited = 0
+
+        begin
+          Process.getpgid(pid)
+
+          TCPSocket.new(hostname, port).close
+        rescue Errno::ECONNREFUSED, Errno::EAFNOSUPPORT
+          time_waited += 0.1
+
+          raise 'Perm server not running after 5 seconds' if time_waited >= 5
+
+          sleep 0.1
+          retry
+        end
+      end
+    end
+  end
+end

data/lib_test_helpers/perm_test_helpers/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module CloudFoundry
+  module PermTestHelpers
+    VERSION = '0.0.2'
+  end
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: cf-perm-test-helpers
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- CloudFoundry Permissions Team
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-04-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: subprocess
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: ruby-mysql
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.14
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.14
+description: 
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- NOTICE
+- README.md
+- lib_test_helpers/fixtures/certs/tls.crt
+- lib_test_helpers/fixtures/certs/tls.key
+- lib_test_helpers/fixtures/certs/tls_ca.crt
+- lib_test_helpers/perm_test_helpers.rb
+- lib_test_helpers/perm_test_helpers/server_runner.rb
+- lib_test_helpers/perm_test_helpers/version.rb
+homepage: 
+licenses:
+- Apache-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib_test_helpers
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.13
+signing_key: 
+specification_version: 4
+summary: Test helpers for CloudFoundry Permissions
+test_files: []