garbagetruck

Welcome!Have you ever forget to take out the garbage?

IntroductionGarbageTruck is a c# library that works among other libraries (add-ins) to handle recurrent date/time events.

A temporal expression is the basic element to describe a recurrent event. The most common example of a recurrent event is the days the garbage truck come to pick the garbage up. In my case I have to take out the garbage every Wednesday night but that can be vary depending on holidays and so on.

So what is the information that can be get from a temporal expression about a recurrent event? This project is focused on:

to determinate if a single date/time is part of the event and when will the event occur again from a given date/time.

There are infinite imaginable recurrent events and its importance depend on the application they are going to be applied, so try to build a complex library to describe them all is not a good idea. This project is based on that premise.

GarbageTruck allows to handle and persist single and related temporal expressions that are build separately in order to gain simplicity and flexibility.

For more information about recurrent events, temporal expressions and the patterns which this project is based on please read Martin Fowler, Recurring Events for Calendars article that can be found in the downloads section of this site.

Help usYour collaboration is very important to improve this project since it requires continuous improvement a test. Performance and accuracy are the key of the successful since there are events that can occur even in nanoseconds.

You can help the way you want to this project but there three main aspects that need to be covered:

Development

There's no words wrote in stone here.

Project structure needs to be reviewed to see if there are a better approach to handle temporal expressions. Current temporal expressions need to be reviewed to see if there's a way to improve their code. New temporal expressions need to be created to increase the scope of recurrent events. Demo applications needs to be created to help people to understand the use of the libraries. For more information about development procedures and tasks see the development page of the wiki.

Quality assurance

To ensure that a temporal expression works as it should is not a simple task, so...

Test cases need to be figured and implanted. Those test cases should be executed. For more information about development procedures and tasks see the Quality assurance page of the wiki.

Documentation

A library must be understandable for the people that needs to use it, code comments are not enough, library reference and tutorials need to be created as well.

For more information about development procedures and tasks see the documentation page of the wiki.

How to join?If you are interested in participate of the project just send an email to the any of the administrators telling how you can collaborate. There's no mailing list at this point.

Issues are going to be created to solve specif needs of the project. Once you be a member you can pick any of the open issues and start working on them.

GarbageTruck is in an initial stage and lots of things need to be done, be free to add issues you think must be covered and let us know any suggestion or comment about the project.

Tags

  csharp scheduling recurrence temporal remaining net events

Share