forked from extern/httpie-cli
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
This commit is contained in:
Mickaël Schoentgen
GitHub
parent
93114072c8
commit
7989e438d2
4
.github/workflows/test-package-mac-brew.yml
vendored
4
.github/workflows/test-package-mac-brew.yml
vendored
@ -1,10 +1,8 @@
|
|||||||
name: Mac brew
|
|
||||||
|
|
||||||
on:
|
on:
|
||||||
pull_request:
|
pull_request:
|
||||||
paths:
|
paths:
|
||||||
- .github/workflows/test-package-mac-brew.yml
|
- .github/workflows/test-package-mac-brew.yml
|
||||||
- extras/httpie.rb
|
- docs/packaging/brew/httpie.rb
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
brew:
|
brew:
|
||||||
|
|||||||
6
Makefile
6
Makefile
@ -130,7 +130,7 @@ pycodestyle: codestyle
|
|||||||
codestyle:
|
codestyle:
|
||||||
@echo $(H1)Running flake8$(H1END)
|
@echo $(H1)Running flake8$(H1END)
|
||||||
@[ -f $(VENV_BIN)/flake8 ] || $(VENV_PIP) install --upgrade --editable '.[dev]'
|
@[ -f $(VENV_BIN)/flake8 ] || $(VENV_PIP) install --upgrade --editable '.[dev]'
|
||||||
$(VENV_BIN)/flake8 httpie/ tests/ extras/ *.py
|
$(VENV_BIN)/flake8 httpie/ tests/ docs/packaging/brew/ *.py
|
||||||
@echo
|
@echo
|
||||||
|
|
||||||
|
|
||||||
@ -196,14 +196,14 @@ uninstall-httpie:
|
|||||||
###############################################################################
|
###############################################################################
|
||||||
|
|
||||||
brew-deps:
|
brew-deps:
|
||||||
extras/brew-deps.py
|
docs/packaging/brew/brew-deps.py
|
||||||
|
|
||||||
brew-test:
|
brew-test:
|
||||||
@echo $(H1)Uninstalling httpie$(H1END)
|
@echo $(H1)Uninstalling httpie$(H1END)
|
||||||
- brew uninstall httpie
|
- brew uninstall httpie
|
||||||
|
|
||||||
@echo $(H1)Building from source…$(H1END)
|
@echo $(H1)Building from source…$(H1END)
|
||||||
- brew install --build-from-source ./extras/httpie.rb
|
- brew install --build-from-source ./docs/packaging/brew/httpie.rb
|
||||||
|
|
||||||
@echo $(H1)Verifying…$(H1END)
|
@echo $(H1)Verifying…$(H1END)
|
||||||
brew test httpie
|
brew test httpie
|
||||||
|
|||||||
49
docs/packaging/README.md
Normal file
49
docs/packaging/README.md
Normal file
@ -0,0 +1,49 @@
|
|||||||
|
# HTTPie release process
|
||||||
|
|
||||||
|
Welcome on the documentation part of the **HTTPie release process**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for HTTPie installation or upgrade instructions, then you can find all you need for your OS on [that page](https://httpie.io/docs#installation). In the case you do not find your OS, [let us know](https://github.com/httpie/httpie/issues/).
|
||||||
|
- If you are looking for technical information about the HTTPie packaging, then you are at the good place.
|
||||||
|
|
||||||
|
## About
|
||||||
|
|
||||||
|
You are looking at the HTTPie packaging documentation, where you will find valuable information about how we manage to release HTTPie to lots of OSes, including technical data that may be worth reading if you are a package maintainer.
|
||||||
|
|
||||||
|
The overall release process starts simple:
|
||||||
|
|
||||||
|
1. Do the [PyPi](https://pypi.org/project/httpie/) publication.
|
||||||
|
2. Then, handle company-related tasks.
|
||||||
|
3. Finally, follow OS-specific steps, described in documents below, to send patches downstream.
|
||||||
|
|
||||||
|
## First, PyPi
|
||||||
|
|
||||||
|
Let's do the release on [PyPi](https://pypi.org/project/httpie/).
|
||||||
|
That is done quite easily by manually triggering the [release workflow](https://github.com/httpie/httpie/actions/workflows/release.yml).
|
||||||
|
|
||||||
|
## Then, company-specific tasks
|
||||||
|
|
||||||
|
- Update the HTTPie version bundled into termible ([example](https://github.com/httpie/termible/pull/1)).
|
||||||
|
|
||||||
|
## Finally, spread dowstream
|
||||||
|
|
||||||
|
Find out how we do release new versions for each and every supported OS in the following table.
|
||||||
|
A more complete state of deployment can be found on [repology](https://repology.org/project/httpie/versions), including unofficial packages.
|
||||||
|
|
||||||
|
| OS | Maintainer |
|
||||||
|
| ------------------------------------------------------------------: | -------------- |
|
||||||
|
| [Alpine](linux-alpine/README.md) | **HTTPie** |
|
||||||
|
| [Arch Linux, and derived](linux-arch/README.md) | trusted person |
|
||||||
|
| :construction: [AOSC OS](linux-aosc/README.md) | **HTTPie** |
|
||||||
|
| [CentOS, RHEL, and derived](linux-centos/README.md) | trusted person |
|
||||||
|
| [Debian, Ubuntu, and derived](linux-debian/README.md) | trusted person |
|
||||||
|
| [Fedora](linux-fedora/README.md) | trusted person |
|
||||||
|
| [Gentoo](linux-gentoo/README.md) | **HTTPie** |
|
||||||
|
| :construction: [Homebrew, Linuxbrew](brew/README.md) | **HTTPie** |
|
||||||
|
| :construction: [MacPorts](mac-ports/README.md) | **HTTPie** |
|
||||||
|
| [Snapcraft](snapcraft/README.md) | **HTTPie** |
|
||||||
|
| [Spack](spack/README.md) | **HTTPie** |
|
||||||
|
| [Void Linux](linux-void/README.md) | **HTTPie** |
|
||||||
|
| :construction: [Windows — Chocolatey](windows-chocolatey/README.md) | **HTTPie** |
|
||||||
|
|
||||||
|
:new: You do not find your system or you would like to see HTTPie supported on another OS? Then [let us know](https://github.com/httpie/httpie/issues/).
|
||||||
33
docs/packaging/brew/README.md
Normal file
33
docs/packaging/brew/README.md
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
# HTTPie on Homebrew, and Linuxbrew
|
||||||
|
|
||||||
|
Welcome to the documentation about **packaging HTTPie for Homebrew**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for HTTPie installation or upgrade instructions on Homebrew, then you can find them on [that page](https://httpie.io/docs#homebrew) ([that one](https://httpie.io/docs#linuxbrew) for Linuxbrew).
|
||||||
|
- If you are looking for technical information about the HTTPie packaging on Homebrew, 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 Homebrew. They apply to Linuxbrew as well.
|
||||||
|
We will discuss setting up the environment, installing development tools, installing and testing changes before submitting a patch downstream.
|
||||||
|
|
||||||
|
## Overall process
|
||||||
|
|
||||||
|
:construction: Work in progress.
|
||||||
|
|
||||||
|
First, update the current Formula:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make brew-deps
|
||||||
|
# Copy-paste content into downstream/mac/brew/httpie.rb
|
||||||
|
git add downstream/mac/brew/httpie.rb
|
||||||
|
git commit -s -m 'Update brew formula to XXX'
|
||||||
|
```
|
||||||
|
|
||||||
|
That [GitHub workflow](https://github.com/httpie/httpie/actions/workflows/test-package-mac-brew.yml) will test the formula when `downstream/mac/brew/httpie.rb` is changed in a pull request.
|
||||||
|
|
||||||
|
Then, open a pull request with those changes to the [downstream file]([ file](https://github.com/Homebrew/homebrew-core/blob/master/Formula/httpie.rb)).
|
||||||
|
|
||||||
|
## Hacking
|
||||||
|
|
||||||
|
:construction: Work in progress.
|
||||||
@ -1,9 +1,3 @@
|
|||||||
# The latest Homebrew formula as submitted to Homebrew/homebrew-core.
|
|
||||||
# Only useful for testing until it gets accepted by homebrew maintainers.
|
|
||||||
# (It will need to be updated from the repo version before next release.)
|
|
||||||
#
|
|
||||||
# https://github.com/Homebrew/homebrew-core/blob/master/Formula/httpie.rb
|
|
||||||
#
|
|
||||||
class Httpie < Formula
|
class Httpie < Formula
|
||||||
include Language::Python::Virtualenv
|
include Language::Python::Virtualenv
|
||||||
|
|
||||||
@ -15,12 +9,11 @@ class Httpie < Formula
|
|||||||
head "https://github.com/httpie/httpie.git"
|
head "https://github.com/httpie/httpie.git"
|
||||||
|
|
||||||
bottle do
|
bottle do
|
||||||
sha256 cellar: :any_skip_relocation, arm64_big_sur: "a0c123788163512698a0d284cfd6cb8125d8355aa59c3e4639df90b4388f94b5"
|
sha256 cellar: :any_skip_relocation, arm64_big_sur: "01115f69aff0399b3f73af09899a42a14343638a4624a35749059cc732c49cdc"
|
||||||
sha256 cellar: :any_skip_relocation, big_sur: "4e4bc9dd47e194bd45e9c0e36039942aed76a465871980924f0f27e83681d918"
|
sha256 cellar: :any_skip_relocation, big_sur: "53f07157f00edf8193b7d4f74f247f53e1796fbc3e675cd2fbaa4b9dc2bad62c"
|
||||||
sha256 cellar: :any_skip_relocation, catalina: "72dfebccff912bdb3913860983faf59c07c74db737ad4bf56143713236803821"
|
sha256 cellar: :any_skip_relocation, catalina: "7cf216fdee98208856d654060fdcad3968623d7ed27fcdeba27d3120354c9a9f"
|
||||||
sha256 cellar: :any_skip_relocation, mojave: "4733686b9a1564835b6662e758dd39dd80fcb940b684af57485392bb9d6bf04e"
|
sha256 cellar: :any_skip_relocation, mojave: "28adb5aed8c1c2b39c51789f242ff0dffde39073e161deb379c79184d787d063"
|
||||||
sha256 cellar: :any_skip_relocation, x86_64_linux: "914d67f6d9f732a7888ba2e35cf9c00525fb24917b6610544125b7bba545c7fc"
|
sha256 cellar: :any_skip_relocation, x86_64_linux: "91cb8c332c643bd8b1d0a8f3ec0acd4770b407991f6de1fd320d675f2b2e95ec"
|
||||||
sha256 cellar: :any_skip_relocation, high_sierra: "87e7348b6fb40fd8e4f7597937952469601962189e62d321b8cb4fa421e035ef"
|
|
||||||
end
|
end
|
||||||
|
|
||||||
depends_on "python@3.9"
|
depends_on "python@3.9"
|
||||||
33
docs/packaging/linux-alpine/APKBUILD
Normal file
33
docs/packaging/linux-alpine/APKBUILD
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
# Contributor: Fabian Affolter <fabian@affolter-engineering.ch>
|
||||||
|
# Maintainer: Fabian Affolter <fabian@affolter-engineering.ch>
|
||||||
|
# Contributor: Daniel Isaksen <d@duniel.no>
|
||||||
|
# Contributor: Mickaël Schoentgen <mickael@apible.io>
|
||||||
|
pkgname=httpie
|
||||||
|
pkgver=2.5.0
|
||||||
|
pkgrel=0
|
||||||
|
pkgdesc="CLI, cURL-like tool"
|
||||||
|
url="https://httpie.org/"
|
||||||
|
arch="noarch"
|
||||||
|
license="BSD-3-Clause"
|
||||||
|
depends="python3 py3-setuptools py3-requests py3-pygments py3-requests-toolbelt py3-pysocks py3-defusedxml"
|
||||||
|
makedepends="py3-setuptools"
|
||||||
|
checkdepends="py3-pytest py3-pytest-httpbin py3-responses"
|
||||||
|
source="https://files.pythonhosted.org/packages/source/h/httpie/httpie-$pkgver.tar.gz"
|
||||||
|
|
||||||
|
# secfixes:
|
||||||
|
# 1.0.3-r0:
|
||||||
|
# - CVE-2019-10751
|
||||||
|
|
||||||
|
build() {
|
||||||
|
python3 setup.py build
|
||||||
|
}
|
||||||
|
|
||||||
|
check() {
|
||||||
|
python3 -m pytest ./httpie ./tests
|
||||||
|
}
|
||||||
|
|
||||||
|
package() {
|
||||||
|
python3 setup.py install --prefix=/usr --root="$pkgdir"
|
||||||
|
}
|
||||||
|
|
||||||
|
sha512sums="3bfe572b03bfde87d5a02f9ba238f9493b32e587c33fd30600a4dd6a45082eedcb2b507c7f1e3e75a423cbdcc1ff0556138897dffb7888d191834994eae9a2aa httpie-2.5.0.tar.gz"
|
||||||
67
docs/packaging/linux-alpine/README.md
Normal file
67
docs/packaging/linux-alpine/README.md
Normal file
@ -0,0 +1,67 @@
|
|||||||
|
# HTTPie on Alpine Linux
|
||||||
|
|
||||||
|
Welcome to the documentation about **packaging HTTPie for Alpine Linux**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for HTTPie installation or upgrade instructions on Alpine Linux, then you can find them on [that page](https://httpie.io/docs#alpine-linux).
|
||||||
|
- 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](https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/community/httpie/APKBUILD) ([example](https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/25075)).
|
||||||
|
|
||||||
|
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:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker pull alpine
|
||||||
|
docker run -it --rm alpine
|
||||||
|
```
|
||||||
|
|
||||||
|
From inside the container:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 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
|
||||||
|
```
|
||||||
24
docs/packaging/linux-aosc/README.md
Normal file
24
docs/packaging/linux-aosc/README.md
Normal file
@ -0,0 +1,24 @@
|
|||||||
|
# HTTPie on AOSC OS
|
||||||
|
|
||||||
|
Welcome to the documentation about **packaging HTTPie for AOSC OS**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for technical information about the HTTPie packaging on AOSC OS, 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 AOSC OS.
|
||||||
|
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](https://github.com/AOSC-Dev/aosc-os-abbs/blob/stable/extra-web/httpie/spec) ([example](https://github.com/AOSC-Dev/aosc-os-abbs/commit/d0d3ba0bcea347387bb582a1b0b1b4e518720c80)).
|
||||||
|
|
||||||
|
Notes:
|
||||||
|
|
||||||
|
- The commit message must be `httpie: update to XXX`.
|
||||||
|
- The commit must be signed-off (`git commit -s`).
|
||||||
|
|
||||||
|
## Hacking
|
||||||
|
|
||||||
|
:construction: Work in progress.
|
||||||
5
docs/packaging/linux-aosc/spec
Normal file
5
docs/packaging/linux-aosc/spec
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
VER=2.5.0
|
||||||
|
SRCS="tbl::https://github.com/httpie/httpie/archive/$VER.tar.gz"
|
||||||
|
CHKSUMS="sha256::66af56e0efc1ca6237323f1186ba34bca1be24e67a4319fd5df7228ab986faea"
|
||||||
|
REL=1
|
||||||
|
CHKUPDATE="anitya::id=1337"
|
||||||
46
docs/packaging/linux-arch/PKGBUILD
Normal file
46
docs/packaging/linux-arch/PKGBUILD
Normal file
@ -0,0 +1,46 @@
|
|||||||
|
# Maintainer: Jelle van der Waa <jelle@archlinux.org>
|
||||||
|
# Maintainer: daurnimator <daurnimator@archlinux.org>
|
||||||
|
# Contributor: Daniel Micay <danielmicay@gmail.com>
|
||||||
|
# Contributor: Thomas Weißschuh <thomas_weissschuh lavabit com>
|
||||||
|
|
||||||
|
pkgname=httpie
|
||||||
|
pkgver=2.5.0
|
||||||
|
pkgrel=1
|
||||||
|
pkgdesc="human-friendly CLI HTTP client for the API era"
|
||||||
|
url="https://github.com/httpie/httpie"
|
||||||
|
depends=('python-defusedxml'
|
||||||
|
'python-pygments'
|
||||||
|
'python-pysocks'
|
||||||
|
'python-requests'
|
||||||
|
'python-requests-toolbelt')
|
||||||
|
makedepends=('python-setuptools')
|
||||||
|
checkdepends=('python-pytest'
|
||||||
|
'python-pytest-httpbin'
|
||||||
|
'python-responses')
|
||||||
|
conflicts=(python-httpie)
|
||||||
|
replaces=(python-httpie python2-httpie)
|
||||||
|
license=('BSD')
|
||||||
|
arch=('any')
|
||||||
|
source=($pkgname-$pkgver.tar.gz::"https://github.com/httpie/httpie/archive/$pkgver.tar.gz")
|
||||||
|
sha256sums=('66af56e0efc1ca6237323f1186ba34bca1be24e67a4319fd5df7228ab986faea')
|
||||||
|
|
||||||
|
build() {
|
||||||
|
cd $pkgname-$pkgver
|
||||||
|
python3 setup.py build
|
||||||
|
}
|
||||||
|
|
||||||
|
package() {
|
||||||
|
cd $pkgname-$pkgver
|
||||||
|
install -Dm644 LICENSE "$pkgdir/usr/share/licenses/httpie/LICENSE"
|
||||||
|
python3 setup.py install --root="$pkgdir" --optimize=1
|
||||||
|
|
||||||
|
# Fix upstream, include them in MANIFEST.in and use data_files in setup.py to install them automatically
|
||||||
|
# TODO: add zsh support
|
||||||
|
install -Dm644 extras/httpie-completion.bash "$pkgdir"/usr/share/bash-completion/completions/http
|
||||||
|
install -Dm644 extras/httpie-completion.fish "$pkgdir"/usr/share/fish/vendor_completions.d/http.fish
|
||||||
|
}
|
||||||
|
|
||||||
|
check() {
|
||||||
|
cd $pkgname-$pkgver
|
||||||
|
PYTHONDONTWRITEBYTECODE=1 python3 setup.py test
|
||||||
|
}
|
||||||
22
docs/packaging/linux-arch/README.md
Normal file
22
docs/packaging/linux-arch/README.md
Normal file
@ -0,0 +1,22 @@
|
|||||||
|
# HTTPie on Arch Linux, and derived
|
||||||
|
|
||||||
|
Welcome to the documentation about **packaging HTTPie for Arch Linux**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for HTTPie installation or upgrade instructions on Arch Linux, then you can find them on [that page](https://httpie.io/docs#arch-linux).
|
||||||
|
- If you are looking for technical information about the HTTPie packaging on Arch 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 Arch Linux. They apply to Arch-derived distributions as well, like ArcoLinux, EndeavourOS, Artix Linux, etc.
|
||||||
|
We will discuss setting up the environment, installing development tools, installing and testing changes before submitting a patch downstream.
|
||||||
|
|
||||||
|
## Overall process
|
||||||
|
|
||||||
|
Note: Sending patches downstream does not seem easy. We failed to find where is located the package file on <https://gitlab.archlinux.org>. So we are relying on the last maintainer, daurnimator, and it works pretty well so far.
|
||||||
|
|
||||||
|
Check <https://archlinux.org/packages/community/any/httpie/> and if the version is outdated, simply [report it](https://archlinux.org/packages/community/any/httpie/flag/).
|
||||||
|
|
||||||
|
## Hacking
|
||||||
|
|
||||||
|
Left blank on purpose, we will fill that section when we will have access to the downstream repository.
|
||||||
26
docs/packaging/linux-centos/README.md
Normal file
26
docs/packaging/linux-centos/README.md
Normal file
@ -0,0 +1,26 @@
|
|||||||
|
# HTTPie on CentOS, RHEL, and derived
|
||||||
|
|
||||||
|
Welcome to the documentation about **packaging HTTPie for CentOS and RHEL**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for HTTPie installation or upgrade instructions on CentOS, then you can find them on [that page](https://httpie.io/docs#centos-and-rhel).
|
||||||
|
- If you are looking for technical information about the HTTPie packaging on CentOS, 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 CentOS. They apply to RHEL as well, and any RHEL-derived distributions like ClearOS, Oracle Linux, etc.
|
||||||
|
We will discuss setting up the environment, installing development tools, installing and testing changes before submitting a patch downstream.
|
||||||
|
|
||||||
|
The current maintainer is [Mikel Olasagasti](https://github.com/kaxero).
|
||||||
|
|
||||||
|
## Overall process
|
||||||
|
|
||||||
|
Same as [Fedora](../linux-fedora/README.md#overall-process).
|
||||||
|
|
||||||
|
## Q/A with Mikel
|
||||||
|
|
||||||
|
Q: What should we do to help seeing a new version on CentOS?
|
||||||
|
|
||||||
|
A: When a new release is published Miro and I get notified by [release-monitoring](https://release-monitoring.org/project/1337/), that fills a BugZilla ticket reporting a new version being available.
|
||||||
|
|
||||||
|
The system also tries to create a simple patch to update the spec file, but in the case of CentOS it needs some manual revision. For example for 2.5.0 `defuxedxml` dep is required. Maybe with CentOS-9 and some new macros that are available now in Fedora it can be automated same way. But even the bump can be automated, maintainers should check for license changes, new binaries/docs/ and so on.
|
||||||
29
docs/packaging/linux-debian/README.md
Normal file
29
docs/packaging/linux-debian/README.md
Normal file
@ -0,0 +1,29 @@
|
|||||||
|
# HTTPie on Debian, Ubuntu, and derived
|
||||||
|
|
||||||
|
Welcome to the documentation about **packaging HTTPie for Debian GNU/Linux**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for HTTPie installation or upgrade instructions on Debian GNU/Linux, then you can find them on [that page](https://httpie.io/docs#debian-and-ubuntu).
|
||||||
|
- If you are looking for technical information about the HTTPie packaging on Debian GNU/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 Debian GNU/Linux. They apply to Ubuntu as well, and any Debian-derived distributions like MX Linux, Linux Mint, deepin, Pop!_OS, KDE neon, Zorin OS, elementary OS, Kubuntu, Devuan, Linux Lite, Peppermint OS, Lubuntu, antiX, Xubuntu, etc.
|
||||||
|
We will discuss setting up the environment, installing development tools, installing and testing changes before submitting a patch downstream.
|
||||||
|
|
||||||
|
The current maintainer is Bartosz Fenski.
|
||||||
|
|
||||||
|
## Overall process
|
||||||
|
|
||||||
|
Open a new bug on the Debian Bug Tracking System by sending an email:
|
||||||
|
|
||||||
|
- To: `Debian Bug Tracking System <submit@bugs.debian.org>`
|
||||||
|
- Subject: `httpie: Version XXX available`
|
||||||
|
- Message template ([example](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=993937)):
|
||||||
|
|
||||||
|
```email
|
||||||
|
Package: httpie
|
||||||
|
Severity: wishlist
|
||||||
|
|
||||||
|
<MESSAGE>
|
||||||
|
```
|
||||||
48
docs/packaging/linux-fedora/README.md
Normal file
48
docs/packaging/linux-fedora/README.md
Normal file
@ -0,0 +1,48 @@
|
|||||||
|
# HTTPie on Fedora
|
||||||
|
|
||||||
|
Welcome to the documentation about **packaging HTTPie for Fedora**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for HTTPie installation or upgrade instructions on Fedora, then you can find them on [that page](https://httpie.io/docs#fedora).
|
||||||
|
- If you are looking for technical information about the HTTPie packaging on Fedora, 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 Fedora.
|
||||||
|
We will discuss setting up the environment, installing development tools, installing and testing changes before submitting a patch downstream.
|
||||||
|
|
||||||
|
The current maintainer is [Miro Hrončok](https://github.com/hroncok).
|
||||||
|
|
||||||
|
## Overall process
|
||||||
|
|
||||||
|
We added the [.packit.yaml](https://github.com/httpie/httpie/blob/master/.packit.yaml) local file.
|
||||||
|
It unlocks real-time Fedora checks on pull requests and new releases.
|
||||||
|
|
||||||
|
So there is nothing to do on our side: `Packit` will see the new release and open a pull request [there](https://src.fedoraproject.org/rpms/httpie). Then, the Fedora maintainer will review and merge.
|
||||||
|
|
||||||
|
It is also possible to follow [user feedbacks](https://bodhi.fedoraproject.org/updates/?packages=httpie) for all builds.
|
||||||
|
|
||||||
|
## Q/A with Miro
|
||||||
|
|
||||||
|
Q: What would the command to install the latest stable version look like?
|
||||||
|
|
||||||
|
A: Assuming the latest stable version is already propagated to Fedora:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Note that yum is an alias to dnf.
|
||||||
|
$ sudo dnf install httpie
|
||||||
|
```
|
||||||
|
|
||||||
|
Q: Will dnf/yum upgrade then update to the latest?
|
||||||
|
|
||||||
|
A: Yes, assuming the same as above.
|
||||||
|
|
||||||
|
Q: Are new versions backported automatically?
|
||||||
|
|
||||||
|
A: No. The process is:
|
||||||
|
|
||||||
|
1. A new HTTPie release is created on Github.
|
||||||
|
2. A pull request for Fedora `rawhide` (the development version of Fedora, currently Fedora 35) is created.
|
||||||
|
3. A Fedora packager (usually Miro) sanity checks the pull request and merges, builds. HTTPie is updated in `rawhide` within 24 hours (sometimes more, for unrelated issues).
|
||||||
|
4. A Fedora packager decides whether the upgrade is suitable for stable Fedora releases (currently 34, 33), if so, merges the changes there.
|
||||||
|
5. (if the above is yes) The new version of HTTPie lands in `updates-testing` repo where it waits for user feedback and lands within ~1 week for broad availability.
|
||||||
2
docs/packaging/linux-gentoo/Manifest
Normal file
2
docs/packaging/linux-gentoo/Manifest
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
DIST httpie-2.4.0.tar.gz 1772537 BLAKE2B 111451cc7dc353d5b586554f98ac715a3198f03e74d261944a5f021d2dcc948455500800222b323d182a2a067d0549bda7c318ab3a6c934b9a9beec64aff2db2 SHA512 44cc7ff4fe0f3d8c53a7dd750465f6b56c36f5bbac06d22b760579bd60949039e82313845699669a659ec91adc69dbeac22c06ddd63af64e6f2e0edecf3e732a
|
||||||
|
DIST httpie-2.5.0.tar.gz 1105177 BLAKE2B 6e16868c81522d4e6d2fc0a4e093c190f18ced720b35217930865ae3f8e168193cc33dfecc13c5d310f52647d6e79d17b247f56e56e8586d633a2d9502be66a7 SHA512 f14aa23fea7578181b9bd6ededea04de9ddf0b2f697b23f76d2d96e2c17b95617318c711750bad6af550400dbc03732ab17fdf84e59d577f33f073e600a55330
|
||||||
78
docs/packaging/linux-gentoo/README.md
Normal file
78
docs/packaging/linux-gentoo/README.md
Normal file
@ -0,0 +1,78 @@
|
|||||||
|
# HTTPie on Gentoo
|
||||||
|
|
||||||
|
Welcome to the documentation about **packaging HTTPie for Gentoo**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for HTTPie installation or upgrade instructions on Gentoo, then you can find them on [that page](https://httpie.io/docs#gentoo).
|
||||||
|
- 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):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 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:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker pull gentoo/stage3
|
||||||
|
docker run -it --rm gentoo/stage3
|
||||||
|
```
|
||||||
|
|
||||||
|
From inside the container:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 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
|
||||||
|
```
|
||||||
42
docs/packaging/linux-gentoo/httpie-2.5.0.ebuild
Normal file
42
docs/packaging/linux-gentoo/httpie-2.5.0.ebuild
Normal file
@ -0,0 +1,42 @@
|
|||||||
|
# Copyright 1999-2021 Gentoo Authors
|
||||||
|
# Distributed under the terms of the GNU General Public License v2
|
||||||
|
|
||||||
|
EAPI=7
|
||||||
|
|
||||||
|
DISTUTILS_USE_SETUPTOOLS=rdepend
|
||||||
|
PYTHON_COMPAT=( python3_{8,9,10} )
|
||||||
|
PYTHON_REQ_USE="ssl(+)"
|
||||||
|
|
||||||
|
inherit bash-completion-r1 distutils-r1
|
||||||
|
|
||||||
|
DESCRIPTION="Modern command line HTTP client"
|
||||||
|
HOMEPAGE="https://httpie.io/ https://pypi.org/project/httpie/"
|
||||||
|
SRC_URI="https://github.com/httpie/httpie/archive/${PV}.tar.gz -> ${P}.tar.gz"
|
||||||
|
|
||||||
|
LICENSE="BSD"
|
||||||
|
SLOT="0"
|
||||||
|
KEYWORDS="~amd64 ~x86"
|
||||||
|
|
||||||
|
RDEPEND="
|
||||||
|
dev-python/defusedxml[${PYTHON_USEDEP}]
|
||||||
|
dev-python/pygments[${PYTHON_USEDEP}]
|
||||||
|
>=dev-python/requests-2.22.0[${PYTHON_USEDEP}]
|
||||||
|
>=dev-python/requests-toolbelt-0.9.1[${PYTHON_USEDEP}]
|
||||||
|
"
|
||||||
|
BDEPEND="
|
||||||
|
test? (
|
||||||
|
${RDEPEND}
|
||||||
|
dev-python/pyopenssl[${PYTHON_USEDEP}]
|
||||||
|
dev-python/pytest-httpbin[${PYTHON_USEDEP}]
|
||||||
|
dev-python/responses[${PYTHON_USEDEP}]
|
||||||
|
)
|
||||||
|
"
|
||||||
|
|
||||||
|
distutils_enable_tests pytest
|
||||||
|
|
||||||
|
python_install_all() {
|
||||||
|
newbashcomp extras/httpie-completion.bash http
|
||||||
|
insinto /usr/share/fish/vendor_completions.d
|
||||||
|
newins extras/httpie-completion.fish http.fish
|
||||||
|
distutils-r1_python_install_all
|
||||||
|
}
|
||||||
28
docs/packaging/linux-gentoo/metadata.xml
Normal file
28
docs/packaging/linux-gentoo/metadata.xml
Normal file
@ -0,0 +1,28 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<!DOCTYPE pkgmetadata SYSTEM "https://www.gentoo.org/dtd/metadata.dtd">
|
||||||
|
<pkgmetadata>
|
||||||
|
<maintainer type="person" proxied="yes">
|
||||||
|
<email>mickael@apible.io</email>
|
||||||
|
<name>Mickaël Schoentgen</name>
|
||||||
|
</maintainer>
|
||||||
|
<maintainer type="project" proxied="proxy">
|
||||||
|
<email>proxy-maint@gentoo.org</email>
|
||||||
|
<name>Proxy Maintainers</name>
|
||||||
|
</maintainer>
|
||||||
|
<longdescription lang="en">
|
||||||
|
HTTPie (pronounced aitch-tee-tee-pie) is a command line HTTP
|
||||||
|
client. Its goal is to make CLI interaction with web services as
|
||||||
|
human-friendly as possible. It provides a simple http command
|
||||||
|
that allows for sending arbitrary HTTP requests using a simple
|
||||||
|
and natural syntax, and displays colorized output. HTTPie can be
|
||||||
|
used for testing, debugging, and generally interacting with HTTP
|
||||||
|
servers.
|
||||||
|
</longdescription>
|
||||||
|
<upstream>
|
||||||
|
<bugs-to>https://github.com/httpie/httpie/issues</bugs-to>
|
||||||
|
<changelog>https://raw.githubusercontent.com/httpie/httpie/master/CHANGELOG.md</changelog>
|
||||||
|
<doc>https://httpie.io/docs</doc>
|
||||||
|
<remote-id type="github">httpie/httpie</remote-id>
|
||||||
|
<remote-id type="pypi">httpie</remote-id>
|
||||||
|
</upstream>
|
||||||
|
</pkgmetadata>
|
||||||
68
docs/packaging/linux-void/README.md
Normal file
68
docs/packaging/linux-void/README.md
Normal file
@ -0,0 +1,68 @@
|
|||||||
|
# HTTPie on Void Linux
|
||||||
|
|
||||||
|
Welcome to the documentation about **packaging HTTPie for Void Linux**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for HTTPie installation or upgrade instructions on Void Linux, then you can find them on [that page](https://httpie.io/docs#void-linux).
|
||||||
|
- If you are looking for technical information about the HTTPie packaging on Void 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 Void 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](https://github.com/void-linux/void-packages/blob/master/srcpkgs/httpie/template) ([example](https://github.com/void-linux/void-packages/pull/32905)).
|
||||||
|
|
||||||
|
- The commit message must be `httpie: update to XXX.`.
|
||||||
|
- The commit must be signed-off (`git commit -s`).
|
||||||
|
|
||||||
|
## Hacking
|
||||||
|
|
||||||
|
Launch the docker image:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker pull voidlinux/voidlinux
|
||||||
|
docker run -it --rm voidlinux/voidlinux
|
||||||
|
```
|
||||||
|
|
||||||
|
From inside the container:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Sync and upgrade once, assume error comes from xbps update
|
||||||
|
xbps-install -Syu
|
||||||
|
# Install tools
|
||||||
|
xbps-install -y git xtools file util-linux binutils bsdtar coreutils
|
||||||
|
|
||||||
|
# Clone
|
||||||
|
git clone --depth=1 git://github.com/void-linux/void-packages.git void-packages-src
|
||||||
|
cd void-packages-src
|
||||||
|
|
||||||
|
# Retrieve the patch of the latest HTTPie version
|
||||||
|
curl https://raw.githubusercontent.com/httpie/httpie/master/docs/packaging/linux-void/template \
|
||||||
|
-o srcpkgs/httpie/template
|
||||||
|
|
||||||
|
# Check the package
|
||||||
|
xlint srcpkgs/httpie/template
|
||||||
|
|
||||||
|
# Link / to /masterdir
|
||||||
|
ln -s / masterdir
|
||||||
|
|
||||||
|
# Enable ethereal chroot-style
|
||||||
|
export XBPS_ALLOW_CHROOT_BREAKOUT=yes
|
||||||
|
./xbps-src binary-bootstrap
|
||||||
|
./xbps-src chroot
|
||||||
|
|
||||||
|
# Build the package
|
||||||
|
cd void-packages
|
||||||
|
export SOURCE_DATE_EPOCH=0
|
||||||
|
./xbps-src pkg httpie
|
||||||
|
|
||||||
|
# Install the package
|
||||||
|
xbps-install --repository=hostdir/binpkgs httpie
|
||||||
|
|
||||||
|
# And finally test it!
|
||||||
|
http --version
|
||||||
|
https --version
|
||||||
|
```
|
||||||
28
docs/packaging/linux-void/template
Normal file
28
docs/packaging/linux-void/template
Normal file
@ -0,0 +1,28 @@
|
|||||||
|
# Template file for 'httpie'
|
||||||
|
pkgname=httpie
|
||||||
|
version=2.5.0
|
||||||
|
revision=1
|
||||||
|
build_style=python3-module
|
||||||
|
hostmakedepends="python3-setuptools"
|
||||||
|
depends="python3-setuptools python3-requests python3-requests-toolbelt
|
||||||
|
python3-Pygments python3-pysocks python3-defusedxml"
|
||||||
|
short_desc="Human-friendly command line HTTP client"
|
||||||
|
maintainer="Mickaël Schoentgen <mickael@apible.io>"
|
||||||
|
license="BSD-3-Clause"
|
||||||
|
homepage="https://httpie.io/"
|
||||||
|
changelog="https://raw.githubusercontent.com/httpie/httpie/${version}/CHANGELOG.md"
|
||||||
|
distfiles="https://github.com/httpie/httpie/archive/${version}.tar.gz"
|
||||||
|
checksum=66af56e0efc1ca6237323f1186ba34bca1be24e67a4319fd5df7228ab986faea
|
||||||
|
make_check=no # needs pytest_httpbin which is not packaged
|
||||||
|
|
||||||
|
post_install() {
|
||||||
|
vcompletion extras/httpie-completion.bash bash http
|
||||||
|
vcompletion extras/httpie-completion.fish fish http
|
||||||
|
vlicense LICENSE
|
||||||
|
}
|
||||||
|
|
||||||
|
python3-httpie_package() {
|
||||||
|
build_style=meta
|
||||||
|
short_desc+=" (transitional dummy package)"
|
||||||
|
depends="httpie>=${version}_${revision}"
|
||||||
|
}
|
||||||
49
docs/packaging/mac-ports/Portfile
Normal file
49
docs/packaging/mac-ports/Portfile
Normal file
@ -0,0 +1,49 @@
|
|||||||
|
# -*- coding: utf-8; mode: tcl; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- vim:fenc=utf-8::et:sw=4:ts=4:sts=4
|
||||||
|
|
||||||
|
PortSystem 1.0
|
||||||
|
PortGroup github 1.0
|
||||||
|
PortGroup python 1.0
|
||||||
|
|
||||||
|
github.setup httpie httpie 2.5.0
|
||||||
|
|
||||||
|
maintainers {g5pw @g5pw} openmaintainer
|
||||||
|
categories net
|
||||||
|
description HTTPie is a command line HTTP client, a user-friendly cURL replacement.
|
||||||
|
long_description HTTPie (pronounced aych-tee-tee-pie) is a command line HTTP \
|
||||||
|
client. Its goal is to make CLI interaction with web \
|
||||||
|
services as human-friendly as possible. It provides a simple \
|
||||||
|
http command that allows for sending arbitrary HTTP requests \
|
||||||
|
using a simple and natural syntax, and displays colorized \
|
||||||
|
responses. HTTPie can be used for testing, debugging, and \
|
||||||
|
generally interacting with HTTP servers.
|
||||||
|
platforms darwin
|
||||||
|
license BSD
|
||||||
|
homepage https://httpie.io/
|
||||||
|
|
||||||
|
variant python36 conflicts python37 python38 python39 description "Use Python 3.6" {}
|
||||||
|
variant python37 conflicts python36 python38 python39 description "Use Python 3.7" {}
|
||||||
|
variant python38 conflicts python36 python37 python39 description "Use Python 3.8" {}
|
||||||
|
variant python39 conflicts python36 python37 python38 description "Use Python 3.9" {}
|
||||||
|
|
||||||
|
if {[variant_isset python36]} {
|
||||||
|
python.default_version 36
|
||||||
|
} elseif {[variant_isset python37]} {
|
||||||
|
python.default_version 37
|
||||||
|
} elseif {[variant_isset python39]} {
|
||||||
|
python.default_version 39
|
||||||
|
} else {
|
||||||
|
default_variants +python38
|
||||||
|
python.default_version 38
|
||||||
|
}
|
||||||
|
|
||||||
|
depends_lib-append port:py${python.version}-requests \
|
||||||
|
port:py${python.version}-requests-toolbelt \
|
||||||
|
port:py${python.version}-pygments \
|
||||||
|
port:py${python.version}-socks \
|
||||||
|
port:py${python.version}-defusedxml
|
||||||
|
|
||||||
|
checksums rmd160 88d227d52199c232c0ddf704a219d1781b1e77ee \
|
||||||
|
sha256 00c4b7bbe7f65abe1473f37b39d9d9f8f53f44069a430ad143a404c01c2179fc \
|
||||||
|
size 1105185
|
||||||
|
|
||||||
|
python.link_binaries_suffix
|
||||||
40
docs/packaging/mac-ports/README.md
Normal file
40
docs/packaging/mac-ports/README.md
Normal file
@ -0,0 +1,40 @@
|
|||||||
|
# HTTPie on MacPorts
|
||||||
|
|
||||||
|
Welcome to the documentation about **packaging HTTPie for MacPorts**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for HTTPie installation or upgrade instructions on MacPorts, then you can find them on [that page](https://httpie.io/docs#macports).
|
||||||
|
- If you are looking for technical information about the HTTPie packaging on MacPorts, 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 MacPorts.
|
||||||
|
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](https://github.com/macports/macports-ports/blob/master/net/httpie/Portfile) ([example](https://github.com/macports/macports-ports/pull/12167)).
|
||||||
|
|
||||||
|
- Here is how to calculate the size and checksums (replace `2.5.0` with the correct version):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Download the archive
|
||||||
|
$ wget https://api.github.com/repos/httpie/httpie/tarball/2.5.0
|
||||||
|
|
||||||
|
# Size
|
||||||
|
$ stat --printf="%s\n" 2.5.0
|
||||||
|
1105185
|
||||||
|
|
||||||
|
# Checksums
|
||||||
|
$ openssl dgst -rmd160 2.5.0
|
||||||
|
RIPEMD160(2.5.0)= 88d227d52199c232c0ddf704a219d1781b1e77ee
|
||||||
|
$ openssl dgst -sha256 2.5.0
|
||||||
|
SHA256(2.5.0)= 00c4b7bbe7f65abe1473f37b39d9d9f8f53f44069a430ad143a404c01c2179fc
|
||||||
|
```
|
||||||
|
|
||||||
|
- The commit message must be `httpie: update to XXX`.
|
||||||
|
- The commit must be signed-off (`git commit -s`).
|
||||||
|
|
||||||
|
## Hacking
|
||||||
|
|
||||||
|
:construction: Work in progress.
|
||||||
51
docs/packaging/snapcraft/README.md
Normal file
51
docs/packaging/snapcraft/README.md
Normal file
@ -0,0 +1,51 @@
|
|||||||
|
# HTTPie on Snapcraft
|
||||||
|
|
||||||
|
Welcome to the documentation about **packaging HTTPie for Snapcraft**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for HTTPie installation or upgrade instructions on Snapcraft, then you can find them on [that page](https://httpie.io/docs#snap-linux) ([that one](https://httpie.io/docs#snap-mac) for macOS).
|
||||||
|
- If you are looking for technical information about the HTTPie packaging on Snapcraft, 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 Snapcraft. They apply to Snapcraft on Linux, macOS, and Windows.
|
||||||
|
We will discuss setting up the environment, installing development tools, installing and testing changes before submitting a patch downstream.
|
||||||
|
|
||||||
|
## Overall process
|
||||||
|
|
||||||
|
Trigger a new [build](https://snapcraft.io/httpie/builds), then [promote it](https://snapcraft.io/httpie/releases). If more management is needed: [revisions supervision](https://dashboard.snapcraft.io/snaps/httpie/revisions/).
|
||||||
|
|
||||||
|
## Hacking
|
||||||
|
|
||||||
|
Launch the docker image:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker pull ubuntu/latest
|
||||||
|
docker run -it --rm ubuntu/latest
|
||||||
|
```
|
||||||
|
|
||||||
|
From inside the container:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Clone
|
||||||
|
git clone --depth=1 https://github.com/httpie/httpie.git
|
||||||
|
cd httpie
|
||||||
|
|
||||||
|
# Build
|
||||||
|
export SNAPCRAFT_BUILD_ENVIRONMENT_CPU=8
|
||||||
|
export SNAPCRAFT_BUILD_ENVIRONMENT_MEMORY=16G
|
||||||
|
snapcraft --debug
|
||||||
|
|
||||||
|
# Install
|
||||||
|
sudo snap install --dangerous httpie_XXX_amd64.snap
|
||||||
|
|
||||||
|
# Test
|
||||||
|
httpie.http --version
|
||||||
|
httpie.https --version
|
||||||
|
# Auto-aliases cannot be tested when installing a snap outside the store.
|
||||||
|
# http --version
|
||||||
|
# https --version
|
||||||
|
|
||||||
|
# Remove
|
||||||
|
sudo snap remove httpie
|
||||||
|
```
|
||||||
54
docs/packaging/spack/README.md
Normal file
54
docs/packaging/spack/README.md
Normal file
@ -0,0 +1,54 @@
|
|||||||
|
# HTTPie on Spack
|
||||||
|
|
||||||
|
Welcome to the documentation about **packaging HTTPie for Spack**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for HTTPie installation or upgrade instructions on Spack, then you can find them on [that page](https://httpie.io/docs#spack-linux) ([that one](https://httpie.io/docs#spack-mac) for macOS).
|
||||||
|
- If you are looking for technical information about the HTTPie packaging on Spack, 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 Spack. They apply to Spack on Linux, and macOS.
|
||||||
|
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](https://github.com/spack/spack/blob/develop/var/spack/repos/builtin/packages/httpie/package.py) ([example](https://github.com/spack/spack/pull/25888)).
|
||||||
|
|
||||||
|
- The commit message must be `httpie: add vXXX`.
|
||||||
|
- The commit must be signed-off (`git commit -s`).
|
||||||
|
|
||||||
|
## Hacking
|
||||||
|
|
||||||
|
Launch the docker image:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker pull spack/centos7
|
||||||
|
docker run -it --rm spack/centos7
|
||||||
|
```
|
||||||
|
|
||||||
|
From inside the container:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Clone
|
||||||
|
git clone --depth=1 https://github.com/spack/spack.git
|
||||||
|
cd spack
|
||||||
|
|
||||||
|
# Retrieve the patch of the latest HTTPie version
|
||||||
|
curl https://raw.githubusercontent.com/httpie/httpie/master/docs/packaging/spack/package.py \
|
||||||
|
-o var/spack/repos/builtin/packages/httpie/package.py
|
||||||
|
|
||||||
|
# Check the package
|
||||||
|
spack spec httpie
|
||||||
|
|
||||||
|
# Check available versions (it should show the new version)
|
||||||
|
spack versions httpie
|
||||||
|
|
||||||
|
# Install the package
|
||||||
|
spack install httpie@XXX
|
||||||
|
spack load httpie
|
||||||
|
|
||||||
|
# And test it!
|
||||||
|
http --version
|
||||||
|
https --version
|
||||||
|
```
|
||||||
32
docs/packaging/spack/package.py
Normal file
32
docs/packaging/spack/package.py
Normal file
@ -0,0 +1,32 @@
|
|||||||
|
# Copyright 2013-2021 Lawrence Livermore National Security, LLC and other
|
||||||
|
# Spack Project Developers. See the top-level COPYRIGHT file for details.
|
||||||
|
#
|
||||||
|
# SPDX-License-Identifier: (Apache-2.0 OR MIT)
|
||||||
|
|
||||||
|
from spack import *
|
||||||
|
|
||||||
|
|
||||||
|
class Httpie(PythonPackage):
|
||||||
|
"""Modern command line HTTP client."""
|
||||||
|
|
||||||
|
homepage = "https://httpie.io/"
|
||||||
|
pypi = "httpie/httpie-2.5.0.tar.gz"
|
||||||
|
|
||||||
|
version('2.5.0', sha256='fe6a8bc50fb0635a84ebe1296a732e39357c3e1354541bf51a7057b4877e47f9')
|
||||||
|
version('0.9.9', sha256='f1202e6fa60367e2265284a53f35bfa5917119592c2ab08277efc7fffd744fcb')
|
||||||
|
version('0.9.8', sha256='515870b15231530f56fe2164190581748e8799b66ef0fe36ec9da3396f0df6e1')
|
||||||
|
|
||||||
|
variant('socks', default=True,
|
||||||
|
description='Enable SOCKS proxy support')
|
||||||
|
|
||||||
|
depends_on('py-setuptools', type=('build', 'run'))
|
||||||
|
depends_on('py-defusedxml', type=('build', 'run'))
|
||||||
|
depends_on('py-pygments', type=('build', 'run'))
|
||||||
|
depends_on('py-requests', type=('build', 'run'))
|
||||||
|
depends_on('py-requests-toolbelt', type=('build', 'run'))
|
||||||
|
depends_on('py-pysocks', type=('build', 'run'), when="+socks")
|
||||||
|
# Concretization problem breaks this. Unconditional for now...
|
||||||
|
# https://github.com/spack/spack/issues/3628
|
||||||
|
# depends_on('py-argparse@1.2.1:', type=('build', 'run'),
|
||||||
|
# when='^python@:2.6,3.0:3.1')
|
||||||
|
depends_on('py-argparse@1.2.1:', type=('build', 'run'), when='^python@:2.6')
|
||||||
20
docs/packaging/windows-chocolatey/README.md
Normal file
20
docs/packaging/windows-chocolatey/README.md
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
# HTTPie on Chocolatey
|
||||||
|
|
||||||
|
Welcome to the documentation about **packaging HTTPie for Chocolatey**.
|
||||||
|
|
||||||
|
- If you do not know HTTPie, have a look [here](https://httpie.io/cli).
|
||||||
|
- If you are looking for HTTPie installation or upgrade instructions on Chocolatey, then you can find them on [that page](https://httpie.io/docs#chocolatey).
|
||||||
|
- If you are looking for technical information about the HTTPie packaging on Chocolatey, 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 Chocolatey.
|
||||||
|
We will discuss setting up the environment, installing development tools, installing and testing changes before submitting a patch downstream.
|
||||||
|
|
||||||
|
## Overall process
|
||||||
|
|
||||||
|
:construction: Work in progress.
|
||||||
|
|
||||||
|
## Hacking
|
||||||
|
|
||||||
|
:construction: Work in progress.
|
||||||
Loading…
Reference in New Issue
Block a user