@suffolklitlab/alkiln 4.0.0-pre-api.9 → 4.0.0

package/CHANGELOG.md

@@ -38,12 +38,12 @@ Format:
 ### Security
 - 
 -->
-<!--2022-02-11 -->
+<!-- ## [Unreleased] -->
 
-## [Unreleased]
+## [4.0.0] - 2022-03-30
 ### Added
-- Add action.yml that runs most of what users' workflows run now, along with notes for a new user workflow that will take less maintainance. See #420. We need to add documentation on how to write a workflow file as it currently is if they want to take back control. Setup interview has not yet been updated with this workflow.
-- Add package.json creation/overwriting to action.yml. Simplify package.json.
+- BREAKING: Add package.json creation/overwriting to action.yml. Simplify package.json.
+- BREAKING: Add action.yml that runs most of what users' workflows run now, along with notes for a new user workflow that will take less maintainance. See #420. We need to add documentation on how to write a workflow file as it currently is if they want to take back control. Setup interview has not yet been updated with this workflow.
 - Step: `the text in the JSON variable "variable_with_text_value" should be`. Compare JSON variable with a text value to given text. See #470. Does not accept nested values, e.g. "child.name.first". Downloads all the JSON vars to a .json file in the "downloads" artifacts.
 - Step to log the page's JSON variables and values in the report. Future goal: save to file. See #454.
 - Step to log into the developer's docassemble server account using GitHub SECRETs. See #499.
@@ -51,13 +51,13 @@ Format:
 - Add control of alkiln npm version to the action.yml
 
 ### Changed
-- NPM package is now suffolklitlab scoped package. Refer to @suffolklitlab/alkiln from now on.
-- Update to v13 of puppeteer
-- Update to v7 of cucumber
-- Update action.yml node to v17
-- Use alkiln v4 package.json we create during the test run in `action.yml` (as discussed in #489)
+- BREAKING: NPM package is now suffolklitlab scoped package. Refer to @suffolklitlab/alkiln from now on.
+- BREAKING: Update to v13 of puppeteer
+- BREAKING: Update to v7 of cucumber
+- BREAKING: Update action.yml node to v17
+- BREAKING: Use alkiln v4 package.json we create during the test run in `action.yml` (as discussed in #489)
+- BREAKING: Use API key to access da server, create projects, pull code, delete projects, and check for server restart.
 - Remove and ignore package-lock.json so that our tests will behave more like our users' tests
-- Use API key to access da server, create projects, pull code, delete projects, and check for server restart.
 - Add warning in steps.js for name input with too many parts. Add test in reports.
 - fix typo in the report
 - Throw an error for uploading nonexistent file, changed to error instead of warning in reports. 
@@ -75,6 +75,57 @@ Format:
 - fix typo in the report.
 - session_vars branch path regex not removing start of branch path
 
+## [3.2.1] - 2022-02-09
+### Fixed
+- Typo in report that was messing up copy/paste of test table
+
+## [3.2.0] - 2022-02-09
+### Added
+- Add Step to log into server account using GitHub SECRETs (environment variables). See #499.
+
+## [3.1.11] - 2022-02-02
+### Changed
+- Handle an Assembly Line name Step value that has too many names, including a warning for the developer. Include the first three names and the last name to try to catch suffixes.
+
+## [3.0.11] - 2022-01-25
+### Added
+- Step: `the text in the JSON variable "variable_with_text_value" should be`. Compare JSON variable with a text value to given text. See #470. Does not accept nested values, e.g. "child.name.first". Downloads all the JSON vars to a .json file in the "downloads" artifacts.
+
+## [3.0.10] - 2022-01-24
+### Added
+- Step to log the page's JSON variables and values in the report. Future goal: save to file. See #454.
+
+## [3.0.9] - 2022-01-10
+### Security
+- Install the security fix in the action's package.json as well. Because dependents have to require cucumber itself, if they're not using our action (if they have their own package.json), they're going to have to implement this fix in their repo too. That's why our fix isn't working. We'll start the process of helping developers update. We also need to deprecate all previous versions of ALKiln. See #489.
+
+## [3.0.8] - 2022-01-10
+### Security
+- Fully publish the security fix in v3.0.7
+
+## [3.0.7] - 2022-01-10
+### Security
+- Pinned colors library to 1.4.0. See https://www.bleepingcomputer.com/news/security/dev-corrupts-npm-libs-colors-and-faker-breaking-thousands-of-apps/. We don't use faker, so we don't need to handle that.
+
+## [3.0.6] - 2022-01-07
+### Changed
+- See #371
+- Scenario heading tags are now on a second line
+- Artifact filenames use dashes more and are created separately from Scenario headings
+- Scenario ids are separated from filenames and Scenario headings
+
+## [3.0.5] - 2022-01-06
+### Added
+- Add action.yml that runs most of what users' workflows run now, along with notes for a new user workflow that will take less maintainance. See #420. We need to add documentation on how to write a workflow file as it currently is if they want to take back control. Setup interview has not yet been updated with this workflow.
+- Add package.json creation/overwriting to action.yml. Simplify package.json.
+
+<!-- ## [3.0.1-peer-deps.1] - 2021-12-07 -->
+### Removed
+- Peer dependencies and dev dependencies. Now `cucumber` is just a dependency. See https://github.com/SuffolkLITLab/ALKiln/issues/396 for discussion. Setup interview has not been updated to remove dependencies.
+
+### Fixed
+- Fixed interview name not allowing url parameters. #449
+
 ## [3.0.4] - 2021-12-11
 ### Fixed
 - Use different criteria for testing that the package was saved.

package/README.md

@@ -1,5 +1,13 @@
-# docassemble-cucumber
-Integrated automated end-to-end testing with docassemble, puppeteer, and cucumber.
+# ALKiln
+Integrated automated end-to-end testing with docassemble, puppeteer, cucumber, and chai.
+
+Works well with https://github.com/suffolklitlab/docassemble-AssemblyLine but isn't
+dependent on it.
+
+Formerly named "docassemble-cucumber"
+
+## Documentation
+Read about how to use this framework at https://suffolklitlab.org/docassemble-AssemblyLine-documentation/docs/automated_integrated_testing/.
 
 ## Integration tests
 To setup for the integration tests, create the project on the server:

package/action.yml

@@ -27,7 +27,7 @@ inputs:
   ALKILN_VERSION:
     description: 'Version of ALKiln to get from npm.'
     required: false
-    default: '4.0.0'
+    default: '^4.0.0'
 
 runs:
   using: "composite"
@@ -53,6 +53,7 @@ runs:
         echo "PLAYGROUND_PASSWORD=${{ inputs.PLAYGROUND_PASSWORD }}" >> $GITHUB_ENV
         echo "PLAYGROUND_ID=${{ inputs.PLAYGROUND_ID }}" >> $GITHUB_ENV
         echo "DOCASSEMBLE_DEVELOPER_API_KEY=${{ inputs.DOCASSEMBLE_DEVELOPER_API_KEY }}" >> $GITHUB_ENV
+        echo "ALKILN_VERSION=${{ inputs.ALKILN_VERSION }}" >> $GITHUB_ENV
       shell: bash
     - name: "ALKiln: confirm info"
       run: echo -e "\nRepo is $REPO_URL\nBranch ref is $BRANCH_PATH\nManually added languages are $EXTRA_LANGUAGES\nAll other data is secret\n"
@@ -60,7 +61,7 @@ runs:
 
     # This doesn't use an already established package-lock.json and that
     # comes with some types of test breaking risks. Same problem as before.
-    - name: Overwrite or create package.json
+    - name: Temporarily overwrite or create package.json
       run: |
         cat << EOF > "package.json"
         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suffolklitlab/alkiln",
-  "version": "4.0.0-pre-api.9",
+  "version": "4.0.0",
   "description": "Integrated automated end-to-end testing with docassemble, puppeteer, and cucumber.",
   "main": "lib/index.js",
   "scripts": {
@@ -32,7 +32,7 @@
   "bugs": {
     "url": "https://github.com/SuffolkLITLab/ALKiln/issues"
   },
-  "homepage": "https://suffolklitlab.github.io/docassemble-AssemblyLine-documentation/docs/automated_integrated_testing",
+  "homepage": "https://suffolklitlab.org/docassemble-AssemblyLine-documentation/docs/automated_integrated_testing/",
   "dependencies": {
     "@cucumber/cucumber": "^7.3.2",
     "axios": "^0.24.0",

package/tests/features/reports.feature

@@ -376,6 +376,16 @@ Scenario: Fail with 2 wrong signin secrets
   """
   Given I sign in with the email "WRONG_EMAIL_NAME" and the password "WRONG_PASSWORD_NAME"
 
+@fast @rf25 @upload
+Scenario: Fail with could not find files 
+  Given the final Scenario status should be "failed"
+  Given the Scenario report should include:
+  """
+  Could not find "nonexistant1.pdf, nonexistant2.pdf"
+  """
+  Given I start the interview at "all_tests"
+  And I upload "nonexistant1.pdf, nonexistant2.pdf" to "upload_files_visible"
+
 # scope.js
 # I upload "___" to "___"
 # No need to test wrong var name
@@ -384,6 +394,7 @@ Scenario: Fail with 2 wrong signin secrets
 #
 # I sign
 
+
 # ===============================
 # Reports for Scenarios with warnings
 # ===============================