Alperen Akyol - bounswe/bounswe2025group2 GitHub Wiki

Note: You can reach my weekly efforts at the bottom of this page.

Note 2: You can reach my description about the external api that i have used at the bottom of this page.

Hey, I am Alperen (a.k.a. AipAkyol), a junior CmpE undergrad in Bogazici University.

My main interest areas are Game Development and Algorithms.

My favorite programming language is Java:

class Main {
    public static void main(String[] args) {
        System.out.println("Everyone loves Java!");
    }
}

Programming Languages:

• Java
• Python
• C
• Svelte
• RISC-V and GNU Assembly

I have created many projects inside and outside of the class. You can check their repos from my Github Profile.

You can also check my first web project that can be used for concurently checking the local time of the cities around the world.

• Gaming and Game Industry since my main goal is becoming a game developer one day :)
• Reading fiction books 📖
• Watching Movies and TV Series, my favorite one is a German series called Dark
• Playing football ⚽

• E-mail: [email protected]
• Github: link
• LinkedIn: link
• You can always find me around the CmpE building in the North Campus :)

The Quotes API provides motivational quotes functionality for the GenFit application fetching motivational quotes from the ZenQuotes API, offering both random and daily quotes to authenticated users. The implementation consists of a Django model and corresponding API views.

• Model Definition: /backend/genfit_django/api/models.py
• API Views: /backend/genfit_django/api/separate_views/quote_views.py

class Quote(models.Model):
    text = models.TextField()
    author = models.CharField(max_length=100)
    fetched_at = models.DateTimeField(default=timezone.now)
    
    class Meta:
        ordering = ['-fetched_at']
    
    def __str__(self):
        return f'"{self.text}" - {self.author}'

The Quote model includes:

• text : The content of the quote (TextField)
• author : The name of the quote's author (CharField, max 100 characters)
• fetched_at : Timestamp of when the quote was fetched (DateTimeField)
• Automatic ordering by most recent quotes first
• String representation combining quote text and author

@api_view(['GET'])
@permission_classes([IsAuthenticated])
def get_random_quote(request):
    quote = fetch_and_cache_quote()
    if quote:
        return Response({
            'text': quote.text,
            'author': quote.author
        })

• URL : /api/quotes/random/
• Method : GET
• Authentication : Required
• Caching : 15-second cache to prevent excessive API calls

@api_view(['GET'])
@permission_classes([IsAuthenticated])
def get_daily_quote(request):
    quote = fetch_daily_quote()
    if quote:
        return Response({
            'text': quote.text,
            'author': quote.author
        })

• URL : /api/quotes/daily/
• Method : GET
• Authentication : Required
• Caching : Cached for the entire day

def fetch_and_cache_quote():
    try:
        recent_quote = Quote.objects.filter(
            fetched_at__gte=timezone.now() - timedelta(seconds=15)
        ).first()
        
        if recent_quote:
            return recent_quote
        
        response = requests.get(f"{ZENQUOTES_API_URL}/random")

• Checks for quotes fetched in the last 15 seconds
• If none found, fetches new quote from ZenQuotes API
• Stores quote in database for caching
• Falls back to most recent quote if API call fails

def fetch_daily_quote():
    try:
        today_start = timezone.now().replace(hour=0, minute=0, second=0, microsecond=0)
        daily_quote = Quote.objects.filter(fetched_at__gte=today_start).first()

• Checks for quotes fetched today
• If none found, fetches new daily quote from ZenQuotes API
• Stores quote in database for daily caching
• Falls back to most recent quote if API call fails

• Returns 503 Service Unavailable if quote fetching fails
• Implements fallback mechanism to use cached quotes
• Gracefully handles API timeouts and connection issues

The quotes API is integrated with the GenFit application to provide motivational content throughout the user experience, such as daily motivation on the main page.

We have decided to conduct our weekly meetings on saturdays from now on, so the weeks will start and end on saturdays as well for my weekly effort table.

“Here’s the thing kid, we don’t get to choose how we start in this life. Real greatness is what you do with the hand your dealt”