@devkong/cli-nx 0.0.27 → 0.0.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devkong/cli-nx",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "type": "commonjs",
   "main": "./src/index.js",
   "typings": "./src/index.d.ts",

package/src/generators/preset/files/kotlin/README.md

@@ -2,14 +2,19 @@
 
 Welcome to the Kong extension development workspace!
 
+To have a better experience, open this file in preview mode of your IDE.
+
 ### Prerequisites
 
-Before you start, make sure you have the following installed:
+Before you start, make sure you have the following installed depending on your OS:
+
+[▶ Windows Setup](#windows-setup)
 
-- [Node.js](https://nodejs.org/en/download/prebuilt-installer). Version >= 20.0
-- [Docker](https://docs.docker.com/desktop/). If using Docker Desktop, start it
+[▶ macOS Setup](#macos-setup)
 - Mac M2 users, see [Troubleshooting](#Troubleshooting)
 
+[▶ Ubuntu Linux Setup](#ubuntu-setup)
+
 To verify the installation and check the versions, run the following commands:
 
 ```shell script
@@ -74,4 +79,181 @@ To emulate a Linux platform, you need to install Rosetta:
 
 ```shell script
 softwareupdate --install-rosetta
-```
+```
+
+
+<details id="windows-setup">
+<summary><strong>Windows Setup</strong></summary>
+
+### Install Windows Subsystem for Linux (WSL2)
+
+1. Open PowerShell as Administrator.
+2. Run the following command to install WSL and set WSL2 as the default version:
+   ```powershell
+   wsl --install
+   ```
+3. Restart your computer if prompted.
+4. After restarting, install a preferred Linux distribution (e.g., Ubuntu) by running:
+   ```powershell
+   wsl --install -d Ubuntu
+   ```
+
+### Install Docker within WSL2
+
+1. Download Docker Desktop for Windows from [Docker's official website](https://www.docker.com/products/docker-desktop).
+2. Run the installer and follow the setup instructions.
+3. During installation, ensure the "Use the WSL 2 based engine" option is selected.
+4. Once installed, open Docker Desktop, go to Settings > General, and enable "Use WSL 2 based engine" if it isn't already enabled.
+5. Confirm Docker is working in your WSL2 distribution (e.g., Ubuntu) by running:
+   ```bash
+   docker --version
+   ```
+
+### Install Node.js and npm on Windows Host
+
+1. Download the Node.js installer for Windows from the [official Node.js website](https://nodejs.org/).
+2. Run the installer, making sure to include the npm package manager during installation.
+3. Verify installation by opening a new Command Prompt and running:
+   ```cmd
+   node -v
+   npm -v
+   ```
+
+### Install Python on Windows Host
+
+1. Download the Python installer for Windows from the [official Python website](https://www.python.org/downloads/windows/).
+2. Run the installer, making sure to check "Add Python to PATH" during setup.
+3. Verify installation by running:
+   ```cmd
+   python --version
+   pip --version
+   ```
+
+### Install Poetry on Windows Host
+
+1. Open Command Prompt or PowerShell.
+2. Run the following command:
+   ```powershell
+   (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -
+   ```
+3. Add Poetry to your PATH:
+   ```powershell
+   $env:Path += ";$env:USERPROFILE\.poetry\bin"
+   ```
+4. Verify installation:
+   ```powershell
+   poetry --version
+   ```
+
+</details>
+
+<details id="macos-setup">
+<summary><strong>macOS Setup</strong></summary>
+
+### Install Docker
+
+1. Download and install Docker Desktop for Mac from [Docker's official website](https://www.docker.com/products/docker-desktop).
+
+### Install Node.js and npm
+
+1. Use Homebrew to install:
+   ```bash
+   brew install node
+   ```
+2. Verify installation:
+   ```bash
+   node -v
+   npm -v
+   ```
+
+### Install Python
+
+1. Use Homebrew to install:
+   ```bash
+   brew install python
+   ```
+2. Verify installation:
+   ```bash
+   python3 --version
+   pip3 --version
+   ```
+
+### Install Poetry
+
+1. Run the following command:
+   ```bash
+   curl -sSL https://install.python-poetry.org | python3 -
+   ```
+2. Add Poetry to your PATH:
+   ```bash
+   export PATH="$HOME/.local/bin:$PATH"
+   ```
+3. Reload the shell:
+   ```bash
+   source ~/.bashrc
+   ```
+4. Verify installation:
+   ```bash
+   poetry --version
+   ```
+
+</details>
+
+<details id="ubuntu-setup">
+<summary><strong>Ubuntu Linux Setup</strong></summary>
+
+### Install Docker
+
+1. Follow the installation instructions on [Docker's official website](https://docs.docker.com/engine/install/ubuntu/).
+2. Start Docker and enable it to start on boot:
+   ```bash
+   sudo systemctl start docker
+   sudo systemctl enable docker
+   ```
+
+### Install Node.js and npm
+
+1. Run the following commands:
+   ```bash
+   sudo apt update
+   sudo apt install -y nodejs npm
+   ```
+2. Verify installation:
+   ```bash
+   node -v
+   npm -v
+   ```
+
+### Install Python
+
+1. Run the following commands:
+   ```bash
+   sudo apt update
+   sudo apt install -y python3 python3-pip
+   ```
+2. Verify installation:
+   ```bash
+   python3 --version
+   pip3 --version
+   ```
+
+### Install Poetry
+
+1. Run the following command:
+   ```bash
+   curl -sSL https://install.python-poetry.org | python3 -
+   ```
+2. Add Poetry to your PATH:
+   ```bash
+   export PATH="$HOME/.local/bin:$PATH"
+   ```
+3. Reload the shell:
+   ```bash
+   source ~/.bashrc
+   ```
+4. Verify installation:
+   ```bash
+   poetry --version
+   ```
+
+</details>

package/src/generators/preset/files/python/README.md

@@ -2,38 +2,39 @@
 
 Welcome to the Kong extension development workspace!
 
+To have a better experience, open this file in preview mode of your IDE.
+
 ### Prerequisites
 
-Before you start, make sure you have the following installed:
+Before you start, make sure you have the following installed depending on your OS:
+
+[▶ Windows Setup](#windows-setup)
+
+[▶ macOS Setup](#macos-setup)
+
+[▶ Ubuntu Linux Setup](#ubuntu-setup)
 
-- [Node.js](https://nodejs.org/en/download/prebuilt-installer). Version >= 20.0
-- [Python](https://www.python.org/downloads/). Version >= 3.10
-- [Docker](https://docs.docker.com/desktop/). If using Docker Desktop, start it
 - Mac M2 users, see [Troubleshooting](#Troubleshooting)
 
+
 To verify the installation and check the versions, run the following commands:
 
 ```shell script
 node --version
-python --version # or python3 --version
 docker info
 ```
 
 ### Getting Started
 
-1. Add your username to the `ownership` field in the `kong.json` file (e.g., "kong-dev", "kong-qa")
-2. Make sure you're in the terminal and inside the extension folder you generated
-3. Run the following commands in your terminal:
+1. Make sure you're in the terminal and inside the extension folder you generated
+2. Run the following commands in your terminal:
 
 ```shell script
 # configure the base Kong URL (e.g., https://kong.dev.app-dts.net)
 kong configure
-
-# install Python dependencies from requirements.txt
-kong install --verbose
 ```
 
-That's it! Now, modify [main.py](./src/main.py), tag it by publishing a new version, and assign aliases for use in the workflow.
+That's it! Now, modify [main.kt](./src/main/kotlin/io/kong/extension/Main.kt), tag it by publishing a new version, and assign aliases for use in the workflow.
 
 ### Publish a New Version
 
@@ -59,31 +60,6 @@ You can assign an alias (e.g., stable, beta) to a specific version. This alias w
 kong set-alias stable 1
 ```
 
-### Running and Debugging Tests
-
-To run the tests, execute the following command:
-
-```shell script
-pytest ./src
-```
-
-This will run the tests located in the `src` directory.
-The debugging process depends on the IDE you're using. For example, in [VSCode](https://code.visualstudio.com/), follow these steps:
-
-1. Open the Run and Debug panel from the left sidebar
-2. In the top combobox (dropdown), select "test" to configure the test environment
-3. Click the green play button to start debugging the tests
-
-This will allow you to set breakpoints and step through your tests.
-
-### Update Python Dependencies
-
-If you modify requirements.txt or requirements-dev.txt, run the following to apply the changes:
-
-```shell script
-kong install --verbose
-```
-
 ### Using a Custom Profile
 
 If you're developing an extension that will be used in different regions (or need to work with a specific profile), you can create a new profile using `kong configure`. Then, include the `--profile <name>` parameter when running the publish-version and set-alias commands to use the desired profile.
@@ -106,10 +82,179 @@ To emulate a Linux platform, you need to install Rosetta:
 softwareupdate --install-rosetta
 ```
 
-#### Using a Different Python Version
 
-To change the Python version, update the `FROM` statement in the `Dockerfile` to the desired version from [Docker Hub](https://hub.docker.com/_/python/):
-
-```docker
-FROM --platform=linux/amd64 python:3.13.1-slim-bullseye
-```
+<details id="windows-setup">
+<summary><strong>Windows Setup</strong></summary>
+
+### Install Windows Subsystem for Linux (WSL2)
+
+1. Open PowerShell as Administrator.
+2. Run the following command to install WSL and set WSL2 as the default version:
+   ```powershell
+   wsl --install
+   ```
+3. Restart your computer if prompted.
+4. After restarting, install a preferred Linux distribution (e.g., Ubuntu) by running:
+   ```powershell
+   wsl --install -d Ubuntu
+   ```
+
+### Install Docker within WSL2
+
+1. Download Docker Desktop for Windows from [Docker's official website](https://www.docker.com/products/docker-desktop).
+2. Run the installer and follow the setup instructions.
+3. During installation, ensure the "Use the WSL 2 based engine" option is selected.
+4. Once installed, open Docker Desktop, go to Settings > General, and enable "Use WSL 2 based engine" if it isn't already enabled.
+5. Confirm Docker is working in your WSL2 distribution (e.g., Ubuntu) by running:
+   ```bash
+   docker --version
+   ```
+
+### Install Node.js and npm on Windows Host
+
+1. Download the Node.js installer for Windows from the [official Node.js website](https://nodejs.org/).
+2. Run the installer, making sure to include the npm package manager during installation.
+3. Verify installation by opening a new Command Prompt and running:
+   ```cmd
+   node -v
+   npm -v
+   ```
+
+### Install Python on Windows Host
+
+1. Download the Python installer for Windows from the [official Python website](https://www.python.org/downloads/windows/).
+2. Run the installer, making sure to check "Add Python to PATH" during setup.
+3. Verify installation by running:
+   ```cmd
+   python --version
+   pip --version
+   ```
+
+### Install Poetry on Windows Host
+
+1. Open Command Prompt or PowerShell.
+2. Run the following command:
+   ```powershell
+   (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -
+   ```
+3. Add Poetry to your PATH:
+   ```powershell
+   $env:Path += ";$env:USERPROFILE\.poetry\bin"
+   ```
+4. Verify installation:
+   ```powershell
+   poetry --version
+   ```
+
+</details>
+
+<details id="macos-setup">
+<summary><strong>macOS Setup</strong></summary>
+
+### Install Docker
+
+1. Download and install Docker Desktop for Mac from [Docker's official website](https://www.docker.com/products/docker-desktop).
+
+### Install Node.js and npm
+
+1. Use Homebrew to install:
+   ```bash
+   brew install node
+   ```
+2. Verify installation:
+   ```bash
+   node -v
+   npm -v
+   ```
+
+### Install Python
+
+1. Use Homebrew to install:
+   ```bash
+   brew install python
+   ```
+2. Verify installation:
+   ```bash
+   python3 --version
+   pip3 --version
+   ```
+
+### Install Poetry
+
+1. Run the following command:
+   ```bash
+   curl -sSL https://install.python-poetry.org | python3 -
+   ```
+2. Add Poetry to your PATH:
+   ```bash
+   export PATH="$HOME/.local/bin:$PATH"
+   ```
+3. Reload the shell:
+   ```bash
+   source ~/.bashrc
+   ```
+4. Verify installation:
+   ```bash
+   poetry --version
+   ```
+
+</details>
+
+<details id="ubuntu-setup">
+<summary><strong>Ubuntu Linux Setup</strong></summary>
+
+### Install Docker
+
+1. Follow the installation instructions on [Docker's official website](https://docs.docker.com/engine/install/ubuntu/).
+2. Start Docker and enable it to start on boot:
+   ```bash
+   sudo systemctl start docker
+   sudo systemctl enable docker
+   ```
+
+### Install Node.js and npm
+
+1. Run the following commands:
+   ```bash
+   sudo apt update
+   sudo apt install -y nodejs npm
+   ```
+2. Verify installation:
+   ```bash
+   node -v
+   npm -v
+   ```
+
+### Install Python
+
+1. Run the following commands:
+   ```bash
+   sudo apt update
+   sudo apt install -y python3 python3-pip
+   ```
+2. Verify installation:
+   ```bash
+   python3 --version
+   pip3 --version
+   ```
+
+### Install Poetry
+
+1. Run the following command:
+   ```bash
+   curl -sSL https://install.python-poetry.org | python3 -
+   ```
+2. Add Poetry to your PATH:
+   ```bash
+   export PATH="$HOME/.local/bin:$PATH"
+   ```
+3. Reload the shell:
+   ```bash
+   source ~/.bashrc
+   ```
+4. Verify installation:
+   ```bash
+   poetry --version
+   ```
+
+</details>

package/src/generators/preset/files/python/requirements.txt

@@ -1,3 +1,3 @@
 --extra-index-url https://nexus.shared.app-dts.net/repository/python-hosted/simple
 pydantic==2.10.3
-kong-sdk==0.0.33
+kong-sdk==0.0.36