Spaces:
Sleeping
Sleeping
Neodpy
commited on
Update app.py
Browse files
app.py
CHANGED
|
@@ -1,37 +1,93 @@
|
|
| 1 |
import os
|
|
|
|
| 2 |
import requests
|
| 3 |
import gradio as gr
|
| 4 |
from groq import Groq
|
|
|
|
| 5 |
|
| 6 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 7 |
"""
|
| 8 |
-
|
| 9 |
"""
|
| 10 |
-
|
| 11 |
-
|
| 12 |
-
|
| 13 |
-
|
| 14 |
-
|
| 15 |
-
|
| 16 |
-
|
| 17 |
-
|
| 18 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 19 |
else:
|
| 20 |
-
|
| 21 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 22 |
if response.status_code != 200:
|
| 23 |
-
|
| 24 |
-
|
| 25 |
-
|
| 26 |
-
|
| 27 |
-
|
| 28 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 29 |
repo_name = repo_data.get("name", repo_id)
|
|
|
|
|
|
|
| 30 |
|
| 31 |
-
# Construct
|
| 32 |
prompt = (
|
| 33 |
f"Generate comprehensive documentation for the GitHub repository '{repo_id}'. "
|
| 34 |
-
f"The repository is named '{repo_name}' and its description is: {repo_description}
|
|
|
|
| 35 |
"Please include sections such as an introduction, installation instructions, usage examples, "
|
| 36 |
"and any relevant details that would help a new user understand and work with this repository."
|
| 37 |
)
|
|
@@ -47,9 +103,7 @@ def generate_docs(repo_id: str) -> str:
|
|
| 47 |
try:
|
| 48 |
# Call the Groq API with the generated prompt.
|
| 49 |
chat_completion = client.chat.completions.create(
|
| 50 |
-
messages=[
|
| 51 |
-
{"role": "user", "content": prompt}
|
| 52 |
-
],
|
| 53 |
model="llama-3.3-70b-versatile",
|
| 54 |
stream=False,
|
| 55 |
)
|
|
@@ -60,15 +114,19 @@ def generate_docs(repo_id: str) -> str:
|
|
| 60 |
documentation = chat_completion.choices[0].message.content
|
| 61 |
return documentation
|
| 62 |
|
|
|
|
| 63 |
# Define the Gradio Blocks interface.
|
| 64 |
with gr.Blocks() as demo:
|
| 65 |
gr.Markdown("# GitHub Repository Documentation Generator")
|
| 66 |
gr.Markdown(
|
| 67 |
-
"Enter a GitHub repository ID (in the format `user/repo`) below. "
|
| 68 |
"This tool fetches repository details and uses the Groq API to generate documentation."
|
| 69 |
)
|
| 70 |
-
|
| 71 |
-
repo_id_input = gr.Textbox(
|
|
|
|
|
|
|
|
|
|
| 72 |
output_box = gr.Textbox(label="Generated Documentation", lines=20)
|
| 73 |
generate_button = gr.Button("Generate Documentation")
|
| 74 |
|
|
@@ -76,4 +134,4 @@ with gr.Blocks() as demo:
|
|
| 76 |
generate_button.click(fn=generate_docs, inputs=repo_id_input, outputs=output_box)
|
| 77 |
|
| 78 |
# Launch the Gradio app.
|
| 79 |
-
demo.launch()
|
|
|
|
| 1 |
import os
|
| 2 |
+
import logging
|
| 3 |
import requests
|
| 4 |
import gradio as gr
|
| 5 |
from groq import Groq
|
| 6 |
+
from urllib.parse import urlparse
|
| 7 |
|
| 8 |
+
# Configure logging
|
| 9 |
+
logging.basicConfig(level=logging.INFO)
|
| 10 |
+
|
| 11 |
+
|
| 12 |
+
def extract_repo_id(input_str: str) -> str:
|
| 13 |
"""
|
| 14 |
+
Extract the repository ID in the format 'user/repo' from a URL or plain string.
|
| 15 |
"""
|
| 16 |
+
input_str = input_str.strip()
|
| 17 |
+
|
| 18 |
+
# Remove trailing '.git' if present
|
| 19 |
+
if input_str.endswith(".git"):
|
| 20 |
+
input_str = input_str[:-4]
|
| 21 |
+
|
| 22 |
+
# If input is a URL, parse it to extract the repo path.
|
| 23 |
+
if input_str.startswith("http"):
|
| 24 |
+
try:
|
| 25 |
+
parsed = urlparse(input_str)
|
| 26 |
+
path_parts = parsed.path.strip("/").split("/")
|
| 27 |
+
if len(path_parts) >= 2:
|
| 28 |
+
repo_id = "/".join(path_parts[:2])
|
| 29 |
+
logging.info("Extracted repo_id: %s", repo_id)
|
| 30 |
+
return repo_id
|
| 31 |
+
else:
|
| 32 |
+
raise ValueError("Invalid GitHub URL format.")
|
| 33 |
+
except Exception as e:
|
| 34 |
+
raise ValueError(f"Error parsing URL: {e}")
|
| 35 |
else:
|
| 36 |
+
# Assume it's already in the correct format.
|
| 37 |
+
return input_str
|
| 38 |
+
|
| 39 |
+
|
| 40 |
+
def fetch_repo_details(repo_id: str) -> dict:
|
| 41 |
+
"""
|
| 42 |
+
Fetch repository details from GitHub using its API.
|
| 43 |
+
"""
|
| 44 |
+
api_url = f"https://api.github.com/repos/{repo_id}"
|
| 45 |
+
response = requests.get(api_url)
|
| 46 |
if response.status_code != 200:
|
| 47 |
+
raise ValueError(
|
| 48 |
+
f"Error: Unable to fetch repository details for '{repo_id}'. "
|
| 49 |
+
f"Status code: {response.status_code}"
|
| 50 |
+
)
|
| 51 |
+
return response.json()
|
| 52 |
+
|
| 53 |
+
|
| 54 |
+
def fetch_readme(repo_id: str) -> str:
|
| 55 |
+
"""
|
| 56 |
+
Attempt to fetch the README.md from the repository's main branch.
|
| 57 |
+
"""
|
| 58 |
+
readme_url = f"https://raw.githubusercontent.com/{repo_id}/main/README.md"
|
| 59 |
+
response = requests.get(readme_url)
|
| 60 |
+
if response.status_code == 200:
|
| 61 |
+
return response.text
|
| 62 |
+
else:
|
| 63 |
+
return "No README found."
|
| 64 |
+
|
| 65 |
+
|
| 66 |
+
def generate_docs(repo_input: str) -> str:
|
| 67 |
+
"""
|
| 68 |
+
Fetch repository details from GitHub and generate documentation using the Groq API.
|
| 69 |
+
"""
|
| 70 |
+
try:
|
| 71 |
+
# Extract a clean repository ID.
|
| 72 |
+
repo_id = extract_repo_id(repo_input)
|
| 73 |
+
except ValueError as e:
|
| 74 |
+
return str(e)
|
| 75 |
+
|
| 76 |
+
try:
|
| 77 |
+
repo_data = fetch_repo_details(repo_id)
|
| 78 |
+
except ValueError as e:
|
| 79 |
+
return str(e)
|
| 80 |
+
|
| 81 |
+
# Extract repository information.
|
| 82 |
repo_name = repo_data.get("name", repo_id)
|
| 83 |
+
repo_description = repo_data.get("description", "No description provided.")
|
| 84 |
+
readme_content = fetch_readme(repo_id)
|
| 85 |
|
| 86 |
+
# Construct the prompt for the Groq API.
|
| 87 |
prompt = (
|
| 88 |
f"Generate comprehensive documentation for the GitHub repository '{repo_id}'. "
|
| 89 |
+
f"The repository is named '{repo_name}' and its description is: {repo_description}. "
|
| 90 |
+
f"Use the following README content as reference:\n\n{readme_content}\n\n"
|
| 91 |
"Please include sections such as an introduction, installation instructions, usage examples, "
|
| 92 |
"and any relevant details that would help a new user understand and work with this repository."
|
| 93 |
)
|
|
|
|
| 103 |
try:
|
| 104 |
# Call the Groq API with the generated prompt.
|
| 105 |
chat_completion = client.chat.completions.create(
|
| 106 |
+
messages=[{"role": "user", "content": prompt}],
|
|
|
|
|
|
|
| 107 |
model="llama-3.3-70b-versatile",
|
| 108 |
stream=False,
|
| 109 |
)
|
|
|
|
| 114 |
documentation = chat_completion.choices[0].message.content
|
| 115 |
return documentation
|
| 116 |
|
| 117 |
+
|
| 118 |
# Define the Gradio Blocks interface.
|
| 119 |
with gr.Blocks() as demo:
|
| 120 |
gr.Markdown("# GitHub Repository Documentation Generator")
|
| 121 |
gr.Markdown(
|
| 122 |
+
"Enter a GitHub repository URL or ID (in the format `user/repo`) below. "
|
| 123 |
"This tool fetches repository details and uses the Groq API to generate documentation."
|
| 124 |
)
|
| 125 |
+
|
| 126 |
+
repo_id_input = gr.Textbox(
|
| 127 |
+
label="GitHub Repository URL or ID",
|
| 128 |
+
placeholder="https://github.com/octocat/Hello-World or octocat/Hello-World",
|
| 129 |
+
)
|
| 130 |
output_box = gr.Textbox(label="Generated Documentation", lines=20)
|
| 131 |
generate_button = gr.Button("Generate Documentation")
|
| 132 |
|
|
|
|
| 134 |
generate_button.click(fn=generate_docs, inputs=repo_id_input, outputs=output_box)
|
| 135 |
|
| 136 |
# Launch the Gradio app.
|
| 137 |
+
demo.launch(ssr=False, debug=True)
|