{"id":13465147,"url":"https://github.com/data-forge/data-forge-ts","last_synced_at":"2025-05-13T21:11:17.697Z","repository":{"id":41136170,"uuid":"112146826","full_name":"data-forge/data-forge-ts","owner":"data-forge","description":"The JavaScript data transformation and analysis toolkit inspired by Pandas and LINQ.","archived":false,"fork":false,"pushed_at":"2025-04-30T00:51:33.000Z","size":3854,"stargazers_count":1361,"open_issues_count":17,"forks_count":79,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-05-13T18:22:56.011Z","etag":null,"topics":["csv","data","data-analysis","data-cleaning","data-cleansing","data-forge","data-management","data-manipulation","data-munging","data-visualization","data-wrangling","javascript","json","linq","nodejs","pandas","visualization"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/data-forge.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null},"funding":{"github":"ashleydavis"}},"created_at":"2017-11-27T04:23:45.000Z","updated_at":"2025-05-09T09:41:53.000Z","dependencies_parsed_at":"2023-11-23T00:07:45.047Z","dependency_job_id":"93a60123-9363-4cac-b282-5729ec41d4a4","html_url":"https://github.com/data-forge/data-forge-ts","commit_stats":{"total_commits":470,"total_committers":15,"mean_commits":"31.333333333333332","dds":0.08510638297872342,"last_synced_commit":"7a061a8fae13b871722bc6df8ce986e5f202b89f"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/data-forge%2Fdata-forge-ts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/data-forge%2Fdata-forge-ts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/data-forge%2Fdata-forge-ts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/data-forge%2Fdata-forge-ts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/data-forge","download_url":"https://codeload.github.com/data-forge/data-forge-ts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254029003,"owners_count":22002283,"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":["csv","data","data-analysis","data-cleaning","data-cleansing","data-forge","data-management","data-manipulation","data-munging","data-visualization","data-wrangling","javascript","json","linq","nodejs","pandas","visualization"],"created_at":"2024-07-31T14:01:01.328Z","updated_at":"2025-05-13T21:11:12.660Z","avatar_url":"https://github.com/data-forge.png","language":"TypeScript","readme":"# Data-Forge\n\nThe JavaScript data transformation and analysis toolkit inspired by Pandas and LINQ.\n\n*Implemented* in TypeScript.\u003cbr\u003e\n*Used* in JavaScript ES5+ or TypeScript.\n\nLove this? Please star this repo and [click here to support my work](https://www.codecapers.com.au/about#support-my-work)\n\n[![Build Status](https://travis-ci.org/data-forge/data-forge-ts.svg?branch=master)](https://travis-ci.org/data-forge/data-forge-ts)\n[![npm version](https://badge.fury.io/js/data-forge.svg)](https://badge.fury.io/js/data-forge)\n[![License](http://img.shields.io/badge/license-MIT-brightgreen.svg)](http://opensource.org/licenses/MIT)\n\n**Please note** that this TypeScript repository replaces the [previous JavaScript version of Data-Forge](https://github.com/data-forge/data-forge-js).\n\n## BREAKING CHANGES\n\nAs of v1.6.9 the dependencies Sugar, Lodash and Moment have been factored out (or replaced with smaller dependencies). This more than halves the bundle size. Hopefully this won't cause any problems - but please log an issue if something changes that you weren't expecting.\n\nAs of v1.3.0 file system support has been removed from the Data-Forge core API. This is after repeated issues from users trying to get Data-Forge working in the browser, especially under AngularJS 6.\n\nFunctions for reading and writing files have been moved to the separate code library [Data-Forge FS](https://github.com/data-forge/data-forge-fs).\n\nIf you are using the file read and write functions prior to 1.3.0 then your code will no longer work when you upgrade to 1.3.0. The fix is simple though, where usually you would just require in Data-Forge as follows:\n\n```javascript\nconst dataForge = require('data-forge');\n```\n\nNow you must also require in the new library as well:\n\n```javascript\nconst dataForge = require('data-forge');\nrequire('data-forge-fs');\n```\n\nData-Forge FS augments Data-Forge core so that you can use the readFile/writeFile functions as in previous versions and as is shown in this readme and the guide.\n\nIf you still have problems with AngularJS 6 please see this workaround:\nhttps://github.com/data-forge/data-forge-ts/issues/3#issuecomment-438580174\n\n## Install\n\nTo install for Node.js and the browser:\n\n    npm install --save data-forge\n\nIf working in Node.js and you want the functions to read and write data files:\n\n    npm install --save data-forge-fs\n\n## Quick start\n\nData-Forge can load CSV, JSON or arbitrary data sets. \n\nParse the data, filter it, transform it, aggregate it, sort it and much more.\n\nUse the data however you want or export it to CSV or JSON.\n\nHere's an example:\n\n```JavaScript\nconst dataForge = require('data-forge');\nrequire('data-forge-fs'); // For readFile/writeFile.\n\ndataForge.readFileSync('./input-data-file.csv') // Read CSV file (or JSON!)\n    .parseCSV()\n    .parseDates([\"Column B\"]) // Parse date columns.\n    .parseInts([\"Column B\", \"Column C\"]) // Parse integer columns.\n    .parseFloats([\"Column D\", \"Column E\"]) // Parse float columns.\n    .dropSeries([\"Column F\"]) // Drop certain columns.\n    .where(row =\u003e predicate(row)) // Filter rows.\n    .select(row =\u003e transform(row)) // Transform the data.\n    .asCSV() \n    .writeFileSync(\"./output-data-file.csv\"); // Write to output CSV file (or JSON!)\n```\n\n## From the browser\n\nData-Forge has been tested with Browserify and Webpack. Please see links to examples below.\n\nIf you aren't using Browserify or Webpack, the npm package includes a pre-packed browser distribution that you can install and included in your HTML as follows:\n\n```html\n\u003cscript language=\"javascript\" type=\"text/javascript\" src=\"node_modules/data-forge/dist/web/index.js\"\u003e\u003c/script\u003e\n```\n\nThis gives you the data-forge package mounted under the global variable `dataForge`.\n\nPlease remember that you can't use data-forge-fs or the file system functions in the browser.\n\n## Features\n\n- Import and export CSV and JSON data and text files (when using [Data-Forge FS](https://github.com/data-forge/data-forge-fs)).\n- Or work with arbitrary JavaScript data.\n- Many options for working with your data:\n    - Filtering\n    - Transformation\n    - Extracting subsets\n    - Grouping, aggregation and summarization\n    - Sorting\n    - And much more\n- Great for slicing and dicing tabular data:\n    - Add, remove, transform and generate named columns (series) of data.\n- Great for working with time series data.\n- Your data is indexed so you have the ability to merge and aggregate.\n- Your data is immutable! Transformations and modifications produce a new dataset.\n- Build data pipeline that are evaluated lazily.\n- Inspired by Pandas and LINQ, so it might feel familiar!\n\n## Contributions\n\nWant a bug fixed or maybe to improve performance?\n\nDon't see your favourite feature?\n\nNeed to add your favourite Pandas or LINQ feature?\n\nPlease contribute and help improve this library for everyone!\n\nFork it, make a change, submit a pull request. Want to chat? See my contact details at the end or reach out on Gitter.\n\n\n\n## Platforms\n\n- Node.js (npm install --save data-forge data-forge-fs) ([see example here](https://github.com/data-forge/data-forge-examples-and-tests/tree/master/package-test/npm))\n- Browser\n    - Via bower (bower install --save data-forge) ([see example here](https://github.com/data-forge/data-forge-examples-and-tests/tree/master/package-test/bower))\n    - Via Browserify ([see example here](https://github.com/data-forge/data-forge-examples-and-tests/tree/master/examples/2.%20plot%20-%20in%20browser))\n    - Via Webpack ([see example here](https://github.com/data-forge/data-forge-examples-and-tests/tree/master/examples/3.%20plot%20-%20in%20browser%20-%20with%20dates))\n\n## Documentation\n\n- [Changes](docs/changes.md)\n- [The guide](docs/guide.md)\n- [Key concepts](docs/concepts.md)\n- [API docs](https://data-forge.github.io/data-forge-ts/)\n- [FS API docs](https://data-forge.github.io/data-forge-fs/index.html)\n- [Data-Forge FS](https://github.com/data-forge/data-forge-fs/)\n- [Data-Forge Plot](https://github.com/data-forge/data-forge-plot/)\n- [Gitter](https://gitter.im/data-forge)\n\n## Resources\n\n- [Data Wrangling with JavaScript](http://bit.ly/2t2cJu2)\n\n## Contact\n\nPlease reach and tell me what you are doing with Data-Forge or how you'd like to see it improved.\n\n- Twitter: @codecapers\n- Email: ashley@codecapers.com.au\n- Linkedin: www.linkedin.com/in/ashleydavis75\n- Web: www.codecapers.com.au\n\n## Support the developer \n\n\u003ca target=\"_blank\" href=\"http://www.codecapers.com.au/about#support-my-work\"\u003eClick here to **support the developer.**\u003c/a\u003e\n\n\n","funding_links":["https://github.com/sponsors/ashleydavis"],"categories":["TypeScript","Libraries"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdata-forge%2Fdata-forge-ts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdata-forge%2Fdata-forge-ts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdata-forge%2Fdata-forge-ts/lists"}