A fast and beautiful command line tool to build API requests

Poodle

A fast and beautiful command line tool to build API requests

Check out the Demo!

Poodle is an interactive command line tool to build and test web APIs based on a pre-built definitions.

Poodle has the following features:

• Register your web services and endpoints easily.
• Use variables in endpoints definitions.
• Painless debugging and interaction with APIs.
• Search web services and endpoints interactively.
• Edit services and endpoints easily (config is just a TOML file).
• Sync services via Gist automatically.

Documentation

Download the latest poodle binary . Also install fzf for better searching otherwise poodle will use a built-in one. Make it executable from everywhere.

$ curl -sL https://github.com/Clivern/Poodle/releases/download/x.x.x/poodle_x.x.x_OS.tar.gz | tar xz

To list all commands and options

$ poodle help

Work seamlessly with Poodle from the command line.

Poodle is in early stages of development, and we'd love to hear your
feedback at <https://github.com/Clivern/Poodle>

Usage:
  poodle [command]

Available Commands:
  call        Interact with one of the configured services
  configure   Configure Poodle
  edit        Edit service definition file
  help        Help about any command
  license     Print the license
  new         Creates a new service definition file
  sync        Sync services definitions
  version     Print the version number

Flags:
  -c, --config string   config file (default "/Users/Clivern/poodle/config.toml")
  -h, --help            help for poodle
  -v, --verbose         verbose output

Use "poodle [command] --help" for more information about a command.

To configure poodle, You will need to provide your github username and oauth token with a gist scope if you need the backup/sync feature

$ poodle configure

To sync definitions with backend. for now only github gists supported

$ poodle sync

To create a new service.

$ poodle new

by default we use https://httpbin.org as service API for testing so change with your web service API.

To edit a previously created service file:

$ poodle edit

To start calling your services endpoints:

$ poodle call

Versioning

For transparency into our release cycle and in striving to maintain backward compatibility, Poodle is maintained under the Semantic Versioning guidelines and release process is predictable and business-friendly.

See the Releases section of our GitHub project for changelogs for each release version of Poodle. It contains summaries of the most noteworthy changes made in each release.

Bug tracker

If you have any suggestions, bug reports, or annoyances please report them to our issue tracker at https://github.com/clivern/poodle/issues

Security Issues

If you discover a security vulnerability within Poodle, please send an email to hello@clivern.com

Contributing

We are an open source, community-driven project so please feel free to join us. see the contributing guidelines for more details.

License

© 2020, Clivern. Released under MIT License .

Poodleis authored and maintained by @clivern .