PHPackages                             vangelis/todoordie - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. vangelis/todoordie

ActiveLibrary[Utility & Helpers](/categories/utility)

vangelis/todoordie
==================

Write TODOs in code that ensure you actually do them

v0.0.2(1y ago)03[1 PRs](https://github.com/vangelis183/todoordie/pulls)MITPHPPHP ^8.1

Since Oct 20Pushed 1y ago1 watchersCompare

[ Source](https://github.com/vangelis183/todoordie)[ Packagist](https://packagist.org/packages/vangelis/todoordie)[ Docs](https://github.com/vangelis/todoordie)[ GitHub Sponsors](https://github.com/vangelis)[ RSS](/packages/vangelis-todoordie/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (3)Used By (0)

Write TODOs in code that ensure you actually do them
====================================================

[](#write-todos-in-code-that-ensure-you-actually-do-them)

[![Latest Version on Packagist](https://camo.githubusercontent.com/3c3b30016f2909786987a6db27e72b3311cdf549a428826d14a01d64cf08e314/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f76616e67656c69732f746f646f6f726469652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vangelis/todoordie)[![Tests](https://camo.githubusercontent.com/0c4734c43454720b6831f23c4008aa2aacdfcfc5b105f78d959ad319e380ca53/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f76616e67656c69732f746f646f6f726469652f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/vangelis/todoordie/actions/workflows/run-tests.yml)[![Total Downloads](https://camo.githubusercontent.com/724b36ef1e1faec8a16fdbbfcc75a62476b2cfa16e835f91c9ced1665395d2f0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f76616e67656c69732f746f646f6f726469652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vangelis/todoordie)

Keep your projects clean
------------------------

[](#keep-your-projects-clean)

To understand why you would ever call a function to write a comment, read on.

If you have some code you know you'll need to change later, don't just leave a comment for later that you'll never read, ever again.

For all the following cases, forgetting a TODO is NOT GOOD:

- remove some code when the dependency support expires,
- remove a feature flag,
- update some code related to another project,
- update a dependency when another refactoring is done,
- ...

This can lead to nasty issues so make your TODOs speak up when they need to with this module ;)

You can now replace your simple comment with this function that will raise and error when the time or the condition are met and remind you to do something about it.

Caution
-------

[](#caution)

This can cause some production apps to break ! This code is named `todoordie`, not `todo_and_kittens` so be careful.

Pull-Requests are welcome to make this more production-ready !

Note this module has no warranty, see the LICENSE !

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require vangelis/todoordie
```

Usage
-----

[](#usage)

This will raise an error if the date is reached or passed:

```
use Vangelis\TodoOrDie\TodoOrDie;

TodoOrDie::check('Test task', '2023-01-01');
```

This will not raise an error until the condition is met (in about 75 years):

```
use Vangelis\TodoOrDie\TodoOrDie;

TodoOrDie::check('Test task', '2099-01-01');
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Credits
-------

[](#credits)

- [Evangelos Dimitriadis](https://github.com/vangelis183)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

569d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b564f3a5b948408c96f5c083b00ccb67e0514121e81c27328b1f53bb078fbc03?d=identicon)[vangelis](/maintainers/vangelis)

---

Top Contributors

[![vangelis183](https://avatars.githubusercontent.com/u/102213?v=4)](https://github.com/vangelis183 "vangelis183 (3 commits)")

---

Tags

todotodoordie

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/vangelis-todoordie/health.svg)

```
[![Health](https://phpackages.com/badges/vangelis-todoordie/health.svg)](https://phpackages.com/packages/vangelis-todoordie)
```

###  Alternatives

[kigkonsult/icalcreator

iCalcreator is the PHP implementation of rfc2445/rfc5545 and rfc updates, management of calendar information

2462.6M16](/packages/kigkonsult-icalcreator)[zidbih/laravel-deadlock

Make temporary Laravel workarounds expire and fail CI when ignored.

961.8k](/packages/zidbih-laravel-deadlock)[simialbi/yii2-kanban

Kanban board module for yii2

111.1k1](/packages/simialbi-yii2-kanban)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)