Skip to content

Latest commit

 

History

History
141 lines (89 loc) · 4.39 KB

README.md

File metadata and controls

141 lines (89 loc) · 4.39 KB
Raw

mb-url - Multiple Backends for Emacs URL package

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

MELPA MELPA Stable CI CircleCI Average time to resolve an issue Percentage of issues still open Issues Pull Requests GitHub Say Thanks!

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.

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)

NOTE: All clients are required to support automatically decompressing response bodies.

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.

mb-url-http-httpie-supported-content-encoding-list

Content encodings which HTTPie supports to decode.

If your HTTPie supports to decode a encoding like br, put the encoding into this list.

By default, HTTPie supports to decode gzip and deflate.

mb-url-http-httpie-content-encoding-fix-function

A function to fix the value of Content-Encoding for HTTPie. Default value is mb-url-http-httpie-delete-content-encoding-from-list.

License

GPLv3

Acknowledgements

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

Converted from mb-url.el by el2markdown.