httpie-cli/docs/packaging/linux-alpine
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
..
APKBUILD Add documentation about our release process (#1159) 2021-10-06 16:45:44 +02:00
README.md Add documentation about our release process (#1159) 2021-10-06 16:45:44 +02:00

HTTPie on Alpine Linux

Welcome to the documentation about packaging HTTPie for Alpine Linux.

  • If you do not know HTTPie, have a look here.
  • If you are looking for HTTPie installation or upgrade instructions on Alpine Linux, then you can find them on that page.
  • If you are looking for technical information about the HTTPie packaging on Alpine Linux, 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 Alpine Linux. 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 update the downstream file (example).

Notes:

  • The pkgrel value must be set to 0.
  • The commit message must be community/httpie: upgrade to XXX.
  • The commit must be signed-off (git commit -s).

Hacking

Launch the docker image:

docker pull alpine
docker run -it --rm alpine

From inside the container:

# Install tools
apk add alpine-sdk sudo

# Add a user (password required)
adduser me
addgroup me abuild
echo "me    ALL=(ALL) ALL" >> /etc/sudoers

# Switch user
su - me

# Create a private key (not used but required)
abuild-keygen -a -i

# Clone
git clone --depth=1 https://gitlab.alpinelinux.org/alpine/aports.git
cd aports/community/httpie

# Retrieve the patch of the latest HTTPie version
curl https://raw.githubusercontent.com/httpie/httpie/master/docs/packaging/linux-alpine/APKBUILD \
    -o APKBUILD

# Build the package
abuild -r

# Install the package
sudo apk add --repository ~/packages/community httpie

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