Metadata-Version: 2.1
Name: pomace
Version: 0.8.11
Summary: Dynamic page objects for browser automation.
Home-page: https://pypi.org/project/pomace
License: MIT
Keywords: browser automation,page object model,selenium,splinter
Author: Jace Browning
Author-email: jacebrowning@gmail.com
Requires-Python: >=3.7,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Software Development :: Testing
Requires-Dist: beautifulsoup4 (>=4.8.2,<5.0.0)
Requires-Dist: bullet (>=2.1,<3.0)
Requires-Dist: cached-property (>=1.5.2,<2.0.0)
Requires-Dist: cleo (>=0.8.1,<0.9.0)
Requires-Dist: datafiles (>=0.15,<0.16)
Requires-Dist: fake-useragent (>=0.1.11,<0.2.0)
Requires-Dist: faker (>=4.1.1)
Requires-Dist: flask-api (>=3.0,<4.0)
Requires-Dist: gitman (>=2.3,<3.0)
Requires-Dist: inflection (>=0.4,<0.5)
Requires-Dist: ipdb (>=0.13.7,<0.14.0)
Requires-Dist: minilog (>=2.0,<3.0)
Requires-Dist: parse (>=1.14,<2.0)
Requires-Dist: splinter (>=0.15,<0.16)
Requires-Dist: us (>=2.0.2,<3.0.0)
Requires-Dist: webdriver_manager (>=2.5,<3.0)
Requires-Dist: zipcodes (>=1.1.2,<2.0.0)
Project-URL: Documentation, https://pomace.readthedocs.io
Project-URL: Repository, https://github.com/jacebrowning/pomace
Description-Content-Type: text/markdown

# Pomace

Dynamic page objects for browser automation.

[![Unix Build Status](https://img.shields.io/github/workflow/status/jacebrowning/pomace/main?label=unix)](https://github.com/jacebrowning/pomace/actions?query=branch%3Amain)
[![Windows Build Status](https://img.shields.io/appveyor/ci/jacebrowning/pomace/main.svg?label=window)](https://ci.appveyor.com/project/jacebrowning/pomace)
[![Coverage Status](https://img.shields.io/codecov/c/gh/jacebrowning/pomace)](https://codecov.io/gh/jacebrowning/pomace)
[![PyPI Version](https://img.shields.io/pypi/v/pomace.svg)](https://pypi.org/project/pomace)
[![PyPI License](https://img.shields.io/pypi/l/pomace.svg)](https://pypi.org/project/pomace)

# Usage

## Quick Start

Open **Terminal.app** in macOS and paste:

```
python3 -m pip install --upgrade pomace && python3 -m pomace run
```

or if you have Homebrew:

```
brew install pipx; pipx run --no-cache pomace run
```

## Installation

If you're planning to run Pomace multiple times, install it with [pipx](https://pipxproject.github.io/pipx/) first:

```
pipx install pomace
```

or get the latest version:

```
pipx upgrade pomace
```

Then download some site models:

```
pomace clone https://github.com/jacebrowning/pomace-twitter.com
```

And launch the application:

```
pomace run twitter.com
```

## Troubleshooting

If you are seeing this error:

```
Traceback (most recent call last):
  File "/Users/Me/.local/bin/pomace", line 5, in <module>
    from pomace.cli import application
  File "/Users/Me/.local/pipx/venvs/pomace/lib/python3.9/site-packages/pomace/cli.py", line 9, in <module>
    from . import models, prompts, server, utils
  File "/Users/Me/.local/pipx/venvs/pomace/lib/python3.9/site-packages/pomace/server.py", line 4, in <module>
    from flask_api import FlaskAPI
  File "/Users/Me/.local/pipx/venvs/pomace/lib/python3.9/site-packages/flask_api/__init__.py", line 1, in <module>
    from flask_api.app import FlaskAPI
  File "/Users/Me/.local/pipx/venvs/pomace/lib/python3.9/site-packages/flask_api/app.py", line 4, in <module>
    from flask._compat import reraise, string_types, text_type
ModuleNotFoundError: No module named 'flask._compat'
```

Trying uninstalling and reinstalling flask:

```
$ pip uninstall flask && python -m pip install flask
```

Then upgrading Pomace:

```
$ pipx upgrade pomace
```

