Skip to content

Arsenic-ATG/Qt-calculator

Repository files navigation

Qt-calculator

Introduction

Welcome to the Qt-calculator project!
As the name suggests, we build a calculator with variety of commonly used functions, interacted by GUI.
We use the Qt creator IDE to setup the project, due to its excellent internal build tools, especially for GUI.
The calculator can be used on all platforms(altough the GUI may differ on each platform).

requirements ✅

Qt creator or Qmake build system set up in your IDE

Setting up Qt 💻

  • Start by installing the Qt SDK from qt.io. Since the online installers can be pretty buggy, it was decided to go with the offline Open Source version
  • The installer does not include any compiler on its default install. Make sure you select the fitting MinGW compiler.
  • As mentioned above, Qt Creator is a sort of an IDE with internal build tools. So currently, it's a good idea to install this.
  • We will not be using CMake since QMake comes bundled with the creator.

Contributing

The calculator is evolving each day, and yet there are always new features to implement, code to optimize, or documentation to add. For this very reason, contributers(completely new ones or veterans) are more than welcome to make the changes. If you wish to contribute, please read CONTRIBUTING.md for details on the code of conduct and process for submitting pull requests to the repository.

Get it running 🏃‍♂️

  1. Clone/download the repository.

  2. Open QtCalculator => calculator.pro using Qt creator. If you haven't downloaded qt creator, go back to the Setting up Qt 💻 section

  3. Once inside Qt creator click on configure Project options (it will configure the project according to your device) 👇 main screen

Publishing the changes 🔧

Before making the needed changes , follow these instructions(if you are familiar with github and its source control functions, you can skip this explanation)

  1. Fork the repository(the button on the top-right of the page)
  2. Create a new branch on the created fork(meaningful branch names are importent)
  3. Make the needed changes on this branch
  4. Commit the changes to the branch.Right now they are saved on your local repository
    • make sure you summarize the changes you made , on the commit description
  5. Push it to the online repository
  6. Create a pull request , on which your changes from the branch commits are explained more deeply
  7. your changes will be reviewed by the project maintainers.
  8. Congratulations 🎉 , you made your first contribution to the project!

screen shots 📸

- These screen shots were taken on Windows 10 OS, result might vary according to your Operating System

calculator themes:

light mode screenshot dark mode screenshot

unary functions:

Sqrt Log_error sin_on_degrees factorial

binary functions

divide multiply

License

License