{"id":18243752,"url":"https://github.com/krisnaajiep/php-expense-tracker-cli","last_synced_at":"2025-04-08T18:27:11.433Z","repository":{"id":281991391,"uuid":"909263554","full_name":"krisnaajiep/php-expense-tracker-cli","owner":"krisnaajiep","description":"A simple expense tracker command line interface (CLI) App built with PHP that used to to manage your finances.","archived":false,"fork":false,"pushed_at":"2025-03-12T07:21:17.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-12T08:26:07.233Z","etag":null,"topics":["cli","cli-app","cli-application","command-line","command-line-app","command-line-interface","csv","csv-files","expense-tracker","filesystem","json-files","php"],"latest_commit_sha":null,"homepage":"","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/krisnaajiep.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-28T07:10:15.000Z","updated_at":"2025-03-12T07:21:21.000Z","dependencies_parsed_at":"2025-03-12T08:36:41.212Z","dependency_job_id":null,"html_url":"https://github.com/krisnaajiep/php-expense-tracker-cli","commit_stats":null,"previous_names":["krisnaajiep/php-expense-tracker-cli"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krisnaajiep%2Fphp-expense-tracker-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krisnaajiep%2Fphp-expense-tracker-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krisnaajiep%2Fphp-expense-tracker-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krisnaajiep%2Fphp-expense-tracker-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/krisnaajiep","download_url":"https://codeload.github.com/krisnaajiep/php-expense-tracker-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247900698,"owners_count":21015108,"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":["cli","cli-app","cli-application","command-line","command-line-app","command-line-interface","csv","csv-files","expense-tracker","filesystem","json-files","php"],"created_at":"2024-11-05T09:02:58.004Z","updated_at":"2025-04-08T18:27:11.425Z","avatar_url":"https://github.com/krisnaajiep.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PHP Expense Tracker\n\n\u003e Simple expense tracker CLI (Command Line Interface) App built with PHP.\n\n## Table of Contents\n\n* [General Info](#general-information)\n* [Technologies Used](#technologies-used)\n* [Features](#features)\n* [Setup](#setup)\n* [Usage](#usage)\n* [Project Status](#project-status)\n* [Acknowledgements](#acknowledgements)\n\n## General Information\n\nPHP Expense Tracker is a simple CLI (Command Line Interface) application that allows users to manage their finances. This project is designed to explore and practice logic building, working with the Command Line Interface (CLI), and filesystem operations in PHP.\n\n## Technologies Used\n\n* PHP - version 8.3.6\n\n## Features\n\n* **Set Budget**: Set montly budget for expenses.\n* **Add a New Expense**: Create a new expense with a category, description, and amount.\n* **List All Expense**: Display a list of all expense with their details.\n* **List Tasks By Category**: Display a list of all tasks by Category.\n* **Update an Expense**: Modify the category, description, or amount of an existing task.\n* **Update Budget**: Modify montly budget for expenses.\n* **Delete an Expense**: Remove an expense from the list.\n* **View a Summary**: View a summary of all expenses or for a specific month (of current year).\n* **Export Into CSV**: Export expenses data into a csv file.\n\n## Setup\n\nTo run this CLI tool, you’ll need:\n\n* **PHP**: Version 8.3 or newer\n\nHow to install:\n\n1. Clone the repository\n\n   ```bash\n   git clone https://github.com/krisnaajiep/php-expense-tracker-cli.git\n   ```\n\n2. Change the current working directory\n\n   ```bash\n   cd path/php-expense-tracker-cli\n   ```\n\n3. Run the task tracker\n\n   ```bash\n   php expense-tracker.php\n   ```\n\n## Usage\n\n`php expense-tracker.php \u003ccommand\u003e [options] \u003carguments\u003e`\n\nAvailable commands, options, and arguments:\n\n| Commands  | Options                               | Description                                                        |\n| --------- | ------------------------------------- | ------------------------------------------------------------------ |\n| `set`     | `--budget`                            | Set monthly budget                                                 |\n| `show`    | `--budget`                            | Show montly budget                                                 |\n| `add`     | `--category, --description, --amount` | Add new expense                                                    |\n| `update`  | `--id, --category`                    | Update expense category                                            |\n| `update`  | `--id, --description`                 | Update expense description                                         |\n| `update`  | `--id, --amount`                      | Update expense amount                                              |\n| `delete`  | `--id`                                | Deleting an expense                                                |\n| `list`    |                                       | List all expenses                                                  |\n| `list`    | `--category`                          | Listing all expense by category                                    |\n| `summary` |                                       | View a summary of all expenses                                     |\n| `export`  |                                       | Export expenses data into csv file                                 |\n| `export`  |                                       | Export expenses data into csv file                                 |\n\nExample:\n\n* Set montly budget\n\n  ```bash\n  php expense-tracker.php set --budget 2000\n  ```\n\n* Adding a new expense\n\n  ```bash\n  php expense-tracker.php add --description \"Lunch\" --amount 20 --category \"Food\"\n  ```\n\n* Updating an expense\n\n  ```bash\n  php expense-tracker.php update --id 1 --category \"Electronic\"\n  ```\n\n  ```bash\n  php expense-tracker.php update --id 1 --description \"Radio\"\n  ```\n\n  ```bash\n  php expense-tracker.php update --id 1 --amount 60\n  ```\n\n* Deleting an expense\n\n  ```bash\n  php expense-tracker.php delete --id 1\n  ```\n\n* Listing all expenses\n\n  ```bash\n  php expense-tracker.php list\n  ```\n\n* Listing all expenses by specific category\n\n  ```bash\n  php expense-tracker.php list --category \"Electronic\"\n  ```\n\n* View a summary of all expenses\n\n  ```bash\n  php expense-tracker.php summary\n  ```\n\n* Listing all expenses by specific month\n\n  ```bash\n  php expense-tracker.php summary --month 6\n  ```\n\n* Export data into csv file\n\n  ```bash\n  php expense-tracker.php export\n  ```\n\n## Project Status\n\nProject is: _complete_.\n\n## Acknowledgements\n\nThis project was inspired by [roadmap.sh](https://roadmap.sh/projects/expense-tracker).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkrisnaajiep%2Fphp-expense-tracker-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkrisnaajiep%2Fphp-expense-tracker-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkrisnaajiep%2Fphp-expense-tracker-cli/lists"}