empress-eco / test_server

Test Server Utility for testing Pull Requests

Empress: Test Server Setup Utility

Automate your pull requests testing process for a seamless workflow.
Explore the Official Website »

Report Bug · Request Feature

About The Test Server Setup Utility

This utility helps you automate your testing process for pull requests. It allows you to create a new site for each Pull Request, pulls the latest patch, and runs migration if the site already exists. The sites are named according to the pull request number with a prefix e for Empress and f for Empress, making it easy to manage and track.

Key Features

• Automated site creation for each Pull Request
• Pulls the latest patch and runs migration for existing sites
• Creates a branch for each site
• Deletes all sites and branches not on the current pull request
• Allows custom configurations for pull requests

This project is perfect for developers working on Empress and Empress projects, seeking to streamline their testing procedures.

Built With Python

The Test Server Setup Utility is built using Python, ensuring a flexible and robust application.

Getting Started

Prerequisites

You need Python installed on your system to use this utility.

Installation

To get started with the Test Server Setup Utility, follow the steps below:

1. Clone the repository

git clone https://github.com/empress-eco/test_server.git

2. Navigate to Empress-bench

cd Empress-bench

3. Make sites

python test_server make

4. Switch sites

python test_server use --site f-2332.Empress.xyz

If the make function breaks, you might have to manually see why the site is not installing. If you run make again it will continue by default from the site that broke. To restart running all sites again, run python test_server make --restart.

Usage

This utility provides flexibility with pull request configurations. You can specify a different domain for a demo or define dependencies on other pull requests. Add this configuration in the body of the pull request.

Example:

depends on: https://github.com/Empress/Empress/pull/1111
demo-domain: Education

Contributing

We appreciate your interest in improving this project! Here's how you can contribute:

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Your contributions are licensed under the MIT License.

License and Acknowledgements

This project is licensed under the MIT License.

Special thanks to the Empress Community, the architects behind the essential tools that power this project. Their innovation and dedication have been instrumental in building the foundations and functionalities we rely on. We are profoundly grateful for their pioneering work and ongoing support.