aboutsummaryrefslogtreecommitdiff
path: root/doc
Commit message (Expand)AuthorAge
* Update version numbers for 0.4.10sapier2014-07-06
* Fix typos in doc/lua-api.txtsfan52014-07-05
* Fix typo in doc/lua_api.txtKahrl2014-07-05
* Add support for Android 2.3+sapier2014-06-29
* Tooltips rework.RealBadAngel2014-06-24
* Add tooltips for button, imagebutton and checkbox.RealBadAngel2014-06-19
* Fix regression dirt texture not beeing default in non cloud menusapier2014-06-14
* Add success and output return values to chat commandsShadowNinja2014-05-28
* Add item eat callbackrubenwardy2014-05-26
* Add formspec toolkit and refactor mainmenu to use itsapier2014-05-16
* Use "core" namespace internallyShadowNinja2014-05-08
* Fix heart + bubble bar size on different texture packssapier2014-05-07
* Add support for dpi based HUD scalingsapier2014-04-27
* Move the old stuff to docBlockMen2014-04-25
* Update documentation on is_ground_contentShadowNinja2014-04-24
* Remove liquid_finite and weatherproller2014-04-18
* Add player:set_eye_offset() by @MirceaKitsune and clean upBlockMen2014-04-12
* Add third person viewBlockMen2014-04-12
* Cleanup client init states by bumping protocol versionsapier2014-04-08
* Replace pause and message menu by formspec onessapier2014-03-05
* Remove "Server -!- " prefix from player messagesShadowNinja2014-02-27
* Schematic: Add force_placement parameter to minetest.place_structure APIkwolekr2014-02-15
* Add minetest.set_noiseparam_defaults() Lua APIkwolekr2014-02-15
* Add capability to read table flag fields from Lua APIkwolekr2014-02-09
* Make flag strings clear specified flag with 'no' prefixkwolekr2014-02-08
* Add minetest.kick_player(name, reason)sapier2014-02-03
* Add player:override_day_night_ratio() for arbitrarily controlling sunlight br...Perttu Ahola2014-02-01
* Add player:set_sky() with simple skybox supportPerttu Ahola2014-02-01
* New HUD element - waypoint.RealBadAngel2014-01-26
* Pass pointed_thing to on_punch and minetest.register_on_punchnode callbacksShadowNinja2014-01-23
* Add pointed_thing to minetest.register_on_placenodeShadowNinja2014-01-21
* Update lua_api.txt documentationkwolekr2014-01-19
* Add minetest.override_itemShadowNinja2014-01-13
* Add formspec tableKahrl2014-01-13
* Allow vertical axis particle rotation constraintkhonkhortisan2014-01-13
* Fix doc and forceloading crash.Novatux2014-01-12
* Add InvRef::get/set_lists()ShadowNinja2014-01-11
* Add forceloadingNovatux2014-01-11
* Deepcopy pointed_thing for after_place_node, give it to on_rightclick too.Novatux2014-01-11
* Document "wielditem" visualShadowNinja2014-01-08
* Pass pointed_thing to after_place_nodeShadowNinja2014-01-06
* Bump version to 0.4.9kwolekr2014-01-01
* Don't throw a error when writing JSON failsShadowNinja2013-12-18
* Add 'minetest.write_json'ShadowNinja2013-12-18
* Add map feature generation notify Lua APIkwolekr2013-12-14
* Remove support for optdepends.txtShadowNinja2013-12-13
* Make line_of_sight return blocking node positionstujones112013-12-12
* Add 'on_prejoinplayer' callbackkaeza2013-12-12
* Fix small mistake in Lua API docssfan52013-12-06
* Use a table in set_physics_override()PilzAdam2013-12-03
tr">'Error: could not find compilation database.') sys.exit(1) result += '../' return os.path.realpath(result) def get_tidy_invocation(f, clang_tidy_binary, checks, warningsaserrors, tmpdir, build_path, header_filter, extra_arg, extra_arg_before, quiet): """Gets a command line for clang-tidy.""" start = [clang_tidy_binary] if header_filter is not None: start.append('-header-filter=' + header_filter) else: # Show warnings in all in-project headers by default. start.append('-header-filter=^' + build_path + '/.*') if checks: start.append('-checks=' + checks) if warningsaserrors: start.append('-warnings-as-errors=' + warningsaserrors) if tmpdir is not None: start.append('-export-fixes') # Get a temporary file. We immediately close the handle so clang-tidy can # overwrite it. (handle, name) = tempfile.mkstemp(suffix='.yaml', dir=tmpdir) os.close(handle) start.append(name) for arg in extra_arg: start.append('-extra-arg=%s' % arg) for arg in extra_arg_before: start.append('-extra-arg-before=%s' % arg) start.append('-p=' + build_path) if quiet: start.append('-quiet') start.append(f) return start def check_clang_apply_replacements_binary(args): """Checks if invoking supplied clang-apply-replacements binary works.""" try: subprocess.check_call([args.clang_apply_replacements_binary, '--version']) except: print('Unable to run clang-apply-replacements. Is clang-apply-replacements ' 'binary correctly specified?', file=sys.stderr) traceback.print_exc() sys.exit(1) def apply_fixes(args, tmpdir): """Calls clang-apply-fixes on a given directory. Deletes the dir when done.""" invocation = [args.clang_apply_replacements_binary] if args.format: invocation.append('-format') if args.style: invocation.append('-style=' + args.style) invocation.append(tmpdir) subprocess.call(invocation) def run_tidy(args, tmpdir, build_path, queue): """Takes filenames out of queue and runs clang-tidy on them.""" while True: name = queue.get() invocation = get_tidy_invocation(name, args.clang_tidy_binary, args.checks, args.warningsaserrors, tmpdir, build_path, args.header_filter, args.extra_arg, args.extra_arg_before, args.quiet) if not args.no_command_on_stdout: sys.stdout.write(' '.join(invocation) + '\n') try: subprocess.check_call(invocation) except subprocess.CalledProcessError: queue.has_error = True queue.task_done() def main(): parser = argparse.ArgumentParser(description='Runs clang-tidy over all files ' 'in a compilation database. Requires ' 'clang-tidy and clang-apply-replacements in ' '$PATH.') parser.add_argument('-clang-tidy-binary', metavar='PATH', default='clang-tidy', help='path to clang-tidy binary') parser.add_argument('-clang-apply-replacements-binary', metavar='PATH', default='clang-apply-replacements', help='path to clang-apply-replacements binary') parser.add_argument('-checks', default=None, help='checks filter, when not specified, use clang-tidy ' 'default') parser.add_argument('-warningsaserrors', default=None, help='warnings-as-errors filter, when not specified, ' 'use clang-tidy default') parser.add_argument('-header-filter', default=None, help='regular expression matching the names of the ' 'headers to output diagnostics from. Diagnostics from ' 'the main file of each translation unit are always ' 'displayed.') parser.add_argument('-j', type=int, default=0, help='number of tidy instances to be run in parallel.') parser.add_argument('files', nargs='*', default=['.*'], help='files to be processed (regex on path)') parser.add_argument('-fix', action='store_true', help='apply fix-its') parser.add_argument('-format', action='store_true', help='Reformat code ' 'after applying fixes') parser.add_argument('-style', default='file', help='The style of reformat ' 'code after applying fixes') parser.add_argument('-p', dest='build_path', help='Path used to read a compile command database.') parser.add_argument('-extra-arg', dest='extra_arg', action='append', default=[], help='Additional argument to append to the compiler ' 'command line.') parser.add_argument('-extra-arg-before', dest='extra_arg_before', action='append', default=[], help='Additional argument to prepend to the compiler ' 'command line.') parser.add_argument('-quiet', action='store_true', help='Run clang-tidy in quiet mode') parser.add_argument('-no-command-on-stdout', action='store_true', help='Run clang-tidy without printing invocation on ' 'stdout') args = parser.parse_args() db_path = 'compile_commands.json' if args.build_path is not None: build_path = args.build_path else: # Find our database build_path = find_compilation_database(db_path) try: invocation = [args.clang_tidy_binary, '-list-checks', '-p=' + build_path] if args.checks: invocation.append('-checks=' + args.checks) if args.warningsaserrors: invocation.append('-warnings-as-errors=' + args.warningsaserrors) invocation.append('-') print(subprocess.check_output(invocation)) except: print("Unable to run clang-tidy.", file=sys.stderr) sys.exit(1) # Load the database and extract all files. database = json.load(open(os.path.join(build_path, db_path))) files = [entry['file'] for entry in database] max_task = args.j if max_task == 0: max_task = multiprocessing.cpu_count() tmpdir = None if args.fix: check_clang_apply_replacements_binary(args) tmpdir = tempfile.mkdtemp() # Build up a big regexy filter from all command line arguments. file_name_re = re.compile('|'.join(args.files)) try: # Spin up a bunch of tidy-launching threads. queue = TidyQueue(max_task) for _ in range(max_task): t = threading.Thread(target=run_tidy, args=(args, tmpdir, build_path, queue)) t.daemon = True t.start() # Fill the queue with files. for name in files: if file_name_re.search(name): queue.put(name) # Wait for all threads to be done. queue.join() # If one clang-tidy process found and error, exit with non-zero # status if queue.has_error: sys.exit(2) except KeyboardInterrupt: # This is a sad hack. Unfortunately subprocess goes # bonkers with ctrl-c and we start forking merrily. print('\nCtrl-C detected, goodbye.') if args.fix: shutil.rmtree(tmpdir) os.kill(0, 9) if args.fix: print('Applying fixes ...') successfully_applied = False try: apply_fixes(args, tmpdir) successfully_applied = True except: print('Error applying fixes.\n', file=sys.stderr) traceback.print_exc() shutil.rmtree(tmpdir) if not successfully_applied: sys.exit(1) if __name__ == '__main__': main()