mirror of
https://github.com/kirill-markin/repo-to-text.git
synced 2025-12-06 03:22:23 -08:00
example update
This commit is contained in:
parent
1c47769317
commit
db89dbfc9c
2 changed files with 55 additions and 50 deletions
|
|
@ -83,7 +83,7 @@ You can customize the behavior of `repo-to-text` with the following options:
|
||||||
|
|
||||||
## Example Output
|
## Example Output
|
||||||
|
|
||||||
The generated text file will include the directory structure and contents of each file. For a full example, see the [example output for this repository](examples/example_repo_snapshot_2024-06-08-09-56-58-UTC.txt).
|
The generated text file will include the directory structure and contents of each file. For a full example, see the [example output for this repository](examples/example_repo_snapshot_2024-06-08-10-30-33-UTC.txt).
|
||||||
|
|
||||||
## Running Tests
|
## Running Tests
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -66,7 +66,7 @@ Contents of README.md:
|
||||||
- Copies the generated text representation to the clipboard for easy sharing.
|
- Copies the generated text representation to the clipboard for easy sharing.
|
||||||
- Easy to install and use via `pip` and Homebrew.
|
- Easy to install and use via `pip` and Homebrew.
|
||||||
|
|
||||||
## Installation
|
<!-- ## Installation
|
||||||
|
|
||||||
### Using pip
|
### Using pip
|
||||||
|
|
||||||
|
|
@ -82,7 +82,7 @@ To install `repo-to-text` via Homebrew, run the following command:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
brew install yourusername/repo-to-text
|
brew install yourusername/repo-to-text
|
||||||
```
|
``` -->
|
||||||
|
|
||||||
### Install Locally
|
### Install Locally
|
||||||
|
|
||||||
|
|
@ -91,7 +91,7 @@ To install `repo-to-text` locally for development, follow these steps:
|
||||||
1. Clone the repository:
|
1. Clone the repository:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/yourusername/repo-to-text.git
|
git clone https://github.com/kirill-markin/repo-to-text
|
||||||
cd repo-to-text
|
cd repo-to-text
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -101,6 +101,14 @@ To install `repo-to-text` locally for development, follow these steps:
|
||||||
pip install -e .
|
pip install -e .
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Installing Dependencies
|
||||||
|
|
||||||
|
To install all the required dependencies, run the following command:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pip install -r requirements.txt
|
||||||
|
```
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
After installation, you can use the `repo-to-text` command in your terminal. Navigate to the directory you want to convert and run:
|
After installation, you can use the `repo-to-text` command in your terminal. Navigate to the directory you want to convert and run:
|
||||||
|
|
@ -109,43 +117,29 @@ After installation, you can use the `repo-to-text` command in your terminal. Nav
|
||||||
repo-to-text
|
repo-to-text
|
||||||
```
|
```
|
||||||
|
|
||||||
This will create a file named repo_snapshot.txt in the current directory with the text representation of the repository. The contents of this file will also be copied to your clipboard for easy sharing.
|
This will create a file named `repo_snapshot_YYYY-MM-DD-HH-MM-SS-UTC.txt` in the current directory with the text representation of the repository. The contents of this file will also be copied to your clipboard for easy sharing.
|
||||||
|
|
||||||
## Enabling Debug Logging
|
### Options
|
||||||
|
|
||||||
By default, repo-to-text runs with INFO logging level. To enable DEBUG logging, use the --debug flag:
|
You can customize the behavior of `repo-to-text` with the following options:
|
||||||
|
|
||||||
```bash
|
- `--output-dir <path>`: Specify an output directory where the generated text file will be saved. For example:
|
||||||
repo-to-text --debug
|
|
||||||
```
|
```bash
|
||||||
|
repo-to-text --output-dir /path/to/output
|
||||||
|
```
|
||||||
|
|
||||||
|
This will save the file in the specified output directory instead of the current directory.
|
||||||
|
|
||||||
|
- `--debug`: Enable DEBUG logging. By default, `repo-to-text` runs with INFO logging level. To enable DEBUG logging, use the `--debug` flag:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
repo-to-text --debug
|
||||||
|
```
|
||||||
|
|
||||||
## Example Output
|
## Example Output
|
||||||
|
|
||||||
The generated text file will include the directory structure and contents of each file. For example:
|
The generated text file will include the directory structure and contents of each file. For a full example, see the [example output for this repository](examples/example_repo_snapshot_2024-06-08-09-56-58-UTC.txt).
|
||||||
|
|
||||||
```
|
|
||||||
.
|
|
||||||
├── README.md
|
|
||||||
├── repo_to_text
|
|
||||||
│ ├── __init__.py
|
|
||||||
│ └── main.py
|
|
||||||
├── requirements.txt
|
|
||||||
├── setup.py
|
|
||||||
└── tests
|
|
||||||
├── __init__.py
|
|
||||||
└── test_main.py
|
|
||||||
|
|
||||||
README.md
|
|
||||||
```
|
|
||||||
```
|
|
||||||
# Contents of README.md
|
|
||||||
...
|
|
||||||
```
|
|
||||||
```
|
|
||||||
# Contents of repo_to_text/__init__.py
|
|
||||||
...
|
|
||||||
```
|
|
||||||
...
|
|
||||||
|
|
||||||
## Running Tests
|
## Running Tests
|
||||||
|
|
||||||
|
|
@ -155,15 +149,9 @@ To run the tests, use the following command:
|
||||||
pytest
|
pytest
|
||||||
```
|
```
|
||||||
|
|
||||||
Make sure you have `pytest` installed. If not, you can install it using:
|
## Uninstall
|
||||||
|
|
||||||
```bash
|
To uninstall the package, run the following command from the directory where the repository is located:
|
||||||
pip install pytest
|
|
||||||
```
|
|
||||||
|
|
||||||
## Uninstall Locally
|
|
||||||
|
|
||||||
To uninstall the locally installed package, run the following command from the directory where the repository is located:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pip uninstall repo-to-text
|
pip uninstall repo-to-text
|
||||||
|
|
@ -179,7 +167,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
|
||||||
|
|
||||||
## Contact
|
## Contact
|
||||||
|
|
||||||
For any inquiries or feedback, please contact [yourname](mailto:youremail@example.com).
|
This project is maintained by [Kirill Markin](https://github.com/kirill-markin). For any inquiries or feedback, please contact [markinkirill@gmail.com](mailto:markinkirill@gmail.com).
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -193,6 +181,13 @@ with open('requirements.txt') as f:
|
||||||
setup(
|
setup(
|
||||||
name='repo-to-text',
|
name='repo-to-text',
|
||||||
version='0.1',
|
version='0.1',
|
||||||
|
author='Kirill Markin',
|
||||||
|
author_email='markinkirill@gmail.com',
|
||||||
|
description='Convert a directory structure and its contents into a single text file, including the tree output and file contents in markdown code blocks.',
|
||||||
|
long_description=open('README.md').read(),
|
||||||
|
long_description_content_type='text/markdown',
|
||||||
|
url='https://github.com/kirill-markin/repo-to-text',
|
||||||
|
license='MIT',
|
||||||
packages=find_packages(),
|
packages=find_packages(),
|
||||||
install_requires=required,
|
install_requires=required,
|
||||||
entry_points={
|
entry_points={
|
||||||
|
|
@ -200,7 +195,14 @@ setup(
|
||||||
'repo-to-text=repo_to_text.main:main',
|
'repo-to-text=repo_to_text.main:main',
|
||||||
],
|
],
|
||||||
},
|
},
|
||||||
|
classifiers=[
|
||||||
|
'Programming Language :: Python :: 3',
|
||||||
|
'License :: OSI Approved :: MIT License',
|
||||||
|
'Operating System :: OS Independent',
|
||||||
|
],
|
||||||
|
python_requires='>=3.6',
|
||||||
)
|
)
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Contents of tests/__init__.py:
|
Contents of tests/__init__.py:
|
||||||
|
|
@ -246,6 +248,9 @@ if __name__ == "__main__":
|
||||||
|
|
||||||
Contents of repo_to_text/__init__.py:
|
Contents of repo_to_text/__init__.py:
|
||||||
```
|
```
|
||||||
|
__author__ = 'Kirill Markin'
|
||||||
|
__email__ = 'markinkirill@gmail.com'
|
||||||
|
__version__ = '0.1'
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue