{"id":24538622,"url":"https://github.com/bitecraft/yaak2postman","last_synced_at":"2025-04-15T02:53:18.513Z","repository":{"id":272384091,"uuid":"916414144","full_name":"BiteCraft/yaak2postman","owner":"BiteCraft","description":"A simple TypeScript CLI tool that converts YAAK files to Postman format. Easily transform your YAAK workspaces, collections and environment variables into Postman v2.1.0 format while preserving folder structures, request details, and environment variables. Perfect for teams migrating from YAAK to Postman or Insomnia.","archived":false,"fork":false,"pushed_at":"2025-01-14T04:30:38.000Z","size":13,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-15T02:53:13.299Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BiteCraft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["BiteCraft"],"patreon":"bitecraft","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"custom":null}},"created_at":"2025-01-14T03:31:22.000Z","updated_at":"2025-03-25T07:10:10.000Z","dependencies_parsed_at":"2025-01-14T04:44:12.228Z","dependency_job_id":null,"html_url":"https://github.com/BiteCraft/yaak2postman","commit_stats":null,"previous_names":["bitecraft/yaak2postman"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BiteCraft%2Fyaak2postman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BiteCraft%2Fyaak2postman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BiteCraft%2Fyaak2postman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BiteCraft%2Fyaak2postman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BiteCraft","download_url":"https://codeload.github.com/BiteCraft/yaak2postman/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248997088,"owners_count":21195797,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-22T15:14:03.093Z","updated_at":"2025-04-15T02:53:18.495Z","avatar_url":"https://github.com/BiteCraft.png","language":"TypeScript","funding_links":["https://github.com/sponsors/BiteCraft","https://patreon.com/bitecraft"],"categories":[],"sub_categories":[],"readme":"```                                                 \n __   __          _    ____  ____           _                         \n \\ \\ / /_ _  __ _| | _|___ \\|  _ \\ ___  ___| |_ _ __ ___   __ _ _ __  \n  \\ V / _` |/ _` | |/ / __) | |_) / _ \\/ __| __| '_ ` _ \\ / _` | '_ \\ \n   | | (_| | (_| |   \u003c / __/|  __/ (_) \\__ \\ |_| | | | | | (_| | | | |\n   |_|\\__,_|\\__,_|_|\\_\\_____|_|   \\___/|___/\\__|_| |_| |_|\\__,_|_| |_|\n```\n\n# YAAK to Postman Converter 🔄\n\n\u003e A simple CLI tool to convert YAAK exported files into Postman collections and environments 🛠️\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node.js Version](https://img.shields.io/badge/node-%3E%3D14.0.0-brightgreen)](https://nodejs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.3.3-blue)](https://www.typescriptlang.org/)\n\n## Table of Contents\n\n• [Overview](#overview)  \n• [Features](#features)  \n• [Installation](#installation)  \n• [Usage](#usage)  \n• [Examples](#examples)\n• [Development](#development)  \n• [API Reference](#api-reference)  \n• [Contributing](#contributing)  \n• [License](#license)  \n\n## Overview 🎯\n\nYAAK to Postman Converter is a command-line interface tool that transforms YAAK format files into Postman collections and environments. It maintains folder structures, request details, and environment variables while providing a seamless conversion experience.\n\n## Features ✨\n\n- 🔄 Convert YAAK files to Postman Collection v2.1.0\n- 🌍 Environment variables support\n- 📁 Preserves folder hierarchy\n- 🔗 Handles both relative and absolute paths\n- 🚀 Fast and efficient processing\n- 💾 Automatic file saving\n- 🎯 Type-safe implementation\n\n## Installation 📦\n\n```bash\n# Using npm\nnpm install -g @bitecraft/yaak2postman\n\n# Using Bun\nbun install -g @bitecraft/yaak2postman\n\n# Using pnpm\npnpm install -g @bitecraft/yaak2postman\n\n# Using yarn\nyarn global add @bitecraft/yaak2postman\n```\n\n## Usage 🚀\n\nThe CLI supports three main usage patterns:\n\n```bash\n# Convert both collection and environments\nyaak2postman path/to/yaak-file.json\n\n# Convert only collection\nyaak2postman collection path/to/yaak-file.json\n\n# Convert only environments\nyaak2postman env path/to/yaak-file.json\n```\n\n## Examples 📝\n\n### Converting a YAAK File\n```bash\nyaak2postman ./my-api.json\n```\n\n### Converting Only Collection\n```bash\nyaak2postman collection ./my-api.json\n```\n\n### Converting Only Environment\n```bash\nyaak2postman env ./my-api.json\n```\n\n## Development 🛠️\n\n### Prerequisites\n\n- Node.js \u003e= 14.0.0\n- Bun (latest version)\n- TypeScript knowledge\n\n### Setting Up Development Environment\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/yourusername/yaak2postman.git\ncd yaak2postman\n```\n\n2. Install dependencies:\n```bash\nbun install\n```\n\n3. Start development:\n```bash\nbun run start\n```\n\n### Building the Project\n\n```bash\nbun run build\n```\n\n## API Reference 📚\n\n### YAAK Structure\nThe tool expects a YAAK file with the following structure:\n\n```typescript\ninterface YaakData {\n    resources: {\n        workspaces: YaakWorkspace[];\n        environments: YaakEnvironment[];\n        folders: YaakFolder[];\n        httpRequests: YaakRequest[];\n    };\n}\n```\n\n### Output Format\nThe tool generates Postman Collection v2.1.0 format files:\n\n```typescript\ninterface PostmanCollection {\n    info: {\n        name: string;\n        description: string;\n        schema: string;\n    };\n    item: (PostmanFolder | PostmanRequest)[];\n    variable: PostmanVariable[];\n}\n```\n\n## Contributing 🤝\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## License 📄\n\nThis project is licensed under the ISC License - see the [LICENSE](LICENSE) file for details.\n\n---\n\nMade with ❤️ using TypeScript and Bun ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitecraft%2Fyaak2postman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitecraft%2Fyaak2postman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitecraft%2Fyaak2postman/lists"}