### ----------------------------------------------------
### -- ASCII::To::Uni
### -- Licenses: Artistic-2.0
### -- Authors: 
### -- File: README.md
### ----------------------------------------------------
[![Actions Status](https://github.com/raku-community-modules/ASCII-To-Uni/actions/workflows/linux.yml/badge.svg)](https://github.com/raku-community-modules/ASCII-To-Uni/actions) [![Actions Status](https://github.com/raku-community-modules/ASCII-To-Uni/actions/workflows/macos.yml/badge.svg)](https://github.com/raku-community-modules/ASCII-To-Uni/actions) [![Actions Status](https://github.com/raku-community-modules/ASCII-To-Uni/actions/workflows/windows.yml/badge.svg)](https://github.com/raku-community-modules/ASCII-To-Uni/actions)

NAME
====

ASCII::To::Uni - convert operators in Raku source files from ASCII to Unicode

SYNOPSIS
========

```raku
use ASCII::To::Uni;

convert-file($filename);
```

DESCRIPTION
===========

The `ASCII::To::Uni` distribution provides a basic (and incomplete) way to convert operators in your Raku-related source files from an ASCII version to Unicode symbol version.

It doesn't support some operators and has some limitations.

SUBROUTINES
===========

This distribution has two basic subroutines:

convert-file
------------

The `convert-file` subroutine takes a file name and by default point s output to a new file with extension like `file-name.uni.xtension`.

A different path can be set with the `:new-path` named argument. It can rewrite file if the named argument `:rewrite` was specified with a `True` value. However, rewriting is not recommended, since this distribution way still be buggy and can mess up your work.

convert-string
--------------

The `convert-string` subroutine takes read-write string and converts it accordingly to operator table.

HISTORY
-------

This distribution started as `Texas::To::Uni`, but since the use of the term "Texas" has been deprecated in favor of "ASCII", it felt like a good opportunity to change the name when reviving it as a Raku Community module. Note that the old name `Texas::To::Uni` is still available as a use target.

AUTHOR
======

Alexander Kiryuhin

COPYRIGHT AND LICENSE
=====================

Copyright 2016 - 2017 Alexander Kiryuhin

Copyright 2024 Raku Community

This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.



