hygull

Hi, I am

Rishikesh Agrawani

Backend engineer with 9+ years of experience. This site is where I keep the notes I write while learning: short tutorials with code you can run. Away from the keyboard I write and record songs.

Short tutorials with runnable code

Learnings

Notes written while learning, kept short on purpose. Each tutorial explains a concept in a few lines, shows the code, and tells you how to run it. Pick a path and read it in order.

Frontend learning path

React to Next

Four tutorials. Learn React first, then Next, use the comparison to lock in what Next changed, and finish with the design skills that turn a Figma file into components.

Step 1

React Essentials

learnings/React/docs/react-tutorial.html

Components, props, state, effects, hooks, context, routing with React Router, auth with a protected route, styling, and turning a Figma file into components.

Step 3

React vs Next.js

learnings/Next_React/docs/react-vs-next.html

Seventeen tasks shown side by side, React on the left and Next on the right, each with one line on what Next added. Only topics where Next changed something.

Step 4

Design to Code

learnings/Design/docs/design-to-code.html

Reading a Figma file, design tokens, spacing, typography, color, responsive layout, states, a reusable component kit, accessibility, and the Figma MCP and Code Connect workflow.

Python learning path

Python Basics

Six tutorials that start from the first print(). They are Python 3 rewrites of the 2017 Pythofrank lessons, with the original examples kept where they still make sense.

Step 1

First Steps

learnings/Python/docs/python-basics.html

What Python is, running it, variables, indentation, numbers, and decisions with if, elif and else.

Step 2

Data Types

learnings/Python/docs/python-data-types.html

Strings, lists, tuples, dictionaries and sets: how to create, read and change each one, and which to pick.

Step 3

Loops

learnings/Python/docs/python-loops.html

for and while loops over numbers, strings, lists and dictionaries, with range, enumerate, zip and comprehensions.

Step 4

Functions

learnings/Python/docs/python-functions.html

Defining functions, arguments and defaults, *args and **kwargs, scope, lambda, map and filter, recursion.

Step 5

Classes

learnings/Python/docs/python-classes.html

Classes and objects, inheritance, class and static methods, properties, and dataclasses, built on a small bank.

Step 6

Errors and Files

learnings/Python/docs/python-errors-and-files.html

Handling exceptions, reading and writing text, CSV and JSON files, and working with dates and times.

Python learning path

Python Advanced

Five tutorials on the parts of Python that take longest to click. Each idea is built up one small step at a time, and every example was run before it was published.

Step 1

Decorators

learnings/Python/docs/python-decorators.html

Closures, plain and parameterised decorators, functools.wraps, class-based decorators, and real uses: logging, retry, caching, permission checks.

Step 2

Iterators and Generators

learnings/Python/docs/python-iterators-generators.html

What a for loop really does, writing your own iterator, generators with yield, pipelines, yield from and itertools.

Step 3

Threads and Processes

learnings/Python/docs/python-concurrency.html

Concurrency versus parallelism, the GIL, threads, race conditions, locks and deadlock, queues, and multiprocessing.

Step 4

Async IO

learnings/Python/docs/python-asyncio.html

The event loop, async and await, running tasks together, timeouts, semaphores and locks, and how not to block the loop.

Step 5

Power Features

learnings/Python/docs/python-power-features.html

Context managers, special methods, descriptors, __slots__, dataclasses in depth, Enum, Protocol, metaclasses and type hints.

Python learning path

Python in Practice

Nine tutorials on everything around the language that a working project needs: setting up, testing, debugging, tooling, data and the web.

Step 1

Project Setup

learnings/Python/docs/python-project-setup.html

Virtual environments, pip, modules and packages, imports, if __name__ == "__main__", project layout and pyproject.toml.

Step 2

Testing

learnings/Python/docs/python-testing.html

Writing tests with pytest: fixtures, parametrised tests, fakes and mocks, test-driven development and coverage.

Step 3

Debugging and Logging

learnings/Python/docs/python-debugging-logging.html

Reading tracebacks, the pdb debugger, a method for finding bugs, and the logging module in place of print.

Step 4

Code Quality

learnings/Python/docs/python-code-quality.html

PEP 8, formatting with black, linting with ruff, type checking with mypy, and pre-commit hooks.

Step 5

Standard Library Tour

learnings/Python/docs/python-standard-library.html

A tour of the modules worth knowing: re, pathlib, argparse, subprocess, json, decimal, hashlib and more.

Step 6

Data Structures and Algorithms

learnings/Python/docs/python-data-structures.html

Big-O in plain words, the cost of list, dict and set operations, deque, heapq and bisect, searching, sorting, recursion and graph search.

Step 7

Performance and Memory

learnings/Python/docs/python-performance.html

Measuring with timeit and cProfile, writing faster Python, and how references, reference counting and garbage collection work.

Step 8

Databases

learnings/Python/docs/python-databases.html

SQL with sqlite3, safe queries, transactions that keep a transfer all-or-nothing, and the SQLAlchemy ORM.

Step 9

Web APIs

learnings/Python/docs/python-web-apis.html

How HTTP works, calling an API, and building and testing a small bank API with FastAPI.

Python learning path

Python Design

Two tutorials built on one small bank. Every example is a few lines long, runs with only the standard library, and reuses the same Person and Account classes.

Step 1

Design Principles

learnings/Python/docs/design-principles.html

The five SOLID principles, then six general ones: DRY, KISS, YAGNI, composition over inheritance, tell don't ask and encapsulation. Each one shown as the code that breaks it, then the fix.

Step 2

Design Patterns

learnings/Python/docs/design-patterns.html

All 23 classic patterns, grouped into creational, structural and behavioural, with what each family means. Every pattern has the problem it solves, a small example and the shortcut Python gives you.

Command line

Bash

Notes on the shell, added as they come up. Each topic is a few short chapters with commands you can paste into a terminal.

Topic 1

History and histverify

learnings/Bash/docs/bash-notes.html

What !!, !$ and !git really do, why they can run a command you have not read, and the one setting that shows it to you first.