Initial project structure

.gitignore

@@ -0,0 +1,93 @@
+# 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/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.env
+.venv/
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs and editors
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.ropeproject/
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Testing
+.coverage
+.pytest_cache/
+.tox/
+.nox/
+htmlcov/
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Logs
+*.log
+
+# Database
+*.db
+*.sqlite3
+
+# Temporary files
+*.tmp
+*.temp
+
+# Local tooling
+.extractrc

.python-version

@@ -0,0 +1 @@
+3.12

README.md

@@ -0,0 +1,59 @@
+# Demo Application
+
+A Python project for coding exercises and development.
+
+## Setup for Development
+
+This is the standard setup for working on this project. It will install the application and all the necessary development tools (pytest, black, etc.).
+
+1. **Create the virtual environment:**
+   ```bash
+   uv venv
+   ```
+
+2. **Install the project in editable mode with development dependencies:**
+   ```bash
+   uv pip install -e ".[dev]"
+   ```
+   This command installs the project, all development tools (like pytest and black), and creates the demo-app command-line script.
+
+
+## Running the Application
+
+After setup, run the application using its console script entry point. This is the standard way to run the app and avoids any warnings.
+
+```bash
+uv run demo-app
+```
+
+## Development Tools
+
+After setting up for development, you can use the following tools.
+
+**Run Tests:**
+```bash
+uv run pytest
+```
+
+**Format Code:**
+```bash
+uv run black .
+```
+
+**Lint Code:**
+```bash
+uv run ruff check .
+```
+
+**Type Checking:**
+```bash
+uv run mypy src/
+```
+
+## Project Structure
+
+```
+src/demo_application/    # Main package
+tests/                   # Test files
+pyproject.toml          # Project configuration
+```

pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "demo_application"
+version = "0.1.0"
+description = "Demo application for technical interview"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "setuptools>=80.9.0",
+]
+
+[project.scripts]
+demo-app = "demo_application.main:main"
+
+[project.optional-dependencies]
+dev = [
+    "black>=25.1.0",
+    "mypy>=1.16.1",
+    "pytest>=8.4.1",
+    "ruff>=0.12.2",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-dir]
+"" = "src"

src/demo_application/__init__.py

@@ -0,0 +1,3 @@
+from .main import main
+
+__all__ = ["main"]

src/demo_application/main.py

@@ -0,0 +1,6 @@
+def main():
+    print("Hello from demo application!")
+
+
+if __name__ == "__main__":
+    main()

tests/test_main.py

@@ -0,0 +1,12 @@
+from demo_application.main import main
+import sys
+from io import StringIO
+
+
+def test_main():
+    """Test that main() prints the expected message."""
+    captured_output = StringIO()
+    sys.stdout = captured_output
+    main()
+    sys.stdout = sys.__stdout__
+    assert "Hello from demo application!" in captured_output.getvalue()