X-Git-Url: https://git.phdru.name/?p=extfs.d.git;a=blobdiff_plain;f=obexftp;h=7b34288d3028f3b4deb60c78feed12bbc126ac56;hp=bfe801e4b8b09e17713b8c465ddef080568efd69;hb=a96601f24ae6fa8c6cca96daedbeee9ecdda89a9;hpb=d6484924badb5aad0fd775ba1d6bcc639b74b87f diff --git a/obexftp b/obexftp index bfe801e..7b34288 100755 --- a/obexftp +++ b/obexftp @@ -1,50 +1,69 @@ #! /usr/local/bin/python -O """ -ObexFTP VFS for Midnight Commander. Manipulate a cell phone's filesystem using obexftp. +ObexFTP Virtual FileSystem for Midnight Commander. Author: Oleg BroytMann . Copyright (C) 2004 PhiloSoft Design. License: GPL. +Manipulate a cell phone's filesystem calling obexftp binary. This is a +complete user-mode solution, no kernel modules required (unlike SieFS or +such). The script implements all commands of Midnight VFS, except for +undocumented "run"; anyway there are no runnable files in the cell phone. The +script is written in Python because I love Python, the best of all languages ;), +and I need to parse XML directory listings from obexftp. + The script requires Midnight Commander 3.1+ (http://www.ibiblio.org/mc/), -Python 2.2+ (http://www.python.org/), OpenOBEX 1.0.1+ (http://openobex.sourceforge.net/) -and ObexFTP 0.10.4+ (http://triq.net/obexftp). +Python 2.2+ (http://www.python.org/), +OpenOBEX 1.0.1+ (http://openobex.sourceforge.net/) and +ObexFTP 0.10.4+ (http://triq.net/obexftp). -Edit the full path to the obexftp binary (see below). Put the file to the -/usr/[local/]lib/mc/extfs, and add a line "obexftp" to the -/usr/[local/]lib/mc/extfs/extfs.ini. Then create somewhere a transport file. +Edit the script, and correct the shebang path, if your python is not in the +/usr/local. Edit the full path to the obexftp binary (see below). Put the file +in the /usr/[local/]lib/mc/extfs, and add a line "obexftp" to the +/usr/[local/]lib/mc/extfs/extfs.ini. -The transport file can have any name, and is expected to be a text file with at -least one line defining the transport to your device. Other lines in the file -are ignored. +Create somewhere a transport file. The transport file may have any name, and +is expected to be a text file with at least one line defining the transport to +your device. Other lines in the file are ignored. -First word in the line is a transport name - Bluetooth, IrDA or TTY. The name +First word in the line is a transport name - Bluetooth, TTY or IrDA. The name is case-insensitive. For the Bluetooth transport put there a line "Bluetooth CP:AD:RE:SS channel", -where CP:AD:RE:SS is the hardware address of the device you want to connect to, -and channel is the OBEX File Transfer channel; you can discover the address and -the channel for your device by using commands like "hcitool scan" and "sdptool -browse". - -For the TTY put a device name: "tty /dev/rfcomm0". - -The content with the IrDA just put "IrDA" in the file. - -Now run this "cd" command in the Midnight Commander (in the "bindings" files -the command is "%cd"): cd description#obexftp. The VFS script uses obexftp to -connect to the device and list files and directories. Plese be warned that -opening the VFS for the first time is VERY slow, because the script needs to -scan the entire cell phone's filesystem. And there must be a timeout between -connections, which doesn't make the scanning process faster. Midnight Commander -caches the result, so you can browse directories quickly. +where CP:AD:RE:SS is the hardware address of the device you want to connect +to, and "channel" is the OBEX File Transfer channel; you can discover the +address and the channel for your device by using commands like "hcitool scan" +and "sdptool browse". + +For the TTY put the device name: "tty /dev/ttyUSB0". + +For the IrDA: just put "IrDA" in the file. + +Now run this "cd" command in the Midnight Commander (in the "bindings" file +the command is "%cd"): cd transport#obexftp, where "transport" is the name of +your transport file. The script uses obexftp to connect to the device and list +files and directories. Please be warned that opening the VFS for the first +time is VERY slow, because the script needs to scan the entire cell phone's +filesystem. And there must be timeouts between connections, which don't make +the scanning faster. Midnight Commander caches the result so you can browse +and manipulate files and directories quickly. + +Please note that manipulating the filesystem using your phone's internal +filemanager in parallel with the VFS leads to disagreement between the VFS +cache and the phone. It is not very dangerous but inconvenient. There is no +way to clear the VFS cache in Midnight Commander and reread the filesystem. +You have to exit the VFS (cd /, for example) and return back using cd +transport#obexftp command. Sometimes even this doesn't help - Midnight +Commander shows the same cached VFS image. Exit Midnight Commander and +restart it. """ -__version__ = "0.5.0" -__revision__ = "$Id: obexftp,v 1.6 2004/06/13 21:48:59 phd Exp $" -__date__ = "$Date: 2004/06/13 21:48:59 $"[7:-2] +__version__ = "1.0.2" +__revision__ = "$Id: obexftp,v 1.13 2004/07/27 15:39:54 phd Exp $" +__date__ = "$Date: 2004/07/27 15:39:54 $"[7:-2] __author__ = "Oleg Broytmann " __copyright__ = "Copyright (C) 2004 PhiloSoft Design" @@ -63,23 +82,27 @@ def log_error(msg): sys.stderr.write(msg + '\n') def error(msg): - log_error(msg + '\n') + log_error(msg) sys.exit(1) if len(sys.argv) < 2: error("""\ -It is not a program - it is a VFS for Midnight Commander. -Put it in /usr/lib/mc/extfs.""") +ObexFTP Virtual FileSystem for Midnight Commander version %s +Author: %s +%s +Put it in /usr/lib/mc/extfs. For more information read the source!""" % ( + __version__, __author__, __copyright__ +)) def setup_transport(): """Setup transport parameters for the obexftp program""" transport_file = open(sys.argv[2], 'r') - line = transport_file.readline().strip() + line = transport_file.readline() transport_file.close() - parts = line.split() + parts = line.strip().split() transport = parts[0].lower() if transport == "bluetooth": @@ -89,12 +112,14 @@ def setup_transport(): elif transport == "irda": return "-i" else: - error("Unknown transport '%s'; expected 'bluetooth', 'tty' or 'irda'" % base_filename) + error("Unknown transport '%s'; expected 'bluetooth', 'tty' or 'irda'" % transport) # Parse ObexFTP XML directory listings class DirectoryEntry(object): + """Represent remote files and directories""" + def __init__(self, type): self.type = type self.size = 0 @@ -130,11 +155,11 @@ class DirectoryEntry(object): ) raise ValueError, "unknown type '%s'; expected 'file' or 'folder'" % self.type -def get_entries(dom, tag): +def get_entries(dom, type): entries = [] - for subtag in dom.getElementsByTagName(tag): - entry = DirectoryEntry(tag) - attrs = subtag.attributes + for obj in dom.getElementsByTagName(type): + entry = DirectoryEntry(type) + attrs = obj.attributes for i in range(attrs.length): attr = attrs.item(i) setattr(entry, attr.name, attr.value) @@ -221,20 +246,14 @@ def mcobex_rm(): """Remove a file from the VFS""" obexftp_args = setup_transport() obex_filename = sys.argv[3] - - setup_tmpdir() os.system("%s %s -k '%s' 2>/dev/null" % (obexftp_prog, obexftp_args, obex_filename)) - cleanup_tmpdir() def mcobex_mkdir(): """Create a directory in the VFS""" obexftp_args = setup_transport() obex_dirname = sys.argv[3] - - setup_tmpdir() os.system("%s %s -C '%s' 2>/dev/null" % (obexftp_prog, obexftp_args, obex_dirname)) - cleanup_tmpdir() mcobex_rmdir = mcobex_rm