feat(workflow): add GitHub Actions workflow for automatic PyPI publishing on version tags

docs(README): update development and deployment instructions, including publishing to PyPI
feat(cli): add logout command to clear state and API key information
feat(client): extend ClientState to include user information and update user info retrieval
chore(pyproject): update project metadata with homepage, documentation, and classifiers

Author: closedLoop

.github/workflows/pypi.yml

@@ -0,0 +1,34 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'  # Trigger on version tags
+
+jobs:
+  build-and-publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      # Required for trusted publishing to PyPI
+      id-token: write
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.x'
+    
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

README.md

@@ -8,6 +8,49 @@ The Infactory SDK provides simple and powerful interfaces to work with your data
 pip install infactory
 ```
 
+## Development and Deployment
+
+### Local Development
+
+1. Clone the repository:
+```bash
+git clone https://github.com/infactory-io/infactory-py.git
+cd infactory-py
+```
+
+2. Install Poetry (if not already installed):
+```bash
+curl -sSL https://install.python-poetry.org | python3 -
+```
+
+3. Install dependencies:
+```bash
+poetry install
+```
+
+4. Run tests:
+```bash
+poetry run pytest
+```
+
+### Publishing to PyPI
+
+The package is automatically published to PyPI when a new version tag is pushed to the repository. To release a new version:
+
+1. Update the version in `pyproject.toml`
+2. Create and push a new version tag:
+```bash
+git add pyproject.toml
+git commit -m "Bump version to X.Y.Z"
+git tag vX.Y.Z
+git push origin main --tags
+```
+
+The GitHub Actions workflow will automatically:
+- Build the package
+- Run tests
+- Publish to PyPI using trusted publisher configuration
+
 ## Getting Started
 
 ### Setting your API Key

infactory_client/cli.py

@@ -42,6 +42,7 @@
 # Configure logging
 logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
 logger = logging.getLogger("infactory-cli")
+logger.setLevel(logging.DEBUG)
 console = Console()
 
 load_dotenv()
@@ -148,6 +149,37 @@ def login():
         typer.echo(f"Failed to login: {e}", err=True)
         raise typer.Exit(1)
 
+@app.command()
+def logout():
+    """Logout and clear all state information."""
+    try:
+        # Get config directory
+        config_dir = get_config_dir()
+        state_file = config_dir / "state.json"
+        api_key_file = config_dir / "api_key"
+
+        # Remove state file if it exists
+        if state_file.exists():
+            state_file.unlink()
+            typer.echo("State information cleared.")
+
+        # Remove API key file if it exists
+        if api_key_file.exists():
+            api_key_file.unlink()
+            typer.echo("API key removed.")
+
+        # Check if NF_API_KEY is set in environment
+        if os.getenv("NF_API_KEY"):
+            typer.echo("\nNOTE: The NF_API_KEY environment variable is still set.")
+            typer.echo("To completely logout, you should unset it:")
+            typer.echo("  export NF_API_KEY=")
+
+        typer.echo("\nLogout successful!")
+
+    except Exception as e:
+        typer.echo(f"Error during logout: {e}", err=True)
+        raise typer.Exit(1)
+
 @app.command()
 def show():
     """Show current state including API key (masked), organization, team, and project."""
@@ -173,6 +205,15 @@ def show():
         # Add API key
         table.add_row("API Key", masked_api_key)
 
+        # Show user info if set
+        if client.state.user_id:
+            table.add_row("User ID", client.state.user_id)
+            table.add_row("User Email", client.state.user_email or "Not set")
+            table.add_row("User Name", client.state.user_name or "Not set")
+            table.add_row("User Created At", client.state.user_created_at or "Not set")
+        else:
+            table.add_row("User", "Not set")
+
         # Show organization info if set
         if client.state.organization_id:
             try:

infactory_client/client.py

@@ -17,6 +17,9 @@
 class ClientState(BaseModel):
     """Represents the state of the client."""
     user_id: Optional[str] = None
+    user_email: Optional[str] = None
+    user_name: Optional[str] = None
+    user_created_at: Optional[str] = None
     organization_id: Optional[str] = None
     team_id: Optional[str] = None
     project_id: Optional[str] = None
@@ -179,7 +182,12 @@ def connect(self):
         # Test connection by getting current user
         try:
             user_info = self._get("v1/authentication/me")
+            self._logger.debug(f"User info: {user_info}")
+            is_clerk_user = user_info.get("clerk_user_id") or False
             self.state.user_id = user_info.get("id")
+            self.state.user_email = user_info.get("email") or ("in CLERK" if is_clerk_user else "---")  
+            self.state.user_name = user_info.get("name") or ("in CLERK" if is_clerk_user else "---")
+            self.state.user_created_at = user_info.get("created_at")
             self._save_state()
         except Exception as e:
             raise AuthenticationError(f"Failed to connect with the provided API key: {e}")