Metadata-Version: 2.4
Name: curlpy_nicolaszmarzagao
Version: 0.1.2
Summary: A simple curl clone in Python
Author-email: Nicolas Z Marzagão <nicolas.marzagao@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/nicolaszmarzagao/curlpy
Project-URL: Issues, https://github.com/nicolaszmarzagao/curlpy/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# cURLpy

A simple `curl` implementation built from scratch using Python 3.

The goal of this project is to use as few dependencies as possible — preferably none.

**Current status:** This project currently has no dependencies.

## Installation

Install from PyPI:

```bash
pip install curlpy-nicolaszmarzagao
```

## Usage

cURLpy works similarly to `curl`. Here are some features already implemented:

### GET Requests

#### HTTP

```bash
python3 -m curlpy example.com
```

#### HTTPS

```bash
python3 -m curlpy https://example.com
```

#### Specific path

```bash
python3 -m curlpy https://example.com/hello/world
```

#### Specific port

```bash
python3 -m curlpy https://example.com:8080
```

Or:

```bash
python3 -m curlpy https://example.com/ -p 8080
```

#### Include HTTP headers

```bash
python3 -m curlpy example.com -i
```

## Local Development

Clone the repository using SSH:

```bash
git clone git@github.com:nicolaszmarzagao/curlpy.git
cd curlpy
```

Create and activate a virtual environment:

```bash
python3 -m venv .venv
source .venv/bin/activate
```

Install cURLpy locally in editable mode:

```bash
python3 -m pip install -e .
```

Run the tests:

```bash
python3 -m unittest discover -s tests -v
```

Run cURLpy:

```bash
python3 -m curlpy
```

## Contributing

Feel free to fork this repository, open issues, suggest features, or contribute with pull requests.

This project is licensed under the MIT License.
