|
1 | 1 | # BELLATRIX-JavaScript
|
2 |
| -BELLATRIX Tailor-made Test Automation Framework |
| 2 | + |
| 3 | +## BELLATRIX Tailor-made Test Automation Framework |
3 | 4 |
|
4 | 5 | Customize and extend our cross-platform framework to perfectly fit your needs. Start on top of hundreds of best practice features and integrations.
|
5 | 6 |
|
6 | 7 | Contains the full source code of BELLATRIX Test Automation Framework and Templates for faster usage
|
7 | 8 |
|
8 | 9 | BELLATRIX is not a single thing it contains multiple framework libraries, extensions and tools. The tool is built to be cross-platform, however some of the features can be used under Windows since they are written for Visual Studio.
|
9 | 10 |
|
10 |
| -Simple Installation |
| 11 | +## Simple Installation |
11 | 12 |
|
12 | 13 | - Download the BELLATRIX projects as a zip file from the Code green button in the right corner.
|
13 |
| --Unzip it. Open BELLATRIX-JavaScript in Visual Studio Code. |
14 |
| -- Open terminal and type npm ci in the root of the project. |
| 14 | +- Unzip it. Open BELLATRIX-JavaScript in Visual Studio Code. |
| 15 | +- Open terminal and type npm ci in the root of the project. |
15 | 16 | - In order to run the sample tests, navigate to the example folder with terminal and type npm run test.
|
16 |
| -- You can try to write a simple test yourself. |
| 17 | +- You can try to write a simple test yourself. |
17 | 18 | - For an in-depth revision of all framework features you can check the official documentation
|
18 | 19 |
|
19 |
| -Running Tests through CLI |
| 20 | +## Running Tests through CLI |
20 | 21 |
|
21 | 22 | To execute your tests via command line in Continues Integration (CI), you can use the Bellatrix CLI through an npm script.
|
22 | 23 |
|
23 | 24 | - Navigate to the folder of your test project.
|
24 | 25 | - Open the CMD there.
|
25 | 26 | - Execute the following command:
|
26 | 27 |
|
27 |
| - bellatrix <path> |
| 28 | +`bellatrix <path>` |
28 | 29 |
|
29 | 30 | where path is an optional argument for a path to the tests folder, either relative or absolute.
|
30 | 31 |
|
31 | 32 | Filters and other more advanced configurations will be supported in a future version.
|
32 | 33 |
|
33 | 34 | Our project uses Semantic Versioning (SemVer) for clear and predictable version management. Each release is tagged with a unique version number that reflects the nature of the changes made.
|
34 |
| -Tags and Releases |
35 | 35 |
|
36 |
| - Tags: We create Git tags for each release to mark specific points in the project's history, making it easier for users to switch between versions. |
37 |
| - Release Notes: Detailed notes accompany each release, highlighting new features, bug fixes, and any breaking changes. |
| 36 | +## Tags and Releases |
| 37 | + |
| 38 | +Tags: We create Git tags for each release to mark specific points in the project's history, making it easier for users to switch between versions. |
| 39 | +Release Notes: Detailed notes accompany each release, highlighting new features, bug fixes, and any breaking changes. |
38 | 40 |
|
39 |
| -Accessing Releases |
| 41 | +## Accessing Releases |
40 | 42 |
|
41 | 43 | Users can access the specific releases directly from our GitHub repository's Releases page or BELLATRIX website's roadmap section. Each release includes a tag, a summary of changes, and assets (if applicable).
|
42 | 44 | Integrating BELLATRIX as a Submodule in Your Project
|
43 | 45 | Adding BELLATRIX as a Submodule
|
44 | 46 |
|
45 | 47 | To leverage a specific version of BELLATRIX in your project, you can add it as a Git submodule. This allows you to keep your copy of BELLATRIX up to date or locked to a specific version, depending on your project's needs.
|
46 | 48 |
|
47 |
| - Navigate to Your Project Directory: Open a terminal and change to the directory where your project is located. |
48 |
| - Add BELLATRIX as a Submodule: Use the following Git command to add BELLATRIX as a submodule to your project: |
| 49 | +Navigate to Your Project Directory: Open a terminal and change to the directory where your project is located. |
| 50 | +Add BELLATRIX as a Submodule: Use the following Git command to add BELLATRIX as a submodule to your project: |
49 | 51 |
|
50 |
| -git submodule add https://github.com/BELLATRIX-Library/BELLATRIX.git path/to/submodule |
| 52 | +`git submodule add https://github.com/BELLATRIX-Library/BELLATRIX.git path/to/submodule` |
51 | 53 |
|
52 | 54 | Replace path/to/submodule with the relative path within your project where you'd like the BELLATRIX submodule to reside. Initialize and Clone the Submodule: If you're adding the submodule for the first time, initialize your local configuration file and clone the BELLATRIX repository as follows:
|
53 | 55 |
|
54 |
| -git submodule update --init --recursive |
| 56 | +`git submodule update --init --recursive` |
55 | 57 |
|
56 | 58 | Checking Out a Specific Tag (Release Version)
|
57 | 59 |
|
58 | 60 | After adding BELLATRIX as a submodule, you might want to use a specific release version rather than the latest commit on the main branch.
|
59 | 61 |
|
60 |
| - Navigate to the Submodule Directory: Change into the BELLATRIX submodule directory within your project: |
| 62 | +Navigate to the Submodule Directory: Change into the BELLATRIX submodule directory within your project: |
61 | 63 |
|
62 |
| -cd path/to/submodule |
| 64 | +`cd path/to/submodule` |
63 | 65 |
|
64 |
| - Fetch All Tags from the BELLATRIX Repository: To ensure you have a list of all available tags, fetch them: |
| 66 | +Fetch All Tags from the BELLATRIX Repository: To ensure you have a list of all available tags, fetch them: |
65 | 67 |
|
66 |
| -git fetch --tags |
| 68 | +`git fetch --tags` |
67 | 69 |
|
68 |
| - Checkout the Desired Tag: Check out the specific tag (release version) you want to use by replacing <tagname> with the desired version: |
| 70 | +Checkout the Desired Tag: Check out the specific tag (release version) you want to use by replacing <tagname> with the desired version: |
69 | 71 |
|
70 |
| -git checkout tags/<tagname>` |
| 72 | +`git checkout tags/<tagname>` |
71 | 73 |
|
72 | 74 | For example, if you want to check out version v3.9.0.0, you would use: git checkout tags/v3.9.0.0
|
73 | 75 |
|
74 |
| - Commit the Submodule Change: Navigate back to your project's root directory, and commit the change to the submodule reference: |
| 76 | +Commit the Submodule Change: Navigate back to your project's root directory, and commit the change to the submodule reference: |
75 | 77 |
|
76 |
| -cd ../.. |
77 |
| -git add path/to/submodule |
78 |
| -git commit -m "Update BELLATRIX submodule to v3.9.0.0" |
| 78 | +`cd ../..` |
| 79 | +`git add path/to/submodule` |
| 80 | +`git commit -m "Update BELLATRIX submodule to v3.9.0.0"` |
79 | 81 |
|
80 | 82 | This process ensures that your project uses a specific, fixed version of BELLATRIX, providing stability and consistency across environments or deployments.
|
81 | 83 | Contributing to Our Project
|
82 | 84 |
|
83 | 85 | We welcome contributions from the community, whether it's in the form of bug reports, feature requests, documentation improvements, or code contributions.
|
84 |
| -Getting Started |
85 | 86 |
|
86 |
| - Fork the Repository: Start by forking the repository to your GitHub account. This provides you with a personal workspace for making changes. |
87 |
| - Clone Your Fork: Clone your fork to your local machine to start working on the changes. |
| 87 | +## Getting Started |
| 88 | + |
| 89 | +Fork the Repository: Start by forking the repository to your GitHub account. This provides you with a personal workspace for making changes. |
| 90 | +Clone Your Fork: Clone your fork to your local machine to start working on the changes. |
88 | 91 |
|
89 |
| -Making Changes |
| 92 | +## Making Changes |
90 | 93 |
|
91 |
| - Create a Feature Branch: From your fork, create a new branch for your work. This keeps your changes organized and separate from the main branch. |
92 |
| - Commit Your Changes: Make your changes locally, and commit them to your feature branch. Use clear and descriptive commit messages. |
| 94 | +Create a Feature Branch: From your fork, create a new branch for your work. This keeps your changes organized and separate from the main branch. |
| 95 | +Commit Your Changes: Make your changes locally, and commit them to your feature branch. Use clear and descriptive commit messages. |
93 | 96 |
|
94 |
| -Submitting Contributions |
| 97 | +## Submitting Contributions |
95 | 98 |
|
96 |
| - Pull from Upstream: Before submitting your contribution, pull the latest changes from the upstream main branch into your feature branch to minimize merge conflicts. |
97 |
| - Push to Your Fork: Push your changes to your fork on GitHub. |
98 |
| - Open a Pull Request (PR): Submit a pull request from your feature branch to the main branch of the original repository. Provide a clear description of your changes and any relevant issue numbers. |
| 99 | +Pull from Upstream: Before submitting your contribution, pull the latest changes from the upstream main branch into your feature branch to minimize merge conflicts. |
| 100 | +Push to Your Fork: Push your changes to your fork on GitHub. |
| 101 | +Open a Pull Request (PR): Submit a pull request from your feature branch to the main branch of the original repository. Provide a clear description of your changes and any relevant issue numbers. |
99 | 102 |
|
100 |
| -Code Review |
| 103 | +## Code Review |
101 | 104 |
|
102 | 105 | Review Process: Your PR will be reviewed by the project maintainers. They may provide feedback or request changes. Be open to discussion and willing to make adjustments as needed.
|
103 |
| -After Your PR is Merged |
| 106 | + |
| 107 | +## After Your PR is Merged |
104 | 108 |
|
105 | 109 | Once your PR is merged, your contributions will become part of the project. You can then safely delete your feature branch.
|
106 |
| -Supported Code Editors |
| 110 | + |
| 111 | +## Supported Code Editors |
107 | 112 |
|
108 | 113 | The recommended code editor for writing BELLATRIX tests is Visual Studio Code
|
0 commit comments