The open-source integration testing tool for your backend code

From git push to production-ready: See the unseen, test the untested

Get started in a single click!

Explore the docs

Report Bug · Request Feature · Join Our Discord · Roadmap · X

Momentum is an open-source tool designed to generate and understand powerful insights into your codebase. It helps you understand changes and their impacts, generate test behaviours and integration test code and much more.

Introduction
What is a behavior?
Here's how momentum can help you!
Installation
Build Instructions with docker
Usage
Contributing
License

Introduction

momentum analyses your codebase and understands intended code behavior and tests it at every git push to ensure the code is ready for production. It generates visualisation and precise context for test plans and test cases for all entry points detected in the system.

What is a behavior?

A behavior is defined as a task or functionality you were trying to create using your code. Examples could be deleting a document using a deleting API or creating a new user in the database. Behaviors can also be more complex sometimes where third-party dependencies are associated for example fetching data from a payment API to check the status. Behaviours must be independently executable tasks.

Here's how momentum can help you!

Blast Radius: This will be a list of endpoints that could potentially be affected by the changes you made in your code. This will also be a starting point to decide what parts of your code need to be tested before shipping to production..

Dependency Visualization: Visualize code dependencies and relationships.

Behaviour identification: Automatically identify behaviors written in your code and generate a plan to test their functionality

Code generation to test functionality: Generate code to test all behaviors identified and run it in your local environment through momentum
Run code in local dev environment: No need for yet another yaml, our cli works with your existing dev environment to run code.
Debug code: Based on the stacktrace of the run, momentum can diagnose and propose a solution

Installation

To get started with Momentum, follow these steps:

Steps

Clone the repository:

git clone https://github.com/getmomentum/momentum-core.git
cd momentum-core

Set up the virtual environment:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Setup keys and .env: You will have to setup keys for services like firebase auth, github app, Open AI, portkey among others. Follow the detailed instructions here
Start the application:
```
./start_momentum.sh
```

Note: You might need to make it an executable, do it by running chmod +x start_momentum.sh

Usage

After installation, you can access Momentum at http://localhost:8001. Key functionalities include:

User Authentication
Parsing Codebase
Listing Parsed Projects and Branches
Generating Blast Radius
Visualizing Dependencies and Flow Graphs
Setting Preferences for Endpoints
Generating and Setting Up Test Plans

For detailed usage instructions, visit the Momentum Documentation.

Contributing

We welcome contributions from the community. Contributions can be of the form:

Documentation : Help improve our docs! If you fixed a problem, chances are others faced it too.
Code : Help us make improvements to existing features and build new features for momentum.
Tests : Help us make momentum resilient by contributing tests.

To contribute:

Fork the repository.
Create a new branch (git checkout -b feature-branch).
Commit your changes (git commit -am 'Add new feature').
Push to the branch (git push origin feature-branch).
Open a Pull Request.

Refer to the Contributing Guide for more details.

License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.

💪 Thanks To All Contributors

Thanks a lot for spending your time helping build momentum. Keep rocking 🥂

getmomentum/momentum-core