项目作者: althonos

项目描述 :
Pyfilesystem2 over SMB using pysmb
高级语言: Python
项目地址: git://github.com/althonos/fs.smbfs.git
创建时间: 2017-08-14T19:06:16Z
项目社区:https://github.com/althonos/fs.smbfs

开源协议:MIT License

下载


fs.smbfs star me

Source
PyPI
Actions
Codecov
Codacy
License
Versions
Format
GitHub issues
Downloads
Changelog

Requirements

PyFilesystem2 PyPI fs Source fs License fs
six PyPI six Source six License six
PySMB PyPI pysmb Source pysmb License pysmb

Installation

Install directly from PyPI, using pip :

  1. $ pip install fs.smbfs

Usage

Opener

Use fs.open_fs to open a filesystem with an SMB FS
URL
:

  1. import fs
  2. smb_fs = fs.open_fs('smb://username:password@SAMBAHOSTNAME:port/share')

The opener can use either an IPv4 address or a NetBIOS hostname, using the
NetBIOS name service to
find the other token. Otherwise, if NetBIOS is not available, a new SMB
connection can be established by using the IPv4 address and giving the
hostname with the hostname URL parameter.

The following parameters can be passed as URL parameters: timeout,
name-port, direct-tcp, hostname, and domain.

Constructor

  1. import fs.smbfs
  2. smb_fs = fs.smbfs.SMBFS(
  3. host, username="guest", passwd="", timeout=15,
  4. port=139, name_port=137, direct_tcp=False, domain=""
  5. )

with each argument explained below:

  • host: either the host name (not the FQDN)
    of the SMB server, its IP address, or both in a tuple.
    If either the IP address or the host name is not given, NETBIOS is queried to get the missing data.
  • user: the username to connect with, defaults to "guest" for anonymous
    connection.
  • passwd: an optional password to connect with, defaults to "" for
    anonymous connection.
  • timeout: the timeout, in seconds, for NetBIOS and TCP requests.
  • port: the port the SMB server is listening on.
  • name_port: the port the NetBIOS naming service is listening on.
  • direct_tcp: set to True if the server is accessible directly
    through TCP, leave as False for maximum compatibility.
  • domain: the network domain to connect with, i.e. the workgroup on
    Windows. Usually safe to leave as empty string, the default.

Once created, the SMBFS filesystem behaves like any other filesystem
(see the Pyfilesystem2 documentation),
except if it was open in the root directory of the server, in which case the
root directory of the SMBFS instance will be read-only (since SMB clients
cannot create new shares).

Feedback

Found a bug ? Have an enhancement request ? Head over to the GitHub
issue tracker
of the
project if you need to report or ask something. If you are filling in on
a bug, please include as much information as you can about the issue,
and try to recreate the same bug in a simple, easily reproducible
situation.

Credits

fs.smbfs is developed and maintained by:

The following people contributed to fs.sshfs:

This project obviously owes a lot to the PyFilesystem2 project and
all its contributors.

See also

  • fs, the core
    Pyfilesystem2 library
  • fs.archive, enhanced
    archive filesystems for Pyfilesystem2
  • fs.sshfs, Pyfilesystem2 over
    SSH using paramiko