Skip to content

An application that generates simple Excel spreadsheet based invoices, which are saved to disk and can be emailed.

Notifications You must be signed in to change notification settings

al-c95/InvoiceGen

Repository files navigation

InvoiceGen

Description and Requirements

An application that generates simple Excel spreadsheet based invoices. It was designed to solve a specific problem where monthly invoices were issued. Invoices are issued as spreadsheets and can be saved to disk and/or emailed. Invoices can be given either a "monthly" or a "custom" title.

It is based on WinForms and targets .NET Framework version 4.6.1.

Invoice records are stored in an XML file, invoices.xml, located in the same directory as the executable.

Current version: v1.1.0 (beta)

Contents

This repository is based around a Microsoft Visual Studio solution. The directories InvoiceGen and InvoiceGen_Tests contain the source code, that is, the production code and unit tests, respectively. The docs directory contains both design and usage documentation.

All notable changes to this document are documented in CHANGELOG.md.

root
|
+--docs
|
|
+--InvoiceGen // source
|
+--InvoiceGen_Tests // unit tests
|
+--packages
+--InvoiceGen.sln // VS solution
+--CHANGELOG.md
+--README.md

Installation and Setup

No installation process is required. Simply place the \InvoiceGen\bin\Release folder somewhere on disk, and execute InvoiceGen.exe to run the application. The invoices.xml file mentioned above contains some example invoice records.

Architecture

The application is based around a simple Model-View-Presenter (MVP) pattern for enhanced unit-testability and separation of concerns.

Usage

Some instructions or a manual may be provided as part of a future release.

Attributions

  • Icons by Icons8: http://icons8.com
  • EPPlus by Jan Källman.
  • FakeItEasy by Patrik Hägne, FakeItEasy contributors.
  • Microsoft.NET.Test.Sdk by Microsoft.
  • Microsoft.NETCore.App by Microsoft.
  • NUnit by Charlie Poole, Rob Prouse.
  • NUnit3TestAdapter by Charlie Poole, Terje Sandstrom.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT

About

An application that generates simple Excel spreadsheet based invoices, which are saved to disk and can be emailed.

Resources

Stars

Watchers

Forks

Packages

No packages published