httpie-cli/docs/packaging/linux-gentoo/README.md
Mickaël Schoentgen 7989e438d2
Add documentation about our release process (#1159)
* Add documentation about our release process

* Fixes

* Add company-related tasks, enable back WIP pages

* Fix WIP links

* Add AOSC OS

* Add WIP for AOSC OS

* Tweak

* Remove maintainers email IDs

* Use GH nicknames

* Remove useless WIP for brew

* Tweaks
2021-10-06 16:45:44 +02:00

2.3 KiB

HTTPie on Gentoo

Welcome to the documentation about packaging HTTPie for Gentoo.

  • If you do not know HTTPie, have a look here.
  • If you are looking for HTTPie installation or upgrade instructions on Gentoo, then you can find them on that page.
  • If you are looking for technical information about the HTTPie packaging on Gentoo, then you are in a good place.

About

This document contains technical details, where we describe how to create a patch for the latest HTTPie version for Gentoo. We will discuss setting up the environment, installing development tools, installing and testing changes before submitting a patch downstream.

Overall process

Open a pull request to create httpie-XXX.ebuild and update Manifest.

  • Here is how to calculate the size and checksum (replace 2.5.0 with the correct version):

    # Download
    $ wget https://github.com/httpie/httpie/archive/2.5.0.tar.gz
    
    # Size
    $ stat --printf="%s\n" 2.5.0.tar.gz
    1105177
    
    # Checksum
    $ openssl dgst -blake2b512 2.5.0.tar.gz
    BLAKE2b512(2.5.0.tar.gz)= 6e16868c81522d4e6d2fc0a4e093c190f18ced720b35217930865ae3f8e168193cc33dfecc13c5d310f52647d6e79d17b247f56e56e8586d633a2d9502be66a7
    
  • The commit message must be net-misc/httpie: version bump to XXX.

  • The commit must be signed-off (git commit -s).

Hacking

Launch the docker image:

docker pull gentoo/stage3
docker run -it --rm gentoo/stage3

From inside the container:

# Install tools
emerge --sync
emerge pkgcheck repoman

# Go to the package location
cd /var/db/repos/gentoo/net-misc/httpie

# Retrieve the patch of the latest HTTPie version
# (only files that were modified since the previous release)
curl https://raw.githubusercontent.com/httpie/httpie/master/docs/packaging/linux-gentoo/httpie-XXX.ebuild \
  -o httpie-XXX.ebuild
curl https://raw.githubusercontent.com/httpie/httpie/master/docs/packaging/linux-gentoo/Manifest \
  -o Manifest
curl https://raw.githubusercontent.com/httpie/httpie/master/docs/packaging/linux-gentoo/metadata.xml \
  -o metadata.xml

# Basic checks
repoman manifest
repoman full -d -x
pkgcheck scan

# Build and install the package
emerge --with-test-deps httpie-XXX.ebuild

# Run the tests suite
ebuild httpie-XXX.ebuild clean test

# And test it!
http --version
https --version