pygitgo 1.7.1__tar.gz → 1.8.0__tar.gz

{pygitgo-1.7.1/src/pygitgo.egg-info → pygitgo-1.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygitgo
-Version: 1.7.1
+Version: 1.8.0
 Summary: GitGo CLI - Your Fast Git Companion. Simplifies git push, link, stash, and user management.
 Author: Huerte
 License: GPL-3.0-or-later
@@ -32,7 +32,7 @@ Dynamic: license-file
 [![PyPI Downloads](https://img.shields.io/pypi/dm/pygitgo?color=blue)](https://pypi.org/project/pygitgo)
 [![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
-[![Ko-fi](https://img.shields.io/badge/Support-Ko--fi-FF5E5B?logo=ko-fi&logoColor=white)](https://ko-fi.com/huerte)
+[![GitHub Sponsors](https://img.shields.io/github/sponsors/Huerte?label=Sponsor&logo=github&color=EA4AAA)](https://github.com/sponsors/Huerte)
 [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS%20%7C%20Termux-lightgrey)](https://github.com/Huerte/GitGo)
 
 **Stop typing the same five Git commands. Run one instead.**
@@ -41,24 +41,24 @@ Dynamic: license-file
 
 <br />
 
-If GitGo saves you time, consider buying me a coffee. It helps keep the project going.
+If GitGo saves you time, give it a star. If you want to go further, sponsoring helps keep it going.
 
-<a href="https://ko-fi.com/huerte">
-  <img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="Support on Ko-fi" />
+<a href="https://github.com/sponsors/Huerte">
+  <img src="https://img.shields.io/badge/Sponsor%20on%20GitHub-%E2%9D%A4-EA4AAA?style=for-the-badge&logo=github" alt="Sponsor on GitHub" />
 </a>
 
 </div>
 
 ---
 
-GitGo wraps your most-typed git commands into shorter ones. It covers init, add, commit, push, branch, and stash. It also includes features most wrappers leave out: SSH key setup, HTTPS-to-SSH conversion, and a named stash interface called state management.
+GitGo wraps your most-typed git commands into shorter ones. It covers init, scaffold, add, commit, push, branch, and stash. It also includes features most wrappers leave out: SSH key setup, HTTPS-to-SSH conversion, a named stash interface called state management, and a one-shot quickstart command that takes you from nothing to a live GitHub repo in seconds.
 
 ```bash
 # Instead of this:
-git init && git add . && git commit -m "init" && git remote add origin <url> && git push -u origin main
+mkdir my-app && cd my-app && git init && git add . && git commit -m "init" && git remote add origin <url> && git push -u origin main
 
 # Run this:
-gitgo link https://github.com/username/repo.git "init"
+gitgo new my-app python
 ```
 
 ---
@@ -88,6 +88,9 @@ gitgo link https://github.com/username/repo.git "init"
 ## Features
 
 - **Single commands for linking, pushing, and stashing.** No more chaining five commands together.
+- **Quickstart with `new`:** One command to scaffold your project, create the GitHub repo, and push it. No switching tabs, no manual steps.
+- **Project scaffolding with `init`:** Generates a language-specific project structure with a `.gitignore` from GitHub's official templates. Supports Python, Node, Rust, Go, C#, and more.
+- **Remote repo creation with `repo`:** Creates a GitHub repo directly from the terminal without touching a browser.
 - **Undo:** Roll back commits, unstage files, discard local changes, or revert pushes. The subcommands say what they do: `undo commit`, `undo add`, `undo changes`, `undo link`, `undo push`.
 - **Branch switching with `jump`:** Stashes your uncommitted work, moves to the target branch, syncs with main, and pops the stash. If a merge conflict occurs, the Try-and-Revert engine offers to roll the whole operation back.
 - **State management:** Named, indexed stash. Run `state list` to see what you saved. No more `stash@{2}` archaeology.
@@ -155,21 +158,47 @@ pip install -e .
 
 ### 1. Set Up Your Identity
 
-Run this once on a new machine. GitGo generates an SSH key, adds it to `ssh-agent`, prints the public key, and opens your GitHub SSH settings page so you can add it for both authentication and commit signing.
+Run this once on each machine you use. GitGo generates an SSH key, prints it for you to copy, and opens GitHub so you can add it. You add the same key twice: once as an **Authentication Key** (to push and pull), once as a **Signing Key** (so your commits show Verified). After that, GitGo tests the connection and sets up your Git identity automatically.
 
 ```bash
 gitgo user login
 ```
 
-### 2. Link a New Project to GitHub
+For a full walkthrough with screenshots, see the [Login Guide](docs/login-guide.md).
 
-Point GitGo at an existing empty GitHub repo. It initializes Git, stages everything, commits, and pushes — including pulling unrelated histories if the remote isn't empty.
+### 2. Start a New Project From Scratch
+
+One command scaffolds the local project, creates the GitHub repo, and pushes it. No tab switching.
+
+```bash
+gitgo new my-app python
+gitgo new my-app rust --private
+gitgo new my-app         # no scaffold, just the repo and push
+```
+
+Or use the individual steps if you want more control:
+
+```bash
+# Step 1: scaffold the project locally
+gitgo init my-app python
+
+# Step 2: create the remote GitHub repo
+cd my-app
+gitgo repo my-app --private
+
+# Step 3: connect and push
+gitgo link https://github.com/username/my-app.git
+```
+
+### 3. Link an Existing Project to GitHub
+
+Point GitGo at an existing empty GitHub repo. It initializes Git, stages everything, commits, and pushes, including pulling unrelated histories if the remote isn't empty.
 
 ```bash
 gitgo link https://github.com/username/repo.git "Initial commit"
 ```
 
-### 3. Push Changes
+### 4. Push Changes
 
 ```bash
 # Push to an existing branch
@@ -179,7 +208,7 @@ gitgo push main "Fix auth bug"
 gitgo push -n feat/login "Add login flow"
 ```
 
-### 4. Switch Branches
+### 5. Switch Branches
 
 Switch branches with uncommitted work in progress. `jump` stashes your changes, moves to the target branch, syncs with main, and pops the stash. If the pop triggers a conflict, it offers to abort and restore the repo to its prior state.
 
@@ -187,7 +216,7 @@ Switch branches with uncommitted work in progress. `jump` stashes your changes,
 gitgo jump feat/new-login
 ```
 
-### 5. Undo Mistakes
+### 6. Undo Mistakes
 
 Undo recent mistakes with commands named for what they undo.
 
@@ -199,7 +228,7 @@ gitgo undo link      # Remove remote and undo initial commit
 gitgo undo push      # DANGER: Revert last push with a force-push
 ```
 
-### 6. Save Your Work-in-Progress
+### 7. Save Your Work-in-Progress
 
 ```bash
 gitgo state save "halfway through refactor"
@@ -207,7 +236,7 @@ gitgo state list
 gitgo state load 1
 ```
 
-### 7. Custom Defaults
+### 8. Custom Defaults
 
 ```bash
 gitgo config set default-branch develop
@@ -219,6 +248,55 @@ gitgo config get default-branch
 
 ## Command Reference
 
+### `gitgo new`
+
+One-shot quickstart. Scaffolds a local project, creates the GitHub remote repo, and pushes, all in one command.
+
+```bash
+gitgo new <name> [lang]
+gitgo new my-app python            # scaffold Python project and push
+gitgo new my-app rust --private    # private Rust project
+gitgo new my-app                   # no scaffold, just create repo and push
+```
+
+| Flag | Description |
+|------|-------------|
+| `lang` | Language to scaffold. Options: `python`, `node`, `rust`, `go`, `cs`, and more |
+| `--template OWNER/REPO` | Use a GitHub template repo instead of a language scaffold |
+| `-p`, `--private` | Create a private repository |
+| `-d`, `--description TEXT` | Short description shown on GitHub |
+
+### `gitgo init`
+
+Scaffolds a project folder locally. Creates a README, `.gitignore` (fetched from GitHub's official templates), and language-specific starter files.
+
+```bash
+gitgo init my-app python                                       # generates pyproject.toml and .python-version
+gitgo init my-app node                                         # generates package.json and index.js
+gitgo init my-app cs                                           # generates .csproj and Program.cs
+gitgo init my-app --template owner/repo                        # slug format
+gitgo init my-app --template https://github.com/owner/repo    # full URL accepted too
+```
+
+Supported languages: `python` (`py`), `node` (`js`, `ts`), `rust` (`rs`), `go` (`golang`), `csharp` (`cs`), and any language with a `.gitignore` template on GitHub.
+
+### `gitgo repo`
+
+Creates a remote GitHub repository without touching your local files.
+
+```bash
+gitgo repo [name]                  # use current directory name if no name given
+gitgo repo my-app --private
+gitgo repo my-app -d "My project description"
+```
+
+| Flag | Description |
+|------|-------------|
+| `-p`, `--private` | Create a private repository |
+| `-d`, `--description TEXT` | Short description shown on GitHub |
+
+On first run, GitGo opens GitHub's PAT page and prompts you to paste a token with `repo` scope. The token is saved to git config for future calls. If the token expires, GitGo detects the 401 and re-prompts automatically.
+
 ### `gitgo push`
 
 Stage, commit, and push in one command.

{pygitgo-1.7.1 → pygitgo-1.8.0}/README.md

@@ -7,7 +7,7 @@
 [![PyPI Downloads](https://img.shields.io/pypi/dm/pygitgo?color=blue)](https://pypi.org/project/pygitgo)
 [![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
-[![Ko-fi](https://img.shields.io/badge/Support-Ko--fi-FF5E5B?logo=ko-fi&logoColor=white)](https://ko-fi.com/huerte)
+[![GitHub Sponsors](https://img.shields.io/github/sponsors/Huerte?label=Sponsor&logo=github&color=EA4AAA)](https://github.com/sponsors/Huerte)
 [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS%20%7C%20Termux-lightgrey)](https://github.com/Huerte/GitGo)
 
 **Stop typing the same five Git commands. Run one instead.**
@@ -16,24 +16,24 @@
 
 <br />
 
-If GitGo saves you time, consider buying me a coffee. It helps keep the project going.
+If GitGo saves you time, give it a star. If you want to go further, sponsoring helps keep it going.
 
-<a href="https://ko-fi.com/huerte">
-  <img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="Support on Ko-fi" />
+<a href="https://github.com/sponsors/Huerte">
+  <img src="https://img.shields.io/badge/Sponsor%20on%20GitHub-%E2%9D%A4-EA4AAA?style=for-the-badge&logo=github" alt="Sponsor on GitHub" />
 </a>
 
 </div>
 
 ---
 
-GitGo wraps your most-typed git commands into shorter ones. It covers init, add, commit, push, branch, and stash. It also includes features most wrappers leave out: SSH key setup, HTTPS-to-SSH conversion, and a named stash interface called state management.
+GitGo wraps your most-typed git commands into shorter ones. It covers init, scaffold, add, commit, push, branch, and stash. It also includes features most wrappers leave out: SSH key setup, HTTPS-to-SSH conversion, a named stash interface called state management, and a one-shot quickstart command that takes you from nothing to a live GitHub repo in seconds.
 
 ```bash
 # Instead of this:
-git init && git add . && git commit -m "init" && git remote add origin <url> && git push -u origin main
+mkdir my-app && cd my-app && git init && git add . && git commit -m "init" && git remote add origin <url> && git push -u origin main
 
 # Run this:
-gitgo link https://github.com/username/repo.git "init"
+gitgo new my-app python
 ```
 
 ---
@@ -63,6 +63,9 @@ gitgo link https://github.com/username/repo.git "init"
 ## Features
 
 - **Single commands for linking, pushing, and stashing.** No more chaining five commands together.
+- **Quickstart with `new`:** One command to scaffold your project, create the GitHub repo, and push it. No switching tabs, no manual steps.
+- **Project scaffolding with `init`:** Generates a language-specific project structure with a `.gitignore` from GitHub's official templates. Supports Python, Node, Rust, Go, C#, and more.
+- **Remote repo creation with `repo`:** Creates a GitHub repo directly from the terminal without touching a browser.
 - **Undo:** Roll back commits, unstage files, discard local changes, or revert pushes. The subcommands say what they do: `undo commit`, `undo add`, `undo changes`, `undo link`, `undo push`.
 - **Branch switching with `jump`:** Stashes your uncommitted work, moves to the target branch, syncs with main, and pops the stash. If a merge conflict occurs, the Try-and-Revert engine offers to roll the whole operation back.
 - **State management:** Named, indexed stash. Run `state list` to see what you saved. No more `stash@{2}` archaeology.
@@ -130,21 +133,47 @@ pip install -e .
 
 ### 1. Set Up Your Identity
 
-Run this once on a new machine. GitGo generates an SSH key, adds it to `ssh-agent`, prints the public key, and opens your GitHub SSH settings page so you can add it for both authentication and commit signing.
+Run this once on each machine you use. GitGo generates an SSH key, prints it for you to copy, and opens GitHub so you can add it. You add the same key twice: once as an **Authentication Key** (to push and pull), once as a **Signing Key** (so your commits show Verified). After that, GitGo tests the connection and sets up your Git identity automatically.
 
 ```bash
 gitgo user login
 ```
 
-### 2. Link a New Project to GitHub
+For a full walkthrough with screenshots, see the [Login Guide](docs/login-guide.md).
 
-Point GitGo at an existing empty GitHub repo. It initializes Git, stages everything, commits, and pushes — including pulling unrelated histories if the remote isn't empty.
+### 2. Start a New Project From Scratch
+
+One command scaffolds the local project, creates the GitHub repo, and pushes it. No tab switching.
+
+```bash
+gitgo new my-app python
+gitgo new my-app rust --private
+gitgo new my-app         # no scaffold, just the repo and push
+```
+
+Or use the individual steps if you want more control:
+
+```bash
+# Step 1: scaffold the project locally
+gitgo init my-app python
+
+# Step 2: create the remote GitHub repo
+cd my-app
+gitgo repo my-app --private
+
+# Step 3: connect and push
+gitgo link https://github.com/username/my-app.git
+```
+
+### 3. Link an Existing Project to GitHub
+
+Point GitGo at an existing empty GitHub repo. It initializes Git, stages everything, commits, and pushes, including pulling unrelated histories if the remote isn't empty.
 
 ```bash
 gitgo link https://github.com/username/repo.git "Initial commit"
 ```
 
-### 3. Push Changes
+### 4. Push Changes
 
 ```bash
 # Push to an existing branch
@@ -154,7 +183,7 @@ gitgo push main "Fix auth bug"
 gitgo push -n feat/login "Add login flow"
 ```
 
-### 4. Switch Branches
+### 5. Switch Branches
 
 Switch branches with uncommitted work in progress. `jump` stashes your changes, moves to the target branch, syncs with main, and pops the stash. If the pop triggers a conflict, it offers to abort and restore the repo to its prior state.
 
@@ -162,7 +191,7 @@ Switch branches with uncommitted work in progress. `jump` stashes your changes,
 gitgo jump feat/new-login
 ```
 
-### 5. Undo Mistakes
+### 6. Undo Mistakes
 
 Undo recent mistakes with commands named for what they undo.
 
@@ -174,7 +203,7 @@ gitgo undo link      # Remove remote and undo initial commit
 gitgo undo push      # DANGER: Revert last push with a force-push
 ```
 
-### 6. Save Your Work-in-Progress
+### 7. Save Your Work-in-Progress
 
 ```bash
 gitgo state save "halfway through refactor"
@@ -182,7 +211,7 @@ gitgo state list
 gitgo state load 1
 ```
 
-### 7. Custom Defaults
+### 8. Custom Defaults
 
 ```bash
 gitgo config set default-branch develop
@@ -194,6 +223,55 @@ gitgo config get default-branch
 
 ## Command Reference
 
+### `gitgo new`
+
+One-shot quickstart. Scaffolds a local project, creates the GitHub remote repo, and pushes, all in one command.
+
+```bash
+gitgo new <name> [lang]
+gitgo new my-app python            # scaffold Python project and push
+gitgo new my-app rust --private    # private Rust project
+gitgo new my-app                   # no scaffold, just create repo and push
+```
+
+| Flag | Description |
+|------|-------------|
+| `lang` | Language to scaffold. Options: `python`, `node`, `rust`, `go`, `cs`, and more |
+| `--template OWNER/REPO` | Use a GitHub template repo instead of a language scaffold |
+| `-p`, `--private` | Create a private repository |
+| `-d`, `--description TEXT` | Short description shown on GitHub |
+
+### `gitgo init`
+
+Scaffolds a project folder locally. Creates a README, `.gitignore` (fetched from GitHub's official templates), and language-specific starter files.
+
+```bash
+gitgo init my-app python                                       # generates pyproject.toml and .python-version
+gitgo init my-app node                                         # generates package.json and index.js
+gitgo init my-app cs                                           # generates .csproj and Program.cs
+gitgo init my-app --template owner/repo                        # slug format
+gitgo init my-app --template https://github.com/owner/repo    # full URL accepted too
+```
+
+Supported languages: `python` (`py`), `node` (`js`, `ts`), `rust` (`rs`), `go` (`golang`), `csharp` (`cs`), and any language with a `.gitignore` template on GitHub.
+
+### `gitgo repo`
+
+Creates a remote GitHub repository without touching your local files.
+
+```bash
+gitgo repo [name]                  # use current directory name if no name given
+gitgo repo my-app --private
+gitgo repo my-app -d "My project description"
+```
+
+| Flag | Description |
+|------|-------------|
+| `-p`, `--private` | Create a private repository |
+| `-d`, `--description TEXT` | Short description shown on GitHub |
+
+On first run, GitGo opens GitHub's PAT page and prompts you to paste a token with `repo` scope. The token is saved to git config for future calls. If the token expires, GitGo detects the 401 and re-prompts automatically.
+
 ### `gitgo push`
 
 Stage, commit, and push in one command.
@@ -331,4 +409,4 @@ Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) for the full
 
 Distributed under the **GPLv3** License. See [`LICENSE`](LICENSE) for details.
 
----
+---

{pygitgo-1.7.1 → pygitgo-1.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pygitgo"
-version = "1.7.1"
+version = "1.8.0"
 description = "GitGo CLI - Your Fast Git Companion. Simplifies git push, link, stash, and user management."
 readme = "README.md"
 license = {text = "GPL-3.0-or-later"}

{pygitgo-1.7.1 → pygitgo-1.8.0}/src/pygitgo/auth/account.py

@@ -21,7 +21,6 @@ def get_user():
 
     return name, email
 
-    
 def set_user(name, email):
     run_command(["git", "config", "--global", "user.name", name])
     run_command(["git", "config", "--global", "user.email", email])
@@ -66,4 +65,3 @@ def ensure_user_configure(default_email=None, default_username=None):
     error("Invalid configuration. Name and Email are required.")
     return False
 
-

{pygitgo-1.7.1 → pygitgo-1.8.0}/src/pygitgo/auth/manager.py

@@ -1,6 +1,7 @@
 from pygitgo.utils.colors import info, success, warning, error
 from pygitgo.utils.executor import run_command
 from pygitgo.exceptions import GitCommandError
+from pygitgo.utils.platform import open_url
 from . import ssh_utils
 import os
 
@@ -39,7 +40,7 @@ def login():
         info("  2. Once as 'Signing Key'          (so your commits show as Verified)")
         info("Both entries use the exact same key text.")
 
-        ssh_utils.open_github_settings()
+        open_url("https://github.com/settings/ssh/new")
         
         input(
             "After adding both keys on GitHub,\n"
@@ -65,6 +66,7 @@ def login():
     info("  1. The key was not pasted on GitHub")
     info("  2. SSH agent is not running (try: eval $(ssh-agent) && ssh-add)")
     info("  3. Network or firewall is blocking SSH connections")
+    info("Need help? Full guide: https://github.com/Huerte/GitGo/blob/main/docs/login-guide.md")
     return False
     
 def logout():

{pygitgo-1.7.1 → pygitgo-1.8.0}/src/pygitgo/auth/ssh_utils.py

@@ -1,11 +1,8 @@
 from pygitgo.exceptions import GitCommandError, GitGoError
 from pygitgo.utils.colors import info, success, warning
 from pygitgo.utils.executor import run_command
-from pygitgo.utils import platform as platform_utils
 from pathlib import Path
-import webbrowser
 import subprocess
-import shutil
 import os
 import re
 
@@ -103,27 +100,6 @@ def generate_ssh_key(email):
     return key_path
 
 
-def open_github_settings():
-    url = "https://github.com/settings/ssh/new"
-    opened = False
-
-    try:
-        if platform_utils.is_termux():
-            if shutil.which("termux-open"):
-                subprocess.run(["termux-open", url], check=False)
-                opened = True
-        else:
-            opened = webbrowser.open(url)
-    except Exception:
-        opened = False
-
-    if not opened:
-        warning("Could not open browser automatically.")
-
-    info("\nIf the browser did not open, visit this URL manually:")
-    print(f"\n  {url}\n")
-
-
 def convert_https_to_ssh(url):    
     pattern = r'^https?://github\.com/([^/]+)/([^/]+?)(?:\.git)?/?$'
     match = re.match(pattern, url.strip())