Skip to content
Snippets Groups Projects
PKG-INFO 6.79 KiB
Metadata-Version: 1.0
Name: pidp.tools
Version: 1.6.2
Summary: PETRA III Debian Package Tools
Home-page: https://stash.desy.de/projects/JMK/repos/pidptools/browse/
Author: Jan Kotanski
Author-email: jankotan@gmail.com
License: GNU GENERAL PUBLIC LICENSE v3
Description: =========================================
        Welcome to Petra III Debian Package Tools
        =========================================
        
        
        Authors: Jan Kotanski
        
        The package contains pidp* scripts to create debian packages
        with use of git-buildpackage and the PIDP stash repository at DESY.
        
        
        | Source code: https://stash.desy.de/projects/JMK/repos/pidptools/browse
        | Web page: https://stash.desy.de/projects/JMK/repos/pidptools/browse
        
        
        ---------
        Use cases
        ---------
        
        Below there are pointed out the most common use cases
        
        
        Update the debian package configuration
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        1) Clone the repository of required project, e.g.
        
        .. code-block:: console
        
        	  $ pidpclone python-tools-extras-p09
        
        2) Change the package configuration in the debian/ directory
           by editing its files
        
        3) Commit your changes, .e.g.
        
        .. code-block:: console
        
        	  $ git commit -a -m 'update dependences'
        
        4) Build the new package, e.g.
        
        .. code-block:: console
        
        	  $ pidpbuild
        
        5) test your new package
        
        6) if tests are successful push it into stash repo, e.g.
        
        .. code-block:: console
        
        	  $ pidppush python-tools-extras-p09
        
        
        Add a patch into the existing debian package
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        1) Clone the repository of required project in the patch mode, e.g.
        
        .. code-block:: console
        
        	  $ pidpclone python-tools-extras-p09 --patch
        
        2) Edit source files in the current and below directories
        
        3) Commit your changes, .e.g.
        
        .. code-block:: console
        
        	  $ git commit -a -m 'update dependences'
        
        4) Build the new package, e.g.
        
        .. code-block:: console
        
        	  $ pidpbuild
        
        5) test your new package
        
        6) if tests are successful push it into stash repo, e.g.
        
        .. code-block:: console
        
        	  $ pidppush python-tools-extras-p09
        
        
        Create a package from a new tarball
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        1) Clone the repository of required project in the patch mode, e.g.
        
        .. code-block:: console
        
        	  $ pidpclone python-tools-extras-p09 --patch
        
        2) Edit source files in the current and below directories
        
        3) Commit your changes, .e.g.
        
        .. code-block:: console
        
        	  $ git commit -a -m 'update dependences'
        
        4) Build the new package with the tarball argument, e.g.
        
        .. code-block:: console
        
        	  $ pidpbuild ../nexdatas.extrasp09-1.2.4.tar.gz
        
        5) if built fails due to conflicts between existing patches
            and the new tarball
            a) fix the conflict by editing the affected files
            b) stage the changes, e.g.
        
            	      $ git add nxsextrasp09/__init__.py
        
            c) continue building process by calling:
        
            	      $ pidpbuild_continue
        
        6) test your new package
        
        7) if tests are successful push it into stash repo, e.g.
        
        .. code-block:: console
        
        	  $ pidppush python-tools-extras-p09
        
        
        Create a package from a new tarball with an additional patch
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        1) Clone the repository of required project, e.g.
        
        .. code-block:: console
        
        	  $ pidpclone python-tools-extras-p09
        
        2) Change the package configuration in the debian/ directory
           by editing its files (if it is needed)
        
        3) Commit your changes, .e.g.
        
        .. code-block:: console
        
        	  $ git commit -a -m 'update dependences'
        
        4) Build the new package with the tarball argument, e.g.
        
        .. code-block:: console
        
        	  $ pidpbuild ../nexdatas.extrasp09-1.2.4.tar.gz
        
        5) if built fails due to conflicts between existing patches
            and the new tarball
            a) fix the conflict by editing the affected files
            b) stage the changes, e.g.
        
            	      $ git add nxsextrasp09/__init__.py
        
            c) continue building process by calling:
        
            	      $ pidpbuild_continue
        
        6) test your new package
        
        7) if tests are successful push it into stash repo, e.g.
        
        .. code-block:: console
        
        	  $ pidppush python-tools-extras-p09
        
        
        ------------
        Installation
        ------------
        
        Install the dependencies:
        
            git-buildpackage, python
        
        From sources
        ^^^^^^^^^^^^
        
        Download the latest version of NeXuS Configuration Server from
        
        |     	  https://stash.desy.de/projects/JMK/repos/pidptools/browse
        
        Extract the sources and run for both packages
        
        .. code-block:: console
        
        	  $ python setup.py install
        
        
        Debian packages
        ^^^^^^^^^^^^^^^
        
        Debian Stretch (and Jessie, Wheezy) packages can be found in the HDRI repository.
        
        To install the debian packages, add the PGP repository key
        
        .. code-block:: console
        
        	  $ sudo su
        	  $ wget -q -O - http://repos.pni-hdri.de/debian_repo.pub.gpg | apt-key add -
        
        and then download the corresponding source list
        
        .. code-block:: console
        
        	  $ cd /etc/apt/sources.list.d
        	  $ wget http://repos.pni-hdri.de/stretch-pni-hdri.list
        
        for stretch or
        
        .. code-block:: console
        
        	  $ cd /etc/apt/sources.list.d
        	  $ wget http://repos.pni-hdri.de/jessie-pni-hdri.list
        
        for jessie.
        
        
        Finally,
        
        .. code-block:: console
        
        	  $ apt-get update
        	  $ apt-get install pidptools
        
Keywords: gbp git stash desy debian package hasylab fs-ec
Platform: Linux Debian