python-cath 0.2.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

python_cath/__init__.py

@@ -1,11 +1,7 @@
-# type: ignore[attr-defined]
+# mypy: disable-error-code="attr-defined"
 """Cat files w/ headers"""
 
-try:
-    from importlib.metadata import version, PackageNotFoundError
-except ImportError:  # pragma: no cover
-    from importlib_metadata import version, PackageNotFoundError
-
+from importlib.metadata import PackageNotFoundError, version
 
 try:
     __version__ = version(__name__)

python_cath/__main__.py

@@ -1,23 +1,21 @@
-# type: ignore[attr-defined]
+# mypy: disable-error-code="attr-defined"
 
-import os
-import random
-from enum import Enum
-from typing import List, Optional
+from typing import List
 
 import typer
-from rich.console import Console
-
 from python_cath import __version__
-from python_cath.example import hello
+from python_cath.concat import concat
+from rich.console import Console
 
 app = typer.Typer(
-    name="python-cath", help="Cat files w/ headers", add_completion=False,
+    name="python-cath",
+    help="Cat files w/ headers",
+    add_completion=False,
 )
 console = Console()
 
 
-def version_callback(value: bool):
+def version_callback(value: bool) -> None:
     """Prints the version of the package."""
     if value:
         console.print(
@@ -26,16 +24,10 @@ def version_callback(value: bool):
         raise typer.Exit()
 
 
-def concat(file_list, output_file):
-    os.system(f"head -1 {file_list[0]} > {output_file}")
-    for afile in file_list:
-        os.system(f"tail -n +2 {afile} >> {output_file}")
-
-
 @app.command()
 def main(
     file_list: List[str] = typer.Argument(...),
     output_file: str = typer.Argument(...),
-):
-    """Prints a greeting for a giving name."""
+) -> None:
+    """Concatenate CSV files with a shared header into output_file."""
     concat(file_list, output_file)

python_cath/concat.py

@@ -0,0 +1,49 @@
+import os
+import shutil
+
+
+def concat(file_list, output_file):
+    """Concatenate CSV files that share the same header.
+
+    Args:
+        file_list: Paths to input files.
+        output_file: Path to write the concatenated output.
+
+    Raises:
+        ValueError: If no input files are provided, any file has an empty
+            header, an input file path collides with the output file, or
+            file headers differ.
+    """
+    file_list = list(file_list)
+    if not file_list:
+        raise ValueError("file_list must not be empty")
+
+    real_output = os.path.realpath(output_file)
+    for afile in file_list:
+        if os.path.realpath(afile) == real_output:
+            raise ValueError(
+                f"Input file {afile!r} is the same path as the output file"
+            )
+
+    # First pass: read and validate headers one file at a time
+    file_headers = {}
+    for afile in file_list:
+        with open(afile, encoding="utf-8") as fh:
+            header = fh.readline().rstrip("\n")
+        if not header:
+            raise ValueError(f"File {afile!r} has an empty or missing header")
+        file_headers[afile] = header
+
+    unique_headers = set(file_headers.values())
+    if len(unique_headers) > 1:
+        detail = ", ".join(f"{f!r}: {h!r}" for f, h in file_headers.items())
+        raise ValueError(f"Headers do not match: {detail}")
+
+    # Second pass: write output one file at a time
+    shared_header = next(iter(unique_headers))
+    with open(output_file, "w", encoding="utf-8") as out:
+        out.write(shared_header + "\n")
+        for afile in file_list:
+            with open(afile, encoding="utf-8") as fh:
+                fh.readline()  # skip header
+                shutil.copyfileobj(fh, out)

{python_cath-0.2.0.dist-info → python_cath-0.3.0.dist-info}/METADATA

@@ -1,24 +1,27 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: python-cath
-Version: 0.2.0
+Version: 0.3.0
 Summary: Cat files w/ headers
-Home-page: https://github.com/samesense/python-cath
 License: MIT
+License-File: LICENSE
 Author: samesense
 Author-email: candptea@gmail.com
-Requires-Python: >=3.7,<4.0
+Requires-Python: >=3.10,<4.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Dist: importlib_metadata (>=1.6.0,<2.0.0); python_version < "3.8"
-Requires-Dist: pre-commit (>=2.5.1,<3.0.0)
-Requires-Dist: rich (>=2.2.2,<3.0.0)
-Requires-Dist: typer[all] (>=0.2.1,<0.3.0)
+Requires-Dist: pre-commit (>=3.0.0,<4.0.0)
+Requires-Dist: rich (>=10.0.0)
+Requires-Dist: typer[all] (>=0.9.0,<0.10.0)
+Project-URL: Homepage, https://github.com/samesense/python-cath
 Project-URL: Repository, https://github.com/samesense/python-cath
 Description-Content-Type: text/markdown
 
@@ -39,116 +42,6 @@ Description-Content-Type: text/markdown
 Cat files w/ headers
 </div>
 
-## Very first steps
-
-### Initial
-
-1. Initialize `git` inside your repo:
-
-```bash
-git init
-```
-
-2. If you don't have `Poetry` installed run:
-
-```bash
-make download-poetry
-```
-
-3. Initialize poetry and install `pre-commit` hooks:
-
-```bash
-make install
-```
-
-4. Upload initial code to GitHub (ensure you've run `make install` to use `pre-commit`):
-
-```bash
-git add .
-git commit -m ":tada: Initial commit"
-git remote add origin https://github.com/samesense/python-cath.git
-git push -u origin master
-```
-
-### Initial setting up
-
-- Set up [Dependabot](https://docs.github.com/en/github/administering-a-repository/enabling-and-disabling-version-updates#enabling-github-dependabot-version-updates) to ensure you have the latest dependencies.
-- Set up [Stale bot](https://github.com/apps/stale) for automatic issue closing.
-
-### Poetry
-
-All manipulations with dependencies are executed through Poetry. If you're new to it, look through [the documentation](https://python-poetry.org/docs/).
-
-<details>
-<summary>Notes about Poetry</summary>
-<p>
-
-Poetry's [commands](https://python-poetry.org/docs/cli/#commands) are very intuitive and easy to learn, like:
-
-- `poetry add numpy`
-- `poetry run pytest`
-- `poetry build`
-- etc
-
-</p>
-</details>
-
-### Building your package
-
-Building a new version of the application contains steps:
-
-- Bump the version of your package `poetry version <version>`. You can pass the new version explicitly, or a rule such as `major`, `minor`, or `patch`. For more details, refer to the [Semantic Versions](https://semver.org/) standard.
-- Make a commit to `GitHub`.
-- Create a `GitHub release`.
-- And... publish 🙂 `poetry publish --build`
-
-## What's next
-
-Well, that's up to you. I can only recommend the packages and articles that helped me.
-
-Packages:
-
-- [`Typer`](https://github.com/tiangolo/typer) is great for creating CLI applications.
-- [`Rich`](https://github.com/willmcgugan/rich) makes it easy to add beautiful formatting in the terminal.
-- [`FastAPI`](https://github.com/tiangolo/fastapi) is a type-driven asynchronous web framework.
-- [`IceCream`](https://github.com/gruns/icecream) is a little library for sweet and creamy debugging
-
-Articles:
-
-- [Open Source Guides](https://opensource.guide/)
-- [GitHub Actions Documentation](https://help.github.com/en/actions)
-- Maybe you would like to add [gitmoji](https://gitmoji.carloscuesta.me/) to commit names. This is really funny. 😄
-
-## 🚀 Features
-
-For your development we've prepared:
-
-- Supports for `Python 3.7` and higher.
-- [`Poetry`](https://python-poetry.org/) as the dependencies manager. See configuration in [`pyproject.toml`](https://github.com/samesense/python-cath/blob/master/pyproject.toml) and [`setup.cfg`](https://github.com/samesense/python-cath/blob/master/setup.cfg).
-- Power of [`black`](https://github.com/psf/black), [`isort`](https://github.com/timothycrosley/isort) and [`pyupgrade`](https://github.com/asottile/pyupgrade) formatters.
-- Ready-to-use [`pre-commit`](https://pre-commit.com/) hooks with formatters above.
-- Type checks with the configured [`mypy`](https://mypy.readthedocs.io).
-- Testing with [`pytest`](https://docs.pytest.org/en/latest/).
-- Docstring checks with [`darglint`](https://github.com/terrencepreilly/darglint).
-- Security checks with [`safety`](https://github.com/pyupio/safety) and [`bandit`](https://github.com/PyCQA/bandit).
-- Well-made [`.editorconfig`](https://github.com/samesense/python-cath/blob/master/.editorconfig), [`.dockerignore`](https://github.com/samesense/python-cath/blob/master/.dockerignore), and [`.gitignore`](https://github.com/samesense/python-cath/blob/master/.gitignore). You don't have to worry about those things.
-
-For building and deployment:
-
-- `GitHub` integration.
-- [`Makefile`](https://github.com/samesense/python-cath/blob/master/Makefile#L89) for building routines. Everything is already set up for security checks, codestyle checks, code formatting, testing, linting, docker builds, etc. More details at [Makefile summary](#makefile-usage)).
-- [Dockerfile](https://github.com/samesense/python-cath/blob/master/docker/Dockerfile) for your package.
-- `Github Actions` with predefined [build workflow](https://github.com/samesense/python-cath/blob/master/.github/workflows/build.yml) as the default CI/CD.
-- Always up-to-date dependencies with [`@dependabot`](https://dependabot.com/) (You will only [enable it](https://docs.github.com/en/github/administering-a-repository/enabling-and-disabling-version-updates#enabling-github-dependabot-version-updates)).
-- Automatic drafts of new releases with [`Release Drafter`](https://github.com/marketplace/actions/release-drafter). It creates a list of changes based on labels in merged `Pull Requests`. You can see labels (aka `categories`) in [`release-drafter.yml`](https://github.com/samesense/python-cath/blob/master/.github/release-drafter.yml). Works perfectly with [Semantic Versions](https://semver.org/) specification.
-
-For creating your open source community:
-
-- Ready-to-use [Pull Requests templates](https://github.com/samesense/python-cath/blob/master/.github/PULL_REQUEST_TEMPLATE.md) and several [Issue templates](https://github.com/samesense/python-cath/tree/master/.github/ISSUE_TEMPLATE).
-- Files such as: `LICENSE`, `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, and `SECURITY.md` are generated automatically.
-- [`Stale bot`](https://github.com/apps/stale) that closes abandoned issues after a period of inactivity. (You will only [need to setup free plan](https://github.com/marketplace/stale)). Configuration is [here](https://github.com/samesense/python-cath/blob/master/.github/.stale.yml).
-- [Semantic Versions](https://semver.org/) specification with [`Release Drafter`](https://github.com/marketplace/actions/release-drafter).
-
 ## Installation
 
 ```bash
@@ -168,7 +61,7 @@ python-cath --help
 ```
 
 ```bash
-python-cath --name Roman
+python-cath file1 file2 outfile
 ```
 
 or if installed with `Poetry`:
@@ -178,7 +71,7 @@ poetry run python-cath --help
 ```
 
 ```bash
-poetry run python-cath --name Roman
+poetry run python-cath file1 file2 outfile
 ```
 
 ### Makefile usage

python_cath-0.3.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+python_cath/__init__.py,sha256=jWtDUGUgV39IeDqwlQ9ziOy9ceofcf1hsppd2C_t9Yw,250
+python_cath/__main__.py,sha256=t3LBYcsZ4lcNo4SUc828O6DoeCZmKlAPazDNfd1n9K8,788
+python_cath/concat.py,sha256=RYSWSePSbdWI9JlzFlIVtoa7rH1-LmiruorjDc9jKZY,1731
+python_cath/example.py,sha256=LGLU6ShWSJtu2zPbGXmQJw5ktJkNlGnRhFjY8OTlePM,366
+python_cath/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_cath-0.3.0.dist-info/METADATA,sha256=CwdIGPs5Gmh6nwDtwfLr_VXqGRyYeJ4f7RpXV9XpmJ4,7674
+python_cath-0.3.0.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
+python_cath-0.3.0.dist-info/entry_points.txt,sha256=CKAIA5eO7sx0McMvZxxXm01CYasNWeOfB3MWbkNcP7I,56
+python_cath-0.3.0.dist-info/licenses/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_cath-0.3.0.dist-info/RECORD,,

{python_cath-0.2.0.dist-info → python_cath-0.3.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry 1.0.10
+Generator: poetry-core 2.3.1
 Root-Is-Purelib: true
 Tag: py3-none-any

python_cath-0.2.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-python_cath/__init__.py,sha256=HIJeYPnh_ZqTjg5-1pf6_VFBPCMeva5APJJkOfYH2wc,352
-python_cath/__main__.py,sha256=g1nyvrk8xV1R2xDYYAjizoDA3A6Gi8lULxzi17LU0fs,965
-python_cath/example.py,sha256=LGLU6ShWSJtu2zPbGXmQJw5ktJkNlGnRhFjY8OTlePM,366
-python_cath/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-python_cath-0.2.0.dist-info/entry_points.txt,sha256=CKAIA5eO7sx0McMvZxxXm01CYasNWeOfB3MWbkNcP7I,56
-python_cath-0.2.0.dist-info/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-python_cath-0.2.0.dist-info/WHEEL,sha256=Q99itqWYDhV793oHzqzi24q7L7Kdiz6cb55YDfTXphE,84
-python_cath-0.2.0.dist-info/METADATA,sha256=n-dcIO0A0jCe-8vQPDt05fewI5ZU5e1l3fw0Aa8NSCM,13310
-python_cath-0.2.0.dist-info/RECORD,,