Skip to main content

Package for handling Mozilla Archive files.

Project description

Package for handling Mozilla Archive files. MAR file format is documented at https://wiki.mozilla.org/Software_Update:MAR

  • Free software: MPL 2.0 license

Usage

To list the contents of a mar:

mar -t complete.mar

To list the contents of a mar with extra detail:

mar -T complete.mar

To extract a mar:

mar -x complete.mar

To extract, and uncompress a bz2 compressed mar:

mar -j -x complete.mar

To verify a mar:

mar -k :mozilla-nightly -v complete.mar

To create a mar, using bz2 compression:

mar -j -c complete.mar *

To create a mar, using xz compression:

mar -J -c complete.mar *

To create a signed mar:

mar -J -c complete.mar -k private.key -H nightly -V 123 tests

Installation

pip install mar

Documentation

https://mar.readthedocs.io/en/latest/

Development

To run the all tests run:

tox

Changelog

3.2.0 (2022-09-01)

  • Dropped python3.6 support

  • Added python3.9 and python3.10 support

  • Fixed file descriptor leaks

3.1.0 (2019-02-19)

  • Added new autograph stage public key

  • Dropped python3.5 support

3.0.0 (2018-09-06)

  • Support extracting mar hash for external signing, and injecting signatures into unsigned files.

  • File modes are set on extraction

  • mar -v can now verify that unsigned mar files are well formed

  • Added helper productinfo property to MarReader to allow convenient access to the product information information

  • Internal signing API changed: * Got rid of Verifier/Signer classes

  • Internal API for the mar format changed: * offets added for the beginning and end of signature and additional blocks * correctly represent additional section padding

  • Support MAR files without additional sections

2.3.0 (2018-07-23)

  • Remove deprecated usage of signature generation and verification in cryptography library. This changes the type of object returned by the make_signer and make_verifier functions.

2.2.3 (2018-01-18)

  • Update dependencies; dependencies are now also pinned in setup.py

  • Correct the key size in exception messages

  • Fix for construct 2.8.22 and higher

  • Fix for hypothesis 3.44.16

2.2.2 (2017-07-06)

  • Fix bug when writing MAR files: the index size was incorrect

  • Support writing interable streams

  • Add new Mozilla SHA384 public keys

2.2.1 (2017-08-23)

  • Output compression and signature type

2.1.0 (2017-06-28)

  • Implement XZ compression

2.0.0 (2017-01-12)

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mar-3.2.0.tar.gz (65.3 kB view details)

Uploaded Source

Built Distribution

mar-3.2.0-py2.py3-none-any.whl (30.7 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file mar-3.2.0.tar.gz.

File metadata

  • Download URL: mar-3.2.0.tar.gz
  • Upload date:
  • Size: 65.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for mar-3.2.0.tar.gz
Algorithm Hash digest
SHA256 dd032cf72b65c62fb4e58e04a347076fda41f84265b41dd248098cc11e396c6e
MD5 f022d0c7aa67039d97dcd51bc1cee05a
BLAKE2b-256 f666a0ee69da5b331edf51f7660f87febe55bfd3890dee6951b051ca3aec2c16

See more details on using hashes here.

File details

Details for the file mar-3.2.0-py2.py3-none-any.whl.

File metadata

  • Download URL: mar-3.2.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 30.7 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for mar-3.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 602f64a99fb2db578a3d76c9f1ac3efd29bd5f8f0ae8568759fb205162b017d0
MD5 29b33cf2f1f1d68a73b40e0fa097929a
BLAKE2b-256 56bbe189fe0876bb33c23cbdceb54affdeba5751f810907eacbd8d8e429d5699

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page