about summary refs log tree commit diff stats
path: root/shell/parse.mu
diff options
context:
space:
mode:
Diffstat (limited to 'shell/parse.mu')
-rw-r--r--shell/parse.mu20
1 files changed, 10 insertions, 10 deletions
diff --git a/shell/parse.mu b/shell/parse.mu
index a0045eb3..eea5b13f 100644
--- a/shell/parse.mu
+++ b/shell/parse.mu
@@ -38,16 +38,16 @@ fn parse-sexpression tokens: (addr stream cell), _out: (addr handle cell), trace
   read-from-stream tokens, curr-token
   $parse-sexpression:type-check: {
     # not bracket -> parse atom
-    var is-bracket-token?/eax: boolean <- is-bracket-token? curr-token
-    compare is-bracket-token?, 0/false
+    var bracket-token?/eax: boolean <- bracket-token? curr-token
+    compare bracket-token?, 0/false
     {
       break-if-!=
       parse-atom curr-token, _out, trace
       break $parse-sexpression:type-check
     }
     # open paren -> parse list
-    var is-open-paren?/eax: boolean <- is-open-paren-token? curr-token
-    compare is-open-paren?, 0/false
+    var open-paren?/eax: boolean <- open-paren-token? curr-token
+    compare open-paren?, 0/false
     {
       break-if-=
       var curr/esi: (addr handle cell) <- copy _out
@@ -56,8 +56,8 @@ fn parse-sexpression tokens: (addr stream cell), _out: (addr handle cell), trace
         var curr-addr/eax: (addr cell) <- lookup *curr
         var left/ecx: (addr handle cell) <- get curr-addr, left
         {
-          var is-close-paren?/eax: boolean <- parse-sexpression tokens, left, trace
-          compare is-close-paren?, 0/false
+          var close-paren?/eax: boolean <- parse-sexpression tokens, left, trace
+          compare close-paren?, 0/false
           break-if-!= $parse-sexpression:list-loop
         }
         #
@@ -67,8 +67,8 @@ fn parse-sexpression tokens: (addr stream cell), _out: (addr handle cell), trace
       break $parse-sexpression:type-check
     }
     # close paren -> parse list
-    var is-close-paren?/eax: boolean <- is-close-paren-token? curr-token
-    compare is-close-paren?, 0/false
+    var close-paren?/eax: boolean <- close-paren-token? curr-token
+    compare close-paren?, 0/false
     {
       break-if-=
       trace-higher trace
@@ -96,8 +96,8 @@ fn parse-atom _curr-token: (addr cell), _out: (addr handle cell), trace: (addr t
   var curr-token-data/esi: (addr stream byte) <- copy _curr-token-data
   trace trace, "read", curr-token-data
   # number
-  var is-number-token?/eax: boolean <- is-number-token? curr-token
-  compare is-number-token?, 0/false
+  var number-token?/eax: boolean <- number-token? curr-token
+  compare number-token?, 0/false
   {
     break-if-=
     rewind-stream curr-token-data
n190' href='#n190'>190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086
# Copyright (C) 2009, 2010, 2011  Roman Zimbelmann <romanz@lavabit.com>
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.

import codecs
import os
import re
import shutil
import string
import tempfile
from os.path import join, isdir, realpath
from os import link, symlink, getcwd
from inspect import cleandoc

import ranger
from ranger.ext.direction import Direction
from ranger.ext.relative_symlink import relative_symlink
from ranger.ext.keybinding_parser import key_to_string, construct_keybinding
from ranger.ext.shell_escape import shell_quote
from ranger.ext.next_available_filename import next_available_filename
from ranger.core.shared import FileManagerAware, EnvironmentAware, \
		SettingsAware
from ranger.fsobject import File
from ranger.core.loader import CommandLoader

MACRO_FAIL = "<\x01\x01MACRO_HAS_NO_VALUE\x01\01>"

class _MacroTemplate(string.Template):
	"""A template for substituting macros in commands"""
	delimiter = ranger.MACRO_DELIMITER

class Actions(FileManagerAware, EnvironmentAware, SettingsAware):
	search_method = 'ctime'
	mode = 'normal'  # either 'normal' or 'visual'.
	_visual_reverse = False
	_visual_start = None
	_visual_start_pos = None
	_previous_selection = None

	# --------------------------
	# -- Basic Commands
	# --------------------------

	def exit(self):
		"""Exit the program"""
		raise SystemExit()

	def reset(self):
		"""Reset the filemanager, clearing the directory buffer"""
		old_path = self.env.cwd.path
		self.previews = {}
		self.env.garbage_collect(-1, self.tabs)
		self.enter_dir(old_path)
		self.change_mode('normal')

	def change_mode(self, mode):
		if mode == self.mode:
			return
		if mode == 'visual':
			self._visual_start       = self.env.cwd.pointed_obj
			self._visual_start_pos   = self.env.cwd.pointer
			self._previous_selection = set(self.env.cwd.marked_items)
			self.mark_files(val=not self._visual_reverse, movedown=False)
		elif mode == 'normal':
			if self.mode == 'visual':
				self._visual_start       = None
				self._visual_start_pos   = None
				self._previous_selection = None
		else:
			return
		self.mode = mode
		self.ui.status.request_redraw()

	def toggle_visual_mode(self, reverse=False):
		if self.mode == 'normal':
			self._visual_reverse = reverse
			self.change_mode('visual')
		else:
			self.change_mode('normal')

	def reload_cwd(self):
		try:
			cwd = self.env.cwd
		except:
			pass
		cwd.unload()
		cwd.load_content()

	def notify(self, text, duration=4, bad=False):
		if isinstance(text, Exception):
			if ranger.arg.debug:
				raise
			bad = True
		text = str(text)
		self.log.appendleft(text)
		if self.ui and self.ui.is_on:
			self.ui.status.notify("  ".join(text.split("\n")),
					duration=duration, bad=bad)
		else:
			print(text)

	def abort(self):
		try:
			item = self.loader.queue[0]
		except:
			self.notify("Type Q or :quit<Enter> to exit ranger")
		else:
			self.notify("Aborting: " + item.get_description())
			self.loader.remove(index=0)

	def get_cumulative_size(self):
		for f in self.env.get_selection() or ():
			f.look_up_cumulative_size()
		self.ui.redraw_main_column()

	def redraw_window(self):
		"""Redraw the window"""
		self.ui.redraw_window()

	def open_console(self, string='', prompt=None, position=None):
		"""Open the console"""
		self.change_mode('normal')
		self.ui.open_console(string, prompt=prompt, position=position)

	def execute_console(self, string='', wildcards=[], quantifier=None):
		"""Execute a command for the console"""
		command_name = string.split()[0]
		cmd_class = self.commands.get_command(command_name, abbrev=False)
		if cmd_class is None:
			self.notify("Command not found: `%s'" % command_name, bad=True)
			return
		cmd = cmd_class(string)
		if cmd.resolve_macros and _MacroTemplate.delimiter in string:
			macros = dict(('any%d'%i, key_to_string(char)) \
					for i, char in enumerate(wildcards))
			if 'any0' in macros:
				macros['any'] = macros['any0']
			try:
				string = self.substitute_macros(string, additional=macros,
						escape=cmd.escape_macros_for_shell)
			except ValueError as e:
				if ranger.arg.debug:
					raise
				else:
					return self.notify(e)
		try:
			cmd_class(string, quantifier=quantifier).execute()
		except Exception as e:
			if ranger.arg.debug:
				raise
			else:
				self.notify(e)

	def substitute_macros(self, string, additional=dict(), escape=False):
		macros = self._get_macros()
		macros.update(additional)
		if escape:
			for key, value in macros.items():
				if isinstance(value, list):
					macros[key] = " ".join(shell_quote(s) for s in value)
				elif value != MACRO_FAIL:
					macros[key] = shell_quote(value)
		else:
			for key, value in macros.items():
				if isinstance(value, list):
					macros[key] = " ".join(value)
		result = _MacroTemplate(string).safe_substitute(macros)
		if MACRO_FAIL in result:
			raise ValueError("Could not apply macros to `%s'" % string)
		return result

	def _get_macros(self):
		macros = {}

		macros['rangerdir'] = ranger.RANGERDIR

		if self.fm.env.cf:
			macros['f'] = self.fm.env.cf.basename
		else:
			macros['f'] = MACRO_FAIL

		if self.fm.env.get_selection:
			macros['s'] = [fl.basename for fl in self.fm.env.get_selection()]
		else:
			macros['s'] = MACRO_FAIL

		if self.fm.env.copy:
			macros['c'] = [fl.path for fl in self.fm.env.copy]
		else:
			macros['c'] = MACRO_FAIL

		if self.fm.env.cwd.files:
			macros['t'] = [fl.basename for fl in self.fm.env.cwd.files
					if fl.realpath in (self.fm.tags or [])]
		else:
			macros['t'] = MACRO_FAIL

		if self.fm.env.cwd:
			macros['d'] = self.fm.env.cwd.path
		else:
			macros['d'] = '.'

		# define d/f/s macros for each tab
		for i in range(1,10):
			try:
				tab_dir_path = self.fm.tabs[i]
			except:
				continue
			tab_dir = self.fm.env.get_directory(tab_dir_path)
			i = str(i)
			macros[i + 'd'] = tab_dir_path
			if tab_dir.get_selection():
				macros[i + 's'] = [fl.path for fl in tab_dir.get_selection()]
			else:
				macros[i + 's'] = MACRO_FAIL
			if tab_dir.pointed_obj:
				macros[i + 'f'] = tab_dir.pointed_obj.path
			else:
				macros[i + 'f'] = MACRO_FAIL

		# define D/F/S for the next tab
		found_current_tab = False
		next_tab_path = None
		first_tab = None
		for tab in self.fm.tabs:
			if not first_tab:
				first_tab = tab
			if found_current_tab:
				next_tab_path = self.fm.tabs[tab]
				break
			if self.fm.current_tab == tab:
				found_current_tab = True
		if found_current_tab and not next_tab_path:
			next_tab_path = self.fm.tabs[first_tab]
		next_tab = self.fm.env.get_directory(next_tab_path)

		if next_tab:
			macros['D'] = str(next_tab.path)
			if next_tab.pointed_obj:
				macros['F'] = next_tab.pointed_obj.path
			else:
				macros['F'] = MACRO_FAIL
			if next_tab.get_selection():
				macros['S'] = [fl.path for fl in next_tab.get_selection()]
			else:
				macros['S'] = MACRO_FAIL
		else:
			macros['D'] = MACRO_FAIL
			macros['F'] = MACRO_FAIL
			macros['S'] = MACRO_FAIL

		return macros

	def source(self, filename):
		filename = os.path.expanduser(filename)
		for line in open(filename, 'r'):
			line = line.rstrip("\r\n")
			if line.startswith("#") or not line.strip():
				continue
			try:
				self.execute_console(line)
			except Exception as e:
				if ranger.arg.debug:
					raise
				else:
					self.notify('Error in line `%s\':\n  %s' %
							(line, str(e)), bad=True)

	def execute_file(self, files, **kw):
		"""Execute a file.
		app is the name of a method in Applications, without the "app_"
		flags is a string consisting of runner.ALLOWED_FLAGS
		mode is a positive integer.
		Both flags and mode specify how the program is run."""

		# ranger can act as a file chooser when running with --choosefile=...
		if ranger.arg.choosefile:
			open(ranger.arg.choosefile, 'w').write(self.fm.env.cf.path)

		if ranger.arg.choosefiles:
			open(ranger.arg.choosefiles, 'w').write("".join(
				f.path + "\n" for f in self.fm.env.get_selection()))

		if ranger.arg.choosefile or ranger.arg.choosefiles:
			raise SystemExit()

		if isinstance(files, set):
			files = list(files)
		elif type(files) not in (list, tuple):
			files = [files]

		if 'flags' in kw:
			from ranger.core.runner import Context
			context = Context(files=list(files), flags=kw['flags'])
			context.squash_flags()
			if 'c' in context.flags:
				files = [self.fm.env.cf]

		self.signal_emit('execute.before', keywords=kw)
		try:
			return self.run(files=list(files), **kw)
		finally:
			self.signal_emit('execute.after')

	# --------------------------
	# -- Moving Around
	# --------------------------

	def move(self, narg=None, **kw):
		"""
		A universal movement method.

		Accepts these parameters:
		(int) down, (int) up, (int) left, (int) right, (int) to,
		(bool) absolute, (bool) relative, (bool) pages,
		(bool) percentage

		to=X is translated to down=X, absolute=True

		Example:
		self.move(down=4, pages=True)  # moves down by 4 pages.
		self.move(to=2, pages=True)  # moves to page 2.
		self.move(to=1, percentage=True)  # moves to 80%
		"""
		cwd = self.env.cwd
		direction = Direction(kw)
		if 'left' in direction or direction.left() > 0:
			steps = direction.left()
			if narg is not None:
				steps *= narg
			try:
				directory = os.path.join(*(['..'] * steps))
			except:
				return
			self.env.enter_dir(directory)
			self.change_mode('normal')
		if cwd and cwd.accessible and cwd.content_loaded:
			if 'right' in direction:
				mode = 0
				if narg is not None:
					mode = narg
				cf = self.env.cf
				selection = self.env.get_selection()
				if not self.env.enter_dir(cf) and selection:
					if self.execute_file(selection, mode=mode) is False:
						self.open_console('open_with ')
			elif direction.vertical() and cwd.files:
				newpos = direction.move(
						direction=direction.down(),
						override=narg,
						maximum=len(cwd),
						current=cwd.pointer,
						pagesize=self.ui.browser.hei)
				cwd.move(to=newpos)
				if self.mode == 'visual':
					try:
						startpos = cwd.index(self._visual_start)
					except:
						self._visual_start = None
						startpos = min(self._visual_start_pos, len(cwd))
					# The files between here and _visual_start_pos
					targets = set(cwd.files[min(startpos, newpos):\
							max(startpos, newpos) + 1])
					# The selection before activating visual mode
					old = self._previous_selection
					# The current selection
					current = set(cwd.marked_items)

					# Set theory anyone?
					if not self._visual_reverse:
						for f in targets - current:
							cwd.mark_item(f, True)
						for f in current - old - targets:
							cwd.mark_item(f, False)
					else:
						for f in targets & current:
							cwd.mark_item(f, False)
						for f in old - current - targets:
							cwd.mark_item(f, True)

	def move_parent(self, n, narg=None):
		self.change_mode('normal')
		if narg is not None:
			n *= narg
		parent = self.env.at_level(-1)
		if parent is not None:
			if parent.pointer + n < 0:
				n = 0 - parent.pointer
			try:
				self.env.enter_dir(parent.files[parent.pointer+n])
			except IndexError:
				pass

	def select_file(self, path):
		path = path.strip()
		if self.enter_dir(os.path.dirname(path)):
			self.env.cwd.move_to_obj(path)

	def history_go(self, relative):
		"""Move back and forth in the history"""
		self.env.history_go(int(relative))

	def scroll(self, relative):
		"""Scroll down by <relative> lines"""
		if self.ui.browser and self.ui.browser.main_column:
			self.ui.browser.main_column.scroll(relative)
			self.env.cf = self.env.cwd.pointed_obj

	def enter_dir(self, path, remember=False, history=True):
		"""Enter the directory at the given path"""
		cwd = self.env.cwd
		result = self.env.enter_dir(path, history=history)
		if cwd != self.env.cwd:
			if remember:
				self.bookmarks.remember(cwd)
			self.change_mode('normal')
		return result

	def cd(self, path, remember=True):
		"""enter the directory at the given path, remember=True"""
		self.enter_dir(path, remember=remember)

	def traverse(self):
		self.change_mode('normal')
		cf = self.env.cf
		cwd = self.env.cwd
		if cf is not None and cf.is_directory:
			self.enter_dir(cf.path)
		elif cwd.pointer >= len(cwd) - 1:
			while True:
				self.move(left=1)
				cwd = self.env.cwd
				if cwd.pointer < len(cwd) - 1:
					break
				if cwd.path == '/':
					break
			self.move(down=1)
			self.traverse()
		else:
			self.move(down=1)
			self.traverse()

	# --------------------------
	# -- Shortcuts / Wrappers
	# --------------------------

	def pager_move(self, narg=None, **kw):
		self.ui.browser.pager.move(narg=narg, **kw)

	def taskview_move(self, narg=None, **kw):
		self.ui.taskview.move(narg=narg, **kw)

	def pager_close(self):
		if self.ui.pager.visible:
			self.ui.close_pager()
		if self.ui.browser.pager.visible:
			self.ui.close_embedded_pager()

	def taskview_open(self):
		self.ui.open_taskview()

	def taskview_close(self):
		self.ui.close_taskview()

	def execute_command(self, cmd, **kw):
		return self.run(cmd, **kw)

	def edit_file(self, file=None):
		"""Calls execute_file with the current file and app='editor'"""
		if file is None:
			file = self.env.cf
		elif isinstance(file, str):
			file = File(os.path.expanduser(file))
		if file is None:
			return
		self.execute_file(file, app = 'editor')

	def toggle_option(self, string):
		"""Toggle a boolean option named <string>"""
		if isinstance(self.env.settings[string], bool):
			self.env.settings[string] ^= True

	def set_option(self, optname, value):
		"""Set the value of an option named <optname>"""
		self.env.settings[optname] = value

	def sort(self, func=None, reverse=None):
		if reverse is not None:
			self.env.settings['sort_reverse'] = bool(reverse)

		if func is not None:
			self.env.settings['sort'] = str(func)

	def set_filter(self, fltr):
		try:
			self.env.cwd.filter = fltr
		except:
			pass

	def mark_files(self, all=False, toggle=False, val=None, movedown=None, narg=1):
		"""
		A wrapper for the directory.mark_xyz functions.

		Arguments:
		all - change all files of the current directory at once?
		toggle - toggle the marked-status?
		val - mark or unmark?
		"""

		if self.env.cwd is None:
			return

		cwd = self.env.cwd

		if not cwd.accessible:
			return

		if movedown is None:
			movedown = not all

		if val is None and toggle is False:
			return

		if all:
			if toggle:
				cwd.toggle_all_marks()
			else:
				cwd.mark_all(val)
			if self.mode == 'visual':
				self.change_mode('normal')
		else:
			for i in range(cwd.pointer, min(cwd.pointer + narg, len(cwd))):
				item = cwd.files[i]
				if item is not None:
					if toggle:
						cwd.toggle_mark(item)
					else:
						cwd.mark_item(item, val)

		if movedown:
			self.move(down=narg)

		self.ui.redraw_main_column()
		self.ui.status.need_redraw = True

	def mark_in_direction(self, val=True, dirarg=None):
		cwd = self.env.cwd
		direction = Direction(dirarg)
		pos, selected = direction.select(lst=cwd.files, current=cwd.pointer,
				pagesize=self.env.termsize[0])
		cwd.pointer = pos
		cwd.correct_pointer()
		for item in selected:
			cwd.mark_item(item, val)

	# --------------------------
	# -- Searching
	# --------------------------

	def search_file(self, text, offset=1, regexp=True):
		if isinstance(text, str) and regexp:
			try:
				text = re.compile(text, re.L | re.U | re.I)
			except:
				return False
		self.env.last_search = text
		self.search_next(order='search', offset=offset)

	def search_next(self, order=None, offset=1, forward=True):
		original_order = order

		if order is None:
			order = self.search_method
		else:
			self.set_search_method(order=order)

		if order in ('search', 'tag'):
			if order == 'search':
				arg = self.env.last_search
				if arg is None:
					return False
				if hasattr(arg, 'search'):
					fnc = lambda x: arg.search(x.basename)
				else:
					fnc = lambda x: arg in x.basename
			elif order == 'tag':
				fnc = lambda x: x.realpath in self.tags

			return self.env.cwd.search_fnc(fnc=fnc, offset=offset, forward=forward)

		elif order in ('size', 'mimetype', 'ctime', 'mtime', 'atime'):
			cwd = self.env.cwd
			if original_order is not None or not cwd.cycle_list:
				lst = list(cwd.files)
				if order == 'size':
					fnc = lambda item: -item.size
				elif order == 'mimetype':
					fnc = lambda item: item.mimetype
				elif order == 'ctime':
					fnc = lambda item: -int(item.stat and item.stat.st_ctime)
				elif order == 'atime':
					fnc = lambda item: -int(item.stat and item.stat.st_atime)
				elif order == 'mtime':
					fnc = lambda item: -int(item.stat and item.stat.st_mtime)
				lst.sort(key=fnc)
				cwd.set_cycle_list(lst)
				return cwd.cycle(forward=None)

			return cwd.cycle(forward=forward)

	def set_search_method(self, order, forward=True):
		if order in ('search', 'tag', 'size', 'mimetype', 'ctime'):
			self.search_method = order

	# --------------------------
	# -- Tags
	# --------------------------
	# Tags are saved in ~/.config/ranger/tagged and simply mark if a
	# file is important to you in any context.

	def tag_toggle(self, paths=None, value=None, movedown=None, tag=None):
		if not self.tags:
			return
		if paths is None:
			tags = tuple(x.realpath for x in self.env.get_selection())
		else:
			tags = [realpath(path) for path in paths]
		if value is True:
			self.tags.add(*tags, tag=tag or self.tags.default_tag)
		elif value is False:
			self.tags.remove(*tags)
		else:
			self.tags.toggle(*tags, tag=tag or self.tags.default_tag)

		if movedown is None:
			movedown = len(tags) == 1 and paths is None
		if movedown:
			self.move(down=1)

		self.ui.redraw_main_column()

	def tag_remove(self, paths=None, movedown=None):
		self.tag_toggle(paths=paths, value=False, movedown=movedown)

	def tag_add(self, paths=None, movedown=None):
		self.tag_toggle(paths=paths, value=True, movedown=movedown)

	# --------------------------
	# -- Bookmarks
	# --------------------------
	# Using ranger.container.bookmarks.

	def enter_bookmark(self, key):
		"""Enter the bookmark with the name <key>"""
		try:
			self.bookmarks.update_if_outdated()
			destination = self.bookmarks[str(key)]
			cwd = self.env.cwd
			if destination.path != cwd.path:
				self.bookmarks.enter(str(key))
				self.bookmarks.remember(cwd)
		except KeyError:
			pass

	def set_bookmark(self, key):
		"""Set the bookmark with the name <key> to the current directory"""
		self.bookmarks.update_if_outdated()
		self.bookmarks[str(key)] = self.env.cwd

	def unset_bookmark(self, key):
		"""Delete the bookmark with the name <key>"""
		self.bookmarks.update_if_outdated()
		self.bookmarks.delete(str(key))

	def draw_bookmarks(self):
		self.ui.browser.draw_bookmarks = True

	def hide_bookmarks(self):
		self.ui.browser.draw_bookmarks = False

	# --------------------------
	# -- Pager
	# --------------------------
	# These commands open the built-in pager and set specific sources.

	def display_command_help(self, console_widget):
		try:
			command = console_widget._get_cmd_class()
		except:
			self.notify("Feature not available!", bad=True)
			return

		if not command:
			self.notify("Command not found!", bad=True)
			return

		if not command.__doc__:
			self.notify("Command has no docstring. Try using python without -OO",
					bad=True)
			return

		pager = self.ui.open_pager()
		lines = cleandoc(command.__doc__).split('\n')
		pager.set_source(lines)

	def display_help(self):
		manualpath = self.relpath('../doc/ranger.1')
		if os.path.exists(manualpath):
			process = self.run(['man', manualpath])
			if process.poll() != 16:
				return
		process = self.run(['man', 'ranger'])
		if process.poll() == 16:
			self.notify("Could not find manpage.", bad=True)

	def display_log(self):
		pager = self.ui.open_pager()
		if self.log:
			pager.set_source(["Message Log:"] + list(self.log))
		else:
			pager.set_source(["Message Log:", "No messages!"])

	def display_file(self):
		if not self.env.cf or not self.env.cf.is_file:
			return

		pager = self.ui.open_embedded_pager()
		pager.set_source(self.env.cf.get_preview_source(pager.wid, pager.hei))

	# --------------------------
	# -- Previews
	# --------------------------
	def update_preview(self, path):
		try:
			del self.previews[path]
			self.ui.need_redraw = True
		except:
			return False

	def get_preview(self, path, width, height):
		if self.settings.preview_script and self.settings.use_preview_script:
			# self.previews is a 2 dimensional dict:
			# self.previews['/tmp/foo.jpg'][(80, 24)] = "the content..."
			# self.previews['/tmp/foo.jpg']['loading'] = False
			# A -1 in tuples means "any"; (80, -1) = wid. of 80 and any hei.
			# The key 'foundpreview' is added later. Values in (True, False)
			# XXX: Previews can break when collapse_preview is on and the
			# preview column is popping out as you move the cursor on e.g. a
			# PDF file.
			try:
				data = self.previews[path]
			except:
				data = self.previews[path] = {'loading': False}
			else:
				if data['loading']:
					return None

			found = data.get((-1, -1), data.get((width, -1),
				data.get((-1, height), data.get((width, height), False))))
			if found == False:
				data['loading'] = True
				loadable = CommandLoader(args=[self.settings.preview_script,
					path, str(width), str(height)], read=True,
					silent=True, descr="Getting preview of %s" % path)
				def on_after(signal):
					exit = signal.process.poll()
					content = signal.loader.stdout_buffer
					data['foundpreview'] = True
					if exit == 0:
						data[(width, height)] = content
					elif exit == 3:
						data[(-1, height)] = content
					elif exit == 4:
						data[(width, -1)] = content
					elif exit == 5:
						data[(-1, -1)] = content
					elif exit == 1:
						data[(-1, -1)] = None
						data['foundpreview'] = False
					elif exit == 2:
						f = codecs.open(path, 'r', errors='ignore')
						try:
							data[(-1, -1)] = f.read(1024 * 32)
						except UnicodeDecodeError:
							f.close()
							f = codecs.open(path, 'r', encoding='latin-1',
									errors='ignore')
							data[(-1, -1)] = f.read(1024 * 32)
						f.close()
					else:
						data[(-1, -1)] = None
					if self.env.cf.realpath == path:
						self.ui.browser.need_redraw = True
					data['loading'] = False
					pager = self.ui.browser.pager
					if self.env.cf and self.env.cf.is_file:
						pager.set_source(self.env.cf.get_preview_source(
							pager.wid, pager.hei))
				def on_destroy(signal):
					try:
						del self.previews[path]
					except:
						pass
				loadable.signal_bind('after', on_after)
				loadable.signal_bind('destroy', on_destroy)
				self.loader.add(loadable)
				return None
			else:
				return found
		else:
			try:
				return codecs.open(path, 'r', errors='ignore')
			except:
				return None

	# --------------------------
	# -- Tabs
	# --------------------------
	# This implementation of tabs is very simple and keeps track of
	# directory paths only.

	def tab_open(self, name, path=None):
		tab_has_changed = name != self.current_tab
		self.current_tab = name
		if path or (name in self.tabs):
			self.enter_dir(path or self.tabs[name])
		else:
			self._update_current_tab()
		if tab_has_changed:
			self.change_mode('normal')
			self.signal_emit('tab.change')

	def tab_close(self, name=None):
		if name is None:
			name = self.current_tab
		if name == self.current_tab:
			direction = -1 if name == self._get_tab_list()[-1] else 1
			previous = self.current_tab
			self.tab_move(direction)
			if previous == self.current_tab:
				return  # can't close last tab
		if name in self.tabs:
			del self.tabs[name]

	def tab_move(self, offset):
		assert isinstance(offset, int)
		tablist = self._get_tab_list()
		current_index = tablist.index(self.current_tab)
		newtab = tablist[(current_index + offset) % len(tablist)]
		if newtab != self.current_tab:
			self.tab_open(newtab)

	def tab_new(self, path=None):
		for i in range(1, 10):
			if not i in self.tabs:
				self.tab_open(i, path)
				break

	def _get_tab_list(self):
		assert len(self.tabs) > 0, "There must be >=1 tabs at all times"
		return sorted(self.tabs)

	def _update_current_tab(self):
		self.tabs[self.current_tab] = self.env.cwd.path

	# --------------------------
	# -- Overview of internals
	# --------------------------

	def dump_keybindings(self, *contexts):
		if not contexts:
			contexts = 'browser', 'console', 'pager', 'taskview'

		temporary_file = tempfile.NamedTemporaryFile()
		def write(string):
			temporary_file.write(string.encode('utf-8'))

		def recurse(before, pointer):
			for key, value in pointer.items():
				keys = before + [key]
				if isinstance(value, dict):
					recurse(keys, value)
				else:
					write("%12s %s\n" % (construct_keybinding(keys), value))

		for context in contexts:
			write("Keybindings in `%s'\n" % context)
			if context in self.env.keymaps:
				recurse([], self.env.keymaps[context])
			else:
				write("  None\n")
			write("\n")

		temporary_file.flush()
		self.run(app='pager', files=[File(temporary_file.name)])

	def dump_commands(self):
		temporary_file = tempfile.NamedTemporaryFile()
		def write(string):
			temporary_file.write(string.encode('utf-8'))

		undocumented = []
		for cmd_name in sorted(self.commands.commands):
			cmd = self.commands.commands[cmd_name]
			if hasattr(cmd, '__doc__') and cmd.__doc__:
				write(cleandoc(cmd.__doc__))
				write("\n\n" + "-" * 60 + "\n")
			else:
				undocumented.append(cmd)

		if undocumented:
			write("Undocumented commands:\n\n")
			for cmd in undocumented:
				write("    :%s\n" % cmd.get_name())

		temporary_file.flush()
		self.run(app='pager', files=[File(temporary_file.name)])

	def dump_settings(self):
		from ranger.container.settingobject import ALLOWED_SETTINGS
		temporary_file = tempfile.NamedTemporaryFile()
		def write(string):
			temporary_file.write(string.encode('utf-8'))

		for setting in sorted(ALLOWED_SETTINGS):
			write("%30s = %s\n" % (setting, getattr(self.settings, setting)))

		temporary_file.flush()
		self.run(app='pager', files=[File(temporary_file.name)])

	# --------------------------
	# -- File System Operations
	# --------------------------

	def uncut(self):
		self.env.copy = set()
		self.env.cut = False
		self.ui.browser.main_column.request_redraw()

	def copy(self, mode='set', narg=None, dirarg=None):
		"""Copy the selected items.  Modes are: 'set', 'add', 'remove'."""
		assert mode in ('set', 'add', 'remove')
		cwd = self.env.cwd
		if not narg and not dirarg:
			selected = (f for f in self.env.get_selection() if f in cwd.files)
		else:
			if not dirarg and narg:
				direction = Direction(down=1)
				offset = 0
			else:
				direction = Direction(dirarg)
				offset = 1
			pos, selected = direction.select(
					override=narg, lst=cwd.files, current=cwd.pointer,
					pagesize=self.env.termsize[0], offset=offset)
			cwd.pointer = pos
			cwd.correct_pointer()
		if mode == 'set':
			self.env.copy = set(selected)
		elif mode == 'add':
			self.env.copy.update(set(selected))
		elif mode == 'remove':
			self.env.copy.difference_update(set(selected))
		self.env.cut = False
		self.ui.browser.main_column.request_redraw()

	def cut(self, mode='set', narg=None, dirarg=None):
		self.copy(mode=mode, narg=narg, dirarg=dirarg)
		self.env.cut = True
		self.ui.browser.main_column.request_redraw()

	def paste_symlink(self, relative=False):
		copied_files = self.env.copy
		for f in copied_files:
			self.notify(next_available_filename(f.basename))
			try:
				new_name = next_available_filename(f.basename)
				if relative:
					relative_symlink(f.path, join(getcwd(), new_name))
				else:
					symlink(f.path, join(getcwd(), new_name))
			except Exception as x:
				self.notify(x)

	def paste_hardlink(self):
		for f in self.env.copy:
			try:
				new_name = next_available_filename(f.basename)
				link(f.path, join(getcwd(), new_name))
			except Exception as x:
				self.notify(x)

	def paste(self, overwrite=False):
		"""Paste the selected items into the current directory"""
		copied_files = tuple(self.env.copy)

		if not copied_files:
			return

		def refresh(_):
			cwd = self.env.get_directory(original_path)
			cwd.load_content()

		cwd = self.env.cwd
		original_path = cwd.path
		one_file = copied_files[0]
		if overwrite:
			cp_flags = ['-af', '--']
			mv_flags = ['-f', '--']
		else:
			cp_flags = ['--backup=numbered', '-a', '--']
			mv_flags = ['--backup=numbered', '--']

		if self.env.cut:
			self.env.copy.clear()
			self.env.cut = False
			if len(copied_files) == 1:
				descr = "moving: " + one_file.path
			else:
				descr = "moving files from: " + one_file.dirname
			obj = CommandLoader(args=['mv'] + mv_flags \
					+ [f.path for f in copied_files] \
					+ [cwd.path], descr=descr)
		else:
			if len(copied_files) == 1:
				descr = "copying: " + one_file.path
			else:
				descr = "copying files from: " + one_file.dirname
			if not overwrite and len(copied_files) == 1 \
					and one_file.dirname == cwd.path:
				# Special case: yypp
				# copying a file onto itself -> create a backup
				obj = CommandLoader(args=['cp', '-f'] + cp_flags \
						+ [one_file.path, one_file.path], descr=descr)
			else:
				obj = CommandLoader(args=['cp'] + cp_flags \
						+ [f.path for f in copied_files] \
						+ [cwd.path], descr=descr)

		obj.signal_bind('after', refresh)
		self.loader.add(obj)

	def delete(self):
		# XXX: warn when deleting mount points/unseen marked files?
		self.notify("Deleting!")
		selected = self.env.get_selection()
		self.env.copy -= set(selected)
		if selected:
			for f in selected:
				if isdir(f.path) and not os.path.islink(f.path):
					try:
						shutil.rmtree(f.path)
					except OSError as err:
						self.notify(err)
				else:
					try:
						os.remove(f.path)
					except OSError as err:
						self.notify(err)
		self.env.ensure_correct_pointer()

	def mkdir(self, name):
		try:
			os.mkdir(os.path.join(self.env.cwd.path, name))
		except OSError as err:
			self.notify(err)

	def rename(self, src, dest):
		if hasattr(src, 'path'):
			src = src.path

		try:
			os.renames(src, dest)
		except OSError as err:
			self.notify(err)