-
Notifications
You must be signed in to change notification settings - Fork 165
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
MockPromptForString + doctor to work with ValidatePathError. #325
Changes from 9 commits
df1c828
556dacd
fac428d
acba2ea
b3fc03c
1b4ffdf
2c18f9d
745c35c
5897c8e
011f86d
6e1020d
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change | ||||||
---|---|---|---|---|---|---|---|---|
@@ -0,0 +1,107 @@ | ||||||||
/* | ||||||||
* Copyright 2020 Google 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. | ||||||||
*/ | ||||||||
|
||||||||
import {Prompt, ValidateFunction} from '../../lib/Prompt'; | ||||||||
|
||||||||
/** | ||||||||
* A class which used for testing and which mocks user's input. | ||||||||
*/ | ||||||||
export class MockPromptForStrings implements Prompt { | ||||||||
private responses: string[] = []; | ||||||||
|
||||||||
/** | ||||||||
* Sets the next answer of this class to be the given message. | ||||||||
* @param message the message to be returned in the next prompt message. | ||||||||
*/ | ||||||||
addMessage(message: string): void { | ||||||||
this.responses.push(message); | ||||||||
} | ||||||||
|
||||||||
async printMessage(): Promise<void> { | ||||||||
// An empty function for testing. | ||||||||
} | ||||||||
|
||||||||
/** | ||||||||
* Sets the output to be the given message. | ||||||||
* @param message the message to be prompt. Not relevant for tests. | ||||||||
* @param {string | null} defaultValue a default value or null. | ||||||||
* @param {ValidateFunction<T>} validateFunction a function to validate the input. | ||||||||
* @returns {Promise<T>} a {@link Promise} that resolves to the validated loaded message, | ||||||||
* converted to `T` by the `validateFunction`. | ||||||||
*/ | ||||||||
async promptInput<T>(_message: string, | ||||||||
_defaultValue: string | null, | ||||||||
validateFunction: ValidateFunction<T>): Promise<T> { | ||||||||
const nextResponse = this.getNextMessage(); | ||||||||
return (await validateFunction(nextResponse)).unwrap(); | ||||||||
} | ||||||||
|
||||||||
/** | ||||||||
* Sets the output to be the given message. | ||||||||
* @param message the message to be prompt. Not relevant for tests. | ||||||||
* @param {string[]} choices a list of choices. Not relevant for testing. | ||||||||
* @param {string | null} defaultValue a default value or null. | ||||||||
* @param {ValidateFunction<T>} validateFunction a function to validate the input. | ||||||||
* @returns {Promise<T>} a {@link Promise} that resolves to the validated loaded message, | ||||||||
* converted to `T` by the `validateFunction`. | ||||||||
*/ | ||||||||
async promptChoice<T>(_message: string, | ||||||||
_choices: string[], | ||||||||
_defaultValue: string | null, | ||||||||
validateFunction: ValidateFunction<T>): Promise<T> { | ||||||||
const nextResponse = this.getNextMessage(); | ||||||||
return (await validateFunction(nextResponse)).unwrap(); | ||||||||
} | ||||||||
|
||||||||
/** | ||||||||
* Sets the output to be the given message. | ||||||||
* @param message the message to be prompt. Not relevant for tests. | ||||||||
* @param defaultValue the value to be returned | ||||||||
* @returns {Promise<boolean>} a {@link Promise} that resolves to a {@link boolean} value. The | ||||||||
* value will the `true` if the user answers `Yes` and `false` for `No`. | ||||||||
*/ | ||||||||
async promptConfirm(_message: string, defaultValue: boolean): Promise<boolean> { | ||||||||
return defaultValue; | ||||||||
} | ||||||||
|
||||||||
/** | ||||||||
* Sets the output to be the given message. | ||||||||
* @param message the message to be prompt. Not relevant for tests. | ||||||||
* @param {ValidateFunction<T>} validateFunction a function to validate the input. | ||||||||
* @returns {Promise<string>} a {@link Promise} that resolves to the user input validated by | ||||||||
* `validateFunction`. | ||||||||
*/ | ||||||||
async promptPassword(_message: string, validateFunction: ValidateFunction<string>, | ||||||||
): Promise<string> { | ||||||||
const nextResponse = this.getNextMessage(); | ||||||||
return (await validateFunction(nextResponse)).unwrap(); | ||||||||
} | ||||||||
|
||||||||
/** | ||||||||
* Sets the output to be the given message. | ||||||||
* @param {ValidateFunction<T>} validateFunction a function to validate the input. | ||||||||
* @returns {string} which is the next message to be prompted`. | ||||||||
*/ | ||||||||
private getNextMessage(): string { | ||||||||
if (this.responses.length === 0) { | ||||||||
throw new Error('No answer was given. Please use addMessage(nextMessage) before' + | ||||||||
' using this function'); | ||||||||
} | ||||||||
const nextResponse = this.responses[0]; | ||||||||
this.responses.shift(); | ||||||||
chenlevy24 marked this conversation as resolved.
Show resolved
Hide resolved
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Any reason why we're not just calling
Suggested change
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Yup, if I do as you say, I get an error because the value could be |
||||||||
return nextResponse; | ||||||||
} | ||||||||
} |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,36 @@ | ||
/* | ||
chenlevy24 marked this conversation as resolved.
Show resolved
Hide resolved
|
||
* Copyright 2020 Google 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. | ||
*/ | ||
|
||
import {Result} from '@bubblewrap/core'; | ||
import {MockPromptForStrings} from './mock/MockPromptForStrings'; | ||
|
||
async function validationFunction(message: string): Promise<Result<string, Error>> { | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Should we test with a validationFunction that returns something other than a string? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I don't see how it could change the bottom line.. every case depends on the implementation but with those tests I made sure that the logic of the class is good and functioning (At least I think so) |
||
return Result.ok(message); | ||
} | ||
|
||
describe('MockPromptForStrings', () => { | ||
describe('#promptInput', () => { | ||
it('Checks if the correct messages are being prompted using promptInput function', async () => { | ||
const mock = new MockPromptForStrings(); | ||
mock.addMessage('first'); | ||
mock.addMessage('second'); | ||
expect(await mock.promptInput('', null, validationFunction)).toBe('first'); | ||
expect(await mock.promptInput('', null, validationFunction)).toBe('second'); | ||
mock.addMessage('third'); | ||
expect(await mock.promptInput('', null, validationFunction)).toBe('third'); | ||
}); | ||
}); | ||
}); |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I just realised this isn't actually "for strings" anymore - it can just be called MockPrompt now.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
But the messages are always strings
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I had thought that the "ForStrings" was about the return type of the methods - for example that promptInput would always return a string (as opposed to a Color or something). The version we've got now works if it's used in a place that returns a Color.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The "forStrings" was for the input we accept, and as for now it's only strings
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I had the same impression about
T
always being astring
, which affects thevalidateFunction
input and thePromise<T>
output. ButT
can now have any values and we could dropForStrings
. The fact thataddMessages()
is always a string seems to be more of an implementation detail?