| Name | py-xsv JSON |
| Version |
0.0.2
JSON |
| download |
| home_page | None |
| Summary | Reading -sv files and writing them to dataframes |
| upload_time | 2025-08-27 12:19:44 |
| maintainer | None |
| docs_url | None |
| author | someone624 |
| requires_python | >=3.9 |
| license | None |
| keywords |
csv
data
parsing
tsv
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# py-xsv
py-xsv is a Python utility for reading -SV files (CSV, TSV, etc.) and converting them into dataframes.
---
## Features
- Auto-detect delimiters in CSV, TSV, or other -SV files.
- Read files into:
- List of dictionaries (`content_dict`)
- List of lists (`content_list`)
- Extract column data easily (`column`).
- Quickly access top/bottom rows (`head`, `tail`).
- Get dimensions (`length_width`) and headers (`headers`).
- Save -SV file to pandas DataFrames (`save_df`).
---
## Installation
```bash
pip install py-xsv
```
This needs Python 3.9 or more.
---
## Docs
### Read a CSV/TSV file as a list of dictionaries
```python
import py_xsv
data = py_xsv.content_dict("data.csv")
print(data[:5])
```
### Read as a list of lists
```python
import py_xsv
data = py_xsv.content_list("data.csv")
print(data[:5])
```
### Detect dilimiter manualy
```python
import py_xsv
with open("data.csv", "r") as f:
lines = f.readlines()
delimiter = py_xsv.detect_delimiter(lines)
print(f"Detected delimiter: {delimiter}")
```
### Work with columns and headers
```python
import py_xsv
data = py_xsv.content_dict("data.csv")
print("Headers:", py_xsv.headers(data))
print("First column:", py_xsv.column(data, "ColumnName"))
```
### Quick access to top and bottom rows
```python
import py_xsv
data = py_xsv.content_list("data.csv")
print("Top 5 rows:", py_xsv.head(data, 5))
print("Bottom 5 rows:", py_xsv.tail(data, 5))
```
### Save data to a pandas DataFrame
```python
import pandas
import py_xsv
data = py_xsv.content_dict("data.csv")
df = py_xsv.save_df(data)
```
> You need to have `import pandas` before doing this
### Exceptions
- `py_xsv.NotSVFileError` - Used when a non -sv file is given
- `py_xsv.PandaError` - Errors while using pandas
- `py_xsv.Error` - Generic Error
---
## License
This is licensed under the WTFPL.
This means that you have permission for:
- Commercial use
- Modification
- Distribution
- Private use
- Everything basically
Under no conditions or limitations
---
Raw data
{
"_id": null,
"home_page": null,
"name": "py-xsv",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "csv, data, parsing, tsv",
"author": "someone624",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/df/dc/ed3c0342a24f6b387baa3c7178c5b3a5a02b6b4860e9161a877add7b7ad3/py_xsv-0.0.2.tar.gz",
"platform": null,
"description": "# py-xsv\npy-xsv is a Python utility for reading -SV files (CSV, TSV, etc.) and converting them into dataframes.\n\n---\n\n## Features\n\n- Auto-detect delimiters in CSV, TSV, or other -SV files.\n- Read files into:\n - List of dictionaries (`content_dict`)\n - List of lists (`content_list`)\n- Extract column data easily (`column`).\n- Quickly access top/bottom rows (`head`, `tail`).\n- Get dimensions (`length_width`) and headers (`headers`).\n- Save -SV file to pandas DataFrames (`save_df`).\n\n---\n\n## Installation\n```bash\npip install py-xsv\n```\nThis needs Python 3.9 or more.\n\n---\n\n## Docs\n\n### Read a CSV/TSV file as a list of dictionaries\n```python\nimport py_xsv\ndata = py_xsv.content_dict(\"data.csv\")\nprint(data[:5])\n```\n\n### Read as a list of lists\n```python\nimport py_xsv\n\ndata = py_xsv.content_list(\"data.csv\")\nprint(data[:5])\n```\n\n### Detect dilimiter manualy\n```python\nimport py_xsv\n\nwith open(\"data.csv\", \"r\") as f:\n lines = f.readlines()\n\ndelimiter = py_xsv.detect_delimiter(lines)\nprint(f\"Detected delimiter: {delimiter}\")\n```\n\n### Work with columns and headers\n```python\nimport py_xsv\n\ndata = py_xsv.content_dict(\"data.csv\")\nprint(\"Headers:\", py_xsv.headers(data))\nprint(\"First column:\", py_xsv.column(data, \"ColumnName\"))\n```\n\n### Quick access to top and bottom rows\n```python\nimport py_xsv\n\ndata = py_xsv.content_list(\"data.csv\")\nprint(\"Top 5 rows:\", py_xsv.head(data, 5))\nprint(\"Bottom 5 rows:\", py_xsv.tail(data, 5))\n```\n\n### Save data to a pandas DataFrame\n```python\nimport pandas\nimport py_xsv\n\ndata = py_xsv.content_dict(\"data.csv\")\ndf = py_xsv.save_df(data)\n```\n> You need to have `import pandas` before doing this\n\n### Exceptions\n- `py_xsv.NotSVFileError` - Used when a non -sv file is given\n- `py_xsv.PandaError` - Errors while using pandas\n- `py_xsv.Error` - Generic Error\n\n---\n\n## License\nThis is licensed under the WTFPL.\n\nThis means that you have permission for:\n- Commercial use\n- Modification\n- Distribution\n- Private use\n- Everything basically\n\nUnder no conditions or limitations\n\n---",
"bugtrack_url": null,
"license": null,
"summary": "Reading -sv files and writing them to dataframes",
"version": "0.0.2",
"project_urls": null,
"split_keywords": [
"csv",
" data",
" parsing",
" tsv"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "447ce2ac4e4ca79be48fe41b524169e7d763f788a4051c53faf5b9529a8a3113",
"md5": "853af7bbe3eb6a5d6e9451c9d4a0f0ed",
"sha256": "3b29e9085be9c4a58e7301bd676315959785f47a61f04c63234381b25cda061f"
},
"downloads": -1,
"filename": "py_xsv-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "853af7bbe3eb6a5d6e9451c9d4a0f0ed",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 4606,
"upload_time": "2025-08-27T12:19:43",
"upload_time_iso_8601": "2025-08-27T12:19:43.548397Z",
"url": "https://files.pythonhosted.org/packages/44/7c/e2ac4e4ca79be48fe41b524169e7d763f788a4051c53faf5b9529a8a3113/py_xsv-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "dfdced3c0342a24f6b387baa3c7178c5b3a5a02b6b4860e9161a877add7b7ad3",
"md5": "6271d561045097acdf3885b8d329f3a4",
"sha256": "7e2bd4e1e589d94aa2301e72f7ac53b4da45a8349fa47c1bc5ba97e53fc8e423"
},
"downloads": -1,
"filename": "py_xsv-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "6271d561045097acdf3885b8d329f3a4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 3862,
"upload_time": "2025-08-27T12:19:44",
"upload_time_iso_8601": "2025-08-27T12:19:44.832874Z",
"url": "https://files.pythonhosted.org/packages/df/dc/ed3c0342a24f6b387baa3c7178c5b3a5a02b6b4860e9161a877add7b7ad3/py_xsv-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-27 12:19:44",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "py-xsv"
}
