{"id":25228141,"url":"https://github.com/jjacoboflorez95/email-list-reader","last_synced_at":"2026-04-12T20:35:54.710Z","repository":{"id":276526213,"uuid":"919461127","full_name":"jjacoboflorez95/email-list-reader","owner":"jjacoboflorez95","description":"A Node.js CLI application for reading and displaying email lists from text files.","archived":false,"fork":false,"pushed_at":"2025-02-17T22:17:47.000Z","size":4,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-17T23:24:53.592Z","etag":null,"topics":["cli-application","college-project","file-handling","javascript","node-js"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/jjacoboflorez95.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":"2025-01-20T12:37:33.000Z","updated_at":"2025-02-17T22:17:51.000Z","dependencies_parsed_at":"2025-02-08T20:34:58.545Z","dependency_job_id":null,"html_url":"https://github.com/jjacoboflorez95/email-list-reader","commit_stats":null,"previous_names":["jjacoboflorez95/email-list-reader"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjacoboflorez95%2Femail-list-reader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjacoboflorez95%2Femail-list-reader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjacoboflorez95%2Femail-list-reader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjacoboflorez95%2Femail-list-reader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jjacoboflorez95","download_url":"https://codeload.github.com/jjacoboflorez95/email-list-reader/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247345321,"owners_count":20924097,"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-application","college-project","file-handling","javascript","node-js"],"created_at":"2025-02-11T09:51:32.134Z","updated_at":"2026-04-12T20:35:49.680Z","avatar_url":"https://github.com/jjacoboflorez95.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📧 Email List Reader\n\n## 📌 Project Overview\n\n**Email List Reader** is a **Node.js application** designed to **read email list files** and display their content in the console. This project demonstrates **file handling in Node.js** and script execution from the command line, making it a useful tool for managing email data.\n\nDeveloped as part of a **professional portfolio**, this project showcases **asynchronous file operations, command-line interaction, and error handling techniques in JavaScript**.\n\n---\n\n## 🚀 Features\n\n- 📄 **Reads email lists** from `.txt` files.\n- 🖥️ **Command-line execution**, allowing users to specify the file to read.\n- 🔄 **Error handling**, displaying messages in case of missing or non-existent files.\n- ⚡ **Asynchronous operation** using `fs.promises` for improved performance.\n\n---\n\n## 🛠 Technologies Used\n\n- **Node.js** → JavaScript runtime environment.\n- **JavaScript (ES6+)** → Uses `async/await` and promises for file handling.\n- **`fs.promises` Module** → Enables **asynchronous file reading**.\n\n---\n\n## 🎯 Project Purpose\n\nThis project demonstrates:\n\n- ✅ **File handling in Node.js** using `fs.promises.readFile`.\n- ✅ **Creating CLI-executable scripts** for file processing.\n- ✅ **Using JavaScript promises and async/await** for asynchronous operations.\n- ✅ **Handling user input and errors gracefully in a command-line application**.\n\n---\n\n## 📂 Project Structure\n\n```\n📁 email_reader_project\n ├── 📄 email_list.txt        # Sample email list file\n ├── 📄 email_list2.txt       # Another sample email list file\n ├── 📄 read.js               # Main Node.js script\n```\n\n---\n\n## 📌 Prerequisites\n\nBefore running the script, ensure **Node.js** is installed. Verify with:\n\n```sh\nnode -v\n```\n\n---\n\n## 🏃‍♂️ How to Use\n\n1️⃣ **Open a terminal** and navigate to the project folder:\n\n```sh\ncd email_reader_project\n```\n\n2️⃣ **Run the script** by providing a file as an argument:\n\n```sh\nnode read.js email_list.txt\n```\n\n🔹 You can also execute it with another file:\n\n```sh\nnode read.js email_list2.txt\n```\n\n---\n\n## 📝 Example Output\n\nIf the `email_list.txt` file contains:\n\n```\nmary@murach.com (Mary Delamater)\njoel@murach.com (Joel Murach)\nanne@murach.com (Anne Boehm)\n```\n\nThe console output will be:\n\n```sh\nScript: /path/to/script/read.js\nFilename: email_list.txt\n=============================================================\nmary@murach.com (Mary Delamater)\njoel@murach.com (Joel Murach)\nanne@murach.com (Anne Boehm)\n```\n\n---\n\n## ⚠️ Error Handling\n\n- If **no filename** is provided, the script will display:\n\n```sh\nError:\nPlease enter a filename to proceed.\n```\n\n- If the file **does not exist**, an error message will be displayed.\n\n---\n\n## 🌟 Future Improvements\n\n- 📝 **Support for different file formats** (e.g., `.csv`, `.json`).\n- 📤 **Export results** to another file or email.\n- 📊 **Filter and sort emails** based on domain names or alphabetical order.\n- 🔍 **Search functionality** to find specific email addresses.\n\n---\n\n## 📜 License\n\nThis project is licensed under the **MIT** License.\n\n---\n\n## 💼 Author\n\n👤 **Juan Jacobo Florez Monroy**  \n🌐 **Portfolio**: [jjacobo95.com](https://jjacobo95.com)  \n🐙 **GitHub**: [github.com/jjacoboflorez95](https://github.com/jjacoboflorez95)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjjacoboflorez95%2Femail-list-reader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjjacoboflorez95%2Femail-list-reader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjjacoboflorez95%2Femail-list-reader/lists"}