Skip to content

Latest commit

 

History

History
105 lines (86 loc) · 3.49 KB

pypi_release_steps.md

File metadata and controls

105 lines (86 loc) · 3.49 KB

PYPI Test mssql-scripter upload

Requirements:

  1. Create and Register a user account on testpypi at test pypi

  2. Add <clone_root> to your PYTHONPATH environment variable:

    Windows
    set PYTHONPATH=<clone_root>;%PYTHONPATH%
    OSX/Ubuntu (bash)
    export PYTHONPATH=<clone_root>:${PYTHONPATH}

  3. Install the dependencies:

    python <clone_root>/dev_setup.py clean

Bump Version

Versioning schema: {major}.{minor}.{patch}{release}{release_version}	
Example: 1.0.0a0

To bump a particular segment of the version, from <clone_root> execute:

bumpversion major              ->  2.0.0a0
bumpversion minor              ->  1.1.0a0
bumpversion patch              ->  1.0.1a0
bumpversion release            ->  1.0.0rc0
bumpversion release_version    ->  1.0.0a1

Note: bumpversion does not allow version bumping if your workspace has pending changes.This is to protect against any manual updates that may have been made which can lead to inconsistent versions across files. If you know what you are doing you can override this by appending --allow-dirty to the bumpversion command.

Build

  1. Clean distribution folders:

    Windows
    rmdir /s dist
    OSX/Ubuntu (bash)
    rm -rf dist

  2. Build mssql-scripter platform wheels and verify readme.rst, From <clone_root> execute:

    python build.py

    Build a OS-Specific wheel:

    python build.py build win32
python build.py build win_amd64
python build.py build macosx_10_11_intel
python build.py build manylinux1_x86_64

  3. Add a .pypirc configuration file:

    • Create a .pypirc file in your user directory:

      Windows:

        Example: C:\Users\bob\.pypirc

      MacOS/Linux:

        Example: /Users/bob/.pypirc

    • Add the following content to the .pypirc file, replace your_username and your_passsword with your account information created from step 1:

      [distutils]
index-servers=
    pypitest
 
[pypitest]
repository = https://test.pypi.org/legacy/
username = your_username
password = your_password

  4. Upload to pypi test server:

    python register_upload.py upload pypitest

  5. Test install locally

    To install the local mssql-scripter wheel package, from <clone_root> execute:

    sudo pip install --no-index -i ./dist/mssql_scripter-1.0.0a1-py2.py3-none-win32.whl

  6. Test install via pypi server:

    Note: Specifying the test pypi server as the index to search for, pip will attempt to search for mssql-scripter's dependencies from the same server. This can result in a requirement not found error, but should not be a problem if dev_setup.py was ran during developer setup. If the error does occur, manually pip install the dependencies that are listed in setup.py and ensure the versions are correct.

    Install the mssql-scripter package that was just uploaded:

    pip install -i https://testpypi.python.org/pypi mssql-scripter

    Upgrade to the mssql-scripter that was uploaded:

    pip install --upgrade -i https://testpypi.python.org/pypi mssql-scripter