TODO/XXX/FIXME comments in tests #4640

Trott · 2016-01-12T05:33:04Z

There are 11 TODO, XXX, and FIXME comments in the test directory. It would be great to either remove them from the code (if they are no longer valid or at least not particularly high value), or get issues opened for them, or just get whatever it is they are addressing addressed. Here they are as of this writing. (Actually, I'm kind of cheating and leaving out two that @santigimeno has PRs in to fix already.)

1: test/internet/test-dgram-multicast-multi-process.js:

var sendSocket = dgram.createSocket('udp4');
// FIXME: a libuv limitation makes it necessary to bind()
// before calling any of the set*() functions. The bind()
// call is what creates the actual socket.

EDIT: This one is being discussed in #5023

2: test/parallel/test-child-process-fork-net2.js:

    disconnected += 1;
  });
  // XXX This resume() should be unnecessary.
  // a stream high water mark should be enough to keep
  // consuming the input.

3: test/parallel/test-cluster-disconnect-handles.js:

let isKilling = false;
const handles = require('internal/cluster').handles;
// FIXME(bnoordhuis) lib/cluster.js scans the execArgv arguments for
// debugger flags and renumbers any port numbers it sees starting
// from the default port 5858. Add a '.' that circumvents the
4: test/parallel/test-cluster-http-pipe.js:

http.createServer(function(req, res) {
assert.equal(req.connection.remoteAddress, undefined);
assert.equal(req.connection.localAddress, undefined); // TODO common.PIPE?
res.writeHead(200);
res.end('OK');
5: test/parallel/test-dgram-oob-buffer.js:

});

socket.close(); // FIXME should not be necessary
6: test/parallel/test-domain-multi.js:

});

// XXX this bind should not be necessary.
// the write cb behavior in http/net should use an
// event so that it picks up the domain handling.
7: test/parallel/test-punycode.js:

// (I) Russian (Cyrillic)
/* XXX disabled, fails - possibly a bug in the RFC
'b1abfaaepdrnnbgefbaDotcwatmq2g4l':
'\u043F\u043E\u0447\u0435\u043C\u0443\u0436\u0435\u043E\u043D\u0438' +
8: test/parallel/test-repl-persistent-history.js:
```
         '4', '2', '\'', '\'42\'\n', prompt, prompt],
```
after: function ensureHistoryFixture() {
// XXX(Fishrock123) Make sure nothing weird happened to our fixture
// or it's temporary copy.
// Sometimes this test used to erase the fixture and I'm not sure why.
9: test/pummel/test-tls-securepair-client.js:

function test(keyfn, certfn, check, next) {
// FIXME: Avoid the common PORT as this test currently hits a C-level
// assertion error with node_g. The program aborts without HUPing
// the openssl s_server thus causing many tests to fail with
10: test/parallel/test-setproctitle.js:

// Original test written by Jakub Lekstan [email protected]

// FIXME add sunos support
if ('linux freebsd darwin'.indexOf(process.platform) === -1) {
console.log(1..0 # Skipped: Unsupported platform [${process.platform}]);
11: test/sequential/test-zerolengthbufferbug.js:

var server = http.createServer(function(req, res) {
var buffer = new Buffer(0);
// FIXME: WTF gjslint want this?
res.writeHead(200, {'Content-Type': 'text/html',
'Content-Length': buffer.length});

/cc @bnoordhuis @Fishrock123

The text was updated successfully, but these errors were encountered:

Fishrock123 · 2016-01-12T15:36:15Z

8: test/parallel/test-repl-persistent-history.js:
// XXX(Fishrock123) Make sure nothing weird happened to our fixture

In older versions of the test (pre-git) I pointed directly to the fixture, but it ended up erasing it after the run. I am really not sure why. (Something we now do to the temporary file but did not do at the time the comment was written.)

aayn · 2016-01-15T19:34:34Z

I'd like to do this please(as it's tagged 'good first contribution'). So, do I just remove the comments?

Fishrock123 · 2016-01-15T19:58:02Z

@aayn Not quite -- you'd need to do some research in order to check if the comment is still relevant, then decide what to do. Myself or @Trott can probably guide you if you need any help along the way. :)

aayn · 2016-01-16T04:56:14Z

Okay. I'll get to it right away. :)
But yeah, I'll probably need some guidance.

aayn · 2016-01-16T07:03:51Z

For 7: test/parallel/test-punycode.js, the Russian(Cyrillic) test still fails, so an issue should be opened for it probably.

aayn · 2016-01-16T07:30:41Z

For 2: test/parallel/test-child-process-fork-net2.js, seems like the client.resume() really is unnecessary. To be sure, I ran it 10,000 times without the client.resume() using a script and it never failed.

update: So, both the comment and the resume() can be removed.

aayn · 2016-01-16T08:09:52Z

For 4: test/parallel/test-cluster-http-pipe.js, I think the // TODO common.PIPE can be removed straight away. It most likely refers to some common.PIPE implementation which already seems to be done.
Even if it doesn't, that comment is not very helpful and should be removed anyway.

Fishrock123 · 2016-01-16T19:04:19Z

I'd like @bnoordhuis to comment on 4., once he is well again. The origin commit shows some signifigance: de88255

Edit: It was re-added there. The true origin was 296b7a5#diff-92a4de49a056f9e6d4d14bd396d326b0R45, but I think the commits that removed it and then were reverted are more telling?

aayn · 2016-01-18T18:50:03Z

In 5: test/parallel/test-dgram-oob-buffer.js, I'm not entirely sure why closing a socket is unnecessary. Seems fine to me. If it is indeed fine, then just removing the comment would do.

aayn · 2016-01-18T19:13:09Z

11: test/sequential/test-zerolengthbufferbug.js The comment should just be removed IMO. Not a very helpful comment, but it's probably referring to some linting issues. This is what eslint test-zerolengthbufferbug.js throws:

1:1 error Definition for rule 'new-with-error' was not found new-with-error
1:1 error Definition for rule 'required-modules' was not found required-modules

update: @Trott Yup. That command works. My bad. Turns out that comment(thanks for introducing me to git blame) was written by 'Oleg Efimov' all the way back in 2010. But, I still can't understand what the comment is referring to.

Trott · 2016-01-18T19:21:42Z

@aayn Those lint issues are because (for whatever reason) your eslint is not loading the custom rules that are specified in the project .eslintrc and contained in tools/eslint-rules. They are unrelated to the contents of the file.

EDIT: This command should work from the top-level directory of the project:

node tools/eslint/bin/eslint.js src lib test tools/eslint-rules \
        --rulesdir tools/eslint-rules --quiet

Trott · 2016-01-18T19:22:47Z

@aayn It might be good (if you haven't) to use git blame to find out when that line was introduced and see if there's any clue in the relevant pull request or elsewhere that might explain what is going on with that comment.

EDIT: Referring to 11 in this case.

aayn · 2016-01-21T05:32:06Z

For 10: test/sequential/test-setproctitle.js, the test file considers anything other than linux, freebsd, or darwin as not supported. The commenter, I believe @bnoordhuis, mentioned that sunos support be added too. If that's been added, we could add sunos to the string with other platforms and then remove the comment. Else, the comment still stands.

edit: @Trott Is there support for sunos? If not, probably an issue should be opened. Else, I could remove the comment and add sunos to the list.

aayn · 2016-01-21T05:47:13Z

Running 3: test/parallel/test-cluster-disconnect-handles.js fails for me. It says:
Error: Cannot find module 'internal/cluster' and a bunch of other stuff. Is that a problem just on my side?

update: @Trott, thanks. Works fine with the flag.

Trott · 2016-01-21T06:39:29Z

@aayn If you look at the top of that file, you'll see this comment:

// Flags: --expose_internals

That let's the test harness know that the test needs to be run with the --expose_internals flag.

./node --expose_internals test/parallel/test-cluster-disconnect-handles.js

aayn · 2016-01-21T09:36:43Z

@Trott I don't quite understand the rest of the tests. Could you point me to some resources/code or tell me a bit about them?

Trott · 2016-01-21T14:52:59Z

@aayn If the tests themselves are not self-explanatory through their code and comments, I don't think they tend to be documented elsewhere. I usually will use git history and/or git blame to try to find the commit and/or PR where they were introduced and see if I can figure out what's going on from that.

Standardizing a way to document tests is (or should be) on a long list of activities for the Testing WG but I don't think we/they will get to it anytime too soon.

aayn · 2016-01-22T14:58:43Z

@Trott For 1(which seems to be written by you), I get the following as the output:

[PARENT] sent "First message to send" to 224.0.0.114:12346
[PARENT] sent "Second message to send" to 224.0.0.114:12346
[PARENT] sent "Third message to send" to 224.0.0.114:12346
[PARENT] sent "Fourth message to send" to 224.0.0.114:12346
[PARENT] sendSocket closed
[PARENT] Responses were not received within 5000 ms.
[PARENT] Fail

Do I need to make a socket listen or something?(Sorry if I'm asking a noob question 😅)

Trott · 2016-01-22T19:12:52Z

@aayn Although I am the last person to touch that comment, it actually originates with @bnoordhuis in 2012 with 46e86aa8. A lot has changed since 2012 and it's possible that the comment is obsolete. Hopefully he can shed some light on it (although like everyone everywhere, he's no doubt got a lot of other things vying for his attention, so we may have to be patient).

Regarding getting the test to work: My naive analysis would be that it's possible multicast UDP is disabled on your computer or that you are having firewall issues.

aayn · 2016-01-27T18:25:31Z

@Trott Oh yeah. It was something to do with my iptables configuration. Now, it works.

aayn · 2016-01-27T18:27:55Z

So, in 1, seems like the bind() is not necessary any more. The set*() functions work just fine without the bind().

aayn · 2016-01-27T19:20:31Z

So, here is the summary of changes suggested by me so far:

In 1, remove the sendSocket.bind() along with the comments below.
In 2, remove the resume() and the comment below.
In 5, just remove the comments, as closing a socket seems fine to me.
Open an issue for 7 as the mentioned test still fails.

@Trott If you concur, can I make these changes please( I'd really like to make a contribution 😅 )? I'll suggest changes on other files as I get to know more about node and when @bnoordhuis replies.

Trott · 2016-01-27T19:29:10Z

@aayn Pick the one that you feel the most confident about, and open a pull request for it. Then you can take what you learn from the process and apply it to the others.

Or open a pull request for each of the first three and an issue for the fourth one if you want.

Each of these changes should probably be its own pull request (or, for the last one, issue). Other than being TODO comments, they're not related, so it's probably best not to bundle them.

ALJCepeda · 2016-09-21T04:03:15Z

It seems that subtask 3 was addressed in c5c28c3

Refs:nodejs#4640 Adds check for `SunOS` support

When NODE_REPL_HISTORY isn't defined `repl` defaults to temporary file This prevents the temporary file from being cleared and removes check on fixture Refs: #4640 PR-URL: #8756 Reviewed-By: Ilkka Myller <[email protected]> Reviewed-By: Jeremiah Senkpiel <[email protected]>

In test parallel/child-process-fork-net2 `net.Socket.resume()` is not necessary since `net.Socket.pause()` is never called. PR-URL: #8679 Refs: #4640 Reviewed-By: James M Snell <[email protected]> Reviewed-By: Gibson Fahnestock <[email protected]> Reviewed-By: Ilkka Myller <[email protected]>

When NODE_REPL_HISTORY isn't defined `repl` defaults to temporary file This prevents the temporary file from being cleared and removes check on fixture Refs: #4640 PR-URL: #8756 Reviewed-By: Ilkka Myller <[email protected]> Reviewed-By: Jeremiah Senkpiel <[email protected]>

Reverts: 85827bd Using `common.PORT` no longer causes other tests to fail Refs: #4640 PR-URL: #8757 Reviewed-By: James M Snell <[email protected]> Reviewed-By: Ilkka Myller <[email protected]> Reviewed-By: Luigi Pinca <[email protected]>

In test parallel/child-process-fork-net2 `net.Socket.resume()` is not necessary since `net.Socket.pause()` is never called. PR-URL: #8679 Refs: #4640 Reviewed-By: James M Snell <[email protected]> Reviewed-By: Gibson Fahnestock <[email protected]> Reviewed-By: Ilkka Myller <[email protected]>

When NODE_REPL_HISTORY isn't defined `repl` defaults to temporary file This prevents the temporary file from being cleared and removes check on fixture Refs: #4640 PR-URL: #8756 Reviewed-By: Ilkka Myller <[email protected]> Reviewed-By: Jeremiah Senkpiel <[email protected]>

Reverts: 85827bd Using `common.PORT` no longer causes other tests to fail Refs: #4640 PR-URL: #8757 Reviewed-By: James M Snell <[email protected]> Reviewed-By: Ilkka Myller <[email protected]> Reviewed-By: Luigi Pinca <[email protected]>

In test parallel/child-process-fork-net2 `net.Socket.resume()` is not necessary since `net.Socket.pause()` is never called. PR-URL: #8679 Refs: #4640 Reviewed-By: James M Snell <[email protected]> Reviewed-By: Gibson Fahnestock <[email protected]> Reviewed-By: Ilkka Myller <[email protected]>

Reverts: 85827bd Using `common.PORT` no longer causes other tests to fail Refs: #4640 PR-URL: #8757 Reviewed-By: James M Snell <[email protected]> Reviewed-By: Ilkka Myller <[email protected]> Reviewed-By: Luigi Pinca <[email protected]>

Refs: #4640 PR-URL: #8689 Reviewed-By: Colin Ihrig <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Ben Noordhuis <[email protected]>

Refs: nodejs#4640 PR-URL: nodejs#8689 Reviewed-By: Colin Ihrig <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Ben Noordhuis <[email protected]>

Refs: #4640 PR-URL: #8689 Reviewed-By: Colin Ihrig <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Ben Noordhuis <[email protected]>

jasnell · 2017-05-30T04:25:15Z

@Trott ... any reason to keep this open?

Trott · 2017-05-30T04:31:41Z

(copy/pasted from a related issue)

@jasnell I'm OK with closing this and the other TODO/XXX/FIXME issues. If any of those items are things that really ought to be fixed (rather than a wishlist or a "will fix after Magical Feature X is available"), a separate issue should be opened anyway because it's just getting lost in these out-of-date tracking issues.

While I think this issue is superfluous personally, anyone else should feel free to re-open (if GitHub permits them to) or comment requesting this be re-opened.

Trott added help wanted Issues that need assistance from volunteers or PRs that need help to proceed. test Issues and PRs related to the tests. good first issue Issues that are suitable for first-time contributors. labels Jan 12, 2016

Fishrock123 added the mentor-available label Jan 12, 2016

aayn mentioned this issue Feb 1, 2016

test: remove an unnecessary call to bind and related comments #5023

Closed

ALJCepeda mentioned this issue Sep 21, 2016

Removes call to net.Socket.resume #8679

Closed

3 tasks

ALJCepeda mentioned this issue Sep 24, 2016

test: remove FIXME pummel/test-tls-securepair-client #8757

Closed

2 tasks

ALJCepeda added a commit to ALJCepeda/node that referenced this issue Sep 24, 2016

test: Removes FIXME parallel/test-setproctitle

9e5ccd1

Refs:nodejs#4640 Adds check for `SunOS` support

ALJCepeda mentioned this issue Sep 24, 2016

test: Removes FIXME parallel/test-setproctitle #8758

Closed

2 tasks

cjihrig pushed a commit that referenced this issue Feb 9, 2017

test: remove obsolete comment from dgram test

89f8ef2

Refs: #4640 PR-URL: #8689 Reviewed-By: Colin Ihrig <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Ben Noordhuis <[email protected]>

jasnell pushed a commit that referenced this issue Mar 7, 2017

test: remove obsolete comment from dgram test

b3771a7

Refs: #4640 PR-URL: #8689 Reviewed-By: Colin Ihrig <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Ben Noordhuis <[email protected]>

MylesBorins pushed a commit that referenced this issue Mar 9, 2017

test: remove obsolete comment from dgram test

c5e8cca

Refs: #4640 PR-URL: #8689 Reviewed-By: Colin Ihrig <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Ben Noordhuis <[email protected]>

Trott mentioned this issue Apr 25, 2017

assert: fix AssertException, assign error code #12651

Closed

3 tasks

Trott removed the good first issue Issues that are suitable for first-time contributors. label Apr 25, 2017

Trott closed this as completed May 30, 2017

Trott removed help wanted Issues that need assistance from volunteers or PRs that need help to proceed. mentor-available labels May 30, 2017

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

TODO/XXX/FIXME comments in tests #4640

TODO/XXX/FIXME comments in tests #4640

Trott commented Jan 12, 2016 •

edited

Loading

Fishrock123 commented Jan 12, 2016

aayn commented Jan 15, 2016

Fishrock123 commented Jan 15, 2016

aayn commented Jan 16, 2016

aayn commented Jan 16, 2016

aayn commented Jan 16, 2016

aayn commented Jan 16, 2016

Fishrock123 commented Jan 16, 2016

aayn commented Jan 18, 2016

aayn commented Jan 18, 2016

Trott commented Jan 18, 2016

Trott commented Jan 18, 2016

aayn commented Jan 21, 2016

aayn commented Jan 21, 2016

Trott commented Jan 21, 2016

aayn commented Jan 21, 2016

Trott commented Jan 21, 2016

aayn commented Jan 22, 2016

Trott commented Jan 22, 2016

aayn commented Jan 27, 2016

aayn commented Jan 27, 2016

aayn commented Jan 27, 2016

Trott commented Jan 27, 2016

ALJCepeda commented Sep 21, 2016

jasnell commented May 30, 2017

Trott commented May 30, 2017

TODO/XXX/FIXME comments in tests #4640

TODO/XXX/FIXME comments in tests #4640

Comments

Trott commented Jan 12, 2016 • edited Loading

Fishrock123 commented Jan 12, 2016

aayn commented Jan 15, 2016

Fishrock123 commented Jan 15, 2016

aayn commented Jan 16, 2016

aayn commented Jan 16, 2016

aayn commented Jan 16, 2016

aayn commented Jan 16, 2016

Fishrock123 commented Jan 16, 2016

aayn commented Jan 18, 2016

aayn commented Jan 18, 2016

Trott commented Jan 18, 2016

Trott commented Jan 18, 2016

aayn commented Jan 21, 2016

aayn commented Jan 21, 2016

Trott commented Jan 21, 2016

aayn commented Jan 21, 2016

Trott commented Jan 21, 2016

aayn commented Jan 22, 2016

Trott commented Jan 22, 2016

aayn commented Jan 27, 2016

aayn commented Jan 27, 2016

aayn commented Jan 27, 2016

Trott commented Jan 27, 2016

ALJCepeda commented Sep 21, 2016

jasnell commented May 30, 2017

Trott commented May 30, 2017

Trott commented Jan 12, 2016 •

edited

Loading