Metadata-Version: 2.1
Name: head_require
Version: 2.2.24
Summary: head-require is a library that aims to simplify the creation of requirements.txt files. head-require generates requirements.txt based on the packages actually used in your project.
Home-page: https://github.com/Thanaraklee/Head-Require
Author: Thanarak Leenanon
Author-email: bzank.lee@hotmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE


<h1 align="center">
<img src="https://raw.githubusercontent.com/Thanaraklee/Head-Require/main/img/logo.jpg">
</h1><br>

| Badge | Link |
|-------|------|
| ![License: MIT](https://img.shields.io/badge/License-MIT-brightgreen.svg) | [License](https://github.com/Thanaraklee/Head-Require/blob/main/LICENSE) |
| ![Upload Python Package](https://github.com/Thanaraklee/Head-Require/actions/workflows/python-publish.yml/badge.svg?event=release) | [Python Publish](https://github.com/Thanaraklee/Head-Require/actions/workflows/python-publish.yml) |
| ![PyPI Downloads](https://img.shields.io/pypi/dm/head-require.svg?label=PyPI%20downloads) | [PyPI Stats](https://pypistats.org/packages/head-require) |
| ![PyPI Latest Release](https://img.shields.io/pypi/v/head-require.svg) | [PyPI Latest Release](https://pypi.org/project/head-require/) |



# Head-Require

Head-Require is a Python library designed to simplify the process of generating `requirements.txt` files based on the imported packages in Python files within your project.

## How to Use

### Installation

To install Head-Require, you can use pip:

```bash
pip install head-require
```

### Usage

Once installed, you can use the `head-require` command in the current directory of your project. Here are some common usage examples:

To generate the `requirements.txt` file based on the imported packages in your Python files, simply run:

```bash
head-require
```

#### Help

For a list of available options and their descriptions, you can use the help option:

```bash
head-require -h
```

### Additional Notes

- Make sure to run the `head-require` command in the root directory of your Python project.
- Head-Require analyzes Python files (`*.py` and `*.ipynb`) to extract imported packages and their versions.

❗**Important:**
This command must be executed within the `activated environment`. If it's not activated, it will work under the machine's environment.

Thank you for using Head-Require! 😊
