#progress-bar #time-tracking #time-measurement #progress-tracking #time-estimation #remaining-time

eta

Tracks progress on repetive tasks and measures estimated remaining times

5 unstable releases

0.2.2 Aug 20, 2022
0.2.1 Aug 19, 2022
0.2.0 Aug 18, 2022
0.1.0 Aug 16, 2022
0.0.0 Aug 18, 2021

#198 in Date and time

41 downloads per month
Used in 2 crates (via image-reducer)

MPL-2.0 license

93KB
225 lines

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 in two ways:

  • 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.
  • with in_progress(TasksCount, TasksDone, TimeAccuracy) function where TasksDone is the number of tasks that have completed.

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)

No runtime deps