PHPackages                             protec/pot - 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. protec/pot

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

protec/pot
==========

Tool to manage iterating through files in a folder and running a command against them. Records the filename of each file and the timestamp of when run in database.

13.5kPHP

Since Jun 18Pushed 10y ago6 watchersCompare

[ Source](https://github.com/protecinnovations/pot)[ Packagist](https://packagist.org/packages/protec/pot)[ RSS](/packages/protec-pot/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

pot
===

[](#pot)

```
    ______     _
    | ___ \   | |
    | |_/ /__ | |_
    |  __/ _ \| __|
    | | | (_) | |_
    \_|  \___/ \__|

```

Tool to manage iterating through files in a folder and running a command against them. Records the filename of each file and the timestamp of when run in database.

Can be run by passing command line flags, or will read configuration from a json config file.

Installation
============

[](#installation)

Clone this repository, or add

```
"protec/pot": "dev-master"

```

to your composer.json

Usage
=====

[](#usage)

php pot.php \[options\]

Alternatively, add pot.php you your PATH and just run

pot \[options\]

Options
=======

[](#options)

```
  --help          -h            Display help message
  --config  -c      Use configuration from  instead of pot.json
  --db  -d  Override configuration file and use
  --user    -u      Override configuration file and use database user
  --pass    -p      Override configuration file and use database password
  --table  -t     Override configuration file and use database password
  --files    -f       Override configuration file and use directory  for transformations
  --kettle   -k       Override configuration file and use directory  for kettle
  --version       -v            Display application version

```

Configuration
=============

[](#configuration)

Provided is an example pot.json file (example.pot.json). Copy this file to your project directory and adjust to your needs. The table pot uses will be created if it does not exist. The command to run must be as complete as possible, missing only the file to run against (represented by %s), eg:

- echo %s
- chmod 775 %s
- /usr/bin/kettle/pan.sh -file=%s

All files in the directory listed will have the command run against. It is recommended to give these files a numeric filename, as pot will calculate the integer value of the filename to determine what order the files should be run

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/32d5546010acf465053389b43a30f009de4ad45bfc2cbc16fef304df292b0717?d=identicon)[ColdFFF](/maintainers/ColdFFF)

---

Top Contributors

[![alexdenvir](https://avatars.githubusercontent.com/u/1412074?v=4)](https://github.com/alexdenvir "alexdenvir (9 commits)")

### Embed Badge

![Health badge](/badges/protec-pot/health.svg)

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

###  Alternatives

[phpsgi/phpsgi

373.2k3](/packages/phpsgi-phpsgi)[kingdee-php/k3cloud

This is KingDee（金蝶） PHP SDK

116.1k1](/packages/kingdee-php-k3cloud)

PHPackages © 2026

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