The feature is to introduce a Core.stdin object that allows trimmed programs to accept data from standard input (stdin), similar to how Core.stdout and Core.stderr are used for output.
Why we need the feature
Currently, trimmed programs lack the ability to read from stdin, which limits their functionality and usability in scenarios where input data is provided via standard input. This feature will enable trimmed programs to handle input data more flexibly and align with the existing capabilities for output.
How to implement and why
Define Core.stdin:
Introduce a new Core.stdin object within the core library, similar to Core.stdout and Core.stderr.
This object should be capable of reading data from the standard input stream.
Modify the Core Library:
Update the core library files, likely within the src directory, to include the definition and initialization of Core.stdin.
Ensure that Core.stdin is properly integrated with the existing IO handling mechanisms.
Update Documentation:
Modify relevant documentation files to include information about the new Core.stdin object and provide examples of its usage.
Testing:
Add tests in the test directory to verify that Core.stdin works as expected, including edge cases and error handling.
Backward Compatibility:
Ensure that the introduction of Core.stdin does not affect existing functionality. Since this is an addition rather than a modification, backward compatibility should be maintained.
About backward compatibility
The addition of Core.stdin should not affect backward compatibility as it introduces new functionality without altering existing features. Existing programs that do not use Core.stdin will continue to function as before.
Original issue: #6
What is the feature
The feature is to introduce a
Core.stdinobject that allows trimmed programs to accept data from standard input (stdin), similar to howCore.stdoutandCore.stderrare used for output.Why we need the feature
Currently, trimmed programs lack the ability to read from stdin, which limits their functionality and usability in scenarios where input data is provided via standard input. This feature will enable trimmed programs to handle input data more flexibly and align with the existing capabilities for output.
How to implement and why
Define
Core.stdin:Core.stdinobject within the core library, similar toCore.stdoutandCore.stderr.Modify the Core Library:
srcdirectory, to include the definition and initialization ofCore.stdin.Core.stdinis properly integrated with the existing IO handling mechanisms.Update Documentation:
Core.stdinobject and provide examples of its usage.Testing:
testdirectory to verify thatCore.stdinworks as expected, including edge cases and error handling.Backward Compatibility:
Core.stdindoes not affect existing functionality. Since this is an addition rather than a modification, backward compatibility should be maintained.About backward compatibility
The addition of
Core.stdinshould not affect backward compatibility as it introduces new functionality without altering existing features. Existing programs that do not useCore.stdinwill continue to function as before.Test these changes locally