{"id":27158876,"url":"https://github.com/activecollab/promises","last_synced_at":"2025-04-08T22:39:17.059Z","repository":{"id":56940244,"uuid":"50685300","full_name":"activecollab/promises","owner":"activecollab","description":null,"archived":false,"fork":false,"pushed_at":"2022-03-03T09:04:16.000Z","size":57,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-30T13:03:29.017Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/activecollab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-29T19:17:40.000Z","updated_at":"2022-03-03T08:56:10.000Z","dependencies_parsed_at":"2022-08-21T06:20:51.808Z","dependency_job_id":null,"html_url":"https://github.com/activecollab/promises","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activecollab%2Fpromises","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activecollab%2Fpromises/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activecollab%2Fpromises/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activecollab%2Fpromises/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/activecollab","download_url":"https://codeload.github.com/activecollab/promises/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247941718,"owners_count":21022035,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-08T22:39:16.447Z","updated_at":"2025-04-08T22:39:17.050Z","avatar_url":"https://github.com/activecollab.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Promises Library\n\n[![Build Status](https://travis-ci.org/activecollab/promises.svg?branch=master)](https://travis-ci.org/activecollab/promises)\n\nPurpose of this library is to provide persisted server side promises. We built it to power our multi-service system, where one service issues a job requests and expect that antoher service executes it (and fulfulls or rejects a promise that it gives when it accepts a job).\n\nExample:\n\n```php\n\u003c?php\n\nuse ActiveCollab\\DatabaseConnection\\Connection\\MysqliConnection;\n\n$mysqli_link = new \\MySQLi('localhost', 'root', '', 'activecollab_promises_test');\n\nif ($mysqli_link-\u003econnect_error) {\n    throw new \\RuntimeException('Failed to connect to database. MySQL said: ' . $mysqli_link-\u003econnect_error);\n}\n\n$mysqli_connection = new MysqliConnection($mysqli_link);\n\n$promises = new Promises($this-\u003econnection);\n\n// Print promise signature\n$promise = $promises-\u003ecreate();\n\nprint $promise-\u003egetSinature() . \"\\n\";\nprint (string) $promise . \"\\n\"; // __toString() is available\n\n// Default promise status\n$promise = $promises-\u003ecreate();\n\n$promises-\u003eisFulfilled($promise); // false\n$promises-\u003eisRejected($promise);  // false\n$promises-\u003eisSettled($promise);   // false\n\n// Promise fulfillment\n$promise = $promises-\u003ecreate();\n\n$promises-\u003efulfill($promise);\n\n$promises-\u003eisFulfilled($promise); // true\n$promises-\u003eisRejected($promise);  // false\n$promises-\u003eisSettled($promise);   // true\n\n// Promise rejection\n$promise = $promises-\u003ecreate();\n\n$promises-\u003ereject($promise);\n\n$promises-\u003eisFulfilled($promise); // false\n$promises-\u003eisRejected($promise);  // true\n$promises-\u003eisSettled($promise);   // true\n```\n\n## Running tests\n\nTo run tests, `cd` to this directory and run:\n\n```bash\nphpunit -c test\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factivecollab%2Fpromises","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Factivecollab%2Fpromises","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factivecollab%2Fpromises/lists"}