Develop

.asyncapi-tool.json

@@ -3,7 +3,7 @@
   "description": "Your API Mocking Tool for Agile Development. Mock and simulate AsyncAPI and OpenAPI services for local testing, development, and CI pipelines — with a visual dashboard to inspect your mocks and a powerful test data generator fully customizable with JavaScript.",
   "links": {
     "websiteUrl": "https://mokapi.io",
-    "docsUrl": "https://mokapi.io/docs/guides/welcome",
+    "docsUrl": "https://mokapi.io/docs/welcome",
     "repoUrl": "https://github.com/marle3003/mokapi"
   },
   "filters": {

.github/actions/build-cli-flags-doc/action.yaml

@@ -2,17 +2,11 @@ name: "Build Mokapi CLI Flags doc"
 runs:
   using: composite
   steps:
-    - name: Create directory and file
+    - name: Create dist directory and file
       shell: bash
       run: |
         mkdir -p webui/dist
         touch webui/dist/.tmp
     - name: Build CLI doc
       shell: bash
-      run: go run ./cmd/internal/gen-cli-docs/main.go
-    - name: Add CLI Flags nav entry
-      working-directory: ./docs
-      shell: bash
-      run: |
-        jq '.Configuration.items.Static.items["CLI Flags"] = "configuration/static/mokapi.md"' ./config.json > ./tmp.json
-        mv ./tmp.json ./config.json
+      run: go run ./cmd/internal/gen-cli-docs/main.go

.github/actions/build-release-notes/action.yml

@@ -9,7 +9,7 @@ runs:
         VERSION=$(jq -r '.release.tag_name' "$GITHUB_EVENT_PATH")
         BODY=$(jq -r '.release.body' "$GITHUB_EVENT_PATH")
         {
-          echo "# Mokapi $VERSION"
+          echo "## Mokapi $VERSION"
           echo
           echo "$BODY"
         } > docs/release.md

.github/actions/publish-website/action.yml

@@ -51,25 +51,12 @@ runs:
       if: always()
       run: docker stop mokapi || true
       shell: bash
-    - name: build webui
+    - uses: ./.github/actions/build-cli-flags-doc
+    - name: build website
       working-directory: ./webui
       run: |
         npm install
         npm version ${{ steps.release.outputs.release }}
-        npm run build
-      shell: bash
-    - name: Build CLI doc
-      run: go run ./cmd/internal/gen-cli-docs/main.go
-      shell: bash
-    - name: Add CLI Flags nav entry
-      run: |
-         jq '.Configuration.items.Static.items["CLI Flags"] = "configuration/static/mokapi.md"' ./config.json > ./tmp.json
-         mv ./tmp.json ./config.json
-      working-directory: ./docs
-      shell: bash
-    - name: build website
-      working-directory: ./webui
-      run: |
         npm run copy-docs
         npm run build-sitemap
         npm run build-website

.github/workflows/release.yml

@@ -17,7 +17,6 @@ jobs:
       - uses: actions/setup-go@v5
         with:
           go-version: 1.25.5
-      - uses: ./.github/actions/build-cli-flags-doc
       - uses: ./.github/actions/build-release-notes
       - uses: actions/setup-node@v4
         with:

README.md

@@ -14,7 +14,7 @@
 </p>
 <p align="center">
     <a href="https://github.com/marle3003/mokapi/releases">Download</a> ·
-    <a href="https://mokapi.io/docs/guides/welcome">Documentation</a>
+    <a href="https://mokapi.io/docs/welcome">Documentation</a>
 </p>
 
 # 🚀 Overview
@@ -99,32 +99,32 @@ Mokapi’s dashboard lets you visualize your mock APIs. View requests and respon
 
 Explore tutorials that walk you through mocking different protocols and scenarios:
 
-- 🌍 [Get started with REST API](https://mokapi.io/docs/resources/tutorials/get-started-with-rest-api)\
+- 🌍 [Get started with REST API](https://mokapi.io/resources/tutorials/get-started-with-rest-api)\
   This tutorial will show you how to mock a REST API using an OpenAPI specification.
 
-- ⚡ [Mocking Kafka with AsyncAPI](https://mokapi.io/docs/resources/tutorials/get-started-with-kafka)\
+- ⚡ [Mocking Kafka with AsyncAPI](https://mokapi.io/resources/tutorials/get-started-with-kafka)\
   Mocking a Kafka topic using Mokapi and verifying that a producer generates valid messages.
 
-- 👨‍💻 [Mocking LDAP Authentication](https://mokapi.io/docs/resources/tutorials/mock-ldap-authentication-in-node)\
+- 👨‍💻 [Mocking LDAP Authentication](https://mokapi.io/resources/tutorials/mock-ldap-authentication-in-node)\
   Simulate LDAP-based login flows, including group-based permissions.
 
-- 📧 [Mocking SMTP Mail Servers](https://mokapi.io/docs/resources/tutorials/mock-smtp-server-send-mail-using-node)\
+- 📧 [Mocking SMTP Mail Servers](https://mokapi.io/resources/tutorials/mock-smtp-server-send-mail-using-node)\
   Use Mokapi to simulate sending and receiving emails in Node.js apps.
 
-- 🖥️ [End-to-End Testing with Jest and GitHub Actions](https://mokapi.io/docs/resources/tutorials/running-mokapi-in-a-ci-cd-pipeline)\
+- 🖥️ [End-to-End Testing with Jest and GitHub Actions](https://mokapi.io/resources/tutorials/running-mokapi-in-a-ci-cd-pipeline)\
   Integrate Mokapi into your CI pipeline for full-stack E2E testing.
 
-> More examples are available on [mokapi.io/docs/resources](https://mokapi.io/docs/resources)
+> More examples are available on [mokapi.io/resources](https://mokapi.io/resources)
 
 # 📚 Documentation
 
-- [Get Started](https://mokapi.io/docs/guides/welcome)
-- [HTTP](https://mokapi.io/docs/guides/http)
-- [Kafka](https://mokapi.io/docs/guides/kafka)
-- [LDAP](https://mokapi.io/docs/guides/ldap)
-- [SMTP](https://mokapi.io/docs/guides/mail)
-- [Javascript API](https://mokapi.io/docs/javascript-api)
-- [Resources](https://mokapi.io/docs/resources)
+- [Get Started](https://mokapi.io/docs/welcome)
+- [HTTP](https://mokapi.io/docs/http/overview)
+- [Kafka](https://mokapi.io/docs/kafka/overview)
+- [LDAP](https://mokapi.io/docs/ldap/overview)
+- [SMTP](https://mokapi.io/docs/mail/overview)
+- [Javascript API](https://mokapi.io/docs/javascript-api/overview)
+- [Resources](https://mokapi.io/resources)
 
 # ☕ Support
 

Taskfile.yml

@@ -28,10 +28,12 @@ tasks:
       GOOS: darwin
       GOARCH: arm64
   build-vue-app:
+    deps: [ensure-dist-folder]
     dir: webui
     cmds:
       - npm run clean
       - npm run copy-docs
+      - go run ../cmd/internal/gen-cli-docs/main.go --output-dir ./webui/src/assets/docs/configuration/static
       - npm version {{.VERSION}}
       - npm run build-dashboard
   build-npm-package:
@@ -64,5 +66,9 @@ tasks:
     env:
       GOOS: darwin
       GOARCH: arm64
+  ensure-dist-folder:
+    cmds:
+      - mkdir -p webui/dist
+      - touch webui/dist/.tmp
 
 

acceptance/ldap_test.go

@@ -20,7 +20,7 @@ type LdapSuite struct {
 func (suite *LdapSuite) SetupSuite() {
 	cfg := static.NewConfig()
 	cfg.Api.Port = try.GetFreePort()
-	cfg.Providers.File.Directories = []string{"./ldap"}
+	cfg.Providers.File.Directories = []static.FileConfig{{Path: "./ldap"}}
 	suite.initCmd(cfg)
 	// ensure scripts are executed
 	time.Sleep(2 * time.Second)

acceptance/mail_test.go

@@ -27,7 +27,7 @@ func (suite *MailSuite) SetupSuite() {
 	wd, err := os.Getwd()
 	require.NoError(suite.T(), err)
 	cfg.ConfigFile = path.Join(wd, "mokapi.yaml")
-	cfg.Providers.File.Directories = []string{"./mail"}
+	cfg.Providers.File.Directories = []static.FileConfig{{Path: "./mail"}}
 	cfg.Certificates.Static = []static.Certificate{
 		{Cert: "./mail/mail.mokapi.local.pem"},
 	}

acceptance/petstore_test.go

@@ -24,7 +24,7 @@ type PetStoreSuite struct{ BaseSuite }
 func (suite *PetStoreSuite) SetupSuite() {
 	cfg := static.NewConfig()
 	cfg.Api.Port = try.GetFreePort()
-	cfg.Providers.File.Directories = []string{"./petstore"}
+	cfg.Providers.File.Directories = []static.FileConfig{{Path: "./petstore"}}
 	cfg.Api.Search.Enabled = true
 	suite.initCmd(cfg)
 }

api/handler_config.go

@@ -2,13 +2,14 @@ package api
 
 import (
 	"fmt"
-	log "github.com/sirupsen/logrus"
 	"mime"
 	"mokapi/config/dynamic"
 	"net/http"
 	"path/filepath"
 	"strings"
 	"time"
+
+	log "github.com/sirupsen/logrus"
 )
 
 type config struct {
@@ -17,6 +18,7 @@ type config struct {
 	Provider string      `json:"provider"`
 	Time     time.Time   `json:"time"`
 	Refs     []configRef `json:"refs,omitempty"`
+	Tags     []string    `json:"tags,omitempty"`
 }
 
 type configRef struct {
@@ -67,7 +69,7 @@ func (h *handler) getConfigData(w http.ResponseWriter, r *http.Request, key stri
 	}
 
 	token := r.Header.Get("If-None-Match")
-	checksum := fmt.Sprintf("%x", c.Info.Checksum)
+	checksum := fmt.Sprintf(`"%x"`, c.Info.Checksum)
 	if token != "" && token == checksum {
 		w.WriteHeader(http.StatusNotModified)
 		return
@@ -116,5 +118,6 @@ func toConfig(cfg *dynamic.Config) config {
 		Time:     cfg.Info.Time,
 		Provider: cfg.Info.Provider,
 		Refs:     refs,
+		Tags:     cfg.Info.Tags,
 	}
 }

api/handler_config_test.go

@@ -37,7 +37,7 @@ func TestHandler_Config(t *testing.T) {
 		panic(err)
 	}
 	checksum := h.Sum(nil)
-	etag := fmt.Sprintf("%x", checksum)
+	etag := fmt.Sprintf(`"%x"`, checksum)
 
 	testcases := []struct {
 		name       string

api/handler_mail.go

@@ -2,6 +2,7 @@ package api
 
 import (
 	"fmt"
+	"mime"
 	"mokapi/media"
 	"mokapi/providers/mail"
 	"mokapi/runtime"
@@ -14,6 +15,8 @@ import (
 	"sort"
 	"strings"
 	"time"
+
+	log "github.com/sirupsen/logrus"
 )
 
 type mailSummary struct {
@@ -420,7 +423,7 @@ func toMessage(m *smtp.Message) *messageData {
 		MessageId:               m.MessageId,
 		InReplyTo:               m.InReplyTo,
 		Date:                    m.Date,
-		Subject:                 m.Subject,
+		Subject:                 decodeSmtpValue(m.Subject),
 		ContentType:             m.ContentType,
 		ContentTransferEncoding: m.ContentTransferEncoding,
 		Body:                    m.Body,
@@ -453,9 +456,19 @@ func toAddress(list []smtp.Address) []address {
 	var r []address
 	for _, a := range list {
 		r = append(r, address{
-			Name:    a.Name,
+			Name:    decodeSmtpValue(a.Name),
 			Address: a.Address,
 		})
 	}
 	return r
 }
+
+func decodeSmtpValue(s string) string {
+	dec := new(mime.WordDecoder)
+	r, err := dec.DecodeHeader(s)
+	if err != nil {
+		log.Errorf("failed to decode SMTP header: %v", err)
+		return s
+	}
+	return r
+}

api/handler_mail_test.go

@@ -330,6 +330,47 @@ func TestHandler_Smtp(t *testing.T) {
 			contentType:  "text/plain",
 			responseBody: "foobar",
 		},
+		{
+			name: "get SMTP mail with encodings",
+			app: func() *runtime.App {
+				app := runtime.New(&static.Config{})
+				app.Mail.Set("foo", &runtime.MailInfo{
+					Config: &mail.Config{},
+					Store: &mail.Store{
+						Name: "foo",
+						Mailboxes: map[string]*mail.Mailbox{
+							"alice@foo.bar": {
+								Folders: map[string]*mail.Folder{
+									"Inbox": {
+										Messages: []*mail.Mail{
+											{
+												Message: &smtp.Message{
+													Sender: nil,
+													From:   []smtp.Address{{Address: "bob@foo.bar"}},
+													To: []smtp.Address{
+														{Address: "juergen@example.com", Name: "=?UTF-8?Q?J=C3=BCrgen?="},
+													},
+													MessageId:   "foo-1@mokapi.io",
+													Date:        now,
+													Subject:     "=?UTF-8?Q?=C2=A1Buenos_d=C3=ADas!?= and =?UTF-8?B?bW9rYXBp?=",
+													ContentType: "text/plain",
+													Body:        "foobar",
+													Size:        10,
+												},
+											},
+										},
+									},
+								},
+							},
+						},
+					},
+				})
+				return app
+			},
+			requestUrl:   "http://foo.api/api/services/mail/messages/foo-1@mokapi.io",
+			contentType:  "application/json",
+			responseBody: fmt.Sprintf(`{"service":"foo","data":{"from":[{"address":"bob@foo.bar"}],"to":[{"name":"Jürgen","address":"juergen@example.com"}],"messageId":"foo-1@mokapi.io","date":"%v","subject":"¡Buenos días! and mokapi","contentType":"text/plain","body":"foobar","size":10}}`, now.Format(time.RFC3339Nano)),
+		},
 	}
 
 	t.Parallel()

cmd/mokapi/main_test.go

@@ -23,6 +23,27 @@ func TestMain_Skeleton(t *testing.T) {
 				require.Equal(t, "1.0\n", out)
 			},
 		},
+		{
+			name: "version short",
+			args: []string{"-v"},
+			test: func(t *testing.T, out string) {
+				require.Equal(t, "1.0\n", out)
+			},
+		},
+		{
+			name: "help",
+			args: []string{"--help"},
+			test: func(t *testing.T, out string) {
+				require.Contains(t, out, "Mokapi is an easy, modern and flexible API mocking tool using Go")
+			},
+		},
+		{
+			name: "help short",
+			args: []string{"-h"},
+			test: func(t *testing.T, out string) {
+				require.Contains(t, out, "Mokapi is an easy, modern and flexible API mocking tool using Go")
+			},
+		},
 		{
 			name: "generate-cli-skeleton",
 			args: []string{"--generate-cli-skeleton"},
@@ -38,6 +59,7 @@ providers:
         skipPrefix:
             - _
         include: []
+        exclude: []
     git:
         urls: []
         pullInterval: ""
@@ -84,6 +106,7 @@ data-gen:
     skipPrefix:
         - _
     include: []
+    exclude: []
 git:
     urls: []
     pullInterval: ""