Even though you can call the files anything you want, there’s an advantage to calling the entry point index.js or server.js Why index.js: When you issue npm init it will set the main entry point of the module to index.js. Some people don’t change it, so they end up naming their main entry point index.js. … Read more
In the general case, [A, B) (inclusive start, exclusive end) has a lot going for it and I don’t see any reason why the same wouldn’t be true for time intervals. Djikstra wrote a nice article about it Why numbering should start at zero which – despite the name – deals mostly with exactly this. … Read more
There are three conventions, which you might find confusing. The standard PEP8 defines a standard for how to name packages and modules: Modules should have short, all-lowercase names. Underscores can be used in the module name if it improves readability. Python packages should also have short, all-lowercase names, although the use of underscores is discouraged. … Read more
Main benefit is in having the test directory as subdirectory of src with the same directory structure as the one in main: Project-A bin lib src main java RootLevelPackageClass.java resources test java TestRootLevelPackageClass.java resources All package private methods of RootLevelPackageClass will be visible, i.e. testable from TestRootLevelPackageClass. Since the testing code is also source its … Read more
You should raise NotImplementedError raise NotImplementedError ruby-doc
With ES6, you can use Template strings: var username=”craig”; console.log(`hello ${username}`); ES5 and below: use the + operator var username=”craig”; var joined = ‘hello ‘ + username; String’s concat(..) var username=”craig”; var joined = ‘hello ‘.concat(username); Alternatively, use Array methods: join(..): var username=”craig”; var joined = [‘hello’, username].join(‘ ‘); Or even fancier, reduce(..) combined with … Read more
Private helper functions can be hidden from the public header file by moving them to an inner class. This works because the inner class is considered part of the class and can access the surrounding class’s private members. Unlike the PIMPL idiom, this does not have any dynamic allocation or indirection penalty. Compile times should … Read more
Really hard question. I hope your answers turn up something good. Meanwhile, here is a catalog of mistakes or other annoying things that I have found in beginners’ code. There is some overlap with the Cal Tech style page that Kornel Kisielewicz points to. Some of my advice is every bit as vague and useless … Read more
In Common Lisp: ;;;; At the top of source files ;;; Comments at the beginning of the line (defun test (a &optional b) ;; Commends indented along with code (do-something a) ; Comments indented at column 40, or the last (do-something-else b)) ; column + 1 space if line exceeds 38 columns Note: Emacs doesn’t … Read more
Splitting an expression that’s too nested and complicated into simpler sub-expressions assigned to local variables, then put together again, is quite a common and popular technique — quite independently of whether the sub-expressions and/or the overall expression are boolean or of just about any other type. With well-chosen names, a tasteful decomposition of this kind … Read more