Script 'mail_helper' called by obssrc Hello community, here is the log from the commit of package gap-curlinterface for openSUSE:Factory checked in at 2026-04-26 21:11:58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Comparing /work/SRC/openSUSE:Factory/gap-curlinterface (Old) and /work/SRC/openSUSE:Factory/.gap-curlinterface.new.11940 (New) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "gap-curlinterface" Sun Apr 26 21:11:58 2026 rev:6 rq:1349319 version:2.4.3 Changes: -------- --- /work/SRC/openSUSE:Factory/gap-curlinterface/gap-curlinterface.changes 2025-06-20 16:55:03.762298364 +0200 +++ /work/SRC/openSUSE:Factory/.gap-curlinterface.new.11940/gap-curlinterface.changes 2026-04-26 21:14:36.653505168 +0200 @@ -1,0 +2,6 @@ +Sat Apr 25 22:55:45 UTC 2026 - Jan Engelhardt <[email protected]> + +- Update to release 2.4.3 + * Changes to GAP-internal package metadata + +------------------------------------------------------------------- Old: ---- curlInterface-2.4.2.tar.gz New: ---- curlInterface-2.4.3.tar.gz ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Other differences: ------------------ ++++++ gap-curlinterface.spec ++++++ --- /var/tmp/diff_new_pack.sF1vbr/_old 2026-04-26 21:14:37.129524617 +0200 +++ /var/tmp/diff_new_pack.sF1vbr/_new 2026-04-26 21:14:37.129524617 +0200 @@ -1,7 +1,7 @@ # # spec file for package gap-curlinterface # -# Copyright (c) 2025 SUSE LLC +# Copyright (c) 2026 SUSE LLC and contributors # # All modifications and additions to the file contributed by third parties # remain the property of their copyright owners, unless otherwise agreed @@ -12,12 +12,12 @@ # license that conforms to the Open Source Definition (Version 1.9) # published by the Open Source Initiative. -# Please submit bugfixes or comments via http://bugs.opensuse.org/ +# Please submit bugfixes or comments via https://bugs.opensuse.org/ # Name: gap-curlinterface -Version: 2.4.2 +Version: 2.4.3 Release: 0 Summary: GAP: Web Access via curl License: GPL-2.0-or-later ++++++ _scmsync.obsinfo ++++++ --- /var/tmp/diff_new_pack.sF1vbr/_old 2026-04-26 21:14:37.161525925 +0200 +++ /var/tmp/diff_new_pack.sF1vbr/_new 2026-04-26 21:14:37.165526088 +0200 @@ -1,5 +1,5 @@ -mtime: 1750422959 -commit: a1b709d05453b968f52ded24d135bdb6628b4cba444c30d16ee1de16b7c35fa7 +mtime: 1777157826 +commit: 028de3dd3ac0041a7b8dc9243128366fce4245f70f9980037998e662237492f4 url: https://src.opensuse.org/jengelh/gap-curlinterface revision: master ++++++ build.specials.obscpio ++++++ ++++++ build.specials.obscpio ++++++ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/.gitignore new/.gitignore --- old/.gitignore 1970-01-01 01:00:00.000000000 +0100 +++ new/.gitignore 2026-04-26 00:57:06.000000000 +0200 @@ -0,0 +1 @@ +.osc ++++++ curlInterface-2.4.2.tar.gz -> curlInterface-2.4.3.tar.gz ++++++ ++++ 2173 lines of diff (skipped) ++++ retrying with extended exclude list diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/curlInterface-2.4.2/.mailmap new/curlInterface-2.4.3/.mailmap --- old/curlInterface-2.4.2/.mailmap 1970-01-01 01:00:00.000000000 +0100 +++ new/curlInterface-2.4.3/.mailmap 2026-04-22 02:00:00.000000000 +0200 @@ -0,0 +1,4 @@ +Chris Jefferson <[email protected]> +Chris Jefferson <[email protected]> <[email protected]> +Michael Young <[email protected]> +Thomas Breuer <[email protected]> \ No newline at end of file diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/curlInterface-2.4.2/.release new/curlInterface-2.4.3/.release --- old/curlInterface-2.4.2/.release 1970-01-01 01:00:00.000000000 +0100 +++ new/curlInterface-2.4.3/.release 2026-04-22 02:00:00.000000000 +0200 @@ -0,0 +1,4 @@ +#!/bin/sh +# This file is executed by the `release` script from +# https://github.com/gap-system/ReleaseTools +rm -f .clang-format diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/curlInterface-2.4.2/CHANGES new/curlInterface-2.4.3/CHANGES --- old/curlInterface-2.4.2/CHANGES 2025-06-20 13:01:26.000000000 +0200 +++ new/curlInterface-2.4.3/CHANGES 2026-04-22 02:00:00.000000000 +0200 @@ -1,5 +1,8 @@ This file describes changes in the curlInterface package. +2.4.3 (2026-04-22) + - Add `NeededSystemPackages` field to `PackageInfo.g` + 2.4.2 (2025-06-20) - Various janitorial changes diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/curlInterface-2.4.2/PackageInfo.g new/curlInterface-2.4.3/PackageInfo.g --- old/curlInterface-2.4.2/PackageInfo.g 2025-06-20 13:01:26.000000000 +0200 +++ new/curlInterface-2.4.3/PackageInfo.g 2026-04-22 02:00:00.000000000 +0200 @@ -10,8 +10,8 @@ PackageName := "curlInterface", Subtitle := "Simple Web Access", -Version := "2.4.2", -Date := "20/06/2025", # dd/mm/yyyy format +Version := "2.4.3", +Date := "22/04/2026", # dd/mm/yyyy format License := "GPL-2.0-or-later", Persons := [ @@ -38,6 +38,7 @@ FirstNames := "Max", LastName := "Horn", WWWHome := "https://www.quendi.de/math";, + GitHubUsername := "fingolfin", Email := "[email protected]", PostalAddress := Concatenation( "Fachbereich Mathematik\n", @@ -107,6 +108,10 @@ GAP := ">= 4.12", NeededOtherPackages := [ [ "GAPDoc", ">= 1.5" ] ], SuggestedOtherPackages := [ ], + NeededSystemPackages := rec( + Ubuntu := [["libcurl4-gnutls-dev"]], + Homebrew := [["curl"]], + ), ExternalConditions := [ ], ), diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/curlInterface-2.4.2/README.md new/curlInterface-2.4.3/README.md --- old/curlInterface-2.4.2/README.md 2025-06-20 13:01:26.000000000 +0200 +++ new/curlInterface-2.4.3/README.md 2026-04-22 02:00:00.000000000 +0200 @@ -1,7 +1,7 @@ The GAP 4 package `curlInterface' ============================== -[](https://github.com/gap-packages/curlInterface/actions?query=workflow%3ACI+branch%3Amaster) +[](https://github.com/gap-packages/curlInterface/actions/workflows/CI.yml) [](https://codecov.io/gh/gap-packages/curlInterface) This Package provides a simple wrapper around libcurl, to allow downloading diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/curlInterface-2.4.2/doc/chap0.html new/curlInterface-2.4.3/doc/chap0.html --- old/curlInterface-2.4.2/doc/chap0.html 2025-06-20 13:01:47.000000000 +0200 +++ new/curlInterface-2.4.3/doc/chap0.html 2026-04-22 02:00:00.000000000 +0200 @@ -29,10 +29,10 @@ <h2>Simple Web Access</h2> <p> - 2.4.2</p> + 2.4.3</p> <p> - 20 June 2025 + 22 April 2026 </p> </div> diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/curlInterface-2.4.2/doc/chap0.txt new/curlInterface-2.4.3/doc/chap0.txt --- old/curlInterface-2.4.2/doc/chap0.txt 2025-06-20 13:01:43.000000000 +0200 +++ new/curlInterface-2.4.3/doc/chap0.txt 2026-04-22 02:00:00.000000000 +0200 @@ -6,10 +6,10 @@ [1X Simple Web Access [101X - 2.4.2 + 2.4.3 - 20 June 2025 + 22 April 2026 Christopher Jefferson diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/curlInterface-2.4.2/doc/chap0_mj.html new/curlInterface-2.4.3/doc/chap0_mj.html --- old/curlInterface-2.4.2/doc/chap0_mj.html 2025-06-20 13:01:47.000000000 +0200 +++ new/curlInterface-2.4.3/doc/chap0_mj.html 2026-04-22 02:00:00.000000000 +0200 @@ -32,10 +32,10 @@ <h2>Simple Web Access</h2> <p> - 2.4.2</p> + 2.4.3</p> <p> - 20 June 2025 + 22 April 2026 </p> </div> diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/curlInterface-2.4.2/doc/curlInterface.tex new/curlInterface-2.4.3/doc/curlInterface.tex --- old/curlInterface-2.4.2/doc/curlInterface.tex 1970-01-01 01:00:00.000000000 +0100 +++ new/curlInterface-2.4.3/doc/curlInterface.tex 2026-04-22 02:00:00.000000000 +0200 @@ -0,0 +1,388 @@ +% generated by GAPDoc2LaTeX from XML source (Frank Luebeck) +\documentclass[a4paper,11pt]{report} + +\usepackage[top=37mm,bottom=37mm,left=27mm,right=27mm]{geometry} +\sloppy +\pagestyle{myheadings} +\usepackage{amssymb} +\usepackage[utf8]{inputenc} +\usepackage{makeidx} +\makeindex +\usepackage{color} +\definecolor{FireBrick}{rgb}{0.5812,0.0074,0.0083} +\definecolor{RoyalBlue}{rgb}{0.0236,0.0894,0.6179} +\definecolor{RoyalGreen}{rgb}{0.0236,0.6179,0.0894} +\definecolor{RoyalRed}{rgb}{0.6179,0.0236,0.0894} +\definecolor{LightBlue}{rgb}{0.8544,0.9511,1.0000} +\definecolor{Black}{rgb}{0.0,0.0,0.0} + +\definecolor{linkColor}{rgb}{0.0,0.0,0.554} +\definecolor{citeColor}{rgb}{0.0,0.0,0.554} +\definecolor{fileColor}{rgb}{0.0,0.0,0.554} +\definecolor{urlColor}{rgb}{0.0,0.0,0.554} +\definecolor{promptColor}{rgb}{0.0,0.0,0.589} +\definecolor{brkpromptColor}{rgb}{0.589,0.0,0.0} +\definecolor{gapinputColor}{rgb}{0.589,0.0,0.0} +\definecolor{gapoutputColor}{rgb}{0.0,0.0,0.0} + +%% for a long time these were red and blue by default, +%% now black, but keep variables to overwrite +\definecolor{FuncColor}{rgb}{0.0,0.0,0.0} +%% strange name because of pdflatex bug: +\definecolor{Chapter }{rgb}{0.0,0.0,0.0} +\definecolor{DarkOlive}{rgb}{0.1047,0.2412,0.0064} + + +\usepackage{fancyvrb} + +\usepackage{mathptmx,helvet} +\usepackage[T1]{fontenc} +\usepackage{textcomp} + + +\usepackage[ + pdftex=true, + bookmarks=true, + a4paper=true, + pdftitle={Written with GAPDoc}, + pdfcreator={LaTeX with hyperref package / GAPDoc}, + colorlinks=true, + backref=page, + breaklinks=true, + linkcolor=linkColor, + citecolor=citeColor, + filecolor=fileColor, + urlcolor=urlColor, + pdfpagemode={UseNone}, + ]{hyperref} + +\newcommand{\maintitlesize}{\fontsize{50}{55}\selectfont} + +% write page numbers to a .pnr log file for online help +\newwrite\pagenrlog +\immediate\openout\pagenrlog =\jobname.pnr +\immediate\write\pagenrlog{PAGENRS := [} +\newcommand{\logpage}[1]{\protect\write\pagenrlog{#1, \thepage,}} +%% were never documented, give conflicts with some additional packages + +\newcommand{\GAP}{\textsf{GAP}} + +%% nicer description environments, allows long labels +\usepackage{enumitem} +\setdescription{style=nextline} + +%% depth of toc +\setcounter{tocdepth}{1} + + + + + +%% command for ColorPrompt style examples +\newcommand{\gapprompt}[1]{\color{promptColor}{\bfseries #1}} +\newcommand{\gapbrkprompt}[1]{\color{brkpromptColor}{\bfseries #1}} +\newcommand{\gapinput}[1]{\color{gapinputColor}{#1}} + + +\begin{document} + +\logpage{[ 0, 0, 0 ]} +\begin{titlepage} +\mbox{}\vfill + +\begin{center}{\maintitlesize \textbf{ curlInterface \mbox{}}}\\ +\vfill + +\hypersetup{pdftitle= curlInterface } +\markright{\scriptsize \mbox{}\hfill curlInterface \hfill\mbox{}} +{\Huge \textbf{ Simple Web Access \mbox{}}}\\ +\vfill + +{\Huge 2.4.3 \mbox{}}\\[1cm] +{ 22 April 2026 \mbox{}}\\[1cm] +\mbox{}\\[2cm] +{\Large \textbf{ Christopher Jefferson\\ + \mbox{}}}\\ +{\Large \textbf{ Michael Young\\ + \mbox{}}}\\ +\hypersetup{pdfauthor= Christopher Jefferson\\ + ; Michael Young\\ + } +\end{center}\vfill + +\mbox{}\\ +{\mbox{}\\ +\small \noindent \textbf{ Christopher Jefferson\\ + } Email: \href{mailto://[email protected]} {\texttt{caj21@st\texttt{\symbol{45}}andrews.ac.uk}}\\ + Homepage: \href{http://caj.host.cs.st-andrews.ac.uk/} {\texttt{http://caj.host.cs.st\texttt{\symbol{45}}andrews.ac.uk/}}\\ + Address: \begin{minipage}[t]{8cm}\noindent + School of Computer Science\\ + University of St Andrews\\ + Jack Cole Building, North Haugh\\ + St Andrews, Fife, KY16 9SX\\ + United Kingdom\\ + \end{minipage} +}\\ +{\mbox{}\\ +\small \noindent \textbf{ Michael Young\\ + } Email: \href{mailto://[email protected]} {\texttt{mct25@st\texttt{\symbol{45}}andrews.ac.uk}}\\ + Homepage: \href{http://mct25.host.cs.st-andrews.ac.uk/} {\texttt{http://mct25.host.cs.st\texttt{\symbol{45}}andrews.ac.uk/}}\\ + Address: \begin{minipage}[t]{8cm}\noindent + School of Computer Science\\ + University of St Andrews\\ + Jack Cole Building, North Haugh\\ + St Andrews, Fife, KY16 9SX\\ + United Kingdom\\ + \end{minipage} +}\\ +\end{titlepage} + +\newpage\setcounter{page}{2} +\newpage + +\def\contentsname{Contents\logpage{[ 0, 0, 1 ]}} + +\tableofcontents +\newpage + + +\chapter{\textcolor{Chapter }{Overview}}\label{Chapter_Overview} +\logpage{[ 1, 0, 0 ]} +\hyperdef{L}{X8389AD927B74BA4A}{} +{ + + + CurlInterface allows a user to interact with http and https servers on the +internet, using the 'curl' library. Pages can be downloaded from a URL, and +http POST requests can be sent to the URL for processing. +\section{\textcolor{Chapter }{Installing curlInterface}}\label{Chapter_Overview_Section_Installing_curlInterface} +\logpage{[ 1, 1, 0 ]} +\hyperdef{L}{X852847EC87B3F9E4}{} +{ + + + curlInterface requires the 'curl' library, available from \href{https://curl.haxx.se/} {\texttt{https://curl.haxx.se/}}. Instructions for building and installing curl can be found at \href{https://curl.haxx.se/docs/install.html} {\texttt{https://curl.haxx.se/docs/install.html}}, however in most systems curl can be installed from your OS's package +manager. + + +\subsection{\textcolor{Chapter }{Linux}}\label{Chapter_Overview_Section_Installing_curlInterface_Subsection_Linux} +\logpage{[ 1, 1, 1 ]} +\hyperdef{L}{X8286176B85B6326F}{} +{ + + + +\begin{itemize} +\item On Debian and Ubuntu, call: \texttt{apt\texttt{\symbol{45}}get install +libcurl4\texttt{\symbol{45}}gnutls\texttt{\symbol{45}}dev} +\item On Redhat and derivatives, call: \texttt{yum install curl\texttt{\symbol{45}}devel} +\end{itemize} + + + } + + +\subsection{\textcolor{Chapter }{Cygwin}}\label{Chapter_Overview_Section_Installing_curlInterface_Subsection_Cygwin} +\logpage{[ 1, 1, 2 ]} +\hyperdef{L}{X7A3117FB8072361E}{} +{ + + + Install \texttt{libcurl\texttt{\symbol{45}}devel} from the cygwin package manager + + } + + +\subsection{\textcolor{Chapter }{macOS}}\label{Chapter_Overview_Section_Installing_curlInterface_Subsection_macOS} +\logpage{[ 1, 1, 3 ]} +\hyperdef{L}{X7FF92C7E7A41189D}{} +{ + + + curl is installed by default on Macs, but libcurl may be required. +\begin{itemize} +\item Homebrew: \texttt{brew install curl} +\item Fink: \texttt{fink install libcurl4} +\item MacPorts: \texttt{port install curl} +\end{itemize} + } + + } + + +\section{\textcolor{Chapter }{Functions}}\label{Chapter_Overview_Section_Functions} +\logpage{[ 1, 2, 0 ]} +\hyperdef{L}{X86FA580F8055B274}{} +{ + + + curlInterface currently provides the following functions for interacting with +URLs: + +\subsection{\textcolor{Chapter }{DownloadURL}} +\logpage{[ 1, 2, 1 ]}\nobreak +\hyperdef{L}{X7827F7DE85113D7E}{} +{\noindent\textcolor{FuncColor}{$\triangleright$\enspace\texttt{DownloadURL({\mdseries\slshape URL[, opts]})\index{DownloadURL@\texttt{DownloadURL}} +\label{DownloadURL} +}\hfill{\scriptsize (function)}}\\ +\textbf{\indent Returns:\ } + a record + + + + Downloads a URL from the internet. \mbox{\texttt{\mdseries\slshape URL}} should be a string describing the address, and should start with either +"http://"; or "https://";. For descriptions of the output and the additional +argument \mbox{\texttt{\mdseries\slshape opts}}, see \texttt{CurlRequest} (\ref{CurlRequest}). + + +\begin{Verbatim}[commandchars=@|A,fontsize=\small,frame=single,label=Example] + @gapprompt|gap>A @gapinput|r := DownloadURL("www.gap-system.org");;A + @gapprompt|gap>A @gapinput|r.success;A + true + @gapprompt|gap>A @gapinput|r.result{[1..50]};A + "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n\n<!DOCTYPE " +\end{Verbatim} + } + + + +\subsection{\textcolor{Chapter }{PostToURL}} +\logpage{[ 1, 2, 2 ]}\nobreak +\hyperdef{L}{X81A7B7017D508BE9}{} +{\noindent\textcolor{FuncColor}{$\triangleright$\enspace\texttt{PostToURL({\mdseries\slshape URL, str[, opts]})\index{PostToURL@\texttt{PostToURL}} +\label{PostToURL} +}\hfill{\scriptsize (function)}}\\ +\textbf{\indent Returns:\ } + a record + + + + Sends an HTTP POST request to a URL on the internet. \mbox{\texttt{\mdseries\slshape URL}} should be a string describing the address, and should start with either +"http://"; or "https://";. \mbox{\texttt{\mdseries\slshape str}} should be the string which will be sent to the server as a POST request. For +descriptions of the output and the additional argument \mbox{\texttt{\mdseries\slshape opts}}, see \texttt{CurlRequest} (\ref{CurlRequest}). + + +\begin{Verbatim}[commandchars=!@|,fontsize=\small,frame=single,label=Example] + !gapprompt@gap>| !gapinput@r := PostToURL("httpbun.com/post", "animal=tiger");;| + !gapprompt@gap>| [email protected];| + true + !gapprompt@gap>| [email protected]{[51..100]};| + "\"form\": {\n \"animal\": \"tiger\"\n }, \n \"headers\":" +\end{Verbatim} + } + + + +\subsection{\textcolor{Chapter }{DeleteURL}} +\logpage{[ 1, 2, 3 ]}\nobreak +\hyperdef{L}{X84C36A2D86B7975B}{} +{\noindent\textcolor{FuncColor}{$\triangleright$\enspace\texttt{DeleteURL({\mdseries\slshape URL[, opts]})\index{DeleteURL@\texttt{DeleteURL}} +\label{DeleteURL} +}\hfill{\scriptsize (function)}}\\ +\textbf{\indent Returns:\ } + a record + + + + Attempts to delete a file on the internet, by sending an HTTP DELETE request +to the given URL. \mbox{\texttt{\mdseries\slshape URL}} should be a string describing the address to be deleted, and should start with +either "http://"; or "https://";. For descriptions of the output and the +additional argument \mbox{\texttt{\mdseries\slshape opts}}, see \texttt{CurlRequest} (\ref{CurlRequest}). + + +\begin{Verbatim}[commandchars=!@|,fontsize=\small,frame=single,label=Example] + !gapprompt@gap>| !gapinput@r := DeleteURL("www.google.com");;| + !gapprompt@gap>| [email protected];| + true + !gapprompt@gap>| [email protected]{[1471..1540]};| + "<p>The request method <code>DELETE</code> is inappropriate for the URL" +\end{Verbatim} + } + + + +\subsection{\textcolor{Chapter }{CurlRequest}} +\logpage{[ 1, 2, 4 ]}\nobreak +\hyperdef{L}{X79B1452982D2B19C}{} +{\noindent\textcolor{FuncColor}{$\triangleright$\enspace\texttt{CurlRequest({\mdseries\slshape URL, type, out{\textunderscore}string[, opts]})\index{CurlRequest@\texttt{CurlRequest}} +\label{CurlRequest} +}\hfill{\scriptsize (function)}}\\ +\textbf{\indent Returns:\ } + a record + + + + Sends an HTTP request of type \mbox{\texttt{\mdseries\slshape type}} to a URL on the internet. \mbox{\texttt{\mdseries\slshape URL}}, \mbox{\texttt{\mdseries\slshape type}}, and \mbox{\texttt{\mdseries\slshape out{\textunderscore}string}} should all be strings: \mbox{\texttt{\mdseries\slshape URL}} is the URL of the server (which should start with "http://"; or "https://";), \mbox{\texttt{\mdseries\slshape type}} is the type of HTTP request (e.g. "GET"), and \mbox{\texttt{\mdseries\slshape out{\textunderscore}string}} is the message, if any, to send to the server (in requests such as GET this +will be ignored). + + An optional fourth argument \mbox{\texttt{\mdseries\slshape opts}} may be included, which should be a record specifying additional options for +the request. The following options are supported: +\begin{itemize} +\item \texttt{verifyCert}: a boolean describing whether to verify HTTPS certificates (corresponds to +the curl options \texttt{CURLOPT{\textunderscore}SSL{\textunderscore}VERIFYPEER} and \texttt{CURLOPT{\textunderscore}SSL{\textunderscore}VERIFYHOST}, the default is \texttt{true} for both); +\item \texttt{verbose}: a boolean describing whether to print extra information to the screen +(corresponds to the curl option \texttt{CURLOPT{\textunderscore}VERBOSE}, the default is \texttt{false}); +\item \texttt{followRedirect}: a boolean describing whether to follow redirection to another URL +(corresponds to the curl option \texttt{CURLOPT{\textunderscore}FOLLOWLOCATION}, the default is \texttt{true}); +\item \texttt{failOnError}: a boolean describing whether to regard 404 (and other 4xx) status codes as +error (corresponds to the curl option \texttt{CURLOPT{\textunderscore}FAILONERROR}, the default is \texttt{false}). +\item \texttt{maxTime}: Maximum time in seconds that you allow each transfer to take. 0 means no +limitation. (default \texttt{0}). +\end{itemize} + + + As output, this function returns a record containing some of the following +components, which describe the outcome of the request: +\begin{itemize} +\item \texttt{success}: a boolean describing whether the request was successfully received by the +server; +\item \texttt{result}: body of the information sent by the server (only if \texttt{success = true}); +\item \texttt{error}: human\texttt{\symbol{45}}readable string saying what went wrong (only if \texttt{success = false}). +\end{itemize} + + + Most of the standard HTTP request types should work, but currently only body +information is returned. To see headers, consider using the \texttt{verbose} option. For convenience, dedicated functions exist for the following request +types: +\begin{itemize} +\item \texttt{DownloadURL} (\ref{DownloadURL}) for GET requests; +\item \texttt{PostToURL} (\ref{PostToURL}) for POST requests; +\item \texttt{DeleteURL} (\ref{DeleteURL}) for DELETE requests. +\end{itemize} + + + +\begin{Verbatim}[commandchars=!@|,fontsize=\small,frame=single,label=Example] + !gapprompt@gap>| !gapinput@r := CurlRequest("https://www.google.com";,| + !gapprompt@>| !gapinput@ "HEAD",| + !gapprompt@>| !gapinput@ "",| + !gapprompt@>| !gapinput@ rec(verifyCert := false));| + rec( result := "", success := true ) + !gapprompt@gap>| !gapinput@r := CurlRequest("httpbun.com/post", "POST", "animal=tiger");;| + !gapprompt@gap>| [email protected];| + true + !gapprompt@gap>| [email protected]{[51..100]};| + "\"form\": {\n \"animal\": \"tiger\"\n }, \n \"headers\":" +\end{Verbatim} + } + + } + + } + + \def\indexname{Index\logpage{[ "Ind", 0, 0 ]} +\hyperdef{L}{X83A0356F839C696F}{} +} + +\cleardoublepage +\phantomsection +\addcontentsline{toc}{chapter}{Index} + + +\printindex + +\immediate\write\pagenrlog{["Ind", 0, 0], \arabic{page},} +\newpage +\immediate\write\pagenrlog{["End"], \arabic{page}];} +\immediate\closeout\pagenrlog +\end{document} Binary files old/curlInterface-2.4.2/doc/manual.pdf and new/curlInterface-2.4.3/doc/manual.pdf differ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/curlInterface-2.4.2/doc/title.xml new/curlInterface-2.4.3/doc/title.xml --- old/curlInterface-2.4.2/doc/title.xml 2025-06-20 13:01:43.000000000 +0200 +++ new/curlInterface-2.4.3/doc/title.xml 2026-04-22 02:00:00.000000000 +0200 @@ -9,7 +9,7 @@ Simple Web Access </Subtitle> <Version> - 2.4.2 + 2.4.3 </Version> <Author> Christopher Jefferson<Alt Only="LaTeX"><Br/></Alt> @@ -38,6 +38,6 @@ </Author> <Date> - 20 June 2025 + 22 April 2026 </Date> </TitlePage> \ No newline at end of file
