Skip to content

Mocka — A Mock Server Made for Developers by Developers, made in Swift ❤️

License

Notifications You must be signed in to change notification settings

wise-emotions/mocka

Repository files navigation

Mocka Banner

Version Language Platforms License

Build Status Build Status


Getting MockaFeaturesUsage RequirementsBuild RequirementsDevelopmentKnown IssuesWanted FeaturesChangelogCommunicationContributingLicense


Mocka — A Mock Server for Developers by Developers, made with Swift ❤️.

☕️ Getting Mocka

You can find the latest version here.

Otherwise, to build it yourself or to contribute, look at the Development section for more information.

🚀 Features

Here is the list of the most important currently implemented features:

  • Server section with a list for all the network exchanges automatically updated
  • API Editor included in the app
  • Console section with a list for all the logs automatically updated
  • Wildcard components in order to be able to define * paths
  • App fully written in Swift by using SwiftUI, Combine, and Vapor

If you want to see what's next, read the Wanted Features section.

You can also go to the GitHub Project board to see the Mocka backlog.

💻 Usage Requirements

Mocka macOS
0.1.0 11.0
develop 11.0

⚙️ Build Requirements

Mocka Swift Xcode
0.1.0 5.3...5.4 12.4...12.5
develop 5.3...5.4 12.4...12.5

👩‍💻🧑‍💻 Development

We currently use XcodeGen in order to generate the .xcodeproj file. To install XcodeGen you will also need brew. If you currently don't have those software installed on your Mac, they will be automatically installed at the first run of setup.sh.

Currently, the setup.sh allows the following parameters:

  • close to close the Xcode instance
  • format to format all the code by using swift-format
  • clean to clean the derived data (at the build folder) and it also run an xcodebuild clean command
  • open to open the Xcode project

For example you can type: ./setup.sh close clean open to close the current Xcode instance, clean the project, and open the newly generated one.

🐛 Known Issues

  1. testIsWorkspaceURLValidReturnsFalseForMissingServerConfiguration in Tests/AppTests/SettingsLogic+Test.swift Unit Test sometimes fails

If you find other issues, please open a bug report.

If you would like to fix a bug, please follow the Contributing section.

🌈 Wanted Features

The following list is not ordered, if you would like to see what will be included in the next release of Mocka, look at the GitHub Project board.

  • Custom 4xx and 5xx Errors Support
  • Automatic Updates
  • Per-API Delay
  • Allow Multiple Responses
  • Responses Based on Query or Body
  • Automatic Mock Data Generator
  • Include SwiftGen for Localization
  • Log Export
  • Use SwiftNIO instead of Vapor
  • Swagger Import
  • Command Line Support

If you you would like to request another feature, please open a feature request.

If you would like to add a feature, please follow the Contributing section.

📃 Changelog

To see what has changed in recent versions of Mocka, see the CHANGELOG.md file.

📣 Communication

  • If you need help, open an issue.
  • If you find a bug, open an issue.
  • If you have a feature request, open an issue.
  • If you want to contribute, see Contributing section.

💥 Contributing

See CONTRIBUTING.md file.

📄 License

Mocka is available under the MIT license. See the LICENSE file for more info.