Skip to main content

GitHub PyPI version PyPI pyversions GitHub Workflow Status

dtrx

"Do The Right eXtraction" - don't remember what set of tar flags or where to pipe the output to extract it? no worries!

TL;DR

pip install dtrx

dtrx yolo.tar.gz

This is a copy-paste of the original dtrx repo, and all credit for this software should be attributed to the original author, Brett Smith @brettcs:

https://github.com/brettcs/dtrx

See the original README for more details on what this does!

Changes in this repo

This repo contains some patches on top of the original source to enable using dtrx with python3. The original motivation was to enable dtrx on Ubuntu 20.04+, where the dtrx apt package was removed from the default ppas (likely due to being python2 only).

Development

Contributions

Contributions are gladly welcomed! Feel free to open a Pull Request with any changes.

Issues

When posting an issue, it can be very handy to provide any example files (for example, the archive that failed to extract) or reproduction steps so we can address the problem quickly.

Running Tests

The tests are most easily run from Docker. Check out the Dockerfile for how that's set up.

We push a pre-built image to Docker Hub as dtrx-py/dtrx:latest, so you can pull that image and run the tests like so:

docker run --rm -it --volume $(pwd):/workspace ghcr.io/dtrx-py/dtrx:latest \
   bash -c "cp -r /workspace ~/scratch && cd ~/scratch && uv run -- tests/compare.py"

Releases

Releases are tagged in this repo and published to pypi.org. The release process for maintainers is the below steps:

  1. update the version specifier:

    # update the version appropriately uv version X.Y.Z
    ❯ git add pyproject.toml uv.lock
    ❯ git commit  # fill in the commit message
    
  2. create an annotated tag for the release.

     git tag -a {,-m}X.Y.Z
    

    be sure to push the tag, git push --tags.

  3. use the make publish-release command to build and publish to GitHub and PyPi

See the Makefile for details on what that rule does.

Release files for dtrx 8.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dtrx 8.7.1
File Size Uploaded
dtrx-8.7.1.tar.gz 31.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for dtrx 8.7.1
File Interpreter ABI Platform
dtrx-8.7.1-py3-none-any.whl Python 3 none any Details

Total release size: 62.3 kB

Release files / dtrx-8.7.1.tar.gz

Download URL dtrx-8.7.1.tar.gz
Size 31.8 kB
Tags Source
SHA-256 checksum
How to use checksums
d3be625ce7860c82d5159a551bbd215eada8a11cf4f82557e4f77eabc0986e43
BLAKE2b-256 checksum
How to use checksums
12c2e678320a0051cbbe5de91d1836998bac858086852a135441d7d0bfddc1c1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.0

Release files / dtrx-8.7.1-py3-none-any.whl

Download URL dtrx-8.7.1-py3-none-any.whl
Size 30.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f52f022d8b35b286a62122e7a30524b06c2fcf53bf3f2e0386f1617ce4c0c99e
BLAKE2b-256 checksum
How to use checksums
539692e459e0ee61c765ca48725cdb110151b745f9b02c4580237d77838bb07f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.0

Release history Release notifications | RSS feed

This release

8.7.1 This release

2 release files

8.7.0

2 release files

8.6.0

2 release files

8.5.3

2 release files

8.5.2

2 release files

8.5.1

2 release files

8.5.0

2 release files

8.4.0

2 release files

8.3.1

2 release files

8.3.0

2 release files

8.2.2

2 release files

8.2.1

1 release file

8.2.0

1 release file

8.1.0

1 release file

8.0.2

1 release file

8.0.1

1 release file

8.0.0

1 release file

7.1

6.6

6.5

6.4

6.3

6.2

6.1

6.0

5.1

5.0

4.0

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page