# Design Cancellable Function

## 10 Prerequisite LeetCode Problems

The problem “2650. Design Cancellable Function” deals with understanding JavaScript generators, asynchronous operations, promises, and error handling. Here are 10 problems that can help you prepare for this:

21. Merge Two Sorted Lists: While this problem is about linked lists, understanding the merge operation here can help with handling the order of operations, a key aspect of understanding async operations.

155. Min Stack: Designing a stack can help you get used to designing data structures with specific behaviors, like the cancellable function in this problem.

70. Climbing Stairs: This is a basic dynamic programming problem. Understanding it can help with understanding control flow, which is key in this problem.

283. Move Zeroes: This problem can help with understanding how to handle order-dependent operations.

206. Reverse Linked List: This problem provides practice with manipulating linked data structures, a useful skill when dealing with complex control flows.

104. Maximum Depth of Binary Tree: Understanding tree traversal can help with dealing with the execution order of async operations.

278. First Bad Version: This problem involves error checking and control flow, both of which are important in this problem.

20. Valid Parentheses: This problem deals with using a stack and checking for error conditions, which is useful for this problem.

169. Majority Element: This problem involves traversing an array and keeping track of information, which can be useful in understanding how to keep track of async operations.

1. Two Sum: This problem helps with understanding how to iterate through data structures and return results, which is key in this problem.

Although these problems don’t directly deal with JavaScript generators or promises, they do help build a strong understanding of control flow, error handling, and data structure manipulation, all of which are essential in this problem. For a deeper understanding of generators and promises specifically, you may want to look at JavaScript tutorials or documentation, as they are somewhat unique to the language.

## Problem Analysis and Key Insights

What are the key insights from analyzing the problem statement?

## Problem Boundary

What is the scope of this problem?

How to establish the boundary of this problem?

## Problem Classification

Problem Statement: Sometimes you have a long running task, and you may wish to cancel it before it completes. To help with this goal, write a function cancellable that accepts a generator object and returns an array of two values: a cancel function and a promise.

You may assume the generator function will only yield promises. It is your function’s responsibility to pass the values resolved by the promise back to the generator. If the promise rejects, your function should throw that error back to the generator.

If the cancel callback is called before the generator is done, your function should throw an error back to the generator. That error should be the string “Cancelled” (Not an Error object). If the error was caught, the returned promise should resolve with the next value that was yielded or returned. Otherwise, the promise should reject with the thrown error. No more code should be executed.

When the generator is done, the promise your function returned should resolve the value the generator returned. If, however, the generator throws an error, the returned promise should reject with the error.

An example of how your code would be used:

function* tasks() { const val = yield new Promise(resolve => resolve(2 + 2)); yield new Promise(resolve => setTimeout(resolve, 100)); return val + 1; // calculation shouldn’t be done. } const [cancel, promise] = cancellable(tasks()); setTimeout(cancel, 50); promise.catch(console.log); // logs “Cancelled” at t=50ms If instead cancel() was not called or was called after t=100ms, the promise would have resolved 5.

Example 1:

Input: generatorFunction = function*() { return 42; } cancelledAt = 100 Output: {“resolved”: 42} Explanation: const generator = generatorFunction(); const [cancel, promise] = cancellable(generator); setTimeout(cancel, 100); promise.then(console.log); // resolves 42 at t=0ms

The generator immediately yields 42 and finishes. Because of that, the returned promise immediately resolves 42. Note that cancelling a finished generator does nothing. Example 2:

Input:
generatorFunction = function*() {
const msg = yield new Promise(res => res(“Hello”));
throw `Error: ${msg}`

;
}
cancelledAt = null
Output: {“rejected”: “Error: Hello”}
Explanation:
A promise is yielded. The function handles this by waiting for it to resolve and then passes the resolved value back to the generator. Then an error is thrown which has the effect of causing the promise to reject with the same thrown error.
Example 3:

Input: generatorFunction = function*() { yield new Promise(res => setTimeout(res, 200)); return “Success”; } cancelledAt = 100 Output: {“rejected”: “Cancelled”} Explanation: While the function is waiting for the yielded promise to resolve, cancel() is called. This causes an error message to be sent back to the generator. Since this error is uncaught, the returned promise rejected with this error. Example 4:

Input: generatorFunction = function*() { let result = 0; yield new Promise(res => setTimeout(res, 100)); result += yield new Promise(res => res(1)); yield new Promise(res => setTimeout(res, 100)); result += yield new Promise(res => res(1)); return result; } cancelledAt = null Output: {“resolved”: 2} Explanation: 4 promises are yielded. Two of those promises have their values added to the result. After 200ms, the generator finishes with a value of 2, and that value is resolved by the returned promise. Example 5:

Input: generatorFunction = function*() { let result = 0; try { yield new Promise(res => setTimeout(res, 100)); result += yield new Promise(res => res(1)); yield new Promise(res => setTimeout(res, 100)); result += yield new Promise(res => res(1)); } catch(e) { return result; } return result; } cancelledAt = 150 Output: {“resolved”: 1} Explanation: The first two yielded promises resolve and cause the result to increment. However, at t=150ms, the generator is cancelled. The error sent to the generator is caught and the result is returned and finally resolved by the returned promise. Example 6:

Input: generatorFunction = function*() { try { yield new Promise((resolve, reject) => reject(“Promise Rejected”)); } catch(e) { let a = yield new Promise(resolve => resolve(2)); let b = yield new Promise(resolve => resolve(2)); return a + b; }; } cancelledAt = null Output: {“resolved”: 4} Explanation: The first yielded promise immediately rejects. This error is caught. Because the generator hasn’t been cancelled, execution continues as usual. It ends up resolving 2 + 2 = 4.

Constraints:

cancelledAt == null or 0 <= cancelledAt <= 1000 generatorFunction returns a generator object

Analyze the provided problem statement. Categorize it based on its domain, ignoring ‘How’ it might be solved. Identify and list out the ‘What’ components. Based on these, further classify the problem. Explain your categorizations.

## Distilling the Problem to Its Core Elements

Can you identify the fundamental concept or principle this problem is based upon? Please explain. What is the simplest way you would describe this problem to someone unfamiliar with the subject? What is the core problem we are trying to solve? Can we simplify the problem statement? Can you break down the problem into its key components? What is the minimal set of operations we need to perform to solve this problem?

## Visual Model of the Problem

How to visualize the problem statement for this problem?

## Problem Restatement

Could you start by paraphrasing the problem statement in your own words? Try to distill the problem into its essential elements and make sure to clarify the requirements and constraints. This exercise should aid in understanding the problem better and aligning our thought process before jumping into solving it.

## Abstract Representation of the Problem

Could you help me formulate an abstract representation of this problem?

Given this problem, how can we describe it in an abstract way that emphasizes the structure and key elements, without the specific real-world details?

## Terminology

Are there any specialized terms, jargon, or technical concepts that are crucial to understanding this problem or solution? Could you define them and explain their role within the context of this problem?

## Problem Simplification and Explanation

Could you please break down this problem into simpler terms? What are the key concepts involved and how do they interact? Can you also provide a metaphor or analogy to help me understand the problem better?

## Constraints

Given the problem statement and the constraints provided, identify specific characteristics or conditions that can be exploited to our advantage in finding an efficient solution. Look for patterns or specific numerical ranges that could be useful in manipulating or interpreting the data.

What are the key insights from analyzing the constraints?

## Case Analysis

Could you please provide additional examples or test cases that cover a wider range of the input space, including edge and boundary conditions? In doing so, could you also analyze each example to highlight different aspects of the problem, key constraints and potential pitfalls, as well as the reasoning behind the expected output for each case? This should help in generating key insights about the problem and ensuring the solution is robust and handles all possible scenarios.

Provide names by categorizing these cases

What are the edge cases?

What are the key insights from analyzing the different cases?

## Identification of Applicable Theoretical Concepts

Can you identify any mathematical or algorithmic concepts or properties that can be applied to simplify the problem or make it more manageable? Think about the nature of the operations or manipulations required by the problem statement. Are there existing theories, metrics, or methodologies in mathematics, computer science, or related fields that can be applied to calculate, measure, or perform these operations more effectively or efficiently?

## Simple Explanation

Can you explain this problem in simple terms or like you would explain to a non-technical person? Imagine you’re explaining this problem to someone without a background in programming. How would you describe it? If you had to explain this problem to a child or someone who doesn’t know anything about coding, how would you do it? In layman’s terms, how would you explain the concept of this problem? Could you provide a metaphor or everyday example to explain the idea of this problem?

## Problem Breakdown and Solution Methodology

Given the problem statement, can you explain in detail how you would approach solving it? Please break down the process into smaller steps, illustrating how each step contributes to the overall solution. If applicable, consider using metaphors, analogies, or visual representations to make your explanation more intuitive. After explaining the process, can you also discuss how specific operations or changes in the problem’s parameters would affect the solution? Lastly, demonstrate the workings of your approach using one or more example cases.

## Inference of Problem-Solving Approach from the Problem Statement

Can you identify the key terms or concepts in this problem and explain how they inform your approach to solving it? Please list each keyword and how it guides you towards using a specific strategy or method.

How did you infer from the problem statement that this problem can be solved using ?

## Simple Explanation of the Proof

I’m having trouble understanding the proof of this algorithm. Could you explain it in a way that’s easy to understand?

## Stepwise Refinement

Could you please provide a stepwise refinement of our approach to solving this problem?

How can we take the high-level solution approach and distill it into more granular, actionable steps?

Could you identify any parts of the problem that can be solved independently?

Are there any repeatable patterns within our solution?

## Solution Approach and Analysis

Given the problem statement, can you explain in detail how you would approach solving it? Please break down the process into smaller steps, illustrating how each step contributes to the overall solution. If applicable, consider using metaphors, analogies, or visual representations to make your explanation more intuitive. After explaining the process, can you also discuss how specific operations or changes in the problem’s parameters would affect the solution? Lastly, demonstrate the workings of your approach using one or more example cases.

## Identify Invariant

What is the invariant in this problem?

## Identify Loop Invariant

What is the loop invariant in this problem?

## Thought Process

Can you explain the basic thought process and steps involved in solving this type of problem?

Explain the thought process by thinking step by step to solve this problem from the problem statement and code the final solution. Write code in Python3. What are the cues in the problem statement? What direction does it suggest in the approach to the problem? Generate insights about the problem statement.

## Establishing Preconditions and Postconditions

**Parameters:**- What are the inputs to the method?
- What types are these parameters?
- What do these parameters represent in the context of the problem?

**Preconditions:**- Before this method is called, what must be true about the state of the program or the values of the parameters?
- Are there any constraints on the input parameters?
- Is there a specific state that the program or some part of it must be in?

**Method Functionality:**- What is this method expected to do?
- How does it interact with the inputs and the current state of the program?

**Postconditions:**- After the method has been called and has returned, what is now true about the state of the program or the values of the parameters?
- What does the return value represent or indicate?
- What side effects, if any, does the method have?

**Error Handling:**- How does the method respond if the preconditions are not met?
- Does it throw an exception, return a special value, or do something else?

## Problem Decomposition

**Problem Understanding:**- Can you explain the problem in your own words? What are the key components and requirements?

**Initial Breakdown:**- Start by identifying the major parts or stages of the problem. How can you break the problem into several broad subproblems?

**Subproblem Refinement:**- For each subproblem identified, ask yourself if it can be further broken down. What are the smaller tasks that need to be done to solve each subproblem?

**Task Identification:**- Within these smaller tasks, are there any that are repeated or very similar? Could these be generalized into a single, reusable task?

**Task Abstraction:**- For each task you’ve identified, is it abstracted enough to be clear and reusable, but still makes sense in the context of the problem?

**Method Naming:**- Can you give each task a simple, descriptive name that makes its purpose clear?

**Subproblem Interactions:**- How do these subproblems or tasks interact with each other? In what order do they need to be performed? Are there any dependencies?

## From Brute Force to Optimal Solution

Could you please begin by illustrating a brute force solution for this problem? After detailing and discussing the inefficiencies of the brute force approach, could you then guide us through the process of optimizing this solution? Please explain each step towards optimization, discussing the reasoning behind each decision made, and how it improves upon the previous solution. Also, could you show how these optimizations impact the time and space complexity of our solution?

## Code Explanation and Design Decisions

Identify the initial parameters and explain their significance in the context of the problem statement or the solution domain.

Discuss the primary loop or iteration over the input data. What does each iteration represent in terms of the problem you’re trying to solve? How does the iteration advance or contribute to the solution?

If there are conditions or branches within the loop, what do these conditions signify? Explain the logical reasoning behind the branching in the context of the problem’s constraints or requirements.

If there are updates or modifications to parameters within the loop, clarify why these changes are necessary. How do these modifications reflect changes in the state of the solution or the constraints of the problem?

Describe any invariant that’s maintained throughout the code, and explain how it helps meet the problem’s constraints or objectives.

Discuss the significance of the final output in relation to the problem statement or solution domain. What does it represent and how does it satisfy the problem’s requirements?

Remember, the focus here is not to explain what the code does on a syntactic level, but to communicate the intent and rationale behind the code in the context of the problem being solved.

## Coding Constructs

Consider the following piece of complex software code.

What are the high-level problem-solving strategies or techniques being used by this code?

If you had to explain the purpose of this code to a non-programmer, what would you say?

Can you identify the logical elements or constructs used in this code, independent of any programming language?

Could you describe the algorithmic approach used by this code in plain English?

What are the key steps or operations this code is performing on the input data, and why?

Can you identify the algorithmic patterns or strategies used by this code, irrespective of the specific programming language syntax?

## Language Agnostic Coding Drills

Your mission is to deconstruct this code into the smallest possible learning units, each corresponding to a separate coding concept. Consider these concepts as unique coding drills that can be individually implemented and later assembled into the final solution.

Dissect the code and identify each distinct concept it contains. Remember, this process should be language-agnostic and generally applicable to most modern programming languages.

Once you’ve identified these coding concepts or drills, list them out in order of increasing difficulty. Provide a brief description of each concept and why it is classified at its particular difficulty level.

Next, describe the problem-solving approach that would lead from the problem statement to the final solution. Think about how each of these coding drills contributes to the overall solution. Elucidate the step-by-step process involved in using these drills to solve the problem. Please refrain from writing any actual code; we’re focusing on understanding the process and strategy.

## Targeted Drills in Python

Now that you’ve identified and ordered the coding concepts from a complex software code in the previous exercise, let’s focus on creating Python-based coding drills for each of those concepts.

Begin by writing a separate piece of Python code that encapsulates each identified concept. These individual drills should illustrate how to implement each concept in Python. Please ensure that these are suitable even for those with a basic understanding of Python.

In addition to the general concepts, identify and write coding drills for any problem-specific concepts that might be needed to create a solution. Describe why these drills are essential for our problem.

Once all drills have been coded, describe how these pieces can be integrated together in the right order to solve the initial problem. Each drill should contribute to building up to the final solution.

Remember, the goal is to not only to write these drills but also to ensure that they can be cohesively assembled into one comprehensive solution.

## Q&A

## Similar Problems

Can you suggest 10 problems from LeetCode that require similar problem-solving strategies or use similar underlying concepts as the problem we’ve just solved? These problems can be from any domain or topic, but they should involve similar steps or techniques in the solution process. Also, please briefly explain why you consider each of these problems to be related to our original problem.