ramsey/uuid-console

A console application for generating UUIDs with ramsey/uuid.

ramsey/uuid-console

A console application for generating UUIDs with ramsey/uuid , _(*1)

, _(*2)

About

ramsey/uuid-console is a console application for generating UUIDs with ramsey/uuid., _(*3)

This project adheres to a code of conduct. By participating in this project and its community, you are expected to uphold this code., _(*4)

Installation

Install this package as a dependency using Composer., _(*5)

composer require ramsey/uuid-console

This will install a reference to the console tool in ./vendor/bin/uuid., _(*6)

Usage

If installed in your project, you may execute the console application from the command line:, _(*7)

$ ./vendor/bin/uuid

If installed globally using Composer, ensure your global Composer installation is in your PATH (it's usually somewhere like ~/.composer/vendor/bin). Then, you may execute it:, _(*8)

$ uuid

Please be aware that some systems may already have a command line application named uuid installed, so this might create a conflict if anything using your PATH expects the other uuid tool., _(*9)

You can generate UUIDs:, _(*10)

$ ./vendor/bin/uuid generate
afe1296a-660b-11e5-bd9f-3c15c2caed47

By default, the application generates version 1 (time-based) UUIDs, but you may specify other versions:, _(*11)

$ ./vendor/bin/uuid generate 4
54478f1d-8b9d-4bf9-8767-1a23010d48a7

You may also decode UUIDs to get information about them:, _(*12)

$ ./vendor/bin/uuid decode afe1296a-660b-11e5-bd9f-3c15c2caed47
 ========= ========== =========================================
  encode:   STR:       afe1296a-660b-11e5-bd9f-3c15c2caed47
            INT:       233784006064090443909084029429027106119
  decode:   variant:   RFC 4122
            version:   1 (time and node based)
            content:   time:  2015-09-28T18:06:49+00:00
                       clock: 15775 (usually random)
                       node:  3c:15:c2:ca:ed:47
 ========= ========== =========================================

For help, just type ./vendor/bin/uuid and read the help information., _(*13)

Contributing

Contributions are welcome! To contribute, please familiarize yourself with CONTRIBUTING.md., _(*14)

Coordinated Disclosure

Keeping user information safe and secure is a top priority, and we welcome the contribution of external security researchers. If you believe you've found a security issue in software that is maintained in this repository, please read SECURITY.md for instructions on submitting a vulnerability report., _(*15)

Copyright and License

The ramsey/uuid-console library is copyright © Ben Ramsey and licensed for use under the MIT License (MIT). Please see LICENSE for more information., _(*16)