This project is moved to https://github.com/Vedadiyan/gopher
Go-Painless is a simple painless package manager that resembles core features and mechanism of npm. It manages and maintains all project's dependencies in a .json file allowing them to be restored when required without relying on the go.mod and go.sum files. When a restore operation is requested, go-painless will automatically create go.mod and go.sum files both for the current project and all its dependencies. Accordingly, go.mod and go.mod can be added to the .gitignore file.
go build -o gopainless ./cmd/
or for Windows or Mac
go build -o gopainless.(exe|dmg) ./cmd/
then you can easily run the executable with the setup command:
./gopainless setup.
You need to add the path HomeDirectory/go-painless/bin to your path variables.
In Linux you should assign executable permissions as well. For example chmod 777 ~/go-painless/bin/go-painless
go-painess falls through the original go command when a command is not available. This means that you can use it as a drop-in replacement for the original go command.
all UPPERCARE flags staring with a single - are required
| Command | Description | Example | Notes |
|---|---|---|---|
| init | creates a new go project | go-painless init -n demo -v v1.0.0 | --name or -n = the name of the project --version or -v = the version of the project |
| create | creates a project based on a template project | go-painless create -t github.com/abc/efg.git -n github.com/abc/xyz | --template or -t = the template repository url --name or -n = the name of the project |
| install | installs a go dependency | go-painless install -u https://github.com/abc/efg.git -n custom_dependency_name --private --recursive | --url or -u = the URL of the dependency (whether private or public) --name or -n = the name used to reference the dependency. This name is used for referencing private packages. --private = used for installing private packages --recursive = used for installing nested dependencies in go-painless maintained packages --update = used for updating existing packages |
| remove | removes a go dependency | go-painless remove -n custom_dependency_name | --name or -n = the name of the dependency to be removed |
| restore | restores all dependencies | go-painless restore | --update = used for updating existing dependency --update-global = used for updating global dependencies (Experimental) --tidy = runs go mod tidy after the restore has completed |
| clear | clear the project | go-painless clear | - |
| publish | creates binaries for a go project | go-painless publish -r linux -a amd64 -o ./ -T ./cmd/ | --runtime or -r = specifies target OS --architecture or -a = specifies target architecture --output or -o = specifies the output directory --template or -t = specifies the go file or folder to build |
It is recommended to always use go-painless tidy after go-painless restore. This is because go-painless is a complement to the original go command.
When using go-painless, the project has to be initiated using go-painless initialize and all dependencies have to be maintained using the go-painless install commands.
Feel free to contibute by forking the project! All new features are welcome. For any issues please open an issue so we can find and fix the problem.
Give a ⭐️ if it kills the pain of managing dependencies in your go projects!
Copyright © 2022 Pouya Vedadiyan.
This project is MIT licensed.