{"id":13305706,"url":"https://github.com/jooy2/spreadit","last_synced_at":"2025-07-11T06:32:42.043Z","repository":{"id":37274284,"uuid":"424053426","full_name":"jooy2/spreadit","owner":"jooy2","description":"⚡ Easy to use Google Apps Script Spreadsheet utils. Handling of external Google Sheets files.","archived":false,"fork":false,"pushed_at":"2025-02-06T01:54:20.000Z","size":506,"stargazers_count":28,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-03T14:02:39.838Z","etag":null,"topics":["clasp","easy-to-use","google","google-apps-script","google-script","google-sheets","google-sheets-api","google-workspace","googleappsscript","googlescript","gscript","gsheet","method-chaining","office","spreadsheet","util","utility"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/jooy2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":"jooy2","custom":["https://jooy2.com/donate"]}},"created_at":"2021-11-03T01:29:52.000Z","updated_at":"2025-06-23T21:19:50.000Z","dependencies_parsed_at":"2023-11-26T10:24:17.921Z","dependency_job_id":"b28e523f-8d4b-4ab3-8233-db1ad5cf29e9","html_url":"https://github.com/jooy2/spreadit","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jooy2/spreadit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jooy2%2Fspreadit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jooy2%2Fspreadit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jooy2%2Fspreadit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jooy2%2Fspreadit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jooy2","download_url":"https://codeload.github.com/jooy2/spreadit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jooy2%2Fspreadit/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264747938,"owners_count":23657933,"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":["clasp","easy-to-use","google","google-apps-script","google-script","google-sheets","google-sheets-api","google-workspace","googleappsscript","googlescript","gscript","gsheet","method-chaining","office","spreadsheet","util","utility"],"created_at":"2024-07-29T17:54:00.056Z","updated_at":"2025-07-11T06:32:42.036Z","avatar_url":"https://github.com/jooy2.png","language":"JavaScript","readme":"# 🔌 Google Apps Script Spreadit\n\n\u003e [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/jooy2/spreadit/blob/main/LICENSE) [![Followers](https://img.shields.io/github/followers/jooy2?style=social)](https://github.com/jooy2) ![Stars](https://img.shields.io/github/stars/jooy2/google-apps-script-sheetio?style=social) ![Line Count](https://img.shields.io/tokei/lines/github/jooy2/google-apps-script-sheetio) ![Commit Count](https://img.shields.io/github/commit-activity/y/jooy2/google-apps-script-sheetio) ![Repo Size](https://img.shields.io/github/repo-size/jooy2/google-apps-script-sheetio)\n\nEasy to use **[Google Apps Script](https://script.google.com)** [Spreadsheet API](https://developers.google.com/apps-script/reference/spreadsheet) (using Method chaining)\n\n## Features\n\n- ⚡️ Installing scripts into your project Super-Fast!\n- ⚡️ Easy to use, data insertion and styling\n- ⚡️ Handling of external Google Sheets files\n- ⚡️ Support for a variety of utility methods to simplify sheet operations\n\n## Installation\n\n### Step 1. Install `clasp`\n\nIn order to properly use all configuration of `clasp`, you need to change the Enabled setting of Google Apps Script API to 'Enable' after logging in with your Google account on the next page: https://script.google.com/home/usersettings\n\nThe clasp package must be installed for automatic installation in `Google Drive`.\n\n```shell\n$ npm install -g @google/clasp\n```\n\nIf you have set up the development environment in this project, you can install it through `npm i`, so you don't need to install the package globally.\n\nYou may need a `clasp` login before proceeding. Skip if you have already done this:\n\n```shell\n$ clasp login\n```\n\n### Step 2-A. Create Google SpreadSheet script in your workspace\n\nYou can create Google Sheets and script projects in Google Drive. We recommend running your own scripts with everything integrated.\n\n#### [Method 1] Create automatically (recommended)\n\nThis npm script helps you quickly and easily push scripts to your new spreadsheet file using `clasp`.\n\n```shell\n$ npm run create\n```\n\n#### [Method 2] Create manually\n\n```shell\n$ clasp create\n```\n\nFollow the `clasp`'s prompts to create a spreadsheet in the `Google Drive` top-level path. After you open that sheet, the script will be installed automatically.\n\nMake sure a `.clasp.json` file is created in your project root. After that, you can install the script into the document with the command below.\n\n```shell\n$ clasp push\n```\n\n### Step 2-B. Manual Installation\n\nIf you already have a Google Script project created, or if you want to add your own script files, follow the steps below.\n\nPut the `Spreadit.js` file in project directory into your new **[Google Apps Script](https://script.google.com)** project file and use it.\n\nYou can also use additional `App.js` and `Test.js` files if necessary.\n\n## Usage\n\n```javascript\n// Create a Spreadit instance.\nconst Sheet = new Spreadit();\n\n// Create a new sheet 'Users'.\nSheet.create('Users');\n\n// Specifies where the currently active sheet is, allowing cells to be processed.\nconst targetSheet = Sheet.active('Users');\n\n// The general method is similar to that of the Google Apps Script Spreadsheet.\ntargetSheet.getRange(1, 1).getValue();\n\n// Continuous use possible with method chaining.\ntargetSheet\n  .clearAll()\n  .insertLastRow([['ID', 'Name', 'Age', 'Gender', 'Created', 'Updated', 'Subscription']])\n  .insertLastRow([\n    ['1', 'Lee', '26', 'M', '2021-11-01', '2021-11-01', 'Y'],\n    ['2', 'James', '31', 'M', '2021-10-25', '2021-11-15', 'N'],\n    ['3', 'Katy', '25', 'W', '2020-09-11', '2021-05-24', 'Y'],\n    ['4', 'Betty', '27', 'W', '2021-03-09', '2021-11-11', 'N'],\n    ['5', 'Mike', '32', 'M', '2020-07-29', '2020-09-06', 'N']\n  ]);\n```\n\n## Using API / Methods\n\nRelated descriptions are attached to the entire method of `Spreadit.js`, and the main method of the default API commonly used in Spreadsheet of **Google Apps Script** is overridden.\n\nNot all Spreadsheet methods may be compatible. If there is a method you would like to request, please leave an issue or send a PR.\n\nSee: https://developers.google.com/apps-script/reference/spreadsheet\n\n## Contributing\n\nAnyone can contribute to the project by reporting new issues or submitting a pull request. For more information, please see [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nPlease see the [LICENSE](LICENSE) file for more information about project owners, usage rights, and more.\n","funding_links":["https://github.com/sponsors/jooy2","https://jooy2.com/donate"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjooy2%2Fspreadit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjooy2%2Fspreadit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjooy2%2Fspreadit/lists"}