Skip to content

aaarkid/eta

Repository files navigation

Stargazers Version Code Coverage
License LinkedIn

Logo

Rust library for tracking progress on repetive tasks and measuring estimated remaining times.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact

About The Project

ETA aims to be a simple, easy to use, and efficient library for tracking progress on repetitive tasks. The main purpose of ETA is to measure remaining time, but it's being develop to include progress tracking and progress bar display too.

Built With

Rust

(back to top)

Getting started

Add this to your Cargo.toml:

[dependencies]
eta = "0.2.2"

Add this to your source code:

use eta::{ETA, TimeAcc};

Usage

Usage is revolved around the Eta Object which implements a number of functions.

Initialize Eta with new(TasksCount, TimeAccuracy) function where TasksCount is the number of tasks you want to track and TimeAccuracy is the accuracy of the time measurement.

TimeAccuracy can be one of the following:

  • TimeAcc::SEC
  • TimeAcc::MILLI
  • TimeAcc::MICRO
  • TimeAcc::NANO

Run step() function on every iteration of your task.

    let mut eta = Eta::new(10, TimeSteps::MILLI);

    for i in 0..10 {
        do_some_function();
        eta.step();
    }

For more examples, please refer to the Documentation

(back to top)

Roadmap

  • Enable to pause and resume time tracking
  • Ability to calculate weight of unequal tasks during development and create more accurate progress and ETA measurement.
  • Create more options for formatting output.
  • Add tolerance against outlier values.

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributing to this repository is greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

Giving the project a star is much appreciated and means a lot! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MPL-2.0 license. See LICENSE.MD for more information.

(back to top)

Contact

@aaarkid - akaleci@jacobs-university.de

(back to top)