Skip to content

Latest commit

 

History

History
106 lines (78 loc) · 4.29 KB

README.md

File metadata and controls

106 lines (78 loc) · 4.29 KB

ramsey/uuid-console

Gitter Chat Source Code Latest Version Software License Build Status HHVM Status Scrutinizer Coverage Status Total Downloads

ramsey/uuid-console is a console application for generating UUIDs with ramsey/uuid.

This project adheres to a Contributor Code of Conduct. By participating in this project and its community, you are expected to uphold this code.

Installation

The preferred method of installation is via Packagist and Composer.

composer require ramsey/uuid-console

This will install a reference to the console tool in ./vendor/bin/uuid.

Examples

If installed in your project, you may execute the console application from the command line:

$ ./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:

$ 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.

You can generate UUIDs:

$ ./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:

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

You may also decode UUIDs to get information about them:

$ ./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.

Contributing

Contributions are welcome! Please read CONTRIBUTING for details.

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.