mb-url - Multiple Backends for Emacs URL package

Author: ZHANG Weiyi dochang@gmail.com
Version: 0.6.1
URL: https://github.com/dochang/mb-url

Multiple Backends for URL package.

This package provides several backends for url-retrieve & url-retrieve-synchronously, which replace the internal implementation.

The motivation of this package is I can't connect HTTPS url behind proxy (Related bugs: #11788, #12636, #18860, msg00756, #10).

Notice

As the URL package has supported HTTPS over proxies supporting CONNECT since Emacs 26, this package is no longer recommended. But it can still be used in Emacs < 26.

Installation

mb-url is available on MELPA and el-get.

To install mb-url from git repository, clone the repo, then add the repo dir into load-path.

mb-url depends on cl-lib; The test code also depends on s.

NOTE: the test code requires GNU Emacs 24.4 and above because it uses the new nadvice package. mb-url may support GNU Emacs 24.3 and below but it's not tested with those versions.

Backends

Currently only support url-http.

url-http

Install mb-url-http-around-advice to use mb-url-http backends.

(advice-add 'url-http :around 'mb-url-http-around-advice)

All backend functions receive (name url buffer default-sentinel), return a process.

mb-url-http-backend indicates the current backend. If the backend is nil, which means no backend, url-http will be called.

E.g.,

(setq mb-url-http-backend 'mb-url-http-curl)

cURL

mb-url-http-curl

cURL backend for url-http.

mb-url-http-curl-program

cURL program.

mb-url-http-curl-switches

cURL switches.

HTTPie

mb-url-http-httpie

HTTPie backend for url-http.

mb-url-http-httpie-program

HTTPie program.

mb-url-http-httpie-switches

HTTPie switches.

License

GPLv3

Acknowledgements

https://github.com/nicferrier/curl-url-retrieve

---

Converted from mb-url.el by el2markdown.