Create app.py

app.py

@@ -0,0 +1,177 @@
+import streamlit as st
+import requests
+import pandas as pd
+import os
+
+# ----------------------------------------
+# Backend Variables (Not Exposed to Frontend)
+# ----------------------------------------
+API_KEY = os.getenv("FMP_API_KEY")
+DEFAULT_RSS_PAGE = 0
+DEFAULT_SEARCH_NAME = "NJOY"
+DEFAULT_CIK = "0001547416"
+
+# ----------------------------------------
+# Initialize Session State Variables
+# ----------------------------------------
+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_equity_rss(rss_page: int) -> pd.DataFrame:
+    """
+    Fetch Equity Offering data from the RSS feed endpoint.
+    """
+    url = f"https://financialmodelingprep.com/api/v4/fundraising-rss-feed?page={rss_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_equity_search(name: str) -> pd.DataFrame:
+    """
+    Search for equity offerings by company/offering name.
+    """
+    url = f"https://financialmodelingprep.com/api/v4/fundraising/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_equity_by_cik(cik: str) -> pd.DataFrame:
+    """
+    Fetch all equity offerings for a company identified by its CIK.
+    """
+    url = f"https://financialmodelingprep.com/api/v4/fundraising?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="Equity Offerings Dashboard", layout="wide")
+    st.title("Equity Offerings Dashboard")
+    st.write(
+        "This dashboard provides access to equity offering announcements. "
+        "Use the sidebar below to choose one of the three pages. Each page shows the raw data in a table format with details fetched from Financial Modeling Prep."
+    )
+    
+    # Sidebar: Navigation and Options inside an expander
+    with st.sidebar.expander("Navigation and Options", expanded=True):
+        page = st.radio(
+            "Select Page",
+            ("Equity Offering RSS Feed", "Equity Offering Search", "Equity Offering By CIK"),
+            help="Choose a page: the RSS Feed shows the live feed; Search allows searching by name; By CIK shows offerings for a company."
+        )
+        if page == "Equity Offering RSS Feed":
+            rss_page = st.number_input(
+                "RSS Feed Page",
+                min_value=0,
+                value=DEFAULT_RSS_PAGE,
+                help="Enter the page number to fetch the RSS feed data."
+            )
+            st.session_state.rss_page = rss_page
+            if st.button("Run Equity Offering RSS Feed"):
+                st.session_state.run_rss = True
+        elif page == "Equity Offering Search":
+            search_name = st.text_input(
+                "Search Name",
+                value=DEFAULT_SEARCH_NAME,
+                help="Enter the name to search for equity offerings (e.g., NJOY)."
+            )
+            st.session_state.search_name = search_name
+            if st.button("Run Equity Offering Search"):
+                st.session_state.run_search = True
+        else:  # Equity Offering By CIK
+            cik_value = st.text_input(
+                "Company CIK",
+                value=DEFAULT_CIK,
+                help="Enter the CIK of the company to view its equity offerings."
+            )
+            st.session_state.cik_value = cik_value
+            if st.button("Run Equity Offering By CIK"):
+                st.session_state.run_cik = True
+
+    # ----------------------------------------
+    # Page Output
+    # ----------------------------------------
+    if page == "Equity Offering RSS Feed":
+        st.header("Equity Offering RSS Feed")
+        st.write(
+            "This page displays the live RSS feed of equity offering announcements. "
+            "The table below shows details such as company name, form type, offering date, and URL."
+        )
+        if st.session_state.run_rss:
+            df_rss = fetch_equity_rss(st.session_state.rss_page)
+            if df_rss.empty:
+                st.error("No data returned from the Equity Offering RSS Feed.")
+            else:
+                st.dataframe(df_rss, use_container_width=True)
+        else:
+            st.info("Enter a page number in the sidebar and click 'Run Equity Offering RSS Feed'.")
+    
+    elif page == "Equity Offering Search":
+        st.header("Equity Offering Search")
+        st.write(
+            "This page allows you to search for equity offering announcements by company or offering name. "
+            "The table below shows the matching offerings along with key details."
+        )
+        if st.session_state.run_search:
+            df_search = fetch_equity_search(st.session_state.search_name)
+            if df_search.empty:
+                st.error("No equity offerings found for the specified search name.")
+            else:
+                st.dataframe(df_search, use_container_width=True)
+        else:
+            st.info("Enter a name in the sidebar and click 'Run Equity Offering Search'.")
+    
+    else:  # Equity Offering By CIK
+        st.header("Equity Offering By CIK")
+        st.write(
+            "This page displays all equity offering announcements made by a company, identified by its CIK. "
+            "The table below lists detailed information for each offering."
+        )
+        if st.session_state.run_cik:
+            df_cik = fetch_equity_by_cik(st.session_state.cik_value)
+            if df_cik.empty:
+                st.error("No equity offerings 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 Equity Offering 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)