Create app.py

app.py

@@ -0,0 +1,179 @@
+import streamlit as st
+import requests
+import pandas as pd
+import os 
+
+# ---------------------------
+# Global Variables (Backend)
+# ---------------------------
+API_KEY = os.getenv("FMP_API_KEY")
+DEFAULT_RSS_PAGE = 0
+DEFAULT_SEARCH_NAME = "enotap"
+DEFAULT_CIK = "0001916078"
+NUM_PAGES = 10  # if applicable, can be used in other endpoints
+
+# ---------------------------
+# Initialize Session State
+# ---------------------------
+if "run_rss" not in st.session_state:
+    st.session_state.run_rss = False
+if "run_search" not in st.session_state:
+    st.session_state.run_search = False
+if "run_cik" not in st.session_state:
+    st.session_state.run_cik = False
+
+if "rss_page" not in st.session_state:
+    st.session_state.rss_page = DEFAULT_RSS_PAGE
+if "search_name" not in st.session_state:
+    st.session_state.search_name = DEFAULT_SEARCH_NAME
+if "cik_value" not in st.session_state:
+    st.session_state.cik_value = DEFAULT_CIK
+
+# ---------------------------
+# CACHED API FUNCTIONS
+# ---------------------------
+@st.cache_data(show_spinner=False)
+def fetch_crowdfunding_rss(page: int) -> pd.DataFrame:
+    """
+    Fetch the crowdfunding RSS feed data from the given page.
+    """
+    url = f"https://financialmodelingprep.com/api/v4/crowdfunding-offerings-rss-feed?page={page}&apikey={API_KEY}"
+    response = requests.get(url)
+    response.raise_for_status()
+    data = response.json()
+    if not data:
+        return pd.DataFrame()
+    return pd.DataFrame(data)
+
+@st.cache_data(show_spinner=False)
+def fetch_crowdfunding_search(name: str) -> pd.DataFrame:
+    """
+    Search for crowdfunding campaigns by name.
+    """
+    url = f"https://financialmodelingprep.com/api/v4/crowdfunding-offerings/search?name={name}&apikey={API_KEY}"
+    response = requests.get(url)
+    response.raise_for_status()
+    data = response.json()
+    if not data:
+        return pd.DataFrame()
+    return pd.DataFrame(data)
+
+@st.cache_data(show_spinner=False)
+def fetch_crowdfunding_by_cik(cik: str) -> pd.DataFrame:
+    """
+    Fetch all crowdfunding campaigns launched by a company identified by its CIK.
+    """
+    url = f"https://financialmodelingprep.com/api/v4/crowdfunding-offerings?cik={cik}&apikey={API_KEY}"
+    response = requests.get(url)
+    response.raise_for_status()
+    data = response.json()
+    if not data:
+        return pd.DataFrame()
+    return pd.DataFrame(data)
+
+# ---------------------------
+# MAIN APP
+# ---------------------------
+def main():
+    st.set_page_config(page_title="Crowdfunding Campaigns Dashboard", layout="wide")
+    st.title("Crowdfunding Campaigns Dashboard")
+    st.write(
+        "This dashboard provides access to real-time crowdfunding campaign data. "
+        "Use the side menu to select one of the three pages below. "
+        "Each page shows a DataFrame with details fetched from Financial Modeling Prep."
+    )
+    
+    # Sidebar: Navigation and Options
+    with st.sidebar.expander("Navigation and Options", expanded=True):
+        page = st.radio(
+            "Select Page",
+            ("Crowdfunding RSS Feed", "Crowdfunding Search", "Crowdfunding By CIK"),
+            help="Choose the page you wish to view. The RSS Feed shows a live feed; Search allows searching by campaign or company name; and By CIK shows campaigns launched by a company using its CIK."
+        )
+        
+        if page == "Crowdfunding RSS Feed":
+            rss_page = st.number_input(
+                "RSS Feed Page",
+                min_value=0,
+                value=DEFAULT_RSS_PAGE,
+                help="Enter the page number to fetch from the crowdfunding RSS feed."
+            )
+            st.session_state.rss_page = rss_page
+            if st.button("Run Crowdfunding RSS Feed"):
+                st.session_state.run_rss = True
+        elif page == "Crowdfunding Search":
+            search_name = st.text_input(
+                "Campaign/Company Name",
+                value=DEFAULT_SEARCH_NAME,
+                help="Enter the name to search for crowdfunding campaigns (e.g., enotap)."
+            )
+            st.session_state.search_name = search_name
+            if st.button("Run Crowdfunding Search"):
+                st.session_state.run_search = True
+        else:  # Crowdfunding By CIK
+            cik_value = st.text_input(
+                "Company CIK",
+                value=DEFAULT_CIK,
+                help="Enter the CIK of the company to fetch its crowdfunding campaigns."
+            )
+            st.session_state.cik_value = cik_value
+            if st.button("Run Crowdfunding By CIK"):
+                st.session_state.run_cik = True
+
+    # Page Output
+    if page == "Crowdfunding RSS Feed":
+        st.header("Crowdfunding RSS Feed")
+        st.write(
+            "This page displays the latest crowdfunding campaigns from an RSS feed. "
+            "The data includes various details such as company name, form type, offering amount, and more."
+        )
+        if st.session_state.run_rss:
+            df_rss = fetch_crowdfunding_rss(st.session_state.rss_page)
+            if df_rss.empty:
+                st.error("No data returned from the Crowdfunding RSS Feed.")
+            else:
+                st.dataframe(df_rss, use_container_width=True)
+        else:
+            st.info("Enter the page number in the sidebar and click 'Run Crowdfunding RSS Feed'.")
+    
+    elif page == "Crowdfunding Search":
+        st.header("Crowdfunding Search")
+        st.write(
+            "This page allows you to search for crowdfunding campaigns by company or campaign name. "
+            "The table below displays the matching campaigns with key details."
+        )
+        if st.session_state.run_search:
+            df_search = fetch_crowdfunding_search(st.session_state.search_name)
+            if df_search.empty:
+                st.error("No crowdfunding campaigns found for the specified name.")
+            else:
+                st.dataframe(df_search, use_container_width=True)
+        else:
+            st.info("Enter a name in the sidebar and click 'Run Crowdfunding Search'.")
+    
+    else:  # Crowdfunding By CIK
+        st.header("Crowdfunding By CIK")
+        st.write(
+            "This page displays all crowdfunding campaigns launched by a company identified by its CIK. "
+            "The table below contains detailed information for each campaign."
+        )
+        if st.session_state.run_cik:
+            df_cik = fetch_crowdfunding_by_cik(st.session_state.cik_value)
+            if df_cik.empty:
+                st.error("No crowdfunding campaigns found for the specified CIK.")
+            else:
+                st.dataframe(df_cik, use_container_width=True)
+        else:
+            st.info("Enter a CIK in the sidebar and click 'Run Crowdfunding By CIK'.")
+
+if __name__ == "__main__":
+    main()
+
+
+hide_streamlit_style = """
+<style>
+#MainMenu {visibility: hidden;}
+footer {visibility: hidden;}
+</style>
+"""
+st.markdown(hide_streamlit_style, unsafe_allow_html=True)