generic_test 0.1.13 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7fd4592cd7c34e39ae05d9db02ea20dd6ca739f368851db22dac04168504ec1
-  data.tar.gz: fb55093d314dfc89e13d0ec4342317106d6caef89dcd9e7341c42c79a59f464b
+  metadata.gz: a5dc87e6158431181b42b3d8775d112382c54617cb5f519657064bb21650a5ac
+  data.tar.gz: 9662978df60eb50b37033056dca365c192e7891a5546159a3d4e34e6a62b6911
 SHA512:
-  metadata.gz: f5ec80dd8977f15b6ffc3a66cec286a2183da371a10eb4d4428ff0f607d849e818bc303ffa96c3295e9ba787f7dcf092e95d64729318dcd357ee390937ec9680
-  data.tar.gz: 92d050bbbd02da8821ba2685cec5bcf86a1187a3f9a3ab82d4cc0ef44b0bc5d47644c520e81b5fd8859293021b840bb16571cf407f7fdc08924beaf67dbef97f
+  metadata.gz: b079ecf7d4f14cd88d64766ed3e49f34052ee349951fdce2c9ec5785e601e8d43c826daaa87f7f693e94c7480b8bfa3d04f5649ce9fbad44793b88a13ce39f52
+  data.tar.gz: 22192bdb59c6563dc8228292328f6a3838476143fbc8753569f3cab00c647d2bc7d326133a82330ce8a31084009f78d4ba0033d4dca921c7d73f51f408f79364

data/.gitlab-ci.yml

@@ -1,4 +1,4 @@
-image: ruby:2.6
+image: ruby:3.3
 
 include:
   - template: Code-Quality.gitlab-ci.yml
@@ -8,16 +8,22 @@ docker_build:
     # Use TLS https://docs.gitlab.com/ee/ci/docker/using_docker_build.html#tls-enabled
     DOCKER_HOST: tcp://docker:2376
     DOCKER_TLS_CERTDIR: "/certs"
-  stage: deploy # Part of a later stage
+  stage: test # Part of a later stage
   services:
-    - docker:19.03.5-dind
-  image: docker:19.03.5
+    - docker:20.10.11-dind
+  image: docker:20.10.11
   script:
     - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
     - docker pull --quiet $CI_REGISTRY_IMAGE:latest || true
     - docker build -t $CI_REGISTRY_IMAGE:latest .
     - docker run -t $CI_REGISTRY_IMAGE:latest generic_test page samuel-garratt.gitlab.io/generic_test/about.html
     - docker push $CI_REGISTRY_IMAGE:latest
+  # only:
+  #   - master
+  # needs: ["test"]
+  except:
+    changes:
+      - "*.md"
 
 test:
   image: registry.gitlab.com/samuel-garratt/generic_test
@@ -34,6 +40,23 @@ test:
     expire_in: 1 week
     when: always
 
+# Example of using generic test
+example_test:
+  stage: test
+  image: registry.gitlab.com/samuel-garratt/generic_test
+  script:
+    - generic_test page samuel-garratt.gitlab.io/generic_test/about.html
+  variables:
+    GIT_STRATEGY: none
+  artifacts:
+    paths:
+      - logs/*.xml
+      - reports
+    reports:
+      junit: logs/*.xml
+    expire_in: 1 week
+    when: always
+
 pages:
   stage: deploy
   script:
@@ -51,4 +74,4 @@ pages:
   image: docker:19.03.5
   stage: test
   script:
-    - docker run myrepo/generic_test BASE_URL
+    - docker run myrepo/generic_test BASE_URL

data/.rspec

@@ -1,5 +1,5 @@
 --format documentation
+--format html --out report.html
 --color
 --require spec_helper
 --format RspecJunitFormatter --out logs/page_<%= ENV['PAGE_URL'].split('://').last.tr('/', '_') %>.xml
---format RspecHtmlReporter

data/Dockerfile

@@ -1,5 +1,5 @@
-FROM ruby:2.6
-MAINTAINER Samuel Garratt
+FROM ruby:3.3
+LABEL AUTHOR=SamuelGarratt
 
 # Required ruby gems
 RUN mkdir /test
@@ -21,4 +21,6 @@ RUN export LANG=C.UTF-8
 RUN export LANGUAGE=C.UTF-8
 RUN export LC_ALL=C.UTF-8
 # By running test image is checked and webdriver will be cached
-RUN generic_test page samuel-garratt.gitlab.io/generic_test/about.html
+RUN generic_test page samuel-garratt.gitlab.io/generic_test/about.html
+
+ENTRYPOINT ["generic_test", "page"]

data/README.md

@@ -2,7 +2,9 @@
 
 This gem provides an easy way to run generic tests for a website/api
 
-Test site is at https://samuel-garratt.gitlab.io/generic_test
+Test site is at [https://samuel-garratt.gitlab.io/generic_test](https://samuel-garratt.gitlab.io/generic_test)
+
+## Quick start
 
 Run test gem through docker against this website with (Note it is an example that has some failures)
 
@@ -14,6 +16,27 @@ To get a log of your tests share a volume with the container.
 
 > Please share this volume from an empty folder. Running from within another gem might cause an issue
 
+## Add to gitlab CI for your website
+
+Add the following `YAML` to test against a website
+```yaml
+example_test:
+  stage: test
+  image: registry.gitlab.com/samuel-garratt/generic_test
+  script:
+    - generic_test page YOUR_WEBSITE_URL
+  variables:
+    GIT_STRATEGY: none # Make more efficient and remove any dependency conflicts
+  artifacts:
+    paths:
+      - logs/*.xml
+      - reports # HTML reports
+    reports:
+      junit: logs/*.xml
+    expire_in: 1 week
+    when: always
+```
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -48,6 +71,10 @@ E.g.,
 
 `docker run -t registry.gitlab.com/samuel-garratt/generic_test generic_test page samuel-garratt.gitlab.io/generic_test`
 
+Check version
+
+`docker run -t registry.gitlab.com/samuel-garratt/generic_test generic_test version`
+
 ### Through login page
 
 Environment variables store Login URL, username and password
@@ -78,11 +105,17 @@ login:
 
 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 that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update 
+the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for 
+the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+The pipeline running on master will deploy a new version of the docker container with the latest version released
+to rubygems.org. Therefore a `rake release` is required before any changes will be reflected in the newly built
+docker container.
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://gitlab.com/samuel-garratt/generic_test. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/generic_test/blob/master/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitLab at https://gitlab.com/samuel-garratt/generic_test. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://gitlab.com/samuel-garratt/generic_test/-/blob/master/CODE_OF_CONDUCT.md).
 
 ## License
 

data/generic_test.gemspec

@@ -29,7 +29,8 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'jekyll' # For hosting test website
   spec.add_development_dependency 'rake'
   spec.add_dependency 'rspec-legacy_formatters' # Needed for rspec_html_reporter after RSpec 3
-  spec.add_dependency 'rspec_html_reporter'   # Pretty HTML reports
+  # This doesn't work with latest Ruby version
+  #spec.add_dependency 'rspec_html_reporter'   # Pretty HTML reports
   spec.add_dependency 'rspec_junit_formatter' # Needed for nicer reporting of rspec for use in CI
   spec.add_dependency 'simplecov'     # Code coverage
 

data/lib/generic_test/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GenericTest
-  VERSION = '0.1.13'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: generic_test
 version: !ruby/object:Gem::Version
-  version: 0.1.13
+  version: 0.2.0
 platform: ruby
 authors:
 - Samuel Garratt
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-06-04 00:00:00.000000000 Z
+date: 2024-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -52,20 +52,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: rspec_html_reporter
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec_junit_formatter
   requirement: !ruby/object:Gem::Requirement
@@ -250,7 +236,7 @@ metadata:
   homepage_uri: https://gitlab.com/samuel-garratt/generic_test
   source_code_uri: https://gitlab.com/samuel-garratt/generic_test
   changelog_uri: https://gitlab.com/samuel-garratt/generic_test/blob/master/ChangeLog
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -265,8 +251,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
-signing_key: 
+rubygems_version: 3.2.3
+signing_key:
 specification_version: 4
 summary: Generic tests for a website/api.
 test_files: []