Spaces:
Runtime error
Runtime error
Commit
Β·
9c405cd
1
Parent(s):
498ef3c
Frontend complete and changed experimental_rerun to rerun
Browse files- frontend/pages/Code.py +4 -3
- frontend/pages/Usage.py +7 -30
- frontend/π‘_Home.py +2 -3
frontend/pages/Code.py
CHANGED
@@ -30,14 +30,15 @@ def instructions():
|
|
30 |
|
31 |
##### 2. Paste the `API Key` in the field provided.
|
32 |
|
33 |
-
##### 3. Paste your code function in the input code box.
|
34 |
|
35 |
##### 4. Click on the `Generate Documentation` π€ button to generate the documentation.
|
36 |
|
37 |
-
##### 5. The generated documentation will be displayed in the section below.
|
38 |
|
39 |
"""
|
40 |
-
)
|
|
|
41 |
|
42 |
|
43 |
with st.sidebar:
|
|
|
30 |
|
31 |
##### 2. Paste the `API Key` in the field provided.
|
32 |
|
33 |
+
##### 3. Paste your `code function` in the input code box.
|
34 |
|
35 |
##### 4. Click on the `Generate Documentation` π€ button to generate the documentation.
|
36 |
|
37 |
+
##### 5. The `generated documentation` will be displayed in the section below.
|
38 |
|
39 |
"""
|
40 |
+
)
|
41 |
+
st.info("Please note that the Streamlit app is just a preview to give the user an idea of the project. To witness the full power of Techdocs, please use the CLI. The instructions to use the CLI are listed in Usage page")
|
42 |
|
43 |
|
44 |
with st.sidebar:
|
frontend/pages/Usage.py
CHANGED
@@ -46,42 +46,19 @@ def usage():
|
|
46 |
st.write(f'<p style="font-size:20px; color:#9c9d9f ">{intro_text}</p>', unsafe_allow_html=True)
|
47 |
st.write(f'<p style="color:#9c9d9f; font-size:20px">{text}</p>', unsafe_allow_html=True)
|
48 |
|
49 |
-
st.markdown("### π Using Techdocs via the CLI")
|
|
|
|
|
50 |
|
51 |
with st.expander("βοΈ Installation and setup",expanded=True):
|
52 |
st.text("1. Create a virtual environment. We recommend using conda but you can python's venv as well:"); st.code("conda create -n techdocs python=3.11","python")
|
53 |
st.text("2. Install Techdocs via pip:"); st.code("pip install techdocs","python")
|
54 |
st.text("3. CD into your project directory.")
|
55 |
st.code("CD <YOUR-PROJECT-DIRECTORY>","bash")
|
56 |
-
st.text(""
|
57 |
-
|
58 |
-
|
59 |
-
|
60 |
-
""")
|
61 |
-
st.code("techdocs -k <API_KEY> -u <USERNAME> -p <PASSWORD> -d <ROOT-DIRECTORY-OF-THE -PROJECT","bash")
|
62 |
-
st.text("6. Wait for the documentation to be generated. You can view the status of the documentation generation in the CLI.")
|
63 |
-
|
64 |
-
st.divider()
|
65 |
-
st.markdown("### π Using Techdocs via the Streamlit")
|
66 |
-
|
67 |
-
with st.expander("πInstructions",expanded=True):
|
68 |
-
st.markdown(
|
69 |
-
"""
|
70 |
-
##### 1. Head over to the Code Page.
|
71 |
-
|
72 |
-
##### 2. Generate an `API Key` from the sidebar to get started.
|
73 |
-
|
74 |
-
##### 3. Paste the `API Key` in the field provided.
|
75 |
-
|
76 |
-
##### 4. Paste your code function in the input code box.
|
77 |
-
|
78 |
-
##### 5. Click on the `Generate Documentation`π€ button to generate the documentation.
|
79 |
-
|
80 |
-
##### 6. The generated documentation will be displayed in the section below.
|
81 |
-
|
82 |
-
"""
|
83 |
-
)
|
84 |
-
|
85 |
|
86 |
|
87 |
if 'access_token' not in st.session_state:
|
|
|
46 |
st.write(f'<p style="font-size:20px; color:#9c9d9f ">{intro_text}</p>', unsafe_allow_html=True)
|
47 |
st.write(f'<p style="color:#9c9d9f; font-size:20px">{text}</p>', unsafe_allow_html=True)
|
48 |
|
49 |
+
st.markdown("### π :rainbow[Using Techdocs via the CLI]")
|
50 |
+
st.info("Please use the CLI to generate the documentation for your project. The Streamlit app is just a preview to give the user an idea of the project.")
|
51 |
+
st.warning("The API Key can only be generated from the Techdocs Streamlit app. To start using the CLI, please generate an API Key from the Streamlit app.")
|
52 |
|
53 |
with st.expander("βοΈ Installation and setup",expanded=True):
|
54 |
st.text("1. Create a virtual environment. We recommend using conda but you can python's venv as well:"); st.code("conda create -n techdocs python=3.11","python")
|
55 |
st.text("2. Install Techdocs via pip:"); st.code("pip install techdocs","python")
|
56 |
st.text("3. CD into your project directory.")
|
57 |
st.code("CD <YOUR-PROJECT-DIRECTORY>","bash")
|
58 |
+
st.text("4. Login into our Techdocs Streamlit app or signup if you don't have an account.")
|
59 |
+
st.text("5. Generate an API Key from the Code page and paste it in the command below.")
|
60 |
+
st.code("techdocs -k <API_KEY> -u <USERNAME> -p <PASSWORD> -d <ROOT-DIRECTORY-OF-THE -PROJECT>","bash")
|
61 |
+
st.text("6. Wait for the documentation to be generated. You can view the status of the documentation generation in the CLI.")
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
62 |
|
63 |
|
64 |
if 'access_token' not in st.session_state:
|
frontend/π‘_Home.py
CHANGED
@@ -85,10 +85,9 @@ def home_page():
|
|
85 |
)
|
86 |
|
87 |
st.markdown("""
|
88 |
-
## :rainbow[
|
89 |
-
##### Head over to the
|
90 |
""")
|
91 |
-
st.link_button("Usage", "http://localhost:8501/Usage_π?page=Usage")
|
92 |
|
93 |
st.sidebar.divider()
|
94 |
st.sidebar.info(
|
|
|
85 |
)
|
86 |
|
87 |
st.markdown("""
|
88 |
+
## :rainbow[Ready to use Techdocs?]
|
89 |
+
##### Head over to the `Usage page` to get started!π
|
90 |
""")
|
|
|
91 |
|
92 |
st.sidebar.divider()
|
93 |
st.sidebar.info(
|