1BLOOM(1)                             bloom                            BLOOM(1)
2
3
4

NAME

6       bloom - bloom Documentation
7

WHAT IS BLOOM?

9       Bloom  is  a release automation tool, designed to make generating plat‐
10       form specific release artifacts from source projects easier.  Bloom  is
11       designed  to  work  best with catkin projects, but can also accommodate
12       other types of projects.
13

HOW DOES IT WORK?

15       Bloom works by importing your upstream source tree into a  git  reposi‐
16       tory,  where it is manipulated and used to generate build artifacts for
17       different platforms like Debian or Fedora.
18
19       First bloom gathers information about your source repository  and  cre‐
20       ates  an  archive for the version you want to release. Then the archive
21       is imported into the release repository, and the  source  tree  is  run
22       through  a  release  track  where it is tagged, can be patched, and has
23       platform specific artifacts generated for it.
24
25       The individual stages of these release tracks are tagged with  git  and
26       those tags are used by build infrastructure and deployment systems.
27

WHAT CAN I RELEASE WITH BLOOM?

29       Bloom  supports releasing arbitrary software packages, but is optimized
30       for use with catkin projects.
31
32       NOTE:
33          For dry ROS stacks, you should use the legacy ros-release system.
34

HOW DO I INSTALL BLOOM?

36       On Ubuntu the recommended method is to use apt:
37
38          $ sudo apt-get install python-bloom
39
40       On other systems you can install bloom via pypi:
41
42          $ sudo pip install -U bloom
43
44       Note: pip will not notify you of updates, but  bloom  will  notify  you
45       when you are using a version of bloom that is not the latest released.
46
47       Develop and build from source:
48
49          $ python setup.py build
50          $ sudo python setup.py develop
51

HOW DO I RELEASE SOMETHING WITH BLOOM?

53       Please  refer  to the documentation and tutorials on the bloom ROS wiki
54       page.
55

AUTHOR

57       William Woodall
58

60       2022, Open Source Robotics Foundation
61
62
63
64
650.4                              Apr 21, 2022                         BLOOM(1)
Impressum