A command line utility for sending requests to TChannel services.
usage: tcurl <service> [--health | <method> [<body> [<head>]]]
Sends one or more TChannel requests.
[-s|--service] <service>
The name of the TChannel/Hyperbahn service to send requests to
[-1|--arg1|--method|--endpoint] <method>
The name of the endpoint to send requests to or method to call
[<body>]
The argument in SHON format, e.g., [ --key value --key value ]
Use --body to supply in JSON format instead.
[<head>]
The headers in SHON format.
Use --head to supply in JSON format instead.
[-3|--arg3|--body <body>]
The body or argument in JSON
[-2|--arg2|--head <head>]
Application headers in JSON
[-p|--peer <peer>...]
The peer or peers to connect
[-P|--peerlist|-H|--hostlist <path>]
The path to a file containing a JSON list of peers
[-r|--raw]
Use the raw argument scheme
[--http <method>]
Use the HTTP argument scheme with given method
[-j|--json]
Use the JSON argument scheme
[-t|--thrift <thrift>]
Where to find Thrift IDL files
[--strict=true*|-s=true|--no-strict=false|-S=false]
Whether to use strict Thrift parsing
[--shard-key|--shardKey <sk>]
Ringpop shard key
[--timeout <ms>]
Timeout in milliseconds
[--rate <rate>]
Request rate in requests per second
[--delay <ms>]
Delay between requests in milliseconds
[--duration <ms>]
Test duration in milliseconds
[--health]
Hit the health endpoint for the service
[-h] short help
[--help] man page
[-v|--version]
Click here for full usage docs.
npm install tcurl
For the purposes of these examples, let's assume that you have a TChannel
server listening on localhost:1234. The server registers handlers for the
thrift interface saved as services/chamber.thrift and defined as:
struct EchoRequest {
1: required string input;
}
service Chamber {
string echo(
1: required EchoRequest request;
)
}
You could use TCurl to query this service by running:
tcurl -p localhost:1234 chamber Chamber::echo -t ./services -3 '{"request": {"input": "foo"}}'
localhost caveatFor TChannel and Hyperbahn to work together effectively, most tchannel services need to listen on the external IP of the host they are running on.
This means when you use 127.0.0.1 you cannot reach the service with tcurl as it's not listening on
loopback.
To make supporting external IPs easier we've made localhost resolve to the external IP of the machine.
This means if your listening on loopback you have to use 127.0.0.1 and not localhost
npm run add-licence This will add the licence headers.npm run cover This runs the tests with code coveragenpm run lint This will run the linter on your codenpm test This will run the tests.npm run trace This will run your tests in tracing mode.npm run travis This is run by travis.CI to run your testsnpm run view-cover This will show code coverage in a browserFAQs
A command line utility to talk to a tchannel server
The npm package tcurl receives a total of 66 weekly downloads. As such, tcurl popularity was classified as not popular.
We found that tcurl demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 6 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
Socket researchers uncover how threat actors weaponize Out-of-Band Application Security Testing (OAST) techniques across the npm, PyPI, and RubyGems ecosystems to exfiltrate sensitive data.
Security News
Research
A malicious npm campaign is targeting Ethereum developers by impersonating Hardhat plugins and the Nomic Foundation, stealing sensitive data like private keys.
Research
Security News
Socket researchers uncover a malicious npm package posing as a tool for detecting vulnerabilities in Etherium smart contracts.