Skip to content

Commit 10b8fbe

Browse files
authored
Merge pull request #4 from Inventitech/macos
Readme improvements
2 parents 7777ceb + 633f1e2 commit 10b8fbe

File tree

3 files changed

+32
-57
lines changed

3 files changed

+32
-57
lines changed

README.md

Lines changed: 32 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@ strans
22
======
33

44
[![Build Status](https://travis-ci.com/Inventitech/strans.svg?token=1pPnTvKwseJq7cTLeeFE&branch=master)](https://travis-ci.com/Inventitech/strans)
5+
![LOC](https://tokei.rs/b1/github/inventitech/strans)
6+
[![Github Releases](https://img.shields.io/github/downloads/inventitech/strans/total.svg)](https://github.com/Inventitech/strans/releases)
7+
[![Join the chat at https://gitter.im/inventitech/strans](https://badges.gitter.im/inventitech/strans.svg)](https://gitter.im/inventitech/strans?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
8+
59

610
`strans` (string transform) is an intuitive string manipulation
711
utility for the shell (primarily Unix, but should work™
@@ -13,22 +17,35 @@ apply them to the input given on STDIN.
1317
How to Install
1418
==============
1519

16-
The easiest way to run `strans` is by installing it via flatpak. It
17-
assumes that you have the
20+
`strans` is distributed as an AppImage for Linux and as a DMG for MacOs.
21+
Download the latest `strans` from
22+
[releases](https://github.com/Inventitech/strans/releases).
23+
24+
## Linux
25+
Our AppImage should run on practically any recent linux Desktop distribution.
26+
27+
After downloading, simply do
1828

19-
`flatpak install flathub org.freedesktop.Platform//18.08 org.freedesktop.Sdk//18.08`
29+
`
30+
chmod +x strans-linux.AppImage
31+
./strans-linux.AppImage
32+
`
2033

21-
runtime installed on your system.
34+
To install it system-wide as `strans`, just
2235

23-
After downloading the latest `strans.flatpak` from
24-
[releases](https://github.com/Inventitech/strans/releases), install it
25-
via
36+
`sudo cp strans-linux.AppImage /usr/bin/strans`
2637

27-
`sudo flatpak install strans.flatpak`
38+
## MacOs
39+
After mounting the `dmg` and copying `strans.app` into `/Applications`, it might be necessary to
2840

29-
> Note: This standalone Flatpak package will not auto-update.
41+
```
42+
chmod +x /Applications/strans.app/Contents/MacOS/strans
43+
/Applications/strans.app/Contents/MacOS/strans
44+
```
45+
to run `strans`.
46+
3047

31-
How to Run
48+
How to Use
3249
==========
3350
```
3451
# With before and after example
@@ -77,7 +94,7 @@ without StackOverflow and Perl, but instead with pure joy!
7794

7895
```
7996
printf "Moritz Beller\nGeorgios Gousios" |
80-
dotnet strans.dll -b "First Last" -a "FL"
97+
strans -b "First Last" -a "FL"
8198
```
8299

83100
neatly outputs
@@ -109,7 +126,7 @@ and call
109126

110127
```
111128
printf "Moritz Beller\nGeorgios Gousios\nAndy Emil Zaidman" |
112-
dotnet strans.dll --example-file example-transformations
129+
strans --example-file example-transformations
113130
```
114131

115132
And, voila, the output is
@@ -125,8 +142,8 @@ transformation rule that satisfies all examples given to it. Simply
125142
having the last FML example would not be enough, because it would miss
126143
the case where only two names are available.
127144

128-
How to Build for Developing
129-
===========================
145+
How to Develop
146+
==============
130147

131148
You need [dotnet](https://dotnet.microsoft.com/) to run `strans`.
132149

@@ -137,7 +154,7 @@ dotnet restore
137154
dotnet publish -c Release
138155
```
139156

140-
An alias (in your bashrc, ...) makes `strans` integrate seamlessly in
157+
An alias (in your bashrc, ...) can make `strans` integrate seamlessly in
141158
a Unix environment:
142159

143160
```

com.inventitech.strans.appdata.xml

Lines changed: 0 additions & 20 deletions
This file was deleted.

com.inventitech.strans.json

Lines changed: 0 additions & 22 deletions
This file was deleted.

0 commit comments

Comments
 (0)