Steps to Follow to Run the Unit Tests

Step 1: Install system dependencies

If you are using Ubuntu 20.04 LTS, you can install the system dependencies with the following command

$> apt-get install python3-dev python3-venv gcc g++ make automake autoconf

For other distributions, you can use their package managers and install the system dependencies (although the package names might differ slightly).

Step 2: Setup python virtualenv

We will create a python3 virtualenv and install the python dependencies for testing in the "venv3" folder.

$> cd <pysmb-home>/python3
$> virtualenv -p /usr/bin/python3 venv3
$> source venv3/bin/activate
$venv3> pip install nose2 pyasn1 twisted

Step 3: Setup shared folder on your remote SMB server

Prepare a shared folder called "smbtest" on your remote SMB server (Windows or Samba).

Then, download smbtest.zip and unzip the contents of this zip file in the shared folder.

You should also configure a user on the SMB server with read-write access to the "smbtest" folder.

Step 4: Update connection details in connection.ini

In the same folder where you are viewing this readme file, there should be an ini file called "connection.ini". Edit this file's connection details to match the shared folder's access information.

Step 5: Run the unit tests in the python3 folder

Before running the tests, the venv3 virtualenv must be activated.

$> cd <pysmb-home>/python3
$> source venv3/bin/activate

To run all the tests:

    $venv3> nose2 -v tests

To selectively run some tests:

    $venv3> nose2 -v tests.SMBConnectionTests
    $venv3> nose2 -v tests.SMBConnectionTests.test_rename
    $venv3> nose2 -v tests.SMBConnectionTests.test_rename.test_rename_english_file_SMB1

For more information, please consult the documentation for nose2.