From 591c8948f069b2c1a1d1234e277457b0c9ebcafd Mon Sep 17 00:00:00 2001
From: 9ao9ai9ar <32834976+9ao9ai9ar@users.noreply.github.com>
Date: Thu, 1 Aug 2024 04:24:33 +0800
Subject: [PATCH 01/12] A modular rewrite with tangible improvements for both
devs and users.
Some common development practices are introduced to the project:
* data (de)serialization and validation, via Pydantic
* API client code generation, via OpenAPI
* continuous integration, via a suite of tests and utilities
Known bugs like posts on meta sites weren't being backed up and #1 are
fixed. More consideration is given to rate limiting while driving down
quota usage by using static filters; a few CLI options are also added.
---
.gitignore | 16 +-
LICENSE | 2 +
README.md | 394 +++++---
assets/account_id.png | Bin 0 -> 42250 bytes
assets/address_bar_userid.png | Bin 203912 -> 0 bytes
assets/demo.avif | Bin 0 -> 333630 bytes
assets/example1.png | Bin 87701 -> 0 bytes
assets/example2.png | Bin 68522 -> 0 bytes
assets/example3.png | Bin 78148 -> 0 bytes
assets/markdown.png | Bin 0 -> 98385 bytes
assets/network_user.png | Bin 0 -> 48478 bytes
assets/se_backup.gif | Bin 723420 -> 0 bytes
assets/se_click.png | Bin 231786 -> 0 bytes
main.py | 403 --------
pyproject.toml | 172 ++++
release.ps1 | 42 +
requirements.txt | 929 ++++++++++++++++++
.../openapi/components/response_wrapper.yaml | 32 +
.../openapi/components/schemas/answer.yaml | 103 ++
.../components/schemas/badge_count.yaml | 12 +
.../components/schemas/closed_details.yaml | 22 +
.../components/schemas/collective.yaml | 22 +
.../schemas/collective_external_link.yaml | 18 +
.../schemas/collective_recommendation.yaml | 11 +
.../openapi/components/schemas/comment.yaml | 49 +
.../openapi/components/schemas/error.yaml | 17 +
.../openapi/components/schemas/filter.yaml | 20 +
.../components/schemas/migration_info.yaml | 14 +
.../components/schemas/network_post.yaml | 19 +
.../components/schemas/network_user.yaml | 46 +
.../openapi/components/schemas/notice.yaml | 14 +
.../components/schemas/original_question.yaml | 17 +
.../openapi/components/schemas/question.yaml | 136 +++
.../components/schemas/related_site.yaml | 21 +
.../components/schemas/shallow_user.yaml | 35 +
.../openapi/components/schemas/site.yaml | 63 ++
.../openapi/components/schemas/styling.yaml | 18 +
resources/openapi/openapi.yaml | 374 +++++++
src/stackexchange/_model_base.py | 11 +
src/stackexchange/api.py | 601 +++++++++++
src/stackexchange/backup.py | 331 +++++++
src/stackexchange/generated/_model_openapi.py | 667 +++++++++++++
src/stackexchange/model_extend.py | 197 ++++
tests/test_api.py | 49 +
tests/test_api_known_bugs.py | 31 +
tests/test_api_regressions.py | 13 +
tests/test_filters.py | 119 +++
tests/test_model.py | 97 ++
48 files changed, 4575 insertions(+), 562 deletions(-)
create mode 100644 assets/account_id.png
delete mode 100644 assets/address_bar_userid.png
create mode 100644 assets/demo.avif
delete mode 100644 assets/example1.png
delete mode 100644 assets/example2.png
delete mode 100644 assets/example3.png
create mode 100644 assets/markdown.png
create mode 100644 assets/network_user.png
delete mode 100644 assets/se_backup.gif
delete mode 100644 assets/se_click.png
delete mode 100644 main.py
create mode 100644 pyproject.toml
create mode 100755 release.ps1
create mode 100644 requirements.txt
create mode 100644 resources/openapi/components/response_wrapper.yaml
create mode 100644 resources/openapi/components/schemas/answer.yaml
create mode 100644 resources/openapi/components/schemas/badge_count.yaml
create mode 100644 resources/openapi/components/schemas/closed_details.yaml
create mode 100644 resources/openapi/components/schemas/collective.yaml
create mode 100644 resources/openapi/components/schemas/collective_external_link.yaml
create mode 100644 resources/openapi/components/schemas/collective_recommendation.yaml
create mode 100644 resources/openapi/components/schemas/comment.yaml
create mode 100644 resources/openapi/components/schemas/error.yaml
create mode 100644 resources/openapi/components/schemas/filter.yaml
create mode 100644 resources/openapi/components/schemas/migration_info.yaml
create mode 100644 resources/openapi/components/schemas/network_post.yaml
create mode 100644 resources/openapi/components/schemas/network_user.yaml
create mode 100644 resources/openapi/components/schemas/notice.yaml
create mode 100644 resources/openapi/components/schemas/original_question.yaml
create mode 100644 resources/openapi/components/schemas/question.yaml
create mode 100644 resources/openapi/components/schemas/related_site.yaml
create mode 100644 resources/openapi/components/schemas/shallow_user.yaml
create mode 100644 resources/openapi/components/schemas/site.yaml
create mode 100644 resources/openapi/components/schemas/styling.yaml
create mode 100644 resources/openapi/openapi.yaml
create mode 100644 src/stackexchange/_model_base.py
create mode 100644 src/stackexchange/api.py
create mode 100644 src/stackexchange/backup.py
create mode 100644 src/stackexchange/generated/_model_openapi.py
create mode 100644 src/stackexchange/model_extend.py
create mode 100644 tests/test_api.py
create mode 100644 tests/test_api_known_bugs.py
create mode 100644 tests/test_api_regressions.py
create mode 100644 tests/test_filters.py
create mode 100644 tests/test_model.py
diff --git a/.gitignore b/.gitignore
index 7ba61e6..588fa4f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,13 @@
-*.csv
-.vscode
-q_and_a
\ No newline at end of file
+/*
+**/*.egg-info/
+**/__pycache__/
+!assets/
+!resources/
+!src/
+!tests/
+!.gitignore
+!LICENSE
+!pyproject.toml
+!README.md
+!release.ps1
+!requirements.txt
diff --git a/LICENSE b/LICENSE
index a732d9e..0d5f011 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,5 +1,7 @@
MIT License
+Copyright (c) 2024 Wei Cheng
+
Copyright (c) 2024 Mahmoud Abdelkhalek
Permission is hereby granted, free of charge, to any person obtaining a copy
diff --git a/README.md b/README.md
index 5063840..d013a0f 100644
--- a/README.md
+++ b/README.md
@@ -1,208 +1,290 @@
# Stack Exchange Backup
-| | |
-| --- | --- |
-| | |
-
-Download all of your questions and answers as Markdown files from all Stack Exchange (SE) sites using a Python script and the [SE API](https://api.stackexchange.com/).
-
-# Getting started
-
-To get started, make sure that Python version 3.11.7 or newer is installed. Then, run the
-following commands (note that these commands were tested in Powershell, and so only one of these commands will need to be translated for use in bash, zsh, etc.):
-```bash
-git clone https://github.com/mhdadk/stack-exchange-backup.git
-cd stack-exchange-backup
-# create a virtual environment
-python -m venv .venv
-# activate the virtual environment. This command should be translated when using bash
-.venv\Scripts\activate
-python -m pip install "requests==2.31.0"
-```
-Finally, determine your SE network user ID by doing the following:
+Download all your posts on the Stack Exchange network as Markdown files
+via a Python script talking to the Stack Exchange API.
+
+## Showcase
+
+
+
+
+## Installation
+
+1. Either download the repository as a ZIP file and extract it,
+ or [install Git](https://git-scm.com/downloads) (recommended) and do a `git clone` of the project.
+
+ ```shell
+ git clone https://github.com/9ao9ai9ar/stack-exchange-backup.git
+ ```
+
+2. [Install Python 3.12 or newer](https://www.python.org/downloads/).
+ See the [support section](#support) for additional information.
+
+3. Enter the directory you just extracted/cloned.
+
+ ```shell
+ cd stack-exchange-backup
+ ```
+
+ All steps hereafter assume operations under said directory.
+
+4. Create and activate a virtual environment (strongly recommended).
+
+ * Windows:
+
+ ```shell
+ py -3 -m venv .venv
+ .\.venv\Scripts\activate
+ ```
+
+ * macOS/Linux:
+
+ ```shell
+ python3 -m venv .venv
+ . .venv/bin/activate
+ ```
-1. Go to https://stackexchange.com/.
-2. Log in to your SE account.
-3. Click on your profile picture on the top-right, as indicated by the red arrow in the screenshot below.
-
-4. Go to the address bar in your browser, and the address should be in the form `https://stackexchange.com/users//`. For example, the screenshot below shows my `user id` as `9073934` and my `user name` as `mhdadk`. Note/save the `user id` from the address bar that is shown for your account, as this will be needed later.
-
+5. Install `stack-exchange-backup` as a local Python package.
-Go to the "Usage" section below for the final step.
+ ```shell
+ python -m pip install -r ./requirements.txt
+ python -m pip install .
+ ```
-# Usage
+## Usage
-Once the steps under the section "Getting started" above are done, you can then download all of your questions and answers from all SE sites by running the following command:
-```powershell
-python main.py --user_id
+Remember to activate the virtual environment first!
+
+```console
+(.venv) $ python -m stackexchange.backup --help
+usage: backup.py [-h] --account-id ACCOUNT_ID [--no-meta] [--out-dir OUT_DIR] [--request-key REQUEST_KEY] [--rps RPS]
+
+options:
+ -h, --help show this help message and exit
+ --account-id ACCOUNT_ID
+ account ID
+ --no-meta do not back up meta posts
+ --out-dir OUT_DIR output directory (default: q_and_a)
+ --request-key REQUEST_KEY
+ request key
+ --rps RPS requests per second limit (default: 20)
```
-where `` should be replaced with your own `user id` that you obtained by following the instructions under the "Getting started" section above. See the "Format" section below for details on the format of the files that are downloaded.
-
-**NOTE**: you may notice that, for some SE sites, there are fewer answers downloaded
-under the `answers` directory than the number of answers shown on the SE site itself
-online. The reason for this is that more than one of your answers may be associated with
-the same question. In this case, the question and your multiple answers for it are
-downloaded once only.
-
-# Format
-
-Once the command under the "Usage" section is run, a `q_and_a` directory will be created inside the directory from which the command was run. This directory will have the following structure:
-```bash
-.com
-|--- questions
-|---|--- .md
-|---|--- .md
-|---|--- ...
-|--- answers
-|---|--- .md
-|---|--- .md
-|---|--- ...
-.com
-|--- questions
-|---|--- .md
-|---|--- .md
-|---|--- ...
-|--- answers
-|---|--- .md
-|---|--- .md
-|---|--- ...
+
+* `ACCOUNT_ID`: the ID of the Stack Exchange account whose posts you want to back up.
+ Note that this is NOT the per-site user ID.
+ To acquire the `ACCOUNT_ID` of a user:
+
+ 1. Go to the user's profile page on one of the Stack Exchange network sites
+ and click on either the *View all* link next to *Communities*
+ or the *Network profile* link in the dropdown under *Profiles*.
+
+ 
+
+ 2. On the new web page that is just opened, note the URL segment after `users` consists of a number:
+ this is the `ACCOUNT_ID` of the user (1 in the case of Jeff Atwood).
+
+ 
+
+* `OUT_DIR`: the folder to download your files to.
+
+* `REQUEST_KEY`: a token that grants an increased download quota.
+ We provide a default request key only for your convenience.
+ As per this [FAQ](https://stackapps.com/q/67),
+ it is advisable that users [bring their own request keys](https://stackapps.com/apps/oauth/register).
+ To access the API without a request key, assign an empty string as the value to this option.
+
+* `RPS`: requests per second, a soft limit imposed on the running program.
+ It is stated [in no uncertain terms](https://api.stackexchange.com/docs/throttle) that
+ the Stack Exchange API considers 30+ requests per second per IP to be very abusive,
+ and will thus ban any rogue IP from making further requests to it for an indefinite period of time.
+ Due to the nature of floating-point arithmetic and the limitations of the current implementation,
+ do not assume it is an exact upper bound on the number of requests the program will make within any one-second period.
+
+## Output
+
+> [!WARNING]
+> A new output layout is underway.
+> This section will be updated when the design is finalized and pushed.
+
+### Directory Layout
+
+```console
+
++---
+| +---answers
+| | .md
+| | .md
+| | ...
+| |
+| \---questions
+| .md
+| .md
+| ...
+|
++---
+| +---answers
+| | .md
+| | .md
+| | ...
+| |
+| \---questions
+| .md
+| .md
+| ...
+|
...
```
-where
-* `` is the name for the `n`th SE site associated with a user.
-* `` is the question ID associated with `n`th question for the parent SE site.
-* `` is the question ID associated with the `n`th answer for the parent SE site.
-
-The `q_and_a` directory will contain Markdown files with the extension `.md`. Each Markdown
-file will represent either a question or an answer, depending on whether it is under a
-`questions` directory or an `answers` directory. If the Markdown file represents a
-question, then the question creator will be you. Otherwise, if the Markdown file
-represents an answer, the question creator will not be you, but the creator of one of
-the answers included in the Markdown file will be you. More specifically, each Markdown
-file will have the following format (text that is inside angle brackets, such as ``,
-represents text that will vary for each Markdown file):
+
+### File Layout
+
```markdown
Question downloaded from
-Question asked by on at .
+Question asked by on at .
Number of up votes:
Number of down votes:
-Score:
+Score:
+
#
+
-### Comment 1
-Comment made by on at .
-Comment score:
+
-
+### Comment
-...
+Comment made by on at .
+Comment score:
-### Comment n
-Comment made by on at .
-Comment score:
+
-
+
-## Answer 1
-Answer by on at .
-This the accepted answer.
-Number of up votes:
-Number of down votes:
-Score:
+## Answer
-
+Answer given by on at .
+This the accepted answer.
+Number of up votes:
+Number of down votes:
+Score:
-### Comment 1
-Comment made by on at .
-Comment score:
+
-
+
-...
+### Comment
-### Comment n
-Comment made by on at .
-Comment score:
+Comment made by on at .
+Comment score:
-
+
+```
-...
+### Omissions
-## Answer m
-Answer by on at .
-This the accepted answer.
-Number of up votes:
-Number of down votes:
-Score:
+| Item | Reason |
+|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Deleted posts | [The API does not provide a way to retrieve deleted posts](https://stackapps.com/q/1917), even when authenticated. |
+| Saves | When public favorites, also briefly known as bookmarks, got reworked into private saves, it was done without coordinated changes to the API, so [it became impossible to query a user's saves through the API](https://meta.stackexchange.com/q/382991). |
+| Area 51 posts | [Area 51 is not adequately supported in the API](https://stackapps.com/q/8726), and few people participated on this site. |
+| Articles | Being a part of collectives, articles have only been rolled out to Stack Overflow, and fewer than 200 articles have been [published](https://stackoverflow.com/collectives/articles) to date since release. Therefore, I have concluded it's not worth the effort to add support for backing up articles, despite them still being queryable through the `/users/{ids}/posts` endpoint after [`/articles` has been removed from the API](https://stackapps.com/a/10466). |
-
+## Related Projects
-### Comment 1
-Comment made by on at .
-Comment score:
+### [Stack Exchange API](https://api.stackexchange.com/)
-
+#### [mhdadk/stack-exchange-backup](https://github.com/mhdadk/stack-exchange-backup)
-...
+The original repository from which this fork is derived.
+I'd like to express my thanks to its author, Mahmoud Abdelkhalek,
+for his well-commented code expedited my process of grokking the Stack Exchange API, which,
+while conceptually simple, has its documentation of related topics,
+some insufficiently explained, and the numerous bugs scattered all over the place.
-### Comment n
-Comment made by on at .
-Comment score:
+#### [StackExchangeBackupLaravel](https://github.com/ryancwalsh/StackExchangeBackupLaravelPHP)
-
-```
+StackExchangeBackupLaravel allows exporting a somewhat complete data footprint of a user on the Stack Exchange network,
+but the output files are in JSON rather than Markdown, which are also zipped and uploaded to Amazon S3 by default.
+By contrast, Stack Exchange Backup is simple and straightforward:
+everything is downloaded to the local machine only, and installation is easier and documentation more thorough.
+
+### [Stack Exchange Data Explorer](https://data.stackexchange.com/)
-See the "Logic" section below for an overview of how the `main.py` file works.
+The Stack Exchange Data Explorer (SEDE) is an open source tool
+for running arbitrary queries against public data from the Stack Exchange network.
+There are ready-made queries to export your data to a
+[single HTML file](https://data.stackexchange.com/meta.stackexchange/query/758326)
+or a [CSV file](https://data.stackexchange.com/meta.stackexchange/query/1529864).
+Unfortunately, they are not the one-stop solution to output individual Markdown files as they were originally authored.
+Moreover, to use the SEDE service, you'd either have to log in or solve some CAPTCHAs first,
+and the data is only [refreshed weekly](https://data.stackexchange.com/help#faq),
+as opposed to the data returned by the API, which is [refreshed about once a minute](https://stackapps.com/a/3544).
-# Logic
+#### [Pippim Website](https://www.pippim.com/programs/stack.html)
-This section is intended for anyone interested in how the `main.py` file works, and is
-optional reading. The following steps are added as comments (as `#%% step X`) inside
-the `main.py` file to indicate which part of the file corresponds to which step below.
+This is a demo website that comes with a set of procedures and programs to help
+convert your Stack Exchange posts into a fancy GitHub Pages website.
-The `main.py` script proceeds as follows:
-1. Given a network user ID, obtain the names of all the SE sites associated with this
-user ID and the corresponding site ID associated with each site.
-2. Create the top-level directory `q_and_a`.
-3. For each SE site obtained in step 1:
+### [Stack Exchange Data Dump](https://stackoverflow.com/help/data-dumps)
- (a) Create the `questions` directory for this SE site.
+This is a quarterly dump of all user-contributed data on the Stack Exchange network.
+In an [announcement](https://meta.stackexchange.com/q/401324) made in July 2024,
+the data dumps will no longer be uploaded to the [Internet Archive](https://archive.org/details/stackexchange);
+instead, they will be provided from a section in the site user profile settings.
+Therefore, this method of backup has a few major downsides:
- (b) Get all questions associated with this user on this SE site.
+1. Being locked behind a login wall.
+2. Being incomplete, meaning the data dump you download
+ is only for the specific site from which you initiated the request.
+3. Being complete, meaning the download size may be humongous, and to get only your data,
+ you'd have to do some non-trivial parsing of the downloaded XML files yourself.
- (c) For each question associated with this user on this SE site, write the contents
- of the question, its comments, the answers, and their comments into a Markdown file
- using the format mentioned in the "Format" section above.
+#### [Stack Exchange data dump downloader and transformer](https://github.com/LunarWatcher/se-data-dump-transformer)
- (d) Create the `answers` directory for this SE site.
+Thankfully, this project exists to address some of the above pain points.
- (e) Get all answers associated with this user on this SE site.
+## Development
- (f) For each answer associated with this user on this SE site, get the ID of the
- question associated with the answer.
+My personal development process for this project is encoded in `release.ps1`,
+a polyglot script that is valid in both the Bourne shell and PowerShell.
+In addition to the dependencies specified in `pyproject.toml`, the script relies on the following utilities:
- (g) For each question ID obtained in step 3(f), get the corresponding question, and
- then write the contents of the question, its comments, the answers, including yours,
- and their comments into a Markdown file using the format mentioned in the
- "Format" section above.
+* [uv](https://github.com/astral-sh/uv)
+* [security-constraints](https://github.com/mam-dev/security-constraints)
+* [Pyright](https://github.com/microsoft/pyright)
-# Alternatives
+which need to be installed and configured separately as instructed in the comments therein.
-There are alternative ways of downloading all your questions and answers from each SE
-site:
+To help you in your experimentation with the Stack Exchange API through the documentation web pages,
+I have compiled a list of the parameter types and their associated icons as follows:
-## `stackapi`
+* : Strings
+* :
+ [Numbers](https://api.stackexchange.com/docs/numbers)
+* :
+ [Dates](https://api.stackexchange.com/docs/dates)
+* :
+ [Lists](https://api.stackexchange.com/docs/vectors)
+* :
+ [Keys](https://api.stackexchange.com/docs/authentication)
+* :
+ [Access Tokens](https://api.stackexchange.com/docs/authentication)
-There exists a Python API for the SE API called [`stackapi`](https://github.com/AWegnerGitHub/stackapi)
-that is built on top of the `requests` package. Although this API provides a nice
-interface to the SE API, my goal here was to use as few dependencies as possible to
-lower the risk of obscelesence later on.
+Except for numbers and dates, the icons are not explained anywhere in the documentation,
+but if you open the inspector in your web browser,
+say when you're on [this page](https://api.stackexchange.com/docs/edit-question),
+and check the `` nodes enclosing the icons you're interested in learning about,
+you'll find that the parameter types are named in the `class` attributes, as `string-type`, `number-type`, etc.
-## Stack Exchange data explorer
+## Support
-The [SE data explorer](https://data.stackexchange.com/) provides another way of obtaining
-a copy of all your questions and answers across all SE sites, via [this query](https://data.stackexchange.com/stackoverflow/query/1811712/all-my-posts-on-the-se-network-with-markdown-and-html-content-plus-editors-and-s) for example. However,
-this query only returns a CSV file, from which the relevant content will need to be
-parsed and then written to Markdown files. Additionally, I am personally not familiar
-with SQL, so I preferred the approach used in the `main.py` file.
+It is my policy to strive to support, within reason,
+all [non-end-of-life, stable releases](https://devguide.python.org/versions/#status-key) of Python,
+as well as all prominent, up-to-date Python implementations, namely CPython, PyPy and GraalPy.
+If you are a Windows or macOS user, do note that official binaries are not provided for the security releases.
+Thereby, I encourage you to instead install it through one of the following channels
+to benefit from the continuing security fixes:
+
+* [Miniconda](https://docs.anaconda.com/miniconda/)
+* [Miniforge](https://github.com/conda-forge/miniforge)
+* [Micromamba](https://github.com/mamba-org/mamba#micromamba)
+* [Pixi](https://github.com/prefix-dev/pixi)
diff --git a/assets/account_id.png b/assets/account_id.png
new file mode 100644
index 0000000000000000000000000000000000000000..b64a07dc82916e10536e9cb86cb98b4be2e92d27
GIT binary patch
literal 42250
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
| 
|
-| --- | --- |
-| 
| 
|
-
-Download all of your questions and answers as Markdown files from all Stack Exchange (SE) sites using a Python script and the [SE API](https://api.stackexchange.com/).
-
-# Getting started
-
-To get started, make sure that Python version 3.11.7 or newer is installed. Then, run the
-following commands (note that these commands were tested in Powershell, and so only one of these commands will need to be translated for use in bash, zsh, etc.):
-```bash
-git clone https://github.com/mhdadk/stack-exchange-backup.git
-cd stack-exchange-backup
-# create a virtual environment
-python -m venv .venv
-# activate the virtual environment. This command should be translated when using bash
-.venv\Scripts\activate
-python -m pip install "requests==2.31.0"
-```
-Finally, determine your SE network user ID by doing the following:
+Download all your posts on the Stack Exchange network as Markdown files
+via a Python script talking to the Stack Exchange API.
+
+## Showcase
+
+
+
+
+## Installation
+
+1. Either download the repository as a ZIP file and extract it,
+ or [install Git](https://git-scm.com/downloads) (recommended) and do a `git clone` of the project.
+
+ ```shell
+ git clone https://github.com/9ao9ai9ar/stack-exchange-backup.git
+ ```
+
+2. [Install Python 3.12 or newer](https://www.python.org/downloads/).
+ See the [support section](#support) for additional information.
+
+3. Enter the directory you just extracted/cloned.
+
+ ```shell
+ cd stack-exchange-backup
+ ```
+
+ All steps hereafter assume operations under said directory.
+
+4. Create and activate a virtual environment (strongly recommended).
+
+ * Windows:
+
+ ```shell
+ py -3 -m venv .venv
+ .\.venv\Scripts\activate
+ ```
+
+ * macOS/Linux:
+
+ ```shell
+ python3 -m venv .venv
+ . .venv/bin/activate
+ ```
-1. Go to https://stackexchange.com/.
-2. Log in to your SE account.
-3. Click on your profile picture on the top-right, as indicated by the red arrow in the screenshot below.
-
-4. Go to the address bar in your browser, and the address should be in the form `https://stackexchange.com/users/