Mounting shares in OS X using python and pyobjc - works with OS X 10.8+

mount_shares_better.py

import objc, CoreFoundation, Foundation

class attrdict(dict): 
    __getattr__ = dict.__getitem__
    __setattr__ = dict.__setitem__

NetFS = attrdict()
# Can cheat and provide 'None' for the identifier, it'll just use frameworkPath instead
# scan_classes=False means only add the contents of this Framework
NetFS_bundle = objc.initFrameworkWrapper('NetFS', frameworkIdentifier=None, frameworkPath=objc.pathForFramework('NetFS.framework'), globals=NetFS, scan_classes=False)

# https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/ObjCRuntimeGuide/Articles/ocrtTypeEncodings.html
# Fix NetFSMountURLSync signature
del NetFS['NetFSMountURLSync']
objc.loadBundleFunctions(NetFS_bundle, NetFS, [('NetFSMountURLSync', 'i@@@@@@o^@')])

def mount_share(share_path):
    # Mounts a share at /Volumes, returns the mount point or raises an error
    sh_url = CoreFoundation.CFURLCreateWithString(None, share_path, None)
    # Set UI to reduced interaction
    open_options  = {NetFS.kNAUIOptionKey: NetFS.kNAUIOptionNoUI}
    # Allow mounting sub-directories of root shares
    mount_options = {NetFS.kNetFSAllowSubMountsKey: True}
    # Mount!
    result, output = NetFS.NetFSMountURLSync(sh_url, None, None, None, open_options, mount_options, None)
    # Check if it worked
    if result != 0:
         raise Exception('Error mounting url "%s": %s' % (share_path, output))
    # Return the mountpath
    return str(output[0])

def mount_share_at_path(share_path, mount_path):
    # Mounts a share at the specified path, returns the mount point or raises an error
    sh_url = CoreFoundation.CFURLCreateWithString(None, share_path, None)
    mo_url = CoreFoundation.CFURLCreateWithString(None, mount_path, None)
    # Set UI to reduced interaction
    open_options  = {NetFS.kNAUIOptionKey: NetFS.kNAUIOptionNoUI}
    # Allow mounting sub-directories of root shares
    # Also specify the share should be mounted directly at (not under) mount_path
    mount_options = {
                     NetFS.kNetFSAllowSubMountsKey: True,
                     NetFS.kNetFSMountAtMountDirKey: True,
                    }
    # Mount!
    result, output = NetFS.NetFSMountURLSync(sh_url, mo_url, None, None, open_options, mount_options, None)
    # Check if it worked
    if result != 0:
         raise Exception('Error mounting url "%s" at path "%s": %s' % (share_path, mount_path, output))
    # Return the mountpath
    return str(output[0])

def mount_share_with_credentials(share_path, username, password):
    # Mounts a share at /Volumes, returns the mount point or raises an error
    # Include username and password as parameters, not in the share_path URL
    sh_url = CoreFoundation.CFURLCreateWithString(None, share_path, None)
    # Set UI to reduced interaction
    open_options  = {NetFS.kNAUIOptionKey: NetFS.kNAUIOptionNoUI}
    # Allow mounting sub-directories of root shares
    mount_options = {NetFS.kNetFSAllowSubMountsKey: True}
    # Mount!
    result, output = NetFS.NetFSMountURLSync(sh_url, None, username, password, open_options, mount_options, None)
    # Check if it worked
    if result != 0:
         raise Exception('Error mounting url "%s": %s' % (share_path, output))
    # Return the mountpath
    return str(output[0])

def mount_share_at_path_with_credentials(share_path, mount_path, username, password):
    # Mounts a share at the specified path, returns the mount point or raises an error
    # Include username and password as parameters, not in the share_path URL
    sh_url = CoreFoundation.CFURLCreateWithString(None, share_path, None)
    mo_url = CoreFoundation.CFURLCreateWithString(None, mount_path, None)
    # Set UI to reduced interaction
    open_options  = {NetFS.kNAUIOptionKey: NetFS.kNAUIOptionNoUI}
    # Allow mounting sub-directories of root shares
    # Also specify the share should be mounted directly at (not under) mount_path
    mount_options = {
                     NetFS.kNetFSAllowSubMountsKey: True,
                     NetFS.kNetFSMountAtMountDirKey: True,
                    }
    # Mount!
    result, output = NetFS.NetFSMountURLSync(sh_url, mo_url, username, password, open_options, mount_options, None)
    # Check if it worked
    if result != 0:
         raise Exception('Error mounting url "%s" at path "%s": %s' % (share_path, mount_path, output))
    # Return the mountpath
    return str(output[0])

Will this mount local shares?

In the past i've often had the need to mount a smb volume with the "no browse" flag set, this prevents it from showing up in the finder side bar and prevents the share from showing on the Desktop, however the share is still fully accessible from the CLI.

i was able to achieve this using: mount_smbfs -o no browse

I managed to find a similar key in NetFS:

kNetFSMountFlagsKey:

The value of this key needs to be the value of MNT_DONTBROWSE which according to the mount.h file (https://opensource.apple.com/source/xnu/xnu-2050.7.9/bsd/sys/mount.h)

is: 0x00100000

So if we do:

mount_options = {
                     NetFS.kNetFSAllowSubMountsKey: True,
                     NetFS.kNetFSMountFlagsKey: 0x00100000,
                     }

Then we get the share mounting in the no browse mode :)

$ mount
/dev/disk0s2 on / (hfs, local, journaled)
//[email protected]/Share_Name on /Volumes/Share_Name (smbfs, nodev, nosuid, nobrowse, mounted by username)

This seems to be broken when run in a recently released preview OS. It complains about open_options = {NetFS.kNAUIOptionKey: NetFS.kNAUIOptionNoUI}. KeyError: 'kNAUIOptionNoUI'

Hidden Mount Sierra:
mount_options = { NetFS.kNetFSAllowSubMountsKey: True, NetFS.kNetFSMountFlagsKey: 0x00100000 }
Hidden Mount High Sierra:
mount_options = { ' AllowSubMounts': True, 'MountFlags': 0x00100000 }

Some changes need to be made to get this working with Python 3. Specifically the way the username and password is passed for the authenticated mounts - it needs to be sent as a "real" NSString (thanks @pudquick for the pointer in Macadmins Slack).

Add:
from Foundation import NSString

Change:

objc.loadBundleFunctions(
    NetFS_bundle, NetFS, [('NetFSMountURLSync', 'i@@@@@@o^@')])

to:

objc.loadBundleFunctions(
    NetFS_bundle, NetFS, [('NetFSMountURLSync', b'i@@@@@@o^@')])

And wherever a user/pass string is passed in:
NSString.alloc().initWithString_('string_to_convert')

@pudquick just wondering if you've revisited this given some deprecations that are going to happen in PyObjC 9:

/usr/local/bin/redlands/mount_shares.py:24: DeprecationWarning: This function will be removed in PyObjC 9, switch to the modern metadata system
  NetFS_bundle = objc.initFrameworkWrapper('NetFS',  frameworkIdentifier=None, frameworkPath=objc.pathForFramework('NetFS.framework'), 1globals=NetFS, scan_classes=False)

Thanks @pudquick for the chat over Slack about the changes that will be upcoming to PyObjC 9.

For anyone else using this, you should be able to comment out these lines and simply replace it all with import NetFS and have it work...
(tested against PyObjC v7.3).

# class attrdict(dict):
#     __getattr__ = dict.__getitem__
#     __setattr__ = dict.__setitem__
# 
# 
# NetFS = attrdict()
# # Can cheat and provide 'None' for the identifier,
# # it'll just use frameworkPath instead
# # scan_classes=False means only add the contents of this Framework
# NetFS_bundle = objc.initFrameworkWrapper('NetFS',
#                                          frameworkIdentifier=None,
#                                          frameworkPath=objc.pathForFramework(
#                                              'NetFS.framework'),
#                                          globals=NetFS,
#                                          scan_classes=False)
# # NetFS_bundle = objc.ObjCLazyModule('NetFS', None, objc.pathForFramework('NetFS.framework'))
# 
# # https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/ObjCRuntimeGuide/Articles/ocrtTypeEncodings.html
# # Fix NetFSMountURLSync signature
# del NetFS['NetFSMountURLSync']
# objc.loadBundleFunctions(NetFS_bundle, NetFS, [('NetFSMountURLSync', b'i@@@@@@o^@')])