{"id":26705943,"url":"https://github.com/rquitales/csv-joiner-python","last_synced_at":"2025-07-29T07:35:10.865Z","repository":{"id":284662039,"uuid":"282346082","full_name":"rquitales/csv-joiner-python","owner":"rquitales","description":"A python package to combine CSV files","archived":false,"fork":false,"pushed_at":"2020-07-29T23:57:03.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-18T19:48:42.997Z","etag":null,"topics":["csv","joins"],"latest_commit_sha":null,"homepage":"","language":"Python","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/rquitales.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-25T01:14:09.000Z","updated_at":"2020-07-29T23:57:05.000Z","dependencies_parsed_at":"2025-03-27T02:43:21.992Z","dependency_job_id":"eedc73d8-47b0-4972-82fd-2257a4a3bd2e","html_url":"https://github.com/rquitales/csv-joiner-python","commit_stats":null,"previous_names":["rquitales/csv-joiner-python"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rquitales/csv-joiner-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rquitales%2Fcsv-joiner-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rquitales%2Fcsv-joiner-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rquitales%2Fcsv-joiner-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rquitales%2Fcsv-joiner-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rquitales","download_url":"https://codeload.github.com/rquitales/csv-joiner-python/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rquitales%2Fcsv-joiner-python/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267646452,"owners_count":24121022,"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","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["csv","joins"],"created_at":"2025-03-27T05:39:12.093Z","updated_at":"2025-07-29T07:35:10.843Z","avatar_url":"https://github.com/rquitales.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n Copyright (c) 2020 Ramon Quitales\n \n This software is released under the MIT License.\n https://opensource.org/licenses/MIT\n--\u003e\n\n\u003c!-- PROJECT SHIELDS --\u003e\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n  \u003c!-- \u003ca href=\"https://github.com/rquitales/csv-joiner-python\"\u003e\n    \u003cimg src=\"images/logo.png\" alt=\"Logo\" width=\"80\" height=\"80\"\u003e\n  \u003c/a\u003e --\u003e\n\n  \u003ch3 align=\"center\"\u003eCSV Joiner\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    Simple python package to merge CSV files\n    \u003cbr /\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n## Table of Contents\n\n- [Table of Contents](#table-of-contents)\n- [About The Project](#about-the-project)\n  - [Built With](#built-with)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n- [Usage](#usage)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About The Project\n\nThis Python package enables merging of 2 CSV files. Currently, only inner joins are supported, with plans for more join operations.\n\nThis package will work fairly well on large datasets as it doesn't require reading both CSV files in memory. However, at least 1 CSV file must be small enough to be read in memory. The inner join is fairly efficient as it employs a HashMap to efficient find rows to be joined.\n\n### Built With\n\n- [Python 3.8](https://python.org)\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started\n\nTo get a local copy up and running follow these simple steps:\n\n1. `pip3 install git+https://github.com/rquitales/csv-joiner-python.git`\n2. Import `csvjoiner` within your Python script\n\n### Prerequisites\n\nThis package requires Python 3.5 or greater in order to function properly. No other dependencies are required as it is implemented fully using base Python.\n\n\u003c!-- USAGE EXAMPLES --\u003e\n## Usage\n\n- **Exporting merged data to CSV file:**\n\n    ```{Python}\n    import csvjoiner\n\n    # Join on columns: colA, colB, colC\n    join = csvjoiner.Joiner(\"/path/to/first/csv\", \"/path/to/second/csv\", \"colA\", \"colB\", \"colC\")\n\n    join.inner(\"/path/to/output/csv\")\n    ```\n\n- **Converting merged data into Pandas dataframe:**\n  \n    ```{Python}\n    import csvjoiner\n    import pandas as pd\n\n    # Join on columns: colA, colB, colC\n    join = csvjoiner.Joiner(\"/path/to/first/csv\", \"/path/to/second/csv\", \"colA\", \"colB\", \"colC\")\n\n    merged_data = join.inner()\n    df = pd.DataFrame(data=merged_data['data'], columns=merged_data['headers'])\n    ```\n\n\u003c!-- CONTRIBUTING --\u003e\n## Contributing\n\nContributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the MIT License. See `LICENSE` for more information.\n\n\u003c!-- CONTACT --\u003e\n## Contact\n\nRamon Quitales - oss@rquitales.com\n\nProject Link: [https://github.com/rquitales/csv-joiner-python](https://github.com/rquitales/csv-joiner-python)\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/rquitales/csv-joiner-python.svg?style=flat-square\n[contributors-url]: https://github.com/rquitales/csv-joiner-python/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/rquitales/csv-joiner-python.svg?style=flat-square\n[forks-url]: https://github.com/rquitales/csv-joiner-python/network/members\n[stars-shield]: https://img.shields.io/github/stars/rquitales/csv-joiner-python.svg?style=flat-square\n[stars-url]: https://github.com/rquitales/csv-joiner-python/stargazers\n[issues-shield]: https://img.shields.io/github/issues/rquitales/csv-joiner-python.svg?style=flat-square\n[issues-url]: https://github.com/rquitales/csv-joiner-python/issues\n[license-shield]: https://img.shields.io/github/license/rquitales/csv-joiner-python.svg?style=flat-square\n[license-url]: https://github.com/rquitales/csv-joiner-python/blob/master/LICENSE.txt","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frquitales%2Fcsv-joiner-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frquitales%2Fcsv-joiner-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frquitales%2Fcsv-joiner-python/lists"}