Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yukihirop/sit
the very very very stupid csv content tracker 🤧 Management for Sheet (ex: GoogleSpreadSheet) like git
https://github.com/yukihirop/sit
cli csv git google-spreadsheet googlespreadsheet nodejs sit
Last synced: about 1 month ago
JSON representation
the very very very stupid csv content tracker 🤧 Management for Sheet (ex: GoogleSpreadSheet) like git
- Host: GitHub
- URL: https://github.com/yukihirop/sit
- Owner: yukihirop
- License: mit
- Created: 2020-01-17T15:15:31.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-12-15T05:41:44.000Z (about 1 year ago)
- Last Synced: 2024-04-20T09:09:06.217Z (8 months ago)
- Topics: cli, csv, git, google-spreadsheet, googlespreadsheet, nodejs, sit
- Language: JavaScript
- Homepage: https://yukihirop.github.io/sit
- Size: 1.66 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# sit
[](https://badge.fury.io/js/%40yukihirop%2Fsit)
[](https://opensource.org/licenses/MIT)
the very very very stupid csv content tracker 🤧
Management for Sheet (ex: GoogleSpreadSheet) like git 😑
## 📦 Installation
```bash
npm install -g @yukihirop/sit
```
## 📖 Usage
```bash
sit -h
Usage: sit [options] [command]
sit cli
Options:
-V, --version output the version number
-h, --help output usage information
Commands:
cat-file [options] cat sit objects
hash-object [options] compute hash sit object
branch [options] operate branch
checkout [options] [repository] [name] checkout branch
status status dist file
diff diff dist file
commit [options] commit dist file
push [options] push rows into Sheet
fetch [options] [branch] fetch rows from Sheet
merge [options] [repository] [branch] merge rows
clone [options] clone rows from sheet
browse-remote [repository] browse remote repository
config [options] configure sitconfig
remote [options] [url] set sitconfig
log [options] Shows the commit logs
reflog Shows the ref logs
show-ref Show refs
rev-parse [options] [args] Many Sit porcelainish commands take mixture of flags
pull-request [options] Create pull request in Sheet
init create setting file (.sitsetting)
clasp clasp cli
repo repo cli
stash stash cli
```
## ❤️ Support Sheets
- GoogleSpreadSheet
## 📕 Documents
Full docs are available at https://yukihirop.github.io/sit
## ⚙ .sitsetting
The configuration file called `.sitsetting` is a file that contains all settings.
- Schema information file managed by GoogleSpreadSheet.
- Authentication information for using GoogleSpreadSheetAPI.
- Information such as output destination of deliverables.
The default settings are as follows:
```yaml
---
version: "1.0.0"
sheet:
gss:
auth:
credPath: ./creds.json
openAPIV3Schema:
type: object
properties:
ja:
type: string
description: 日本語
en:
type: string
description: 英語
key:
type: string
description: キー
defaultWorksheet:
rowCount: 10000
colCount: 20
repo:
local: .sit
dist:
path: ./dist
sheetName: "master_data.csv"
```
## Development Environment
```bash
$ node -v
v12.13.0
$ npm -v
6.12.0
$ yarn -v
1.19.2
```
## 🤖 Environments Variables
`sit` has environment variables to flexibly set the location of `local repositories` and
`configuration file`, and environment variables required to access `GoogleSpreadSheet`.
|name|content|default|
|----|-------|-------|
|SIT_DIR|Path to local repository|`.`|
|SIT_SETTING_DIR|Path to `.sitsetting`|`.`|
|SIT_GOOGLE_SERVICE_ACCOUNT_EMAIL|Google Service Account Email||
|SIT_GOOGLE_PRIVATE_KEY|Google Private Key||
## 📝 License
This package is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
## 🤝 Contributing
1. Fork it ( http://github.com/yukihirop/sit/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request