pm2insomnia 0.1.0__tar.gz

pm2insomnia-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Antonio Saco
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pm2insomnia-0.1.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: pm2insomnia
+Version: 0.1.0
+Summary: CLI to convert Postman collections into Insomnia imports
+License-Expression: MIT
+Keywords: cli,postman,insomnia,api,converter
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: build>=1.2.2; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: ruff>=0.11.0; extra == "dev"
+Requires-Dist: twine>=6.1.0; extra == "dev"
+Dynamic: license-file
+
+<h1 align="center">
+  <img src="assets/post-insomnia-icon.svg" alt="pm2insomnia icon" width="180" /><br />
+  pm2insomnia
+</h1>
+
+<p align="center">
+  <a href="https://github.com/antonillos/pm2insomnia/actions/workflows/tests.yml">
+    <img src="https://github.com/antonillos/pm2insomnia/actions/workflows/tests.yml/badge.svg" alt="Tests" />
+  </a>
+  <img src="https://img.shields.io/badge/python-3.11%2B-blue" alt="Python 3.11+" />
+  <img src="https://img.shields.io/badge/code%20style-ruff-261230?logo=ruff&logoColor=white" alt="Code style: Ruff" />
+  <a href="LICENSE">
+    <img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="MIT License" />
+  </a>
+</p>
+
+<h3 align="center">
+  Move your Postman collections to Insomnia in seconds — no manual work.
+</h3>
+
+<p align="center">
+  <a href="#install">Install</a> •
+  <a href="#usage">Usage</a> •
+  <a href="#what-gets-converted">What gets converted</a> •
+  <a href="#license">License</a>
+</p>
+
+---
+
+If your team exports collections from Postman but you prefer working in Insomnia, `pm2insomnia` does the conversion for you. Drop in a Postman export, get an Insomnia file ready to import — folders, requests, environments, auth, and examples included.
+
+## Install
+
+The easiest way is with [pipx](https://pipx.pypa.io), which installs the tool globally and keeps it isolated from your Python environment:
+
+```bash
+pipx install pm2insomnia
+```
+
+That's it. The `pm2insomnia` command is now available anywhere in your terminal.
+
+> **Don't have pipx?** Install it first:
+> ```bash
+> pip install pipx
+> ```
+
+## Usage
+
+### Convert a collection
+
+```bash
+pm2insomnia convert --input my-collection.postman.json
+```
+
+This creates `my-collection.insomnia.json` in the same folder. Open Insomnia, go to **Import**, and select that file.
+
+Want to include your Postman environments too?
+
+```bash
+pm2insomnia convert \
+  --input my-collection.postman.json \
+  --environment my-environments.json
+```
+
+### Export a versioned bundle
+
+If you want to store the collection and API docs together in a repository:
+
+```bash
+pm2insomnia bundle \
+  --input my-api-1.9.1.postman.json \
+  --workspace-name "My API" \
+  --output-dir exports/
+```
+
+This generates a tidy folder structure:
+
+```
+exports/
+  collections/my-api/1.9.1/my-api.insomnia.json
+  api-docs/my-api/1.9.1/README.md
+```
+
+You can also attach an OpenAPI spec:
+
+```bash
+pm2insomnia bundle \
+  --input my-api-1.9.1.postman.json \
+  --workspace-name "My API" \
+  --spec openapi.yaml \
+  --environment environments.zip \
+  --output-dir exports/
+```
+
+### Importing in Insomnia
+
+1. Open Insomnia → **Import**
+2. Select the `.insomnia.json` file
+3. Done — your collection, environments, and examples are ready
+
+## Options
+
+| Flag | What it does |
+|------|-------------|
+| `--input` | Path to your Postman collection JSON |
+| `--environment` | Postman environment file (`.json` or `.zip`). Repeat for multiple files |
+| `--output` | Where to write the Insomnia file (default: same folder as input) |
+| `--output-dir` | Write the output into a specific directory |
+| `--workspace-name` | Override the workspace name shown in Insomnia |
+| `--pretty` | Format the JSON output so it's readable |
+| `--strict` | Fail with exit code `2` if anything couldn't be converted |
+
+## What gets converted
+
+✅ Folders and subfolders  
+✅ Requests — method, URL, headers, query params  
+✅ Request and folder descriptions  
+✅ Body — raw, form, and URL-encoded  
+✅ Path variables  
+✅ Bearer auth  
+✅ Saved response examples  
+✅ Collection variables → Insomnia base environment  
+✅ Postman environments → Insomnia sub-environments  
+
+## What doesn't convert
+
+These Postman features have no direct equivalent in Insomnia and are skipped. The tool will warn you when it encounters them:
+
+- Pre-request and test scripts
+- Auth types other than Bearer
+- GraphQL body mode
+- Variable resolution (placeholders are kept as-is)
+
+## License
+
+MIT. See [LICENSE](LICENSE).

pm2insomnia-0.1.0/README.md

@@ -0,0 +1,136 @@
+<h1 align="center">
+  <img src="assets/post-insomnia-icon.svg" alt="pm2insomnia icon" width="180" /><br />
+  pm2insomnia
+</h1>
+
+<p align="center">
+  <a href="https://github.com/antonillos/pm2insomnia/actions/workflows/tests.yml">
+    <img src="https://github.com/antonillos/pm2insomnia/actions/workflows/tests.yml/badge.svg" alt="Tests" />
+  </a>
+  <img src="https://img.shields.io/badge/python-3.11%2B-blue" alt="Python 3.11+" />
+  <img src="https://img.shields.io/badge/code%20style-ruff-261230?logo=ruff&logoColor=white" alt="Code style: Ruff" />
+  <a href="LICENSE">
+    <img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="MIT License" />
+  </a>
+</p>
+
+<h3 align="center">
+  Move your Postman collections to Insomnia in seconds — no manual work.
+</h3>
+
+<p align="center">
+  <a href="#install">Install</a> •
+  <a href="#usage">Usage</a> •
+  <a href="#what-gets-converted">What gets converted</a> •
+  <a href="#license">License</a>
+</p>
+
+---
+
+If your team exports collections from Postman but you prefer working in Insomnia, `pm2insomnia` does the conversion for you. Drop in a Postman export, get an Insomnia file ready to import — folders, requests, environments, auth, and examples included.
+
+## Install
+
+The easiest way is with [pipx](https://pipx.pypa.io), which installs the tool globally and keeps it isolated from your Python environment:
+
+```bash
+pipx install pm2insomnia
+```
+
+That's it. The `pm2insomnia` command is now available anywhere in your terminal.
+
+> **Don't have pipx?** Install it first:
+> ```bash
+> pip install pipx
+> ```
+
+## Usage
+
+### Convert a collection
+
+```bash
+pm2insomnia convert --input my-collection.postman.json
+```
+
+This creates `my-collection.insomnia.json` in the same folder. Open Insomnia, go to **Import**, and select that file.
+
+Want to include your Postman environments too?
+
+```bash
+pm2insomnia convert \
+  --input my-collection.postman.json \
+  --environment my-environments.json
+```
+
+### Export a versioned bundle
+
+If you want to store the collection and API docs together in a repository:
+
+```bash
+pm2insomnia bundle \
+  --input my-api-1.9.1.postman.json \
+  --workspace-name "My API" \
+  --output-dir exports/
+```
+
+This generates a tidy folder structure:
+
+```
+exports/
+  collections/my-api/1.9.1/my-api.insomnia.json
+  api-docs/my-api/1.9.1/README.md
+```
+
+You can also attach an OpenAPI spec:
+
+```bash
+pm2insomnia bundle \
+  --input my-api-1.9.1.postman.json \
+  --workspace-name "My API" \
+  --spec openapi.yaml \
+  --environment environments.zip \
+  --output-dir exports/
+```
+
+### Importing in Insomnia
+
+1. Open Insomnia → **Import**
+2. Select the `.insomnia.json` file
+3. Done — your collection, environments, and examples are ready
+
+## Options
+
+| Flag | What it does |
+|------|-------------|
+| `--input` | Path to your Postman collection JSON |
+| `--environment` | Postman environment file (`.json` or `.zip`). Repeat for multiple files |
+| `--output` | Where to write the Insomnia file (default: same folder as input) |
+| `--output-dir` | Write the output into a specific directory |
+| `--workspace-name` | Override the workspace name shown in Insomnia |
+| `--pretty` | Format the JSON output so it's readable |
+| `--strict` | Fail with exit code `2` if anything couldn't be converted |
+
+## What gets converted
+
+✅ Folders and subfolders  
+✅ Requests — method, URL, headers, query params  
+✅ Request and folder descriptions  
+✅ Body — raw, form, and URL-encoded  
+✅ Path variables  
+✅ Bearer auth  
+✅ Saved response examples  
+✅ Collection variables → Insomnia base environment  
+✅ Postman environments → Insomnia sub-environments  
+
+## What doesn't convert
+
+These Postman features have no direct equivalent in Insomnia and are skipped. The tool will warn you when it encounters them:
+
+- Pre-request and test scripts
+- Auth types other than Bearer
+- GraphQL body mode
+- Variable resolution (placeholders are kept as-is)
+
+## License
+
+MIT. See [LICENSE](LICENSE).

pm2insomnia-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pm2insomnia"
+version = "0.1.0"
+description = "CLI to convert Postman collections into Insomnia imports"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["cli", "postman", "insomnia", "api", "converter"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Build Tools",
+  "Topic :: Utilities",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["build>=1.2.2", "pytest>=8.0.0", "ruff>=0.11.0", "twine>=6.1.0"]
+
+[project.scripts]
+pm2insomnia = "pm2insomnia.cli:main"
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+ignore = ["E501"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "lf"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

pm2insomnia-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pm2insomnia-0.1.0/src/pm2insomnia/__init__.py

@@ -0,0 +1,3 @@
+"""pm2insomnia package."""
+
+__version__ = "0.1.0"