1 # A table is a stream of (key, value) rows. 2 # 3 # Each row consists of a 4-byte key -- a 'string_key' which is (addr array 4 # byte) -- and a variable-size value. 5 # 6 # Accessing the table performs a linear scan for a key string, and always 7 # requires passing in the row size. 8 # 9 # Table primitives have the form <variant>(stream, <arg>, row-size, ...) -> address/eax 10 # 11 # The following table shows available options for <variant>: 12 # if not found: | arg=string arg=slice 13 # ------------------------+--------------------------------------------------- 14 # abort | get get-slice 15 # insert key | get-or-insert leaky-get-or-insert-slice 16 # stop | get-or-stop get-slice-or-stop 17 # return null | maybe-get maybe-get-slice 18 # Some variants may take extra args. 19 20 == code 21 # instruction effective address register displacement immediate 22 # . op subop mod rm32 base index scale r32 23 # . 1-3 bytes 3 bits 2 bits 3 bits 3 bits 3 bits 2 bits 2 bits 0/1/2/4 bytes 0/1/2/4 bytes 24 25 # if no row is found, abort 26 # type string_key = (addr array byte) 27 get: # table: (addr stream {string_key, T}), key: string_key, row-size: int, abort-message-prefix: (addr array byte) -> eax: (addr T) 28 # pseudocode: 29 # curr = table->data 30 # max = &table->data[table->write] 31 # while curr < max 32 # if string-equal?(key, *curr) 33 # return curr+4 34 # curr += row-size 35 # abort 36 # 37 # . prologue 38 55/push-ebp 39 89/copy 3/mod/direct 5/rm32/ebp . . . 4/r32/esp . . # copy esp to ebp 40 # . save registers 41 51/push-ecx 42 52/push-edx 43 56/push-esi 44 # esi = table 45 8b/copy 1/mod/*+disp8 5/rm32/ebp . . . 6/r32/esi 8/disp8 . # copy *(ebp+8) to esi 46 # var curr/ecx: (addr string_key) = table->data 47 8d/copy-address 1/mod/*+disp8 6/rm32/esi . . . 1/r32/ecx 0xc/disp8 . # copy esi+12 to ecx 48 # var max/edx: (addr byte) = &table->data[table->write] 49 8b/copy 0/mod/indirect 6/rm32/esi . . . 2/r32/edx . . # copy *esi to edx 50 8d/copy-address 0/mod/indirect 4/rm32/sib 1/base/ecx 2/index/edx . 2/r32/edx . . # copy ecx+edx to edx 51 $get:search-loop: 52 # if (curr >= max) abort 53 39/compare 3/mod/direct 1/rm32/ecx . . . 2/r32/edx . . # compare ecx with edx 54 73/jump-if-addr>= $get:abort/disp8 55 # if (string-equal?(key, *curr)) return curr+4 56 # . eax = string-equal?(key, *curr) 57 # . . pu<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html><head><title>Python: module ranger.fsobject.fsobject</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> </head><body bgcolor="#f0f0f8"> <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading"> <tr bgcolor="#7799ee"> <td valign=bottom> <br> <font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="ranger.html"><font color="#ffffff">ranger</font></a>.<a href="ranger.fsobject.html"><font color="#ffffff">fsobject</font></a>.fsobject</strong></big></big></font></td ><td align=right valign=bottom ><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/home/hut/work/ranger/ranger/fsobject/fsobject.py">/home/hut/work/ranger/ranger/fsobject/fsobject.py</a></font></td></tr></table> <p></p> <p> <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> <tr bgcolor="#ee77aa"> <td colspan=3 valign=bottom> <br> <font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr> <tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td> <td width="100%"><dl> <dt><font face="helvetica, arial"><a href="ranger.shared.html#FileManagerAware">ranger.shared.FileManagerAware</a>(<a href="ranger.shared.html#Awareness">ranger.shared.Awareness</a>) </font></dt><dd> <dl> <dt><font face="helvetica, arial"><a href="ranger.fsobject.fsobject.html#FileSystemObject">FileSystemObject</a>(<a href="ranger.shared.mimetype.html#MimeTypeAware">ranger.shared.mimetype.MimeTypeAware</a>, <a href="ranger.shared.html#FileManagerAware">ranger.shared.FileManagerAware</a>) </font></dt></dl> </dd> <dt><font face="helvetica, arial"><a href="ranger.shared.mimetype.html#MimeTypeAware">ranger.shared.mimetype.MimeTypeAware</a>(<a href="builtins.html#object">builtins.object</a>) </font></dt><dd> <dl> <dt><font face="helvetica, arial"><a href="ranger.fsobject.fsobject.html#FileSystemObject">FileSystemObject</a>(<a href="ranger.shared.mimetype.html#MimeTypeAware">ranger.shared.mimetype.MimeTypeAware</a>, <a href="ranger.shared.html#FileManagerAware">ranger.shared.FileManagerAware</a>) </font></dt></dl> </dd> </dl> <p> <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> <tr bgcolor="#ffc8d8"> <td colspan=3 valign=bottom> <br> <font color="#000000" face="helvetica, arial"><a name="FileSystemObject">class <strong>FileSystemObject</strong></a>(<a href="ranger.shared.mimetype.html#MimeTypeAware">ranger.shared.mimetype.MimeTypeAware</a>, <a href="ranger.shared.html#FileManagerAware">ranger.shared.FileManagerAware</a>)</font></td></tr> <tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td> <td width="100%"><dl><dt>Method resolution order:</dt> <dd><a href="ranger.fsobject.fsobject.html#FileSystemObject">FileSystemObject</a></dd> <dd><a href="ranger.shared.mimetype.html#MimeTypeAware">ranger.shared.mimetype.MimeTypeAware</a></dd> <dd><a href="ranger.shared.html#FileManagerAware">ranger.shared.FileManagerAware</a></dd> <dd><a href="ranger.shared.html#Awareness">ranger.shared.Awareness</a></dd> <dd><a href="builtins.html#object">builtins.object</a></dd> </dl> <hr> Methods defined here:<br> <dl><dt><a name="FileSystemObject-__init__"><strong>__init__</strong></a>(self, path)</dt></dl> <dl><dt><a name="FileSystemObject-__str__"><strong>__str__</strong></a>(self)</dt><dd><tt>returns a string containing the absolute path</tt></dd></dl> <dl><dt><a name="FileSystemObject-get_description"><strong>get_description</strong></a>(self)</dt></dl> <dl><dt><a name="FileSystemObject-get_permission_string"><strong>get_permission_string</strong></a>(self)</dt></dl> <dl><dt><a name="FileSystemObject-go"><strong>go</strong></a>(self)</dt><dd><tt>enter the directory if the filemanager is running</tt></dd></dl> <dl><dt><a name="FileSystemObject-is_older_than"><strong>is_older_than</strong></a>(self, seconds)</dt><dd><tt>returns whether this object wasn't <a href="#FileSystemObject-use">use</a>()d in the last n seconds</tt></dd></dl> <dl><dt><a name="FileSystemObject-load"><strong>load</strong></a>(self)</dt><dd><tt>reads useful information about the filesystem-object from the<br> filesystem and caches it for later use</tt></dd></dl> <dl><dt><a name="FileSystemObject-load_if_outdated"><strong>load_if_outdated</strong></a>(self)</dt><dd><tt>Calls <a href="#FileSystemObject-load">load</a>() if the currently cached information is outdated<br> or nonexistant.</tt></dd></dl> <dl><dt><a name="FileSystemObject-load_once"><strong>load_once</strong></a>(self)</dt><dd><tt>calls <a href="#FileSystemObject-load">load</a>() if it has not been called at least once yet</tt></dd></dl> <dl><dt><a name="FileSystemObject-mark"><strong>mark</strong></a>(self, boolean)</dt></dl> <dl><dt><a name="FileSystemObject-set_mimetype"><strong>set_mimetype</strong></a>(self)</dt><dd><tt>assign attributes such as self.<strong>video</strong> according to the mimetype</tt></dd></dl> <dl><dt><a name="FileSystemObject-use"><strong>use</strong></a>(self)</dt><dd><tt>mark the filesystem-object as used at the current time</tt></dd></dl> <hr> Data and other attributes defined here:<br> <dl><dt><strong>accessible</strong> = False</dl> <dl><dt><strong>audio</strong> = False</dl> <dl><dt><strong>basename</strong> = None</dl> <dl><dt><strong>basename_lower</strong> = None</dl> <dl><dt><strong>container</strong> = False</dl> <dl><dt><strong>content_loaded</strong> = False</dl> <dl><dt><strong>dirname</strong> = None</dl> <dl><dt><strong>document</strong> = False</dl> <dl><dt><strong>exists</strong> = False</dl> <dl><dt><strong>extension</strong> = None</dl> <dl><dt><strong>force_load</strong> = False</dl> <dl><dt><strong>image</strong> = False</dl> <dl><dt><strong>infostring</strong> = None</dl> <dl><dt><strong>islink</strong> = False</dl> <dl><dt><strong>last_used</strong> = None</dl> <dl><dt><strong>loaded</strong> = False</dl> <dl><dt><strong>marked</strong> = False</dl> <dl><dt><strong>media</strong> = False</dl> <dl><dt><strong>mimetype_tuple</strong> = ()</dl> <dl><dt><strong>path</strong> = None</dl> <dl><dt><strong>permissions</strong> = None</dl> <dl><dt><strong>readlink</strong> = None</dl> <dl><dt><strong>runnable</strong> = False</dl> <dl><dt><strong>size</strong> = 0</dl> <dl><dt><strong>stat</strong> = None</dl> <dl><dt><strong>stopped</strong> = False</dl> <dl><dt><strong>tagged</strong> = False</dl> <dl><dt><strong>type</strong> = 'unknown'</dl> <dl><dt><strong>video</strong> = False</dl> <hr> Data descriptors inherited from <a href="ranger.shared.mimetype.html#MimeTypeAware">ranger.shared.mimetype.MimeTypeAware</a>:<br> <dl><dt><strong>__dict__</strong></dt> <dd><tt>dictionary for instance variables (if defined)</tt></dd> </dl> <dl><dt><strong>__weakref__</strong></dt> <dd><tt>list of weak references to the object (if defined)</tt></dd> </dl> <hr> Data and other attributes inherited from <a href="ranger.shared.mimetype.html#MimeTypeAware">ranger.shared.mimetype.MimeTypeAware</a>:<br> <dl><dt><strong>mimetypes</strong> = {}</dl> <hr> Data and other attributes inherited from <a href="ranger.shared.html#FileManagerAware">ranger.shared.FileManagerAware</a>:<br> <dl><dt><strong>fm</strong> = None</dl> </td></tr></table></td></tr></table><p> <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> <tr bgcolor="#55aa55"> <td colspan=3 valign=bottom> <br> <font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr> <tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td> <td width="100%"><strong>BAD_INFO</strong> = None<br> <strong>CONTAINER_EXTENSIONS</strong> = ['rar', 'zip', 'tar', 'gz', 'bz', 'bz2', 'tgz', '7z', 'iso', 'cab']<br> <strong>DOCUMENT_BASENAMES</strong> = ['README', 'TODO', 'LICENSE']<br> <strong>DOCUMENT_EXTENSIONS</strong> = ['pdf', 'doc', 'ppt', 'odt']<br> <strong>T_DIRECTORY</strong> = 'directory'<br> <strong>T_FILE</strong> = 'file'<br> <strong>T_NONEXISTANT</strong> = 'nonexistant'<br> <strong>T_UNKNOWN</strong> = 'unknown'</td></tr></table> </body></html>