Skip to main content

No project description provided

Project description


🕵️‍♀️ GitSherlock: Your GitHub Repository Sleuth 🕵️‍♀️

Built with ❤︎ by Mina Basem


GitSherlock is your one-stop shop for analyzing and understanding GitHub repositories! 💥 Allowing you to dive deep into any repository's structure, content, and functionality. 🔭

⚡ What can GitSherlock do? ⚡

  • Validate GitHub repository URLs: Ensure you're looking at the right codebase! 🔐
  • Summarize the repository: No need to read the entire README, GitSherlock will do that for you. 😉
  • Generate a file tree: Visually explore the repository's directory structure. 🌳
  • Analyze individual files: Get descriptions and function breakdowns for supported file types (including Python, JavaScript, Java, C++, and more!). 🧠
  • Display repository details: Get important information like the owner, number of stars, forks, open issues, and language. ✨
  • Interactive mode: Analyze multiple repositories without leaving the terminal! 💻

✨ How to Use GitSherlock ✨

  1. Install Python: Make sure you have Python installed on your system.
  2. Install GitSherlock:
    pip install git-sherlock 
    
  3. Setup up the environment variable for Gemini API key:
  • For Linux: export GEMINI_API_KEY=XXXXXXXXX
  • For Windows: set GEMINI_API_KEY=XXXXXXXXX
  1. Run GitSherlock:
    git-sherlock -u <github_repository_url>
    
    Or, use the interactive mode:
    git-sherlock -i 
    

Example Usage 🚀

git-sherlock -u https://github.com/facebook/react

This command will analyze the React repository and display the following:

  • A summary of the README file.
  • A detailed file tree showing the repository's structure.
  • Analysis of each supported file, including descriptions and functions.
  • Repository details like owner, stars, forks, etc.

Features You'll Love 🎉

  • Rich Terminal Output: Beautiful and informative output with colors and formatting
  • User-Friendly: Easy to use, even if you're new to analyzing code 🧑‍💻
  • Fast and Efficient: Get your analysis results quickly and effortlessly ⚡️
  • Constantly Evolving: There's more to be added to the experience 🚀

Contribute to GitSherlock!

Like the project and think you have room for improving it? Don't hesitate to send in a Pull Request


Ready to unravel the mysteries of GitHub repositories? Install GitSherlock and start exploring! 😎

Keywords: GitHub, repository, analysis, code, file tree, summary, details, interactive, terminal, Python, tool, open source, developer, programmer, project, codebase, efficiency, documentation, learn, explore, understand, deep dive, insights, insights, detective, sleuth, unravel, explore, powerful, fast, rich output, user-friendly.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

git_sherlock_tool-1.2.tar.gz (13.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

git_sherlock_tool-1.2-py3-none-any.whl (14.3 kB view details)

Uploaded Python 3

File details

Details for the file git_sherlock_tool-1.2.tar.gz.

File metadata

  • Download URL: git_sherlock_tool-1.2.tar.gz
  • Upload date:
  • Size: 13.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.3

File hashes

Hashes for git_sherlock_tool-1.2.tar.gz
Algorithm Hash digest
SHA256 1ccd6b1fd0f56d4102d003fcfd145f09fc2b3e2b5264d4247a5c5cb410b5d18d
MD5 4260e4b5dabcd92ae25f1b2f56f4da98
BLAKE2b-256 22da9418c1d9dbd6837eefcdcba600e8b679e58a0d82a263aac84e8e04887fb8

See more details on using hashes here.

File details

Details for the file git_sherlock_tool-1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for git_sherlock_tool-1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b3c33837a897ba38be5e3a1cc9252918568b363b2cfe823c24540f223545c0c2
MD5 230dd47be14123c5fdd82d0445943033
BLAKE2b-256 a36584e6ba178a1be9cc882c486fa5387bccdd05baa8f19459e53fa6f12f87eb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page