flagrant-client 0.1.0__tar.gz → 0.2.0__tar.gz

{flagrant_client-0.1.0 → flagrant_client-0.2.0}/.agent-shell/transcripts/2026-09-11-21-40-01.md

@@ -1287,3 +1287,101 @@ SOFTWARE.
 
 I should check whether the hatchling version being used supports the PEP 639 SPDX license string format, since older versions might not handle `license = "MIT"` correctly. Let me just confirm the build works with this setup.
 
+
+
+### Tool Call [completed]: uv build 2>&1 | tail -30
+
+**Tool:** execute
+**Timestamp:** 2026-09-11 22:40:17
+**Command:** uv build 2>&1 | tail -30
+
+````
+```console
+Building source distribution...
+Building wheel from source distribution...
+Successfully built dist/flagrant_client-0.1.0.tar.gz
+Successfully built dist/flagrant_client-0.1.0-py3-none-any.whl
+```
+````
+
+## Agent (2026-09-11 22:40:19)
+
+Build succeeds. Updated `pyproject.toml` with description, `license = "MIT"`, GitHub homepage/repository URLs, and the two classifiers, and added a `LICENSE` (MIT, Michal Buczko) file. Verified with `uv build` — both sdist and wheel build cleanly.
+
+You're set to publish with `uv publish` (needs a PyPI token via `UV_PUBLISH_TOKEN` or `--token`).
+
+## User (2026-09-11 22:56:12)
+
+how to remove a history in fish shell? I'd like to remove the recent entry.
+
+## Agent's Thoughts (2026-09-11 22:56:18)
+
+This is about fish shell history rather than the repo itself. Fish stores history in ~/.local/share/fish/fish_history, and I recall the `history delete` command can remove entries by exact match, so I need to find the right syntax to delete just the most recent one.
+
+My plan: capture the most recent command with `history --max 1`, store it in a variable, then pass that to `history delete --exact --` to remove it precisely.
+
+
+
+### Tool Call [completed]: fish -c 'history --help' 2>&1 | head -40
+
+**Tool:** execute
+**Timestamp:** 2026-09-11 22:56:27
+**Command:** fish -c 'history --help' 2>&1 | head -40
+
+````
+```console
+HISTORY(1)                        fish-shell                        HISTORY(1)
+
+NNAAMMEE
+       history - show and manipulate command history
+
+SSYYNNOOPPSSIISS
+       hhiissttoorryy [sseeaarrcchh] [----sshhooww--ttiimmee] [----ccaassee--sseennssiittiivvee]
+                        [----eexxaacctt | ----pprreeffiixx | ----ccoonnttaaiinnss] [----mmaaxx _N] [----nnuullll] [----rreevveerrssee]
+                        [_S_E_A_R_C_H___S_T_R_I_N_G ...]
+       hhiissttoorryy ddeelleettee [----ccaassee--sseennssiittiivvee]
+                      [----eexxaacctt | ----pprreeffiixx | ----ccoonnttaaiinnss] _S_E_A_R_C_H___S_T_R_I_N_G ...
+       hhiissttoorryy mmeerrggee
+       hhiissttoorryy ssaavvee
+       hhiissttoorryy cclleeaarr
+       hhiissttoorryy cclleeaarr--sseessssiioonn
+       hhiissttoorryy aappppeenndd _C_O_M_M_A_N_D ...
+
+
+DDEESSCCRRIIPPTTIIOONN
+       hhiissttoorryy is used to search, delete, and otherwise manipulate the history
+       of interactive commands <#history-search>.
+
+       The following operations (sub-commands) are available:
+
+       sseeaarrcchh Returns history items matching the search string. If no search
+              string is provided it returns all history items. This is the
+              default operation if no other operation is specified. You only
+              have to explicitly say hhiissttoorryy sseeaarrcchh if you wish to search for
+              one of the subcommands. The ----ccoonnttaaiinnss search option will be
+              used if you don't specify a different search option. Entries are
+              ordered newest to oldest unless you use the ----rreevveerrssee flag. If
+              stdout is attached to a tty the output will be piped through
+              your pager by the history function. The history builtin writes
+              the results to stdout.
+
+       ddeelleettee Deletes history items. The ----ccoonnttaaiinnss search option will be used
+              if you don't specify a different search option. If you don't
+              specify ----eexxaacctt a prompt will be displayed before any items are
+              deleted asking you which entries are to be deleted. You can
+              enter the word "all" to delete all matching entries. You can
+```
+````
+
+## Agent (2026-09-11 22:56:29)
+
+To delete just the most recent history entry in fish:
+
+```fish
+history delete --exact --case-sensitive -- (history --max 1)
+```
+
+`history --max 1` grabs the last entry's exact text, and `history delete --exact` removes only that exact match (without `--exact` it does a `--contains` match and prompts you interactively). Run `history save` afterward if you want the deletion flushed to disk immediately (fish normally does this on shell exit anyway).
+
+If you'd rather do it interactively: just run `history delete <part of the command>` — fish will show matching entries and let you type `all` or pick which to remove.
+

flagrant_client-0.2.0/.agent-shell/transcripts/2026-10-01-22-10-28.md

@@ -0,0 +1,264 @@
+# Agent Shell Transcript
+
+**Agent:** Claude
+**Started:** 2026-10-01 22:10:40
+**Working Directory:** /Users/michal/workspace/python/flagrant-client/
+**Session ID:** a52ab1c2-8ea5-4e3d-97db-b9e80551c806
+
+---
+
+## User (2026-10-01 22:10:40)
+
+rename it to FlagrantOpts
+
+src/flagrant/client.py:12-12
+
+class FlagsmithOpts:
+
+## Agent's Thoughts (2026-10-01 22:10:42)
+
+I need to rename FlagsmithOpts to FlagrantOpts in src/flagrant/client.py, so let me check that file first.
+
+
+
+### Tool Call [completed]: Read src/flagrant/client.py
+
+**Tool:** read
+**Timestamp:** 2026-10-01 22:10:42
+**Parameters:**
+file_path: /Users/michal/workspace/python/flagrant-client/src/flagrant/client.py
+
+````
+```
+1	from collections.abc import Callable
+2	from dataclasses import dataclass
+3	from typing import Any
+4	
+5	from flagrant.cache import LRUCache
+6	from flagrant.models import Feature
+7	from flagrant.transport import Transport, TransientError
+8	
+9	DefaultFlagHandler = Callable[[str, str], list[Feature] | None]
+10	
+11	@dataclass(frozen=True)
+12	class FlagsmithOpts:
+13	    cache_ttl: float | None = None
+14	    cache_size: int | None = None
+15	
+16	
+17	class FlagrantClient:
+18	    def __init__(
+19	        self,
+20	        project: str,
+21	        transport: Transport,
+22	        *,
+23	        default_handler: DefaultFlagHandler | None = None,
+24	        opts: FlagsmithOpts = FlagsmithOpts()
+25	    ) -> None:
+26	        self.project = project
+27	        self.transport = transport
+28	        self.opts = opts
+29	        self.default_handler = default_handler
+30	
+31	        self._cache: LRUCache[tuple[str, str], list[Feature]] | None = (
+32	            LRUCache(max_size=opts.cache_size, ttl=opts.cache_ttl)
+33	            if opts.cache_size
+34	            else None
+35	        )
+36	
+37	    def get_features(self, environment: str, identity: str) -> list[Feature] | None:
+38	        key = (environment, identity)
+39	        if self._cache is not None:
+40	            if cached := self._cache.get(key):
+41	                return cached
+42	
+43	        try:
+44	            features = self.transport.fetch(self.project, environment, identity)
+45	        except TransientError:
+46	            if self._cache is not None and (stale := self._cache.get_stale(key)) is not None:
+47	                return stale
+48	            if self.default_handler is None:
+49	                raise
+50	            return self.default_handler(environment, identity)
+51	
+52	        if self._cache is not None:
+53	            self._cache.set(key, features)
+54	
+55	        return features
+56	
+57	    def close(self) -> None:
+58	        self.transport.close()
+59	
+60	    def __enter__(self) -> "FlagrantClient":
+61	        return self
+62	
+63	    def __exit__(self, *_args: Any) -> None:
+64	        self.close()
+```
+````
+
+## Agent (2026-10-01 22:10:43)
+
+Let me check for other usages of `FlagsmithOpts` across the repo before renaming.
+
+### Tool Call [completed]: grep -rn "FlagsmithOpts" /Users/michal/workspace/python/flagrant-client --include="*.py"
+
+**Tool:** execute
+**Timestamp:** 2026-10-01 22:10:44
+**Description:** Search for other usages of FlagsmithOpts
+**Command:** grep -rn "FlagsmithOpts" /Users/michal/workspace/python/flagrant-client --include="*.py"
+
+````
+```console
+/Users/michal/workspace/python/flagrant-client/src/flagrant/client.py:12:class FlagsmithOpts:
+/Users/michal/workspace/python/flagrant-client/src/flagrant/client.py:24:        opts: FlagsmithOpts = FlagsmithOpts()
+/Users/michal/workspace/python/flagrant-client/src/flagrant/__init__.py:1:from flagrant.client import FlagrantClient, FlagsmithOpts
+/Users/michal/workspace/python/flagrant-client/src/flagrant/__init__.py:8:    "FlagsmithOpts",
+```
+````
+
+## Agent (2026-10-01 22:10:45)
+
+Only two files reference it. Renaming both.
+
+### Tool Call [completed]: Edit src/flagrant/client.py
+
+**Tool:** edit
+**Timestamp:** 2026-10-01 22:10:51
+**Parameters:**
+file_path: /Users/michal/workspace/python/flagrant-client/src/flagrant/client.py
+old_string: class FlagsmithOpts:
+    cache_ttl: float | None = None
+    cache_size: int | None = None
+
+
+class FlagrantClient:
+    def __init__(
+        self,
+        project: str,
+        transport: Transport,
+        *,
+        default_handler: DefaultFlagHandler | None = None,
+        opts: FlagsmithOpts = FlagsmithOpts()
+new_string: class FlagrantOpts:
+    cache_ttl: float | None = None
+    cache_size: int | None = None
+
+
+class FlagrantClient:
+    def __init__(
+        self,
+        project: str,
+        transport: Transport,
+        *,
+        default_handler: DefaultFlagHandler | None = None,
+        opts: FlagrantOpts = FlagrantOpts()
+
+```
+╭────────────────────────╮
+│ src/flagrant/client.py │
+╰────────────────────────╯
+
+@@ -1,6 +1,6 @@
+ DefaultFlagHandler = Callable[[str, str], list[Feature] | None]
+ 
+ @dataclass(frozen=True)
+-class FlagsmithOpts:
++class FlagrantOpts:
+     cache_ttl: float | None = None
+     cache_size: int | None = None
+
+
+╭────────────────────────╮
+│ src/flagrant/client.py │
+╰────────────────────────╯
+
+@@ -1,7 +1,7 @@
+         transport: Transport,
+         *,
+         default_handler: DefaultFlagHandler | None = None,
+-        opts: FlagsmithOpts = FlagsmithOpts()
++        opts: FlagrantOpts = FlagrantOpts()
+     ) -> None:
+         self.project = project
+         self.transport = transport
+
+```
+
+
+### Tool Call [completed]: Read src/flagrant/__init__.py
+
+**Tool:** read
+**Timestamp:** 2026-10-01 22:10:52
+**Parameters:**
+file_path: /Users/michal/workspace/python/flagrant-client/src/flagrant/__init__.py
+
+````
+```
+1	from flagrant.client import FlagrantClient, FlagsmithOpts
+2	from flagrant.grpc_transport import GrpcTransport
+3	from flagrant.http_transport import HttpTransport
+4	from flagrant.transport import PermanentError, Transport, TransientError
+5	
+6	__all__ = [
+7	    "FlagrantClient",
+8	    "FlagsmithOpts",
+9	    "GrpcTransport",
+10	    "HttpTransport",
+11	    "PermanentError",
+12	    "Transport",
+13	    "TransientError",
+14	]
+```
+````
+
+
+### Tool Call [completed]: Edit src/flagrant/__init__.py
+
+**Tool:** edit
+**Timestamp:** 2026-10-01 22:10:59
+**Parameters:**
+file_path: /Users/michal/workspace/python/flagrant-client/src/flagrant/__init__.py
+old_string: from flagrant.client import FlagrantClient, FlagsmithOpts
+from flagrant.grpc_transport import GrpcTransport
+from flagrant.http_transport import HttpTransport
+from flagrant.transport import PermanentError, Transport, TransientError
+
+__all__ = [
+    "FlagrantClient",
+    "FlagsmithOpts",
+new_string: from flagrant.client import FlagrantClient, FlagrantOpts
+from flagrant.grpc_transport import GrpcTransport
+from flagrant.http_transport import HttpTransport
+from flagrant.transport import PermanentError, Transport, TransientError
+
+__all__ = [
+    "FlagrantClient",
+    "FlagrantOpts",
+
+```
+╭──────────────────────────╮
+│ src/flagrant/__init__.py │
+╰──────────────────────────╯
+
+@@ -1,11 +1,11 @@
+-from flagrant.client import FlagrantClient, FlagsmithOpts
++from flagrant.client import FlagrantClient, FlagrantOpts
+ from flagrant.grpc_transport import GrpcTransport
+ from flagrant.http_transport import HttpTransport
+ from flagrant.transport import PermanentError, Transport, TransientError
+ 
+ __all__ = [
+     "FlagrantClient",
+-    "FlagsmithOpts",
++    "FlagrantOpts",
+     "GrpcTransport",
+     "HttpTransport",
+     "PermanentError",
+
+```
+
+## Agent (2026-10-01 22:10:59)
+
+Done — renamed `FlagsmithOpts` → `FlagrantOpts` in `client.py:12,24` and `__init__.py:1,8`.
+

{flagrant_client-0.1.0 → flagrant_client-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: flagrant-client
-Version: 0.1.0
+Version: 0.2.0
 Summary: A python client for Flagrant feature-flagging API
 Project-URL: Homepage, https://github.com/mbuczko/flagrant-client-python
 Project-URL: Repository, https://github.com/mbuczko/flagrant-client-python
@@ -39,7 +39,7 @@ This split lets `FlagrantClient.get_features` react differently depending on whe
 
 ## Caching and fallback
 
-`FlagrantClient` optionally wraps fetches in an `LRUCache` (per `(environment, identity)` key), configured via `FlagsmithOpts(cache_size=..., cache_ttl=...)`. On a `TransientError`, the client tries a stale cache entry before falling back to a user-supplied `default_handler`, and only re-raises if neither is available.
+`FlagrantClient` optionally wraps fetches in an `LRUCache` (per `(environment, identity)` key), configured via `FlagrantOpts(cache_size=..., cache_ttl=...)`. On a `TransientError`, the client tries a stale cache entry before falling back to a user-supplied `default_handler`, and only re-raises if neither is available.
 
 ## Testing in IPython
 

{flagrant_client-0.1.0 → flagrant_client-0.2.0}/README.md

@@ -21,7 +21,7 @@ This split lets `FlagrantClient.get_features` react differently depending on whe
 
 ## Caching and fallback
 
-`FlagrantClient` optionally wraps fetches in an `LRUCache` (per `(environment, identity)` key), configured via `FlagsmithOpts(cache_size=..., cache_ttl=...)`. On a `TransientError`, the client tries a stale cache entry before falling back to a user-supplied `default_handler`, and only re-raises if neither is available.
+`FlagrantClient` optionally wraps fetches in an `LRUCache` (per `(environment, identity)` key), configured via `FlagrantOpts(cache_size=..., cache_ttl=...)`. On a `TransientError`, the client tries a stale cache entry before falling back to a user-supplied `default_handler`, and only re-raises if neither is available.
 
 ## Testing in IPython
 

{flagrant_client-0.1.0 → flagrant_client-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "flagrant-client"
-version = "0.1.0"
+version = "0.2.0"
 description = "A python client for Flagrant feature-flagging API"
 readme = "README.md"
 license = "MIT"

{flagrant_client-0.1.0 → flagrant_client-0.2.0}/src/flagrant/__init__.py

@@ -1,11 +1,11 @@
-from flagrant.client import FlagrantClient, FlagsmithOpts
+from flagrant.client import FlagrantClient, FlagrantOpts
 from flagrant.grpc_transport import GrpcTransport
 from flagrant.http_transport import HttpTransport
 from flagrant.transport import PermanentError, Transport, TransientError
 
 __all__ = [
     "FlagrantClient",
-    "FlagsmithOpts",
+    "FlagrantOpts",
     "GrpcTransport",
     "HttpTransport",
     "PermanentError",

{flagrant_client-0.1.0 → flagrant_client-0.2.0}/src/flagrant/cache.py

@@ -28,8 +28,10 @@ class LRUCache(Generic[K, V]):
             return None
 
         timestamp, value = entry
+
         if self.ttl is not None and time.monotonic() - timestamp > self.ttl:
             return None
+
         self._data.move_to_end(key)
         return value
 

{flagrant_client-0.1.0 → flagrant_client-0.2.0}/src/flagrant/client.py

@@ -9,7 +9,7 @@ from flagrant.transport import Transport, TransientError
 DefaultFlagHandler = Callable[[str, str], list[Feature] | None]
 
 @dataclass(frozen=True)
-class FlagsmithOpts:
+class FlagrantOpts:
     cache_ttl: float | None = None
     cache_size: int | None = None
 
@@ -21,7 +21,7 @@ class FlagrantClient:
         transport: Transport,
         *,
         default_handler: DefaultFlagHandler | None = None,
-        opts: FlagsmithOpts = FlagsmithOpts()
+        opts: FlagrantOpts = FlagrantOpts()
     ) -> None:
         self.project = project
         self.transport = transport