Request

by twolfson ALL

Make HTTP requests from Sublime Text

Labels http, url

Details

Version 0.5.0
Homepage github.com
Issues github.com
Modified 11 years ago
Last Seen 58 minutes ago
First Seen 11 years ago

Installs

Total 10K
Win 7K
Mac 2K
Linux 720

	Dec 22	Dec 21	Dec 20	Dec 19	Dec 18	Dec 17	Dec 16	Dec 15	Dec 14	Dec 13	Dec 12	Dec 11	Dec 10	Dec 9	Dec 8	Dec 7	Dec 6	Dec 5	Dec 4	Dec 3	Dec 2	Dec 1	Nov 30	Nov 29	Nov 28	Nov 27	Nov 26	Nov 25	Nov 24	Nov 23	Nov 22	Nov 21	Nov 20	Nov 19	Nov 18	Nov 17	Nov 16	Nov 15	Nov 14	Nov 13	Nov 12	Nov 11	Nov 10	Nov 9	Nov 8	Nov 7
Windows	0	1	0	0	2	1	3	0	0	1	0	1	2	1	1	1	0	2	0	1	0	1	0	0	0	0	0	0	0	2	1	2	0	1	1	0	2	2	0	0	0	0	0	0	0	0
Mac	0	1	0	0	0	1	0	0	0	0	0	0	1	1	0	0	0	0	0	0	0	0	0	2	0	0	0	0	0	0	0	0	0	0	0	0	0	1	0	0	0	0	0	0	0	1
Linux	1	0	0	0	0	0	0	0	1	0	0	1	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	1	0	0	0	0	1	0	0	0	0	0	0	0	0	0	0

Readme

Source: raw.githubusercontent.com

sublime-request

Make HTTP requests from Sublime Text.

Attach to the request command via your keyboard shortcuts or add a custom command pallete to hook into.

Getting started

Installation

This package is available under Request inside of Package Control, a Sublime Text plugin that allows for easy management of other plugins.

If you prefer the manual route, you can install the script via the following command in the Sublime Text terminal (ctrl+`) which utilizes git clone.

import os; path=sublime.packages_path(); (os.makedirs(path) if not os.path.exists(path) else None); window.run_command('exec', {'cmd': ['git', 'clone', 'https://github.com/twolfson/sublime-request', 'request'], 'working_dir': path})

Packages can be uninstalled via “Package Control: Remove Package” via the command pallete, ctrl+shift+p on Windows/Linux, command+shift+p on Mac.

Working with the plugin

By default, no keyboards shortcuts or commands are added to the command pallete.

You are left to add in your own custom features since typing out HTTP parameters every time is tedious.

To add your own custom keyboard shortcut:

Open the command pallete, ctrl+shift+p on Windows/Linux, command+shift+p on Mac
Navigate to “Preferences: Key Bindings - User”
Inside of the top level [], add the following code

{
  "keys": ["alt+x"],
  "command": "request",
  "args": {
    "open_args": ["http://google.com/"],
    "save_to_clipboard": true
  }
}

You now have alt+x bound to download http://google.com/ to your clipboard.

Documentation

sublime-request is written on top of Python's urllib2 library (urllib in Sublime Text 3). We accept the following parameters:

open_args - List of arguments to pass to urllib2.urlopen/urllib.request.urlopen
open_kwargs - Dictionary of keyword arguments to pass to urllib2.urlopen/urllib.request.urlopen
read_args - List of arguments to pass to request.read
read_kwargs - Dictionary of keyword arguments to pass to request.read
save_to_clipboard - Copies result from read to clipboard

I don't know Python

This is a fact of life. Rather than creating a meta language to be just as simple, I will show you some commmon examples to draw from.

Using open “js {"open_args”: [url, data, timeout]}

// Make GET request to google.com // url = http://google.com/ {“open_args”: [“http://google.com/”]}

// Make POST request to google.com. Switches to POST when data is included // url = http://google.com/, data = “some=data” {“open_args”: [“http://google.com”, “some=data”]}

**Using read**
```js
{"read_args": [buffer_length]}

// Read all of response from request
// buffer_length = null (None in Python)
{"open_args": ["http://google.com/"]}

// Read first 100 bytes of response
// buffer_length = 100
{"open_args": ["http://google.com"], "read_args": [100]}

Examples

Ping a server

Ping a server via a key binding (requests http://localhost:3000/ when alt+x is pressed.

{
  "keys": ["alt+x"],
  "command": "request",
  "args": {
    "open_args": ["http://localhost:3000/"]
  }
}

Grab some Lorem Ipsum

Copy the first 100 characters of Lorem Ipsum to your clipboard via a key binding, alt+x.

{
  "keys": ["alt+x"],
  "command": "request",
  "args": {
    "open_args": ["http://loripsum.net/api/plaintext"],
    "read_args": [100],
    "save_to_clipboard": true
  }
}

FAQ

I want to see the results of my request.

Sublime Text comes default with an exec command which runs CLI commands in a panel. There are no official docs to my knowledge but you can find the source code via Command Pallete -> Browse Packages -> Default/exec.py@class ExecCommand.

Here is a key binding that runs curl to http://google.com/.

{
  "keys": ["alt+x"],
  "command": "exec",
  "args": {
    "cmd": ["curl", "http://google.com/"]
  }
}

% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed

  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
100   219  100   219    0     0   2565      0 --:--:-- --:--:-- --:--:--  5918
<HTML><HEAD><meta http-equiv="content-type" content="text/html;charset=utf-8">
<TITLE>301 Moved</TITLE></HEAD><BODY>
<H1>301 Moved</H1>
The document has moved
<A HREF="http://www.google.com/">here</A>.
</BODY></HTML>
[Finished in 0.1s]

Donating

Support this project and others by twolfson via gittip.

License

Licensed under the MIT license.