Metadata-Version: 2.4
Name: gitforce
Version: 0.5.1
Summary: Gitforce CLI wrapper package for terminal installation via pip.
Author: Gitforce Contributors
License-Expression: MIT
Project-URL: Homepage, https://github.com/fullpressco/Gitforce
Project-URL: Repository, https://github.com/fullpressco/Gitforce
Project-URL: Issues, https://github.com/fullpressco/Gitforce/issues
Keywords: salesforce,github,devops,cli
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: JavaScript
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# Gitforce (PyPI Wrapper)

This package exposes `gitforce` through `pip install` for users who prefer Python tooling.

## What It Installs

- `gitforce` command in your Python environment
- bundled Gitforce Node CLI artifact

## Runtime Requirements

- Node.js 20+ (recommended: 24+)
- Python 3.9+
- Salesforce CLI (`sf`)
- GitHub CLI (`gh`)
- `git` available on `PATH`

## Install

```bash
pipx install gitforce
gitforce --help
```

`python -m pip install gitforce` also works in a Python virtual environment.

## Updates and behavior

Use `pipx upgrade gitforce` (or `python -m pip install --upgrade gitforce` in a virtual environment). The package contains a bundled CLI from its release; it does not download the current GitHub `main` branch at runtime. After upgrading the CLI, run `gitforce generate-workflows` in each managed repo and review the generated changes.

For defaults, seed/drift behavior, and commands, see the [main README](../README.md) and [configuration reference](../docs/configuration.md). A source change reaches Python installations only after a new PyPI package is built and published.

## Notes

- This package is a Python wrapper around the main Node CLI.
- If Node.js is missing, running `gitforce` will print an installation error.
