Packaging GOGS
==============

Trying to package GOGS/Gitea for Debian-main turned out to be a huge mistake. It
is a moving target with a development team that is more concerned about features
over stability, security, and/or documentation.

This page documents my efforts, which were ultimately in vain.

Create on Alioth
----------------

.. code-block:: sh

   ssh git.debian.org "/git/pkg-go/setup-repository golang-github-gogits-cron 'Packaging for golang-github-gogits-cron'"

Initial Packaging
-----------------

.. code-block:: text

   dh-make-golang -t library github.com/gogits/cron
   vim itp-golang-github-gogits-cron.txt
     License: MIT => Expat
     Description: improvify
   sudo sendmail -t < itp-golang-github-gogits-cron.txt
   rm itp-golang-github-gogits-cron.txt
   cd golang-github-gogits-cron
   vim debian/control
     Standards-Version: 3.9.8
     Vcs-Git: https://<line_above>
     Description: improvify
   grep -i copyright . -R
   vim copyright
     TODO -> Expat
     MIT => Expat *ALWAYS*
     Add anything that isn't an exact match.
   vim debian/changelog
     TODO -> <itp>
     Include '#' in bug number
   echo README.md > debian/docs
   git add debian
   git commit -a -m 'Initial packaging'
   pristine-tar commit ../golang-github-gogits-cron_0.0~git20160810.32.7f3990a.orig.tar.xz

Test Build
----------

.. code-block:: sh

   build-unstable

Push to Alioth
--------------

.. code-block:: sh

   git push git+ssh://git.debian.org/git/pkg-go/packages/golang-github-gogits-cron.git --tags master pristine-tar upstream


To strip binaries
-----------------

debian/rules::

    override_dh_auto_install:
    	dh_auto_install
    	# Binary files need more love before being fit for distribution
    	$(RM) -r $(CURDIR)/debian/$(shell dh_listpackages)/usr/bin


To disable tests
----------------

debian/rules::

    # Tests attempt to reach out to web services.
    override_dh_auto_test:

See ``golang-github-jaytaylor-html2text`` about a patch that can make tests work.


misc
----

.. code-block:: sh

   git commit -am 'Finalize d/changelog for release'

Upload new revision
-------------------

If upstream does not create release tarballs::

   # Use dh-make-golang to grab a new .tar.xz
   gbp import-orig # will auto-gen new revision
   pristine-tar commit
   dch -v <new revision>-1
   build-unstable --git-pbuilder-options=--source-only-changes
     # Or  SOURCE_ONLY_CHANGES=yes  in ~/.pbuilderrc
   gbp buildpackage --git-tag --git-tag-only
   git push --all
   git push --tags

for a specific branch::

   https://github.com/gopherjs/gopherjs/commits/go1.7
   dh-make-golang -type library -git_revision d5c6ba6916a7 github.com/gopherjs/gopherjs
   pristine-tar commit ../*xz
   git branch -l upstream-go1.7 upstream
   gbp import-orig --upstream-branch=upstream-go1.7 ../golang-github-gopherjs-gopherjs_0.0~git20170216.0.d5c6ba6.orig.tar.xz
   build-unstable --git-upstream-branch=upstream-go1.7


dfsg
----

(probably documented elsewhere)::

   Files-Excluded: in header of d/copyright
   build-unstable; ^c # just need *.xz
   mk-origtargz --compression xz ../golang-github-gogits-chardet_0.0~git20150115.0.2404f77.orig.tar.xz
   mv ../<foo>.orig.tar.xz ../<foo>+dfsg.orig.tar.xz
   pristine-tar commit ../*+dfsg.orig.tar.xz
   git branch -l upstream+dfsg upstream
   gbp import-orig --upstream-branch=upstream+dfsg ../*+dfsg.orig.tar.xz
   dch -e
   build-unstable --git-upstream-branch=upstream+dfsg


checklist
----------

.. code-block:: sh

   pristine-tar
   d/docs
   copyright headings
   license
   extra license files
   name
   match name on bsd-3-clause and apache-2.0
   dch -r
   git tag

sbuild
------

https://wiki.debian.org/sbuild

.. code-block:: sh

   apt-get install sbuild
   sbuild-adduser michael
   sbuild-createchroot --include=eatmydata,ccache,gnupg unstable /srv/chroot/unstable-amd64-sbuild http://httpredir.debian.org/debian
   sbuild-createchroot --include=eatmydata,ccache,gnupg testing /srv/chroot/testing-amd64-sbuild http://httpredir.debian.org/debian

ratt
----

requires sbuild

.. code-block:: sh

   ratt -sbuild_dist testing golang-go.crypto_0.0~git20170407.0.55a552f-1_amd64.changes

misc
----

.. code-block:: sh

   grep-dctrl -FBuild-Depends golang-go.crypto-dev -sPackage /var/lib/apt/lists/*Sources