refactor: rename local repository -> project scope

Author: nalgeon

README.md

@@ -13,7 +13,7 @@ $ sqlpkg help
 │ Commands:                                      │
 │ help       Display help                        │
 │ info       Display package information         │
-│ init       Create local repository             │
+│ init       Init project scope                  │
 │ install    Install packages                    │
 │ list       List installed packages             │
 │ uninstall  Uninstall package                   │
@@ -174,9 +174,9 @@ sqlpkg version
 
 Displays `sqlpkg` version number.
 
-## Using a local repository
+## Project vs. global scope
 
-By default, `sqlpkg` installs all extensions in the home folder. If you are writing a Python (JavaScript, Go, ...) application — you may prefer to put them in the project folder (like virtual environment in Python or `node_modules` in JavaScript).
+By default, `sqlpkg` installs all extensions in the home folder (global scope). If you are writing a Python (JavaScript, Go, ...) application — you may prefer to put them in the project folder (project scope, like virtual environment in Python or `node_modules` in JavaScript).
 
 To do that, run the `init` command:
 
@@ -194,7 +194,7 @@ If you _are_ a package author, who wants your package to be installable by `sqlp
 
 ## Lockfile
 
-`sqlpkg` stores information about the installed packages in a special file (the _lockfile_) — `sqlpkg.lock`. If you're using a local repository, it's a good idea to commit `sqlpkg.lock` along with other code. This way, when you check out the code on another machine, you can install all the packages at once.
+`sqlpkg` stores information about the installed packages in a special file (the _lockfile_) — `sqlpkg.lock`. If you're using a project scope, it's a good idea to commit `sqlpkg.lock` along with other code. This way, when you check out the code on another machine, you can install all the packages at once.
 
 To install the packages listed in the lockfile, simply run `install` with no arguments:
 

cmd/cmd.go

@@ -41,10 +41,10 @@ func GetPathByFullName(fullName string) (string, error) {
 	return path, nil
 }
 
-// PrintLocalRepo prints information about the local sqlpkg repository.
-func PrintLocalRepo() {
+// PrintScope prints information about the current scope (project/global).
+func PrintScope() {
 	if WorkDir == "." {
-		logx.Log("(local repository)")
+		logx.Log("(project scope)")
 	}
 }
 

cmd/cmd_test.go

@@ -71,7 +71,7 @@ func TestGetDirByFullName(t *testing.T) {
 	})
 }
 
-func TestPrintLocalRepo(t *testing.T) {
+func TestPrintScope(t *testing.T) {
 	mem := logx.Mock()
 	home, err := os.UserHomeDir()
 	if err != nil {
@@ -80,19 +80,19 @@ func TestPrintLocalRepo(t *testing.T) {
 
 	t.Run("home dir", func(t *testing.T) {
 		WorkDir = home
-		PrintLocalRepo()
+		PrintScope()
 		if len(mem.Lines) != 0 {
-			t.Fatalf("PrintLocalRepo: unexpected line count %v", len(mem.Lines))
+			t.Fatalf("PrintScope: unexpected line count %v", len(mem.Lines))
 		}
 	})
 	t.Run("project dir", func(t *testing.T) {
 		WorkDir = "."
-		PrintLocalRepo()
+		PrintScope()
 		if len(mem.Lines) != 1 {
-			t.Fatalf("PrintLocalRepo: unexpected line count %v", len(mem.Lines))
+			t.Fatalf("PrintScope: unexpected line count %v", len(mem.Lines))
 		}
-		if !mem.Has("(local repository)") {
-			t.Errorf("PrintLocalRepo: unexpected output %v", mem.Lines)
+		if !mem.Has("(project scope)") {
+			t.Errorf("PrintScope: unexpected output %v", mem.Lines)
 		}
 	})
 }

cmd/help/help.go

@@ -14,7 +14,7 @@ const help = "usage: sqlpkg help"
 var commandsHelp = map[string]string{
 	"help":      "Display help",
 	"info":      "Display package information",
-	"init":      "Create local repository",
+	"init":      "Init project scope",
 	"install":   "Install packages",
 	"list":      "List installed packages",
 	"uninstall": "Uninstall package",

cmd/init/init.go

@@ -24,9 +24,9 @@ func Init(args []string) error {
 
 	err := os.Mkdir(spec.DirName, 0755)
 	if err != nil {
-		return fmt.Errorf("failed to create a local repository: %w", err)
+		return fmt.Errorf("failed to create a project scope: %w", err)
 	}
 
-	logx.Log("✓ created a local repository")
+	logx.Log("✓ created a project scope")
 	return nil
 }

cmd/init/init_test.go

@@ -20,7 +20,7 @@ func TestInit(t *testing.T) {
 	}
 
 	mem.Print()
-	mem.MustHave(t, "created a local repository")
+	mem.MustHave(t, "created a project scope")
 }
 
 func TestAlreadyExists(t *testing.T) {

cmd/install/install.go

@@ -13,7 +13,7 @@ const installHelp = "usage: sqlpkg install [package]"
 
 // InstallAll installs all packages from the lockfile.
 func InstallAll(args []string) error {
-	cmd.PrintLocalRepo()
+	cmd.PrintScope()
 
 	lck, err := cmd.ReadLockfile()
 	if err != nil {
@@ -48,7 +48,7 @@ func Install(args []string) error {
 		return errors.New(installHelp)
 	}
 
-	cmd.PrintLocalRepo()
+	cmd.PrintScope()
 
 	path := args[0]
 	err := installPackage(path)

cmd/list/list.go

@@ -93,7 +93,7 @@ func sortPackages(packages []*spec.Package) {
 
 // printPackages prints packages.
 func printPackages(packages []*spec.Package) {
-	cmd.PrintLocalRepo()
+	cmd.PrintScope()
 	if len(packages) == 0 {
 		logx.Log("no packages installed")
 		return

cmd/uninstall/uninstall.go

@@ -18,7 +18,7 @@ func Uninstall(args []string) error {
 		return errors.New(uninstallHelp)
 	}
 
-	cmd.PrintLocalRepo()
+	cmd.PrintScope()
 
 	fullName := args[0]
 	logx.Log("> uninstalling %s...", fullName)

cmd/update/update.go

@@ -19,7 +19,7 @@ func UpdateAll(args []string) error {
 		return errors.New(updateHelp)
 	}
 
-	cmd.PrintLocalRepo()
+	cmd.PrintScope()
 
 	pattern := filepath.Join(cmd.WorkDir, spec.DirName, "*", "*", spec.FileName)
 	paths, _ := filepath.Glob(pattern)