whatdidyoudo 0.1.0__tar.gz

whatdidyoudo-0.1.0/.github/copilot-instructions.md

@@ -0,0 +1,63 @@
+<!-- Use this file to provide workspace-specific custom instructions to Copilot. For more details, visit https://code.visualstudio.com/docs/copilot/copilot-customization#_use-a-githubcopilotinstructionsmd-file -->
+- [x] Verify that the copilot-instructions.md file in the .github directory is created.
+
+- [ ] Clarify Project Requirements
+- [ ] Scaffold the Project
+- [ ] Customize the Project
+- [ ] Install Required Extensions
+- [ ] Compile the Project
+- [ ] Create and Run Task
+- [ ] Launch the Project
+- [ ] Ensure Documentation is Complete
+
+<!--
+## Execution Guidelines
+PROGRESS TRACKING:
+- If any tools are available to manage the above todo list, use it to track progress through this checklist.
+- After completing each step, mark it complete and add a summary.
+- Read current todo list status before starting each new step.
+
+COMMUNICATION RULES:
+- Avoid verbose explanations or printing full command outputs.
+- If a step is skipped, state that briefly (e.g. "No extensions needed").
+- Do not explain project structure unless asked.
+- Keep explanations concise and focused.
+
+DEVELOPMENT RULES:
+- Use '.' as the working directory unless user specifies otherwise.
+- Avoid adding media or external links unless explicitly requested.
+- Use placeholders only with a note that they should be replaced.
+- Use VS Code API tool only for VS Code extension projects.
+- Once the project is created, it is already opened in Visual Studio Code—do not suggest commands to open this project in Visual Studio again.
+- If the project setup information has additional rules, follow them strictly.
+
+FOLDER CREATION RULES:
+- Always use the current directory as the project root.
+- If you are running any terminal commands, use the '.' argument to ensure that the current working directory is used ALWAYS.
+- Do not create a new folder unless the user explicitly requests it besides a .vscode folder for a tasks.json file.
+- If any of the scaffolding commands mention that the folder name is not correct, let the user know to create a new folder with the correct name and then reopen it again in vscode.
+
+EXTENSION INSTALLATION RULES:
+- Only install extension specified by the get_project_setup_info tool. DO NOT INSTALL any other extensions.
+
+PROJECT CONTENT RULES:
+- If the user has not specified project details, assume they want a "Hello World" project as a starting point.
+- Avoid adding links of any type (URLs, files, folders, etc.) or integrations that are not explicitly required.
+- Avoid generating images, videos, or any other media files unless explicitly requested.
+- If you need to use any media assets as placeholders, let the user know that these are placeholders and should be replaced with the actual assets later.
+- Ensure all generated components serve a clear purpose within the user's requested workflow.
+- If a feature is assumed but not confirmed, prompt the user for clarification before including it.
+- If you are working on a VS Code extension, use the VS Code API tool with a query to find relevant VS Code API references and samples related to that query.
+
+TASK COMPLETION RULES:
+- Your task is complete when:
+  - Project is successfully scaffolded and compiled without errors
+  - copilot-instructions.md file in the .github directory exists in the project
+  - README.md file exists and is up to date
+  - User is provided with clear instructions to debug/launch the project
+
+Before starting a new task in the above plan, update progress in the plan.
+-->
+- Work through each checklist item systematically.
+- Keep communication concise and focused.
+- Follow development best practices.

whatdidyoudo-0.1.0/.gitignore

@@ -0,0 +1,134 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+debug.log
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+.dmypy-working/
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# VS Code
+.vscode/

whatdidyoudo-0.1.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: whatdidyoudo
+Version: 0.1.0
+Summary: A minimal Flask app that shows the amount of OpenStreetMap changes made by a user on a day.
+Author-email: Ulf Rompe <whatdidyoudo.rompe.org@rompe.org>
+License: MIT
+Requires-Python: >=3.11
+Requires-Dist: flask-caching==2.3.1
+Requires-Dist: flask>=3.0.3
+Requires-Dist: requests>=2.32.4
+Provides-Extra: dev
+Requires-Dist: hatchling>=1.27.0; extra == 'dev'
+Requires-Dist: ruff>=0.13.2; extra == 'dev'
+Requires-Dist: twine>=6.2.0; extra == 'dev'
+Requires-Dist: types-requests>=2.32.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# whatdidyoudo
+
+A minimal Flask app that shows the amount of OpenStreetMap changes made by a user on a day.
+
+## Background
+
+I often ask myself after contributing many changes to OpenStreetMap, either by walking around
+while extensively using StreetComplete, MapComplete or Vespucci, or by doing some tasks in iD or
+jOSM: **How many changes did I contribute to the map today?**
+
+I'm not the only one. I heard questions like this quite a few times:
+**Where can I see how much I did on yesterday's mapwalk?**
+
+Because I think that simple questions deserve simple answers, I made this tool to give exactly
+this information and nothing else.
+
+You don't need to self-host it, it is available for anyone at
+[whatdidyoudo.rompe.org](https://whatdidyoudo.rompe.org).
+
+## Setup
+
+Fun fact: of course you don't really need *uv* for this. I'm just using this project to
+get used to it as I think it has a lot of potential.
+
+1. Install [uv](https://github.com/astral-sh/uv) if needed:
+
+   ```sh
+   pip install uv
+   ```
+
+2. Install dependencies using *uv*:
+
+   ```sh
+   uv pip install -r pyproject.toml
+   ```
+
+   If you want to develop:
+
+   ```sh
+   uv pip install -r pyproject.toml --extra dev
+   ```
+
+3. Run the app in test mode:
+
+   ```sh
+   python run_test.py
+   ```
+
+   Visit [http://127.0.0.1:5000/](http://127.0.0.1:5000/) in your browser to see "hello world".
+
+4. Build a package and upload it to Pypi
+
+   ```sh
+   uv hatchling build
+   uv twine upload dist/*
+   ```
+
+## License
+
+This project is licensed under the MIT License. See the `pyproject.toml` for details.

whatdidyoudo-0.1.0/README.md

@@ -0,0 +1,60 @@
+# whatdidyoudo
+
+A minimal Flask app that shows the amount of OpenStreetMap changes made by a user on a day.
+
+## Background
+
+I often ask myself after contributing many changes to OpenStreetMap, either by walking around
+while extensively using StreetComplete, MapComplete or Vespucci, or by doing some tasks in iD or
+jOSM: **How many changes did I contribute to the map today?**
+
+I'm not the only one. I heard questions like this quite a few times:
+**Where can I see how much I did on yesterday's mapwalk?**
+
+Because I think that simple questions deserve simple answers, I made this tool to give exactly
+this information and nothing else.
+
+You don't need to self-host it, it is available for anyone at
+[whatdidyoudo.rompe.org](https://whatdidyoudo.rompe.org).
+
+## Setup
+
+Fun fact: of course you don't really need *uv* for this. I'm just using this project to
+get used to it as I think it has a lot of potential.
+
+1. Install [uv](https://github.com/astral-sh/uv) if needed:
+
+   ```sh
+   pip install uv
+   ```
+
+2. Install dependencies using *uv*:
+
+   ```sh
+   uv pip install -r pyproject.toml
+   ```
+
+   If you want to develop:
+
+   ```sh
+   uv pip install -r pyproject.toml --extra dev
+   ```
+
+3. Run the app in test mode:
+
+   ```sh
+   python run_test.py
+   ```
+
+   Visit [http://127.0.0.1:5000/](http://127.0.0.1:5000/) in your browser to see "hello world".
+
+4. Build a package and upload it to Pypi
+
+   ```sh
+   uv hatchling build
+   uv twine upload dist/*
+   ```
+
+## License
+
+This project is licensed under the MIT License. See the `pyproject.toml` for details.

whatdidyoudo-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "whatdidyoudo"
+version = "0.1.0"
+description = "A minimal Flask app that shows the amount of OpenStreetMap changes made by a user on a day."
+authors = [
+    { name = "Ulf Rompe", email = "whatdidyoudo.rompe.org@rompe.org" }
+]
+license = { text = "MIT" }
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "Flask>=3.0.3",
+    "flask-caching==2.3.1",
+    "requests>=2.32.4",
+]
+
+[project.optional-dependencies]
+dev = [
+    "Ruff>=0.13.2",
+    "types-requests>=2.32.4",
+    "hatchling>=1.27.0",
+    "twine>=6.2.0",
+]
+
+[tool.uv]
+# uv-specific settings go here
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"

whatdidyoudo-0.1.0/run_test.py

@@ -0,0 +1,8 @@
+import os
+from whatdidyoudo.app import app
+
+def run():
+    app.run(debug=True)
+
+if __name__ == "__main__":
+    run()

whatdidyoudo-0.1.0/whatdidyoudo/app.py

@@ -0,0 +1,84 @@
+"""A Flask app that shows OSM tasks done by a user on a specific day."""
+import datetime
+import xml.etree.ElementTree as ET
+from collections import defaultdict
+import requests
+
+from flask import Flask, render_template
+from flask_caching import Cache
+from flask_limiter import Limiter
+from flask_limiter.util import get_remote_address
+
+
+app = Flask(__name__)
+cache = Cache(app, config={"CACHE_TYPE": "SimpleCache",
+                           "CACHE_DEFAULT_TIMEOUT": 60 * 60 * 24 * 7})
+limiter = Limiter(app=app, key_func=get_remote_address)
+
+
+def get_etree_from_url(url: str) -> ET.Element:
+    """Fetches XML content from a URL and returns the root Element."""
+    response = requests.get(url, timeout=120)
+    response.raise_for_status()  # Raise an error for bad responses
+    return ET.fromstring(response.content)
+
+
+def get_changes(user: str, date: str):
+    """Return a {app: num of changes} dictionary and the changesets amount."""
+    changes: defaultdict[str, int] = defaultdict(int)
+    changesets = 0
+    datetime_date = datetime.date.fromisoformat(date)
+    start_time = f"{datetime_date}T00:00:00Z"
+    end_time = f"{datetime_date + datetime.timedelta(days=1)}T00:00:00Z"
+
+    changeset_url = ("https://api.openstreetmap.org/api/0.6/changesets?"
+                     f"display_name={user}&time={start_time},{end_time}")
+    root = get_etree_from_url(url=changeset_url)
+
+    for cs in root.findall("changeset"):
+        cs_id = cs.attrib["id"]
+
+        tags = {tag.attrib["k"]: tag.attrib["v"] for tag in cs.findall("tag")}
+        editor = tags.get("created_by", "")
+        changesets += 1
+
+        diff_url = ("https://api.openstreetmap.org/api/0.6/changeset/"
+                    f"{cs_id}/download")
+        try:
+            root = get_etree_from_url(url=diff_url)
+        except requests.HTTPError:
+            continue
+
+        for action in root:
+            changes[editor] += len(action)
+    return changes, changesets
+
+
+@app.route('/')
+@app.route('/<user>')
+@app.route('/<user>/<date>')
+def whatdidyoudo(user: str | None = None, date: str | None = None) -> str:
+    """shows OSM tasks done by a user on a specific day."""
+    changes: defaultdict[str, int] = defaultdict(int)
+    changesets = 0
+    error = ""
+    if user and date:
+        try:
+            today = datetime.date.today().isoformat()
+            if date != today:
+                cache_key = f"changes_{user}_{date}"
+                cached = cache.get(cache_key)  # type: ignore
+                if cached:
+                    changes, changesets = cached
+                else:
+                    with limiter.limit("10 per minute"):
+                        changes, changesets = get_changes(user, date)
+                    cache.set(cache_key, (changes, changesets))  # type: ignore
+            else:
+                with limiter.limit("10 per minute"):
+                    changes, changesets = get_changes(user, date)
+        except requests.HTTPError:
+            error = f"Can't determine changes for user {user} on {date}."
+
+    return render_template('form.html', user=user, date=date, changes=changes,
+                           changesets=changesets, error=error)

whatdidyoudo-0.1.0/whatdidyoudo/static/style.css

@@ -0,0 +1,103 @@
+body {
+    font-family: 'Segoe UI', Arial, sans-serif;
+    background: linear-gradient(120deg, #232526 0%, #414345 100%);
+    color: #f3f3f3;
+    min-height: 100vh;
+    margin: 0;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+}
+
+.container {
+    background: rgba(30, 30, 30, 0.92);
+    border-radius: 16px;
+    box-shadow: 0 4px 24px rgba(0,0,0,0.3);
+    padding: 2em 2.5em 1.5em 2.5em;
+    margin-top: 2em;
+    max-width: 600px;
+    width: 100%;
+}
+
+.error {
+    background: #ff4d4f;
+    color: #fff;
+    padding: 0.7em 1em;
+    border-radius: 8px;
+    margin-bottom: 1em;
+    font-weight: 600;
+}
+
+form {
+    display: flex;
+    flex-direction: row;
+    align-items: flex-end;
+    gap: 1em;
+    width: 100%;
+}
+
+label {
+    display: none;
+}
+
+input[type="text"] {
+    flex: 2 1 200px;
+    padding: 0.7em 1em;
+    border-radius: 8px;
+    border: none;
+    font-size: 1.1em;
+    background: #2c2f34;
+    color: #f3f3f3;
+    outline: none;
+}
+
+input[type="date"] {
+    flex: 1 1 120px;
+    padding: 0.7em 0.5em;
+    border-radius: 8px;
+    border: none;
+    font-size: 1.1em;
+    background: #2c2f34;
+    color: #f3f3f3;
+    outline: none;
+    min-width: 120px;
+    max-width: 160px;
+}
+
+button {
+    padding: 0.7em 1.5em;
+    border-radius: 8px;
+    border: none;
+    background: #4f8cff;
+    color: #fff;
+    font-size: 1.1em;
+    font-weight: 600;
+    cursor: pointer;
+    transition: background 0.2s;
+}
+button:hover {
+    background: #2563eb;
+}
+
+h2 a {
+    color: #f3f3f3;
+    text-decoration: none;
+    font-weight: 700;
+    letter-spacing: 1px;
+}
+
+@media (max-width: 600px) {
+    .container {
+        padding: 1em 0.5em;
+    }
+    form {
+        flex-direction: column;
+        gap: 0.7em;
+    }
+    input[type="date"] {
+        width: 100%;
+        min-width: unset;
+        max-width: unset;
+    }
+}

whatdidyoudo-0.1.0/whatdidyoudo/templates/form.html

@@ -0,0 +1,49 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <title>What Did You Do?</title>
+    <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}">
+    <script>
+    window.onload = function() {
+        var dateInput = document.getElementById('date');
+        if (!dateInput.value) {
+            var today = new Date();
+            var yyyy = today.getFullYear();
+            var mm = String(today.getMonth() + 1).padStart(2, '0');
+            var dd = String(today.getDate()).padStart(2, '0');
+            dateInput.value = yyyy + '-' + mm + '-' + dd;
+        }
+    };
+    </script>
+</head>
+<body>
+    <div class="container">
+        <h2><a href="/">What Did You Do?</a></h2>
+        <form method="get" action="" onsubmit="event.preventDefault(); window.location.href='/' + encodeURIComponent(document.getElementById('user').value) + '/' + encodeURIComponent(document.getElementById('date').value);">
+            <label for="user">User:</label>
+            <input type="text" id="user" name="user" value="{{ user or '' }}" placeholder="insert OSM username" required>
+
+            <label for="date">Date:</label>
+            <input type="date" id="date" name="date" value="{{ date or '' }}" required>
+
+            <button type="submit">Show</button>
+        </form>
+    </div>
+    {% if user and date %}
+        {% if error %}
+            <p class=error>{{ error }}</p>
+        {% elif changes %}
+            <p>{{ user }} did some changes on {{ date }}!</p>
+            {% for app, count in changes.items() %}
+            <ul>
+            <li>{{ count }} changes in {{ app }}</li>
+            </ul>
+            {% endfor %}
+            That's a total of {{ changesets }} changesets.
+        {% else %}
+            <p>{{ user }} did not do anything on {{ date }}.</p>
+        {% endif %}
+    {% endif %}
+</body>
+</html>