https://github.com/rzavalik/codetraining

A simple calculator app showcasing technologies, techniques, and best practices.
https://github.com/rzavalik/codetraining

azure bdd dotnet-core moq playwright shouldly tdd test

Last synced: 4 months ago
JSON representation

A simple calculator app showcasing technologies, techniques, and best practices.

• Host: GitHub
• URL: https://github.com/rzavalik/codetraining
• Owner: rzavalik
• License: other
• Created: 2025-04-08T19:45:08.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-04-28T23:11:34.000Z (about 1 year ago)
• Last Synced: 2025-10-11T07:35:55.565Z (8 months ago)
• Topics: azure, bdd, dotnet-core, moq, playwright, shouldly, tdd, test
• Language: C#
• Homepage:
• Size: 1.06 MB
• Stars: 1
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          


# Calculator App

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.html)

[![.NET](https://img.shields.io/badge/.NET-8.0-blue.svg)](https://dotnet.microsoft.com/en-us/)

![Build Status](https://dev.azure.com/zavalik/codetraining/_apis/build/status%2FCI%20for%20Main%20Branch?branchName=main&stageName=BuildTest&jobName=Build%20and%20Test%20.NET%20Projects)

---

## 📖 Overview

**Calculator App** is a simple calculator application designed to showcase modern development practices including Clean Architecture, Unit Testing, CI/CD automation, and best coding standards using .NET.

This project serves both as a learning tool and a demonstration of high-quality code organization and delivery workflows.

---

## ✨ Features

- Basic calculator operations (add, subtract, multiply, divide)

- Clean Architecture structure

- Full Unit Test coverage

- Continuous Integration with GitHub Actions

- Follows best practices for .NET development

- Extensible for new features

---

## 🚀 Technologies

- [.NET 8.0](https://dotnet.microsoft.com/en-us/)

- xUnit and Shouldly for testing

- GitHub Actions for CI/CD

- Docker support (optional, if you add it later)

---

## ⚡ Getting Started

### Prerequisites

- [.NET 8 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)

- Git

### Running Locally

```bash

# Clone the repository

git clone https://github.com/rzavalik/codetraining.git

cd codetraining

# Build and run the application

dotnet build

dotnet run --project Calculator.UI

```

### Running Tests

```bash

# Execute unit tests

dotnet test

```

---

## 📂 Project Structure

```

src/

 └── Calculator.UI/          # Console UI for the calculator

 └── Calculator.API/          # Web API version (if implemented)

 └── Calculator.Domain/       # Core domain entities and logic

 └── Calculator.Application/  # Application logic and services

 └── Calculator.Tests/        # Unit tests

```

---

## 🤝 Contributing

We welcome contributions!

Please read our [CONTRIBUTING.md](./CONTRIBUTING.md) to learn how to get started.

---

## 📜 License

This project is licensed under the [GPL-3.0-or-later License](LICENSE).

---

## 🙌 Acknowledgments

- Inspired by clean architecture principles and best practices from the .NET community.