Skip to content

Commit

Permalink
data archive prune, new installation instructions
Browse files Browse the repository at this point in the history
BFG prune just before this commit. Drastically reduce repo size to not track large binary files.
  • Loading branch information
porterhau5 committed Jan 15, 2018
1 parent 3ce0e52 commit 3865b99
Show file tree
Hide file tree
Showing 3 changed files with 43 additions and 12 deletions.
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,16 @@
# Change Log
All notable changes to this project will be documented in this file.

## [2.1.1] - 2018-01-15
### Removed
- data.tar.xz
- Pruned data.tar.xz and data.tar.gz from git history to cut down on repo size. These files will now be included on the Releases page as a binary for each new version.

### Changed
- README updated for new installation instructions
- wordsmith.rb updated for new installation instructions


## [2.1.0] - 2018-01-11
### Added
- World geonames (11,332,168 new words)
Expand Down
38 changes: 28 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,27 +2,45 @@

The aim of Wordsmith is to assist with creating tailored wordlists and usernames that are primarilly based on geolocation.

authors: [@hackerjiv](https://twitter.com/hackerjiv) & [@porterhau5](https://twitter.com/porterhau5)
Authors: [@hackerjiv](https://twitter.com/hackerjiv) & [@porterhau5](https://twitter.com/porterhau5).

Wild West Hackin' Fest 2017 [presentation](https://www.youtube.com/watch?v=-ZNNA7Z0JGM).

Wordsmith Parsers project: https://github.com/skahwah/wordsmith_parsers
Wordsmith Parsers project: https://github.com/skahwah/wordsmith_parsers.

#### Installation

On first run, Wordsmith will unpack some files from data.tar.xz. This may take a few seconds.
Start by cloning the repo or downloading the latest release:

``` shell
$ git clone https://github.com/skahwah/wordsmith.git
Cloning into 'wordsmith'...
remote: Counting objects: 651, done.
remote: Compressing objects: 100% (23/23), done.
Receiving objects: 100% (651/651), 166.45 MiB | 2.20 MiB/s, done.
Resolving deltas: 100% (337/337), done.
remote: Counting objects: 165, done.
remote: Compressing objects: 100% (62/62), done.
remote: Total 165 (delta 55), reused 117 (delta 55), pack-reused 48
Receiving objects: 100% (165/165), 61.99 KiB | 1.05 MiB/s, done.
Resolving deltas: 100% (92/92), done.
```

Then download the latest `data.tar.xz` from the Releases page and place it into the wordsmith directory:
``` shell
$ cd wordsmith
$ ruby wordsmith.rb
wordsmith v2.1.0
wordsmith v2.1.1
Written by: Sanjiv Kawa (@hackerjiv) & Tom Porter (@porterhau5)

[!] data/regions.csv and data.tar.xz not detected! Try downloading data.tar.xz:
$ wget https://github.com/skahwah/wordsmith/releases/download/v2.1.1/data.tar.xz

[!] If data.tar.xz is downloaded, then try changing to the wordsmith directory.

$ wget https://github.com/skahwah/wordsmith/releases/download/v2.1.1/data.tar.xz
```

On next run, Wordsmith will unpack some files from `data.tar.xz` to complete the installation. This may take a few seconds:
``` shell
$ ruby wordsmith.rb
wordsmith v2.1.1
Written by: Sanjiv Kawa (@hackerjiv) & Tom Porter (@porterhau5)

[*] Hello new wordsmither!
Expand All @@ -36,7 +54,7 @@ Written by: Sanjiv Kawa (@hackerjiv) & Tom Porter (@porterhau5)

``` shell
$ ruby wordsmith.rb
wordsmith v2.1.0
wordsmith v2.1.1
Written by: Sanjiv Kawa (@hackerjiv) & Tom Porter (@porterhau5)

Usage: ruby wordsmith.rb [options]
Expand Down Expand Up @@ -103,7 +121,7 @@ Info Options:
#### Command Examples
```
$ ruby wordsmith.rb -E
wordsmith v2.1.0
wordsmith v2.1.1
Written by: Sanjiv Kawa (@hackerjiv) & Tom Porter (@porterhau5)
Input names:
Expand Down
7 changes: 5 additions & 2 deletions wordsmith.rb
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,8 @@

# Print the title of the program on run
def title()
puts "wordsmith v2.1.0"
@version = "v2.1.1"
puts "wordsmith #{@version}"
puts "Written by: Sanjiv Kawa (@hackerjiv) & Tom Porter (@porterhau5)"
puts ""
end
Expand Down Expand Up @@ -984,8 +985,10 @@ def checkFiles()
if File.exist?(dataCheck) == false || File.exist?(regionsCheck) == false
archiveCheck = "data.tar.xz"
if File.exist?(archiveCheck) == false
puts "[!] data/regions.csv and data.tar.xz not detected! Try changing to the wordsmith directory."
puts "[!] data/regions.csv and data.tar.xz not detected! Try downloading data.tar.xz:"
puts " $ wget https://github.com/skahwah/wordsmith/releases/download/#{@version}/data.tar.xz"
puts ""
puts "[!] If data.tar.xz is downloaded, then try changing to the wordsmith directory."
abort
elsif File.exist?(dataCheck) == false
puts "[*] Hello new wordsmither!"
Expand Down

0 comments on commit 3865b99

Please sign in to comment.