GraphMan CLI generates an complete collection from a GraphQL endpoint, containing one request per query & mutation, with pre filled fields, parameters and variables.
Note: GraphMan is designed for the postman-collection spec 2.1
Visualizing and exploring existing graphql APIs can be quite daunting. Using postman to manage all your apis is pretty standard, however creating and maintaining collections is difficult. GraphMan makes thoses things easy, helping you for:
- Graph discovery
- Graph testing
- Collection updating
Run from url
- Install deno
deno run https://firstname.lastname@example.org/src/cli.ts <graphql endpoint url>
- Import the generated
[...].postman_collection.jsonfile in postman.
If you want to access graphman easly you can "install" it on your machine:
- Install deno
deno install -r -f --allow-net --allow-write -n graphman https://email@example.com/src/cli.ts
- The command will output
export PATH="..."copy paste it in your
~/.zshrcfile to add graphman to your path. You can now run graphman using the
🎉To update GraphMan just reproduce the step 2.
Note: this is not a real installation, it just creates a script that basically aliases the run form url command.
- Clone the repo
deno run src/index.ts <params>
Note that deno will ask for network and file-system permissions as it's runtime is secure by default
The relases are mirrored at https://deno.land/x/graphman@VERSION, you can use previous versions if needed.
- Custom output filename:
- Authorization header:
- Get help:
You can try graphman on public graphql APIs, and it is a great way to get started with graphQL:
- Rick&Morty API:
deno run https://firstname.lastname@example.org/src/cli.ts https://rickandmortyapi.com/graphql
|GraphMan collection for the Rick and morty API|
|Character query for the Rick and morty API collection|
Issues and contributions
- Please open an issue if you encounter bugs, with reproduction steps and error message.
- For feature requests, please open an issue too
- Feel free to create merge requests to improve GraphMan !