No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
resources
scripts
README.md

README.md

Script to release Python packages used for ROS

Setup

The following dependencies need to be installed before being able to run the ros_release_python script:

  • Install dput:
    • sudo apt-get install dput
  • Install apt-file:
    • sudo apt-get install apt-file
    • and run:
    • sudo apt-file update
  • Install setuptools:
    • sudo apt-get install python-setuptools python3-setuptools
  • Install Python "all":
    • sudo apt-get install python-all python3-all
  • Install PIP:
    • sudo apt-get install python-pip python3-pip
  • Install up-to-date setuptools via PIP (if necessary):
  • Install stdeb (0.8.4 or higher) via PIP:
    • sudo pip install [--upgrade] stdeb
    • sudo pip3 install [--upgrade] stdeb
    • Do not use the Debian packages on Wily and newer. They will embed a newer Python dependency into the control file (2.7.5, 3.3.2) which breaks the package on older distributions like Precise.
  • Install twine via PIP:
    • sudo pip3 install [--upgrade] twine

Note: Make sure pip is for Python2, because sometimes when you install pip for Python3 (like on precise) it overwrites pip as pip for Python3. You can explicitly invoke pip from Python2 like this:

$ sudo python -c "from pkg_resources import load_entry_point; load_entry_point('pip', 'console_scripts', 'pip')()" install -U stdeb

Or with Python3 like this:

$ sudo python3 -c "from pkg_resources import load_entry_point; load_entry_point('pip', 'console_scripts', 'pip')()" install -U stdeb

Prepare a Python package

The Python package needs a stdeb.cfg file beside the setup.py file.

Release a Python package

Invoke scripts/ros_release_python in the root folder of the Python package to ensure that the packages can be built. If this succeeds invoke the same command with the --upload argument to actually push the packages to the servers.

Release a Python package only into new suites

Invoke scripts/ros_release_python --include --upload in the root folder of the Python package.

Sync into building / testing / main repos

This tool only uploads the generated Debian packages into the bootstrap repository. To make the packages available in the building / testing / main repos the Jenkins job to "import upstream" must be run.