fastgitorg / fgit-go

🔧 A go-written tool to do git operation with fastgit easily

fgit-go

Command line to do git operation with FastGit.

What works

• Stdout/stderr
  Real-time display has been tested in Windows 10 (build 1809)

• Push
  fgit push command had been tested in Windows 10 (build 1809)

• Clone
  fgit clone GITHUB_URL command had been tested in Windows 10 (build 1809)

Preparation

Before use fgit-go, install git by yourself. Add git to env PATH is also required.

Download source code of fgit-go, build and run.

Extra Syntax

1. debug

SYNTAX:

fgit debug [URL<string>] [help]

FUNCTION:

This command line is for debug. Will provide remote addr, local addr, and connection info.

EXAMPLE:

>fastgit debug
FastGit Debug Tool
==================
Remote Address: https://hub.fastgit.org
IP Address: [x.x.x.x]
Local Address: [x.x.x.x]
Test connection...Success

2. get

SYNTAX:

fgit get [URL<string>] [Path<string>] [--help]

ALIAS:

fgit dl
fgit download

FUNCTION:

This command line is for downloading. Will auto convert github download link to fastgit.

EXAMPLE:

>fgit get https://github.com/fastgitorg/fgit-go/archive/master.zip
File with the same name exists. New file will cover the old file.
Do you want to continue? [Y/n]y
Redirect url -> https://download.fastgit.org/fastgitorg/fgit-go/archive/master.zip
Downloading...
Finished.

Difference between fgit

fgit by @xkeyc only provides clone operation support, but fgit-go provides push and etc.

And, fgit-go is cross-platform.

How does fgit-go work

To clone, fgit-go just replaces url to FastGit url.

To push, fgit-go modifies .git config temporarily. Like

[core]
        repositoryformatversion = 0
        filemode = false
        bare = false
        logallrefupdates = true
        symlinks = false
        ignorecase = true
[remote "origin"]
        url = https://github.com/A/B
        fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
        remote = origin
        merge = refs/heads/master

To

[core]
        repositoryformatversion = 0
        filemode = false
        bare = false
        logallrefupdates = true
        symlinks = false
        ignorecase = true
[remote "origin"]
        url = https://hub.fastgit.org/A/B
        fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
        remote = origin
        merge = refs/heads/master

Open-Source License - GNU General Public License v3.0

                    GNU GENERAL PUBLIC LICENSE
                       Version 3, 29 June 2007

 Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
 Everyone is permitted to copy and distribute verbatim copies
 of this license document, but changing it is not allowed.

---

Proudly build with ❤️ & golang

fgit-go's Issues

use fgit pull

[fgit] 程序崩溃, 错误原因: JSON反序列化失败: {"key":"ACCOUNT_NOT_FOUND"}
: json: cannot unmarshal object into Go value of type string

[feature] dns fix

[FR] convert command

looks like

fgit conv github
fgit conv fastgit
fgit conv fg
fgit conv gh

Draft: 0.8.x Roadmap

To provide better experience, I hope that fgit-go should finish following points:

• 0.8.x
  • fix conv(#7)
  • add server choice
  • fix android debug

[FR] -v flag

To show version

从环境变量或配置文件中读取备用服务器

鉴于目前fastgit.xyz被干扰,提出此需求

考虑修改目录结构以兼容直接 go install

目前使用 go install 会这样

可以对目录和import做一些修改来让他能够直接用 go install 安装

hub.fastgit.org has been changed to hub.fastgit.xyz

Due to irreversible factors, we have updated our hub link from hub.fastgit.org to hub.fastgit.xyz.

https://doc.fastgit.org/en-gb/guide.html

Bug: conv not work

[Feature] 3rd party mirror support

Add a configuration file