collect-framework-fox-task5 1.0.0__tar.gz

collect_framework_fox_task5-1.0.0/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(/tmp/test-install/bin/collect_framework:*)"
+    ]
+  }
+}

collect_framework_fox_task5-1.0.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+.pytest_cache/
+*.egg-info/
+dist/
+build/
+.venv/

collect_framework_fox_task5-1.0.0/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: collect-framework-fox-task5
+Version: 1.0.0
+Summary: Count unique characters in a string via CLI
+Requires-Python: >=3.8

collect_framework_fox_task5-1.0.0/README.md

@@ -0,0 +1,54 @@
+# collect_framework
+
+A CLI tool that counts unique characters (characters appearing exactly once) in a string or text file.
+
+## Installation
+
+```bash
+pip install .
+```
+
+For development (editable install):
+
+```bash
+pip install -e .
+```
+
+## Usage
+
+### Count unique characters in a string
+
+```bash
+python -m collect_framework --string "abbbccdf"
+```
+
+Output: `3` (characters `a`, `d`, `f` appear once)
+
+### Count unique characters in a file
+
+```bash
+python -m collect_framework --file path_to_text_file
+```
+
+### Both parameters
+
+If both `--string` and `--file` are provided, `--file` takes priority and the string is ignored:
+
+```bash
+python -m collect_framework --string "your string" --file path_to_text_file
+```
+
+### As an installed script
+
+After installation, the command is also available directly:
+
+```bash
+collect_framework --string "hello"
+```
+
+## Running Tests
+
+```bash
+pip install pytest
+python -m pytest tests/ -v
+```

collect_framework_fox_task5-1.0.0/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "collect-framework-fox-task5"
+version = "1.0.0"
+description = "Count unique characters in a string via CLI"
+requires-python = ">=3.8"
+
+[project.scripts]
+collect_framework = "collect_framework.__main__:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/collect_framework"]

collect_framework_fox_task5-1.0.0/src/collect_framework/__init__.py

@@ -0,0 +1,10 @@
+"""Count unique characters in a string."""
+
+from collections import Counter
+from functools import lru_cache
+
+
+@lru_cache
+def count_elements(string: str) -> int:
+    """Return the number of characters that appear exactly once."""
+    return sum(1 for count in Counter(string).values() if count == 1)

collect_framework_fox_task5-1.0.0/src/collect_framework/__main__.py

@@ -0,0 +1,43 @@
+"""CLI entry point for collect_framework."""
+
+import argparse
+
+from collect_framework import count_elements
+
+
+def create_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(description="Count unique characters.")
+    parser.add_argument("--string", nargs="+", help="Input string")
+    parser.add_argument(
+        "--file",
+        nargs="+",
+        help="Path to text file(s) (higher priority than --string)",
+    )
+    return parser
+
+
+def main(args=None):
+    parser = create_parser()
+    parsed = parser.parse_args(args)
+
+    if parsed.file:
+        parts = []
+        for filepath in parsed.file:
+            try:
+                with open(filepath, "r") as f:
+                    parts.append(f.read())
+            except FileNotFoundError:
+                parser.error(f"File not found: {filepath}")
+        text = "".join(parts)
+    elif parsed.string is not None:
+        text = " ".join(parsed.string)
+    else:
+        parser.error("Provide --string or --file")
+
+    result = count_elements(text)
+    print(result)
+    return result
+
+
+if __name__ == "__main__":
+    main()

collect_framework_fox_task5-1.0.0/tests/test_collect_framework.py

@@ -0,0 +1,117 @@
+"""Tests for collect_framework package."""
+
+import pytest
+from unittest.mock import patch, mock_open
+
+from collect_framework import count_elements
+from collect_framework.__main__ import main
+
+
+@pytest.mark.parametrize("input_str, expected", [
+    pytest.param("abbbccdf", 3, id="example_from_spec (a, d, f)"),
+    pytest.param("abcdef", 6, id="all_unique"),
+    pytest.param("aabbcc", 0, id="no_unique"),
+    pytest.param("a", 1, id="single_char"),
+    pytest.param("", 0, id="empty_string"),
+    pytest.param("aaaa", 0, id="all_same_char"),
+    pytest.param("AaBb", 4, id="mixed_case (A and a are different)"),
+    pytest.param("a b b", 1, id="spaces (a unique, space and b repeated)"),
+    pytest.param("112233", 0, id="digits_no_unique"),
+    pytest.param("12345", 5, id="digits_all_unique"),
+    pytest.param("café", 4, id="unicode (c, a, f, é all unique)"),
+    pytest.param("x", 1, id="single_x"),
+    pytest.param("xx", 0, id="double_x"),
+    pytest.param("abcabc", 0, id="repeated_pattern"),
+    pytest.param("abcabcd", 1, id="one_unique_in_pattern"),
+    pytest.param("aAbBcC", 6, id="mixed_case_all_unique"),
+    pytest.param("!@#!@#$", 1, id="special_chars_one_unique"),
+])
+def test_count_elements(input_str, expected):
+    assert count_elements(input_str) == expected
+
+
+class TestCaching:
+
+    def setup_method(self):
+        count_elements.cache_clear()
+
+    def test_cache_returns_same_result(self):
+        first_call = count_elements("abbbccdf")
+        second_call = count_elements("abbbccdf")
+        assert first_call == second_call
+
+    def test_cache_stats_show_hit(self):
+        count_elements("hello")
+        count_elements("hello")
+        info = count_elements.cache_info()
+        assert info.hits == 1
+        assert info.misses == 1
+
+    def test_different_strings_cached_separately(self):
+        count_elements("abc")
+        count_elements("def")
+        info = count_elements.cache_info()
+        assert info.misses == 2
+        assert info.currsize == 2
+
+
+class TestCLIArgs:
+    """Test argparse parameter handling with mocked arguments."""
+
+    def test_string_single_word(self, capsys):
+        result = main(["--string", "abbbccdf"])
+        assert result == 3
+        assert capsys.readouterr().out.strip() == "3"
+
+    def test_string_multiple_words(self, capsys):
+        result = main(["--string", "your", "string"])
+        # "your string" joined with space → count unique chars
+        assert result == count_elements("your string")
+
+    def test_file_flag(self, capsys):
+        m = mock_open(read_data="abcdef")
+        with patch("builtins.open", m):
+            result = main(["--file", "dummy.txt"])
+        m.assert_called_once_with("dummy.txt", "r")
+        assert result == 6
+        assert capsys.readouterr().out.strip() == "6"
+
+    def test_file_has_priority_over_string(self, capsys):
+        m = mock_open(read_data="xyz")
+        with patch("builtins.open", m):
+            result = main(["--string", "abbbccdf", "--file", "dummy.txt"])
+        m.assert_called_once_with("dummy.txt", "r")
+        assert result == 3  # x, y, z all unique
+        assert capsys.readouterr().out.strip() == "3"
+
+    def test_multiple_files(self, capsys):
+        m = mock_open(read_data="abc")
+        with patch("builtins.open", m):
+            result = main(["--file", "a.txt", "b.txt"])
+        assert m.call_count == 2
+
+    def test_no_args_raises_error(self):
+        with pytest.raises(SystemExit):
+            main([])
+
+
+class TestFileReading:
+    """Test file reading with mocks."""
+
+    def test_reads_file_content(self, capsys):
+        m = mock_open(read_data="hello")
+        with patch("builtins.open", m):
+            result = main(["--file", "test.txt"])
+        m.assert_called_once_with("test.txt", "r")
+        assert result == 3  # h, e, o unique; l repeated
+
+    def test_missing_file_raises_error(self):
+        with patch("builtins.open", side_effect=FileNotFoundError):
+            with pytest.raises(SystemExit):
+                main(["--file", "nonexistent.txt"])
+
+    def test_empty_file(self, capsys):
+        m = mock_open(read_data="")
+        with patch("builtins.open", m):
+            result = main(["--file", "empty.txt"])
+        assert result == 0