os: make EOL configurable and readonly #14622

XadillaX · 2017-08-04T06:28:12Z

Checklist

make -j4 test (UNIX)
tests and/or benchmarks are included
commit message follows commit guidelines

Affected core subsystem(s)

os

richardlau · 2017-08-04T10:09:45Z

test/parallel/test-os-eol.js

+
+const eol = common.isWindows ? '\r\n' : '\n';
+
+assert.strictEqual(eol, os.EOL);


Assertion parameters should be actual, expected so I think these should be the other way around.

tniessen

LGTM with @richardlau's comment addressed.

tniessen · 2017-08-04T11:33:03Z

test/parallel/test-os-eol.js

+
+assert.strictEqual(eol, os.EOL);
+
+common.expectsError(function() {


I know that we didn't reach consensus on this, but I personally prefer arrow functions in our tests to make them a little more readable.

IMHO I'd like to use anonymous function.

Refs: #14496 (comment)

Even though there was no result about that discussion.

refack · 2017-08-04T14:59:10Z

Optional

@XadillaX we could take this one step further. Move EOL to node_contants.c defined with NODE_DEFINE_CONSTANT. Then the os.EOL property would be just a getter {get: () => constants.EOL} (maybe even deprecate it, now or later).

jasnell · 2017-08-04T15:02:46Z

@ChALkeR ... any way we can get an estimate on any breakage this may cause? (if any)

TimothyGu · 2017-08-04T15:51:21Z

@refack Those constants are all numbers, used as flags to be passed between C++ and JS. I don't see a reason to introduce an inconsistency here.

TimothyGu · 2017-08-04T15:53:04Z

lib/os.js

+  },
+
+  EOL: {
+    configurable: false,


On a second thought, maybe making it configurable would be better? This way people who really need to change it for testing can do so, but requiring them to explicitly state their intentions. I'm okay either way though.

addaleax

I think @TimothyGu’s comment is a blocker.

(Also, I’m kind of missing the motivation here… people don’t accidentally override os.EOL, do they?)

richardlau · 2017-08-04T16:54:14Z

(Also, I’m kind of missing the motivation here… people don’t accidentally override os.EOL, do they?)

From #14619:

os.EOL is specified as a constant but its value is getting updated

So an alternative is to update the docs.

tniessen · 2017-08-04T17:06:13Z

people don’t accidentally override os.EOL, do they?

@addaleax In my opinion, this should throw when in strict mode:

if(os.EOL = 'foo') {
  console.log('Nope');
}

I am ±0 about making it configurable, but it should be a constant by default.

TimothyGu

Still LGTM, just even more so!

XadillaX · 2017-08-07T03:11:12Z

@addaleax How's the code now?

outdated

addaleax · 2017-08-07T13:07:52Z

I’ve removed my Changes Requested label, but as I mentioned I don’t quite see the point here.

Maybe it’s a miscommunication about what “constant” means in this context; if documentation for JS code says that foo.bar is a constant, I personally would expect that to mean that the value is not changed by whatever code provides that value, i.e. in this specific case that Node doesn’t change that value while a process is running.

refack · 2017-08-07T22:16:32Z

@jasnell did a grep on Gzemnid dump from 2017-02-23, no assignment to EOL found.
@XadillaX added a test case for configurability in 3e31ac4, feel free to push out or edit.

refack · 2017-08-07T22:17:37Z

CI: https://ci.nodejs.org/job/node-test-pull-request/9526/

jasnell · 2017-08-08T22:57:47Z

Marking this one ctc-review. @nodejs/ctc ... please weigh in

XadillaX · 2017-08-11T02:32:50Z

@jasnell, @joyeecheung just reviewed

jasnell

LGTM with good CI and CITGM run.

Fishrock123

¯\_(ツ)_/¯

not-an-aardvark · 2017-08-14T18:08:25Z

-0. In general I'm not sure it's a good idea to make properties like this non-configurable, because it removes an escape hatch. I can imagine a hypothetical test helper to verify an that application works on multiple platforms, which could rely on mutating os.EOL. We don't have any evidence that the current behavior has caused problems in practice, so changing it seems like it's a solution without a problem.

If we're convinced that we want to make the property non-writable to avoid accidental mutation, could we keep the property configurable? That way it would still be possible to overwrite the property as an escape hatch, but users would be unlikely to mutate it by mistake.

edit: I just saw that it is configurable the current version of the PR. The title of the PR still says it's non-configurable.

refack

LGTM with { configurable: true }

refack · 2017-08-14T18:13:47Z

CitGM: https://ci.nodejs.org/view/Node.js-citgm/job/citgm-smoker/951/

I count 4 ✔️s from CTC members, so IMHO this is ready to land (pending CitGM)

mcollina · 2017-08-16T09:44:10Z

before landing, can this get a rebase? We are getting some failures for body-parser that are already fixed on master.

mcollina

LGTM if CITGM is ok

XadillaX · 2017-08-17T03:54:02Z

@mcollina rebased.

mcollina · 2017-08-17T07:34:14Z

CITGM: https://ci.nodejs.org/view/Node.js-citgm/job/citgm-smoker/957/

not-an-aardvark · 2017-08-17T07:43:26Z

Reminder to whoever lands this: the commit message should be updated to correct "non-configurable" to "configurable".

Refs: nodejs#14619

XadillaX · 2017-08-17T09:50:11Z

@not-an-aardvark Thanks and I've rebased the message.

mcollina · 2017-08-17T10:36:38Z

I think CITGM is green, this can be landed.

aqrln · 2017-08-17T12:54:42Z

@XadillaX regarding the commit message, I think the patch "Fixes:", not just "Refs:" the issue, doesn't it?

XadillaX · 2017-08-21T02:51:18Z

@aqrln Right, I think who to land this may help me to modify the commit message.

refack · 2017-08-21T03:12:36Z

Pre-land CI: https://ci.nodejs.org/job/node-test-commit/11929/

refack · 2017-08-21T04:24:19Z

Landed in f6caeb9

PR-URL: #14622 Fixes: #14619 Reviewed-By: Vse Mozhet Byt <[email protected]> Reviewed-By: Timothy Gu <[email protected]> Reviewed-By: Tobias Nießen <[email protected]> Reviewed-By: Colin Ihrig <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Alexey Orlenko <[email protected]> Reviewed-By: Joyee Cheung <[email protected]> Reviewed-By: James M Snell <[email protected]> Reviewed-By: Rod Vagg <[email protected]> Reviewed-By: Refael Ackermann <[email protected]> Reviewed-By: Matteo Collina <[email protected]>

* **async_hooks** * Older experimental `async_hooks` APIs have been removed [[`d731369b1d`](d731369b1d)] **(SEMVER-MAJOR)** [#14414](#14414) * **Errors** * Multiple built in modules have been migrated to use static error codes * **Domains** * The long deprecated `.dispose()` method has been removed [[`602fd36d95`](602fd36d95)] **(SEMVER-MAJOR)** [#15412](#15412) * **File system** * `fs.ReadStream` and `fs.WriteStream` now make use of `.destroy()` [[`e5c290bed9`](e5c290bed9)] **(SEMVER-MAJOR)** [#15407](#15407) * `fs` callbacks are now invoked with an undefined `this` context [[`2249234fee`](2249234fee)] **(SEMVER-MAJOR)** [#14645](#14645) * **HTTP** * Socket timeout is set when the socket connects [[`10be20a0e8`](10be20a0e8)] **(SEMVER-MAJOR)** [#8895](#8895) * A bug causing the request `error` event to fire twice has been fixed [[`620ba41694`](620ba41694)] **(SEMVER-MAJOR)** [#14659](#14659) * The `pipe` method on `OutgoingMessage` has been disabled [[`156549d8ff`](156549d8ff)] **(SEMVER-MAJOR)** [#14358](#14358) * **HTTP/2** * The `--expose-http2` command-line argument is no longer required [[`f55ee6e24a`](f55ee6e24a)] **(SEMVER-MAJOR)** [#15535](#15535) * **Internationalization** * The `Intl.v8BreakIterator` class has been removed [[`668ad44922`](668ad44922)] **(SEMVER-MAJOR)** [#15238](#15238) * **OS** * `os.EOL` is now read-only [[`f6caeb9526`](f6caeb9526)] **(SEMVER-MAJOR)** [#14622](#14622) * **Process** * It is now possible to pass additional flags to `dlopen` [[`5f22375922`](5f22375922)] **(SEMVER-MAJOR)** [#12794](#12794) * **Timers** * Using a timeout duration larger than 32-bits will now emit a warning [[`ce3586da31`](ce3586da31)] **(SEMVER-MAJOR)** [#15627](#15627) * **TLS** * `parseCertString` has been deprecated [[`468110b327`](468110b327)] **(SEMVER-MAJOR)** [#14249](#14249) * Type-checking for `key`, `cert`, and `ca` options has been added [[`a7dccd040d`](a7dccd040d)] **(SEMVER-MAJOR)** [#14807](#14807)

nodejs-github-bot added the os Issues and PRs related to the os subsystem. label Aug 4, 2017

XadillaX added the semver-major PRs that contain breaking changes and should be released in the next major version. label Aug 4, 2017

vsemozhetbyt approved these changes Aug 4, 2017

View reviewed changes

TimothyGu approved these changes Aug 4, 2017

View reviewed changes

richardlau reviewed Aug 4, 2017

View reviewed changes

tniessen approved these changes Aug 4, 2017

View reviewed changes

cjihrig approved these changes Aug 4, 2017

View reviewed changes

lpinca approved these changes Aug 4, 2017

View reviewed changes

TimothyGu approved these changes Aug 4, 2017

View reviewed changes

addaleax previously requested changes Aug 4, 2017

View reviewed changes

TimothyGu approved these changes Aug 6, 2017

View reviewed changes

aqrln approved these changes Aug 6, 2017

View reviewed changes

jasnell added the ctc-review label Aug 8, 2017

joyeecheung approved these changes Aug 10, 2017

View reviewed changes

jasnell approved these changes Aug 11, 2017

View reviewed changes

Trott mentioned this pull request Aug 13, 2017

Node.js Foundation Core Technical Committee (CTC) Meeting 2017-08-16 nodejs/CTC#162

Closed

rvagg approved these changes Aug 14, 2017

View reviewed changes

Fishrock123 reviewed Aug 14, 2017

View reviewed changes

refack approved these changes Aug 14, 2017

View reviewed changes

aqrln changed the title ~~os: make EOL non-configurable and readonly~~ os: make EOL configurable and readonly Aug 15, 2017

mcollina approved these changes Aug 16, 2017

View reviewed changes

XadillaX force-pushed the feature/os-eol branch from 3e31ac4 to 042c259 Compare August 17, 2017 03:53

XadillaX changed the title ~~os: make EOL configurable and readonly~~ os: make EOL non-configurable and readonly Aug 17, 2017

XadillaX changed the title ~~os: make EOL non-configurable and readonly~~ os: make EOL configurable and readonly Aug 17, 2017

os: make EOL configurable and readonly

6f5087d

Refs: nodejs#14619

XadillaX force-pushed the feature/os-eol branch from 042c259 to 6f5087d Compare August 17, 2017 09:49

refack closed this Aug 21, 2017

Trott removed the ctc-review label Aug 21, 2017

jasnell mentioned this pull request Oct 30, 2017

Proposal: 2017-10-31, Version 9.0.0 (Current) #15135

Merged


		const eol = common.isWindows ? '\r\n' : '\n';

		assert.strictEqual(eol, os.EOL);


		assert.strictEqual(eol, os.EOL);

		common.expectsError(function() {

os: make EOL configurable and readonly #14622

os: make EOL configurable and readonly #14622

Conversation

XadillaX commented Aug 4, 2017 • edited Loading

Checklist

Affected core subsystem(s)

richardlau Aug 4, 2017

Choose a reason for hiding this comment

tniessen left a comment

Choose a reason for hiding this comment

tniessen Aug 4, 2017

Choose a reason for hiding this comment

XadillaX Aug 4, 2017

Choose a reason for hiding this comment

refack commented Aug 4, 2017 • edited Loading

Optional

jasnell commented Aug 4, 2017

TimothyGu commented Aug 4, 2017

TimothyGu Aug 4, 2017

Choose a reason for hiding this comment

XadillaX Aug 6, 2017

Choose a reason for hiding this comment

addaleax left a comment

Choose a reason for hiding this comment

richardlau commented Aug 4, 2017

tniessen commented Aug 4, 2017

TimothyGu left a comment

Choose a reason for hiding this comment

XadillaX commented Aug 7, 2017

addaleax commented Aug 7, 2017

refack commented Aug 7, 2017

refack commented Aug 7, 2017

jasnell commented Aug 8, 2017

XadillaX commented Aug 11, 2017

jasnell left a comment

Choose a reason for hiding this comment

Fishrock123 left a comment

Choose a reason for hiding this comment

not-an-aardvark commented Aug 14, 2017 • edited Loading

refack left a comment

Choose a reason for hiding this comment

refack commented Aug 14, 2017

mcollina commented Aug 16, 2017

mcollina left a comment

Choose a reason for hiding this comment

XadillaX commented Aug 17, 2017

mcollina commented Aug 17, 2017

not-an-aardvark commented Aug 17, 2017

XadillaX commented Aug 17, 2017

mcollina commented Aug 17, 2017

aqrln commented Aug 17, 2017

XadillaX commented Aug 21, 2017

refack commented Aug 21, 2017

refack commented Aug 21, 2017

XadillaX commented Aug 4, 2017 •

edited

Loading

refack commented Aug 4, 2017 •

edited

Loading

not-an-aardvark commented Aug 14, 2017 •

edited

Loading