gas-github

Chrome-extension for manage Google Apps Script(GAS) code with github/github enterprise.

With this extension, you can manage your code on GAS IDE, push code to a new created branch, pull from some repository/branch.

The extension does not use Google Drive API, so you don't need any google authentication.And also, this extension support Embedded Script which belongs to some Spreadsheet or Doc.

#1.Install Install this extension from chrome web store.

#2.Usage After install, when you open GAS IDE, a new button will appear to ask you login in to Github/Github Enterprise.

##2.1.Login Login to your Github/Github Enterprise account, with Two-factor authentication support.

Actually, this is not a login action, but to create the access token which will be used for the extension

Note: the access token will be stored in chrome.storage.sync(password will not be stored), if you take this as a security hole, pleast DO NOT use this extension.

##2.2.Bind After login, you can bind your GAS Project with Github repo and branch, or create a new one.

##2.3.Manage Manage your code with the similar Push and Pull.But there are something need to know before use it.

###2.3.1.Create Repository/Branch In Repo and Branch dropdown list, there is an option to Create new Repo and Branch.

New Repo will created with init, mean's a default README.md.

###2.3.2.Pull and Push The PULL/PUSH is not actually same as Github's PULL/PUSH, because GAS project does not have any git info, so what can do is limited.

The differences are:

• Pull will fetch code form the bind Repository/Branch, and OVERWRITE to current GAS Project. There is no merge operation.
• Pull will create new file if needed(when the file only shows in Github), but will not deleted any file that has been deleted in Github. You can delete them by yourself.
• Push will commit file changed, file added to Github, but not file deleted.

Other points:

• A diff dialog will shown before you confirm to Push or Pull.
• You can choose files to operate with in the diff dialog.
• Push must have a commit comment which will be asked at the diff dialog.

##2.4.Logout You can logout from the extension's option page any time. After logout, the access token stored in extension will be deleted, but you will need to delete the token it self from Github/Github Enterprise's settins page.

#3.Features

• Support Push/Pull code between github and GAS
• Support embedded script
• Support create github repo, branch from GAS IDE
• Support diff check when pull/push
• Support choose files to pull/push
• Support file changed and file added(no file deleted)
• Support commit comment when push
• Support Github and Github Enterprise
• Support two-factor authentication
• Support directory in Github(with slash in filename)
• Google Apps Script native ui

#4.Support please create an issue for any question or bug report.