Merge branch 'main' into resolve-issue-json

Author: ashitaprasad

.gitignore

@@ -5,9 +5,11 @@
 *.swp
 .DS_Store
 .atom/
+.build/
 .buildlog/
 .history
 .svn/
+.swiftpm/
 migrate_working_dir/
 .fvm
 .fvmrc

doc/dev_guide/api_endpoints_for_testing.md

@@ -15,3 +15,28 @@ A List of API endpoints that can be used for testing API Dash
 #### For Testing sites with Bad Certificate
 - https://badssl.com/
 - https://www.ssl.com/sample-valid-revoked-and-expired-ssl-tls-certificates/
+
+#### PDF
+
+- https://training.github.com/downloads/github-git-cheat-sheet.pdf
+
+#### Text
+
+- https://www.google.com/robots.txt
+
+#### JSON
+
+- https://api.apidash.dev/openapi.json
+
+#### XML
+
+- https://apidash.dev/sitemap.xml
+
+#### Video
+
+- https://download.blender.org/peach/bigbuckbunny_movies/
+- https://flutter.github.io/assets-for-api-docs/assets/videos/bee.mp4
+
+#### Audio
+
+- 

doc/proposals/2025/gsoc/application_papa_kofi_api_auth.md

@@ -0,0 +1,49 @@
+## Instructions
+
+- Create a fork of API Dash.
+- In the folder [doc/proposals/2025/gsoc](https://github.com/foss42/apidash/tree/main/doc/proposals/2025/gsoc) create a file named `application_<your name>_<short project name>.md`
+
+The file should contain the follow:
+
+```
+### About 
+
+1. Full Name
+3. Contact info (email, phone, etc.)
+6. Discord handle
+7. Home page (if any)
+8. Blog (if any)
+9. GitHub profile link 
+10. Twitter, LinkedIn, other socials
+11. Time zone
+12. Link to a resume (PDF, publicly accessible via link and not behind any login-wall)
+
+### University Info
+
+1. University name
+2. Program you are enrolled in (Degree & Major/Minor)
+3. Year 
+5. Expected graduation date
+
+### Motivation & Past Experience
+
+Short answers to the following questions (Add relevant links wherever you can):
+1. Have you worked on or contributed to a FOSS project before? Can you attach repo links or relevant PRs? 
+2. What is your one project/achievement that you are most proud of? Why?
+3. What kind of problems or challenges motivate you the most to solve them?
+4. Will you be working on GSoC full-time? In case not, what will you be studying or working on while working on the project?
+6. Do you mind regularly syncing up with the project mentors?
+7. What interests you the most about API Dash?
+8. Can you mention some areas where the project can be improved?
+
+### Project Proposal Information
+
+1. Proposal Title
+2. Abstract: A brief summary about the problem that you will be tackling & how.
+3. Detailed Description
+4. Weekly Timeline: A rough week-wise timeline of activities that you would undertake.
+
+```
+
+- Feel free to add images by adding it to the `images` folder inside [doc/proposals/2025/gsoc](https://github.com/foss42/apidash/tree/main/doc/proposals/2025/gsoc) and linking it to your doc.
+- Finally, send your application as a PR for review.

doc/proposals/2025/gsoc/idea_Akshay_Waghmare_ai-agent-testing.md

@@ -0,0 +1,26 @@
+## Instructions
+
+- Create a fork of API Dash.
+- In the folder [doc/proposals/2025/gsoc](https://github.com/foss42/apidash/tree/main/doc/proposals/2025/gsoc) create a file named `idea_<your name>_<short project name>.md`
+
+The file should contain the following:
+
+```
+### Initial Idea Submission
+
+Full Name:   
+University name:   
+Program you are enrolled in (Degree & Major/Minor):   
+Year:   
+Expected graduation date:  
+
+Project Title: <Write your idea title>  
+Relevant issues: <Add links to the relevant issues>  
+
+Idea description:
+<Write you thoughts below discussing your approach and how will you implement it>
+
+```
+
+- Feel free to add images by adding it to the `images` folder inside [doc/proposals/2025/gsoc](https://github.com/foss42/apidash/tree/main/doc/proposals/2025/gsoc) and linking it to your doc.
+- Finally, send you changes as a PR for review.

doc/proposals/2025/gsoc/images/oauth1.png

@@ -268,15 +268,100 @@ Here are the detailed instructions for running the generated API Dash code in **
 
 ## Go (net/http)
 
-TODO
+### 1. Install Go compiler
+
+- Windows and MacOS: check out the [official source](https://go.dev/doc/install)
+- Linux: Install from your distro's package manager.
+
+Verify if go is installed:
+
+```bash
+go version
+```
+
+### 2. Create a project
+```bash
+go mod init example.com/api
+```
+
+### 3. Run the generated code
+- Paste the generated code into `main.go`.
+- Build and run by `go run main.go`.
 
 ## JavaScript (axios)
 
-TODO
+The generated api code can be run in browser by using the code in an html file as demonstrated below:
+
+### 1. Create the html file with generated code
+
+Create a new file `index.html`
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Axios Example</title>
+    <script src="https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js"></script>
+</head>
+<body>
+    <script>
+        // Paste your API Dash generated code here !!
+    </script>
+</body>
+</html>
+
+```
+
+Make sure to paste the generated js code from api dash under the `<script>` tag.
+
+### 2. Test with Browser Developer Tools
+
+Open the `index.html` file in a modern browser and open devtools.
+
+- **Chrome**: Right-click the page and select "Inspect" or press Ctrl+Shift+I (Windows/Linux) or Cmd+Option+I (macOS).
+
+- **Firefox**: Right-click the page and select "Inspect Element" or press Ctrl+Shift+I (Windows/Linux) or Cmd+Option+I (macOS).
+
+- **Edge**: Right-click the page and select "Inspect" or press F12 or Ctrl+Shift+I.
+
+Navigate to network tab and refresh the page to see the requests and network activity.
 
 ## JavaScript (fetch)
 
-TODO
+The generated api code can be run in browser by using the code in an html file as demonstrated below:
+
+### 1. Create the html file with generated code
+
+Create a new file `index.html`
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Fetch Example</title>
+</head>
+<body>
+    <script>
+        // Paste your API Dash generated code here !!
+    </script>
+</body>
+</html>
+
+```
+
+Make sure to paste the generated js code from api dash under the `<script>` tag.
+
+### 2. Test with Browser Developer Tools
+
+Open the `index.html` file in a modern browser and open devtools.
+
+- **Chrome**: Right-click the page and select "Inspect" or press Ctrl+Shift+I (Windows/Linux) or Cmd+Option+I (macOS).
+
+- **Firefox**: Right-click the page and select "Inspect Element" or press Ctrl+Shift+I (Windows/Linux) or Cmd+Option+I (macOS).
+
+- **Edge**: Right-click the page and select "Inspect" or press F12 or Ctrl+Shift+I.
+
+Navigate to network tab and refresh the page to see the requests and network activity.
 
 ## node.js (JavaScript, axios)
 
@@ -655,7 +740,88 @@ java -jar api_test.jar
 
 ## PHP (curl)
 
-TODO
+Here are the detailed instructions for running the generated API Dash code in PHP (using `curl`) for macOS, Windows, and Linux:
+
+### 1. Install and set PHP:
+Before starting out, we need to install PHP in our system. 
+#### macOS:
+- Go to the official PHP website: [https://www.php.net/manual/en/install.macosx.php](https://www.php.net/manual/en/install.macosx.php)
+- Follow the installation instructions.
+
+#### Windows:
+- Go to the official PHP website: [https://www.php.net/manual/en/install.windows.php](https://www.php.net/manual/en/install.windows.php)
+- Follow the installation instructions.
+
+#### Linux:
+The installation process depends on your Linux distribution. Use the appropriate command below:
+- ##### Ubuntu/Debian
+```bash
+sudo apt update
+sudo apt install php php-cli php-curl php-mbstring php-xml php-zip -y
+```
+- ##### Arch Linux / Manjaro
+```bash
+sudo pacman -S php php-apache php-cgi php-curl php-mbstring php-xml php-zip
+```
+- ##### Fedora / CentOS
+```bash
+- sudo dnf install php php-cli php-curl php-mbstring php-xml php-zip -y
+```
+- ##### OpenSUSE
+```bash
+sudo zypper install php php-cli php-curl php-mbstring php-xml php-zip
+```
+
+✅ Finally, check that everything works correctly pasting this command in your terminal
+```bash
+php --version
+```
+
+### 2. Check cURL
+cURL is usually enabled by default. To check if it's active, run:
+```bash
+php -m | grep curl
+```
+and check if it returns **curl** as output
+
+#### If curl is disabled
+
+ 1. Open the `php.ini` configuration file. You can find its location by running:
+```bash
+php --ini
+```
+ 2. Open the file in a text editor/IDE
+ 3. Find this line
+```bash
+;extension=curl
+```
+ 4. Remove the semicolon (`;`) at the beginning to enable it:
+```bash
+extension=curl
+```
+ 5. Save and restart php by using
+```bash
+sudo systemctl restart apache2  # For Apache
+sudo systemctl restart php8.2-fpm  # For PHP-FPM (Nginx)
+```
+
+### 3. Execute the generated code:
+Once you have everything needed installed, follow these steps to execute the generated code:
+
+1. **Open a IDE/text editor** ✍️ (Visual Studio, VS Code or any other text editor).
+2. **Create a php file ( ex. `request.php` )** ✍️ (Visual Studio, VS Code or any other text editor).
+3. **Copy and paste the generated API code** 📋 from API Dash into the `request.php` file.
+
+#### In Visual Studio:
+1. Click the **Start Debugging `(F5)`** button from the top menu to run the project.
+2. The terminal will display the API response.
+
+#### Using the CLI:
+ 1. Open the terminal at the project root directory and run the file you've created:
+   ```bash
+   php filename.php
+   ```
+ 2. The terminal will display the API response.
 
 ## PHP (guzzle)
 

doc/proposals/2025/gsoc/templates/gsoc_application_template.md

@@ -1,6 +1,7 @@
 import 'dart:convert';
 import 'package:apidash_core/apidash_core.dart';
 import 'package:code_builder/code_builder.dart';
+import 'package:pub_semver/pub_semver.dart';
 import 'package:dart_style/dart_style.dart';
 import 'shared.dart';
 
@@ -141,7 +142,8 @@ class DartDioCodeGen {
     sbf.writeln(mainFunction.accept(emitter));
 
     return DartFormatter(
-            pageWidth: contentType == ContentType.formdata ? 70 : 160)
-        .format(sbf.toString());
+      languageVersion: Version(3, 2, 4),
+      pageWidth: contentType == ContentType.formdata ? 70 : 160,
+    ).format(sbf.toString());
   }
 }

doc/proposals/2025/gsoc/templates/initial_idea_template.md

@@ -2,6 +2,7 @@ import 'dart:convert';
 import 'dart:io';
 import 'package:apidash_core/apidash_core.dart';
 import 'package:code_builder/code_builder.dart';
+import 'package:pub_semver/pub_semver.dart';
 import 'package:dart_style/dart_style.dart';
 import 'shared.dart';
 
@@ -225,7 +226,8 @@ class DartHttpCodeGen {
     sbf.writeln(mainFunction.accept(emitter));
 
     return DartFormatter(
-            pageWidth: contentType == ContentType.formdata ? 70 : 160)
-        .format(sbf.toString());
+      languageVersion: Version(3, 2, 4),
+      pageWidth: contentType == ContentType.formdata ? 70 : 160,
+    ).format(sbf.toString());
   }
 }