Skip to content

Simplifies the cloning of private GitHub repositories, for example on Termux or on a server.

License

Notifications You must be signed in to change notification settings

smartlegionlab/github-ssh-key

Repository files navigation

github-ssh-key

github-ssh-key - GitHub ssh key manager. Console utility for creating, getting, testing, using public ssh keys for GitHub.


GitHub top language PyPI - Downloads GitHub release (latest by date) GitHub PyPI PyPI - Format GitHub Repo stars GitHub watchers GitHub forks


Author and developer: A.A Suvorov


Supported:

  • Linux: All.
  • Termux (Android).

Images:

logo


What's new?

github-ssh-key v0.3.0

  • Improved work with help, added the ability to run commands directly from help.
  • Improved interface.

Description:

github-ssh-key - GitHub ssh key manager. Console utility for creating, getting, testing, using public ssh keys for GitHub.

Possibilities:

  • Convenient interactive menu.
  • Generating ssh keys for GitHub.
  • Output ssh key to the console.
  • Adding ssh key to GitHub.
  • Checking the ssh key, testing the connection.
  • Interactive menu for working with the utility.
  • Interactive menu for help.
  • Launch the default browser with a page for adding ssh key on GitHub.
  • Cloning private repositories via ssh.
  • Running individual commands.

Help:

Install and use:

Install:

pip install github-ssh-key

github-ssh-key

Use:

To access GitHub over ssh, you should run some sequence of actions.

  • Install openssh;
  • Generate new ssh keys;
  • Copy the public key;
  • Add your public key to GitHub;
  • Check the connection;

This utility provides you with these capabilities.

Adding a key to your GitHub account involves several steps:

  1. Generating new ssh key.
    • Install openssh, or make sure you have it installed with the ssh command.
    • During the generation process, enter your email that you use when working with GitHub.
    • Do not change the default file name.
    • Don't set a passphrase if you don't want to enter it every time.
  2. Copying ssh key.
    • Highlight and completely copy your ssh key.
  3. Adding ssh key to your GitHub account.
    • Highlight and completely copy your ssh key.
    • Add your ssh key to your GitHub account.
  4. Testing the ssh key (Testing the connection).
    • For a successful connection, you had to follow these steps:
      • Generate ssh key.
      • Highlight and completely copy your ssh key.
      • Add ssh key to your GitHub account.
      • If you did everything correctly, you will see a personalized greeting.

Also, directly from the interactive menu, you can clone your private repository using ssh.

To get help with commands, use:

github-ssh-key [command] -h

github-ssh-key new -h github-ssh-key show -h github-ssh-key add -h github-ssh-key test -h github-ssh-key clone -h github-ssh-key help -h

Commands:

github-ssh-key [command] [args]

  • run github-ssh-key run
  • new github-ssh-key new -e [your email]
  • show github-ssh-key show
  • add github-ssh-key add
  • test github-ssh-key test
  • clone github-ssh-key clone -l [GitHub login] -n [repo name]

Variant 1:

  • Go to the project folder
  • python setup.py install
  • github-ssh-key

Variant 2:

  • Install python
  • Go to the project folder
  • pip install -r requirements.txt
  • python github-ssh-key.py

Disclaimer of liability:

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Copyright:

--------------------------------------------------------
Licensed under the terms of the BSD 3-Clause License
(see LICENSE for details).
Copyright © 2018-2024, A.A Suvorov
All rights reserved.
--------------------------------------------------------