{"id":21819359,"url":"https://github.com/dflydev/dflydev-symfony-finder-factory","last_synced_at":"2025-04-14T02:28:52.884Z","repository":{"id":5424590,"uuid":"6616408","full_name":"dflydev/dflydev-symfony-finder-factory","owner":"dflydev","description":"Symfony Finder Factory","archived":false,"fork":false,"pushed_at":"2017-03-12T09:34:04.000Z","size":120,"stargazers_count":6,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-27T16:21:29.093Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dflydev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-11-09T16:32:53.000Z","updated_at":"2017-12-23T12:45:57.000Z","dependencies_parsed_at":"2022-07-06T17:02:20.789Z","dependency_job_id":null,"html_url":"https://github.com/dflydev/dflydev-symfony-finder-factory","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dflydev%2Fdflydev-symfony-finder-factory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dflydev%2Fdflydev-symfony-finder-factory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dflydev%2Fdflydev-symfony-finder-factory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dflydev%2Fdflydev-symfony-finder-factory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dflydev","download_url":"https://codeload.github.com/dflydev/dflydev-symfony-finder-factory/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248358634,"owners_count":21090407,"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":"2024-11-27T16:18:38.988Z","updated_at":"2025-04-14T02:28:52.850Z","avatar_url":"https://github.com/dflydev.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"Symfony Finder Factory\n======================\n\nA factory for Symfony Finder ([symfony/finder][1]) Finder instances.\n\nThe idea being able to inject a factory to create Finder instances into\nservices rather than calling `new Finder` in each service.\n\n\nRequirements\n------------\n\n * PHP 5.3+\n * Symfony Finder ~2.0\n\n \nInstallation\n------------\n \nThrough [Composer][2] as [dflydev/symfony-finder-factory][3]\n\n\nUsage\n-----\n\n```php\n\u003c?php\nnamespace My;\n\nuse Dflydev\\Symfony\\FinderFactory;\nuse Dflydev\\Symfony\\FinderFactoryInterface;\n\nclass Service\n{\n    public function __construct(FinderFactoryInterface $finderFactory = null)\n    {\n        $this-\u003efinderFactory = $finderFactory ?: new FinderFactory;\n    }\n\n    public function doThingsWithTempFiles()\n    {\n        $finder = $this-\u003efinderFactory-\u003ecreate();\n\n        $finder-\u003ein(sys_get_temp_dir());\n        \n        // do stuff with temp files\n    }\n}\n```\n\n\nUse Case\n--------\n\nMocking Finder has proven to be extremely difficult if `new Finder` is\ncalled inside of a class. By injecting a mocked Finder Factory we can\nhave the opportunity to get mocked Finder instances inside our classes\nfor the purpose of testing.\n\nThis is best shown by example:\n\n```php\n\u003c?php\nnamespace My;\n\nuse Dflydev\\Symfony\\FinderFactory;\nuse Dflydev\\Symfony\\FinderFactoryInterface;\nuse Symfony\\Component\\Finder\\Finder;\n\nclass Service\n{\n    public function __construct(FinderFactoryInterface $finderFactory = null)\n    {\n        $this-\u003efinderFactory = $finderFactory ?: new FinderFactory;\n    }\n\n    public function findTmpFilesNew()\n    {\n        // Potential for mocked injected Finder Factory to return\n        // a mocked Finder instance.\n        $finder = $this-\u003efinderFactory-\u003ecreate();\n\n        return $finder-\u003ein(sys_get_temp_dir());\n    }\n\n    public function findTmpFilesOld()\n    {\n        // Difficult to Mock\n        $finder = new Finder;\n\n        return $finder-\u003ein(sys_get_temp_dir());\n    }\n}\n```\n\n\nLicense\n-------\n\nMIT, see LICENSE.\n\n\nCommunity\n---------\n\nIf you have questions or want to help out, join us in the\n\u003ca href=\"irc://irc.freenode.net/#dflydev\"\u003e#dflydev\u003c/a\u003e channel\non irc.freenode.net.\n\n\nNot Invented Here\n-----------------\n\nThis project is based on work previously submitted to Symfony core\n([symfony/symfony#5650][4]) but rejected.\n\n\n[1]: https://packagist.org/packages/symfony/finder\n[2]: http://getcomposer.org\n[3]: https://packagist.org/packages/dflydev/symfony-finder-factory\n[4]: https://github.com/symfony/symfony/pull/5650","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdflydev%2Fdflydev-symfony-finder-factory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdflydev%2Fdflydev-symfony-finder-factory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdflydev%2Fdflydev-symfony-finder-factory/lists"}