feels 0.1.0__tar.gz

feels-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gabriel Pereira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

feels-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include MANIFEST.in
+recursive-include tests *.py

feels-0.1.0/PKG-INFO

@@ -0,0 +1,296 @@
+Metadata-Version: 2.4
+Name: feels
+Version: 0.1.0
+Summary: A local-first CLI mood tracker for developers
+Author-email: Gabriel Pereira <gabriel@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/gabrielpereira/feels
+Project-URL: Bug Tracker, https://github.com/gabrielpereira/feels/issues
+Project-URL: Documentation, https://github.com/gabrielpereira/feels#readme
+Project-URL: Source Code, https://github.com/gabrielpereira/feels
+Keywords: mood,tracker,cli,mental-health,journal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Dynamic: license-file
+
+# feels
+
+A local-first CLI mood tracker for developers. Log how you're feeling, track focus and stress, organize by project, all from your terminal.
+
+**All data stays on your machine.** No cloud. No accounts. No tracking.
+
+## Installation
+
+```bash
+# From PyPI (when published)
+pip install feels
+
+# From source
+git clone https://github.com/gabrielpereira/feels.git
+cd feels
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# First run — interactive setup
+feels
+
+# Log an entry (interactive prompts)
+feels add
+
+# View logs (last 7 days by default)
+feels logs
+
+# View all logs
+feels logs --all
+
+# See all commands
+feels help
+```
+
+## Commands
+
+### Logging
+- **`feels add`** — Log a new entry with mood (0–5), optional focus/stress scores, tags, and a note
+- **`feels logs`** — View logs grouped by day
+  - `--all` — Show all logs ever
+  - `--oldest` — Reverse sort (oldest first)
+  - `--from YYYY-MM-DD` — Start date
+  - `--to YYYY-MM-DD` — End date
+  - `--project <name>` — Filter by project
+- **`feels edit <id>`** — Edit an existing log entry
+- **`feels delete <id>`** — Delete a log entry (with confirmation)
+
+### Organization
+- **`feels config`** — Update settings (enable/disable focus, stress, projects, tags, notes)
+- **`feels project add <name>`** — Manually add a project (or projects auto-create during `feels add`)
+- **`feels project list`** — Show all projects
+- **`feels project delete <name>`** — Remove a project
+
+### Insights & Data
+- **`feels stats`** — View statistics
+  - Overall: total logs, average mood, best/worst mood
+  - Optional: focus and stress averages (if enabled)
+  - Last 7 days: logs this week and weekly average
+- **`feels export`** — Export logs as JSON or CSV
+  - `--format json` — JSON format (full details)
+  - `--format csv` — CSV format (spreadsheet-friendly)
+- **`feels reset`** — Delete all data (logs, projects, settings) with double confirmation
+
+### Help & Home
+- **`feels help`** — Show all available commands
+- **`feels`** — Show home screen with quick stats and command list
+
+## Features
+
+✅ **Log mood entries** with optional focus and stress scores (0–5)
+✅ **Add tags and notes** to logs for context
+✅ **Organize by project** (optional) to keep work separated
+✅ **View logs grouped by day** with flexible filtering
+✅ **Edit & delete** entries anytime
+✅ **Home dashboard** showing total logs, current streak, last 7-days average
+✅ **Statistics** — overall and weekly mood/focus/stress analysis
+✅ **Export data** as JSON (full) or CSV (spreadsheet)
+✅ **Local storage only** — everything at `~/.feels/`, completely private
+✅ **Comprehensive tests** — 23 tests covering core functionality
+✅ **Robust error handling** — validates input and reports clear errors
+
+## Configuration
+
+Settings are interactive. On first run, choose your defaults:
+- **Mood score** — always enabled (required)
+- **Focus score** — optional (enable/disable anytime)
+- **Stress score** — optional (enable/disable anytime)
+- **Projects** — optional (organize logs by project; projects auto-create during logging)
+- **Tags** — enabled by default (enable/disable anytime)
+- **Notes** — enabled by default (enable/disable anytime)
+
+Run **`feels config`** anytime to revisit and change these settings.
+
+### Projects
+
+When projects are enabled, you can create them on-the-fly while logging:
+
+```bash
+$ feels add
+  Project (last_project): new-project    # Type any project name
+  Mood: 4
+  ✓ Logged 4/5 mood #1
+
+# Next time, new-project is remembered as default
+$ feels add
+  Project (new-project):                 # Press Enter to use it again
+  Mood: 5
+  ✓ Logged 5/5 mood #2
+
+# Or override anytime
+$ feels add
+  Project (new-project): another-one     # New project auto-created
+  Mood: 3
+  ✓ Logged 3/5 mood #3
+```
+
+You can also manage projects with `feels project` commands.
+
+## Data Storage
+
+All your data lives locally:
+- `~/.feels/config.json` — your configuration
+- `~/.feels/data.db` — your log entries (SQLite database)
+
+**No internet required.** No servers. No tracking. No data leaves your machine.
+
+## Examples
+
+### Log your first entry
+```bash
+$ feels add
+  Project: work
+  Mood (0–5): 4
+  Focus (0–5): 3
+  Stress (0–5): 2
+  Tags: #meetings #productive
+  Note: Good progress on the project
+
+✓ Logged 4/5 mood #1
+```
+
+### View logs from the last week
+```bash
+$ feels logs
+──────────────────── March 25, 2026 ────────────────────
+#1  ·  14:30  ·  work
+4/5  3/5 focus  2/5 stress  #meetings  #productive
+Good progress on the project
+```
+
+### View statistics
+```bash
+$ feels stats
+
+Overall
+   total logs          42
+   avg mood            3.8/5
+   best               5/5
+   worst              1/5
+
+Focus
+   avg                3.5/5
+   best               5/5
+   worst              1/5
+
+Last 7 days
+   logs this week     12
+   avg mood           4.1/5
+```
+
+### Export your logs
+```bash
+$ feels export --format json
+✓ Exported 42 logs to feels_20260325_170013.json
+
+$ feels export --format csv
+✓ Exported 42 logs to feels_20260325_170014.csv
+```
+
+### Reset all data
+```bash
+$ feels reset
+This will delete all your logs, projects, and settings.
+Are you sure? [y/n] (n): y
+
+THIS ACTION CANNOT BE UNDONE. ALL DATA WILL BE PERMANENTLY DELETED. ARE YOU SURE? [y/n] (n): y
+
+✓ All data deleted. Run feels to start fresh.
+```
+
+## Development
+
+### Running Tests
+
+```bash
+# Install test dependencies
+pip install -e ".[test]"
+
+# Run all tests
+pytest tests/ -v
+
+# Run with coverage
+pytest tests/ --cov=src/feels --cov-report=html
+```
+
+Current test coverage:
+- **100%** config module
+- **84%** database module
+- **85%** utils module
+- **21%** overall
+
+### Project Structure
+
+```
+feels/
+├── src/feels/
+│   ├── cli.py           # CLI entry point and argument routing
+│   ├── config.py        # Configuration management
+│   ├── database.py      # SQLite database operations
+│   ├── utils.py         # Shared utilities (colors, formatting)
+│   ├── validation.py    # Input validation
+│   ├── add.py           # Log entry command
+│   ├── logs.py          # View logs command
+│   ├── edit.py          # Edit log command
+│   ├── delete.py        # Delete log command
+│   ├── config_cmd.py    # Settings command (mood, focus, stress, projects, tags, notes)
+│   ├── project_cmd.py   # Project management command
+│   ├── stats_cmd.py     # Statistics command (overall, weekly, optional scores)
+│   ├── export_cmd.py    # Export command (JSON, CSV)
+│   ├── reset_cmd.py     # Reset command (delete all data with confirmation)
+│   ├── help_cmd.py      # Help command
+│   ├── home.py          # Home screen display
+│   └── onboarding.py    # First-run setup
+├── tests/               # Test suite
+├── pyproject.toml       # Package configuration
+└── README.md            # This file
+```
+
+## Roadmap
+
+- [ ] Theme customization (light/dark, custom colors)
+- [ ] Mood trends over time
+- [ ] Daily/weekly/monthly summaries
+- [ ] Best/worst times of day analysis
+- [ ] Export to other formats (PDF, Excel)
+- [ ] Data import from CSV
+- [ ] Cloud sync option (optional, default local)
+- [ ] Plugin system for custom commands
+
+## License
+
+MIT License — see LICENSE file for details.
+
+## Contributing
+
+Contributions welcome! Feel free to open issues or submit PRs.

feels-0.1.0/README.md

@@ -0,0 +1,259 @@
+# feels
+
+A local-first CLI mood tracker for developers. Log how you're feeling, track focus and stress, organize by project, all from your terminal.
+
+**All data stays on your machine.** No cloud. No accounts. No tracking.
+
+## Installation
+
+```bash
+# From PyPI (when published)
+pip install feels
+
+# From source
+git clone https://github.com/gabrielpereira/feels.git
+cd feels
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# First run — interactive setup
+feels
+
+# Log an entry (interactive prompts)
+feels add
+
+# View logs (last 7 days by default)
+feels logs
+
+# View all logs
+feels logs --all
+
+# See all commands
+feels help
+```
+
+## Commands
+
+### Logging
+- **`feels add`** — Log a new entry with mood (0–5), optional focus/stress scores, tags, and a note
+- **`feels logs`** — View logs grouped by day
+  - `--all` — Show all logs ever
+  - `--oldest` — Reverse sort (oldest first)
+  - `--from YYYY-MM-DD` — Start date
+  - `--to YYYY-MM-DD` — End date
+  - `--project <name>` — Filter by project
+- **`feels edit <id>`** — Edit an existing log entry
+- **`feels delete <id>`** — Delete a log entry (with confirmation)
+
+### Organization
+- **`feels config`** — Update settings (enable/disable focus, stress, projects, tags, notes)
+- **`feels project add <name>`** — Manually add a project (or projects auto-create during `feels add`)
+- **`feels project list`** — Show all projects
+- **`feels project delete <name>`** — Remove a project
+
+### Insights & Data
+- **`feels stats`** — View statistics
+  - Overall: total logs, average mood, best/worst mood
+  - Optional: focus and stress averages (if enabled)
+  - Last 7 days: logs this week and weekly average
+- **`feels export`** — Export logs as JSON or CSV
+  - `--format json` — JSON format (full details)
+  - `--format csv` — CSV format (spreadsheet-friendly)
+- **`feels reset`** — Delete all data (logs, projects, settings) with double confirmation
+
+### Help & Home
+- **`feels help`** — Show all available commands
+- **`feels`** — Show home screen with quick stats and command list
+
+## Features
+
+✅ **Log mood entries** with optional focus and stress scores (0–5)
+✅ **Add tags and notes** to logs for context
+✅ **Organize by project** (optional) to keep work separated
+✅ **View logs grouped by day** with flexible filtering
+✅ **Edit & delete** entries anytime
+✅ **Home dashboard** showing total logs, current streak, last 7-days average
+✅ **Statistics** — overall and weekly mood/focus/stress analysis
+✅ **Export data** as JSON (full) or CSV (spreadsheet)
+✅ **Local storage only** — everything at `~/.feels/`, completely private
+✅ **Comprehensive tests** — 23 tests covering core functionality
+✅ **Robust error handling** — validates input and reports clear errors
+
+## Configuration
+
+Settings are interactive. On first run, choose your defaults:
+- **Mood score** — always enabled (required)
+- **Focus score** — optional (enable/disable anytime)
+- **Stress score** — optional (enable/disable anytime)
+- **Projects** — optional (organize logs by project; projects auto-create during logging)
+- **Tags** — enabled by default (enable/disable anytime)
+- **Notes** — enabled by default (enable/disable anytime)
+
+Run **`feels config`** anytime to revisit and change these settings.
+
+### Projects
+
+When projects are enabled, you can create them on-the-fly while logging:
+
+```bash
+$ feels add
+  Project (last_project): new-project    # Type any project name
+  Mood: 4
+  ✓ Logged 4/5 mood #1
+
+# Next time, new-project is remembered as default
+$ feels add
+  Project (new-project):                 # Press Enter to use it again
+  Mood: 5
+  ✓ Logged 5/5 mood #2
+
+# Or override anytime
+$ feels add
+  Project (new-project): another-one     # New project auto-created
+  Mood: 3
+  ✓ Logged 3/5 mood #3
+```
+
+You can also manage projects with `feels project` commands.
+
+## Data Storage
+
+All your data lives locally:
+- `~/.feels/config.json` — your configuration
+- `~/.feels/data.db` — your log entries (SQLite database)
+
+**No internet required.** No servers. No tracking. No data leaves your machine.
+
+## Examples
+
+### Log your first entry
+```bash
+$ feels add
+  Project: work
+  Mood (0–5): 4
+  Focus (0–5): 3
+  Stress (0–5): 2
+  Tags: #meetings #productive
+  Note: Good progress on the project
+
+✓ Logged 4/5 mood #1
+```
+
+### View logs from the last week
+```bash
+$ feels logs
+──────────────────── March 25, 2026 ────────────────────
+#1  ·  14:30  ·  work
+4/5  3/5 focus  2/5 stress  #meetings  #productive
+Good progress on the project
+```
+
+### View statistics
+```bash
+$ feels stats
+
+Overall
+   total logs          42
+   avg mood            3.8/5
+   best               5/5
+   worst              1/5
+
+Focus
+   avg                3.5/5
+   best               5/5
+   worst              1/5
+
+Last 7 days
+   logs this week     12
+   avg mood           4.1/5
+```
+
+### Export your logs
+```bash
+$ feels export --format json
+✓ Exported 42 logs to feels_20260325_170013.json
+
+$ feels export --format csv
+✓ Exported 42 logs to feels_20260325_170014.csv
+```
+
+### Reset all data
+```bash
+$ feels reset
+This will delete all your logs, projects, and settings.
+Are you sure? [y/n] (n): y
+
+THIS ACTION CANNOT BE UNDONE. ALL DATA WILL BE PERMANENTLY DELETED. ARE YOU SURE? [y/n] (n): y
+
+✓ All data deleted. Run feels to start fresh.
+```
+
+## Development
+
+### Running Tests
+
+```bash
+# Install test dependencies
+pip install -e ".[test]"
+
+# Run all tests
+pytest tests/ -v
+
+# Run with coverage
+pytest tests/ --cov=src/feels --cov-report=html
+```
+
+Current test coverage:
+- **100%** config module
+- **84%** database module
+- **85%** utils module
+- **21%** overall
+
+### Project Structure
+
+```
+feels/
+├── src/feels/
+│   ├── cli.py           # CLI entry point and argument routing
+│   ├── config.py        # Configuration management
+│   ├── database.py      # SQLite database operations
+│   ├── utils.py         # Shared utilities (colors, formatting)
+│   ├── validation.py    # Input validation
+│   ├── add.py           # Log entry command
+│   ├── logs.py          # View logs command
+│   ├── edit.py          # Edit log command
+│   ├── delete.py        # Delete log command
+│   ├── config_cmd.py    # Settings command (mood, focus, stress, projects, tags, notes)
+│   ├── project_cmd.py   # Project management command
+│   ├── stats_cmd.py     # Statistics command (overall, weekly, optional scores)
+│   ├── export_cmd.py    # Export command (JSON, CSV)
+│   ├── reset_cmd.py     # Reset command (delete all data with confirmation)
+│   ├── help_cmd.py      # Help command
+│   ├── home.py          # Home screen display
+│   └── onboarding.py    # First-run setup
+├── tests/               # Test suite
+├── pyproject.toml       # Package configuration
+└── README.md            # This file
+```
+
+## Roadmap
+
+- [ ] Theme customization (light/dark, custom colors)
+- [ ] Mood trends over time
+- [ ] Daily/weekly/monthly summaries
+- [ ] Best/worst times of day analysis
+- [ ] Export to other formats (PDF, Excel)
+- [ ] Data import from CSV
+- [ ] Cloud sync option (optional, default local)
+- [ ] Plugin system for custom commands
+
+## License
+
+MIT License — see LICENSE file for details.
+
+## Contributing
+
+Contributions welcome! Feel free to open issues or submit PRs.

feels-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "feels"
+version = "0.1.0"
+description = "A local-first CLI mood tracker for developers"
+authors = [{name = "Gabriel Pereira", email = "gabriel@example.com"}]
+license = {text = "MIT"}
+readme = "README.md"
+requires-python = ">=3.10"
+keywords = ["mood", "tracker", "cli", "mental-health", "journal"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "rich>=13.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[project.urls]
+"Homepage" = "https://github.com/gabrielpereira/feels"
+"Bug Tracker" = "https://github.com/gabrielpereira/feels/issues"
+"Documentation" = "https://github.com/gabrielpereira/feels#readme"
+"Source Code" = "https://github.com/gabrielpereira/feels"
+
+[project.optional-dependencies]
+test = ["pytest>=7.0", "pytest-cov>=4.0"]
+dev = ["pytest>=7.0", "pytest-cov>=4.0", "black", "ruff"]
+
+[project.scripts]
+feels = "feels.cli:main"
+fls = "feels.cli:main"

feels-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+