Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rdeits/crypticcrosswords.jl
Cryptic crossword clue solver written in Julia
https://github.com/rdeits/crypticcrosswords.jl
Last synced: 2 days ago
JSON representation
Cryptic crossword clue solver written in Julia
- Host: GitHub
- URL: https://github.com/rdeits/crypticcrosswords.jl
- Owner: rdeits
- License: other
- Created: 2019-01-13T09:22:42.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-01-04T22:43:52.000Z (almost 3 years ago)
- Last Synced: 2024-11-11T15:03:27.768Z (4 days ago)
- Language: Julia
- Homepage:
- Size: 165 KB
- Stars: 8
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# CrypticCrosswords
[![Build Status](https://github.com/rdeits/CrypticCrosswords.jl/workflows/CI/badge.svg)](https://github.com/rdeits/CrypticCrosswords.jl/actions?query=workflow%3ACI) [![codecov.io](http://codecov.io/github/rdeits/CrypticCrosswords.jl/coverage.svg?branch=master)](http://codecov.io/github/rdeits/CrypticCrosswords.jl?branch=master) [![DOI](https://zenodo.org/badge/165487213.svg)](https://zenodo.org/badge/latestdoi/165487213)
This package implements a fully automated solver for cryptic crossword clues in the Julia programming language. It works by building up a formal context-free grammar describing the way cryptic clues tend to be structured, then parsing the given clue using that grammar. Each valid parse is solved and checked to see if it produces a coherent wordplay and definition.
This package was adapted from my prior work in Python, which can still be found at https://github.com/rdeits/cryptics . The Julia implementation is significantly more powerful and flexible, as it also includes a custom chart parser (powered by [ChartParsers.jl](https://github.com/rdeits/ChartParsers.jl)) with support for probabilistic grammars. As a result, the Julia implementation can consistently handle longer clues which would have completely stumped the older Python version.
## Status: Experimental
This package is still under active development, and its interfaces will continue to evolve. For examples of basic usage, check out the the solver tests in [test/clues.jl](test/clues.jl) and the derivation tests in [test/derivations.jl](test/derivations.jl). For a simple web server that allows interactive cryptic clue solving, see [CrypticServer.jl](https://github.com/rdeits/CrypticServer.jl/).
## Additional License Information
This package relies on several useful corpora, all of which have their own licenses attached. These corpora will be downloaded automatically when you install this package.
### mhl-abbreviations
The cryptic crossword abbreviations list was originally compiled by Ross Beresford and posted to rec.puzzles.crosswords in 1992. That post can be found here: . The updated list is maintained by Mark Longair at .
### WordNet 3.0
> WordNet Release 3.0 This software and database is being provided to you, the LICENSEE, by Princeton University under the following license. By obtaining, using and/or copying this software and database, you agree that you have read, understood, and will comply with these terms and conditions.: Permission to use, copy, modify and distribute this software and database and its documentation for any purpose and without fee or royalty is hereby granted, provided that you agree to comply with the following copyright notice and statements, including the disclaimer, and that the same appear on ALL copies of the software, database and documentation, including modifications that you make for internal use or for distribution. WordNet 3.0 Copyright 2006 by Princeton University. All rights reserved. THIS SOFTWARE AND DATABASE IS PROVIDED "AS IS" AND PRINCETON UNIVERSITY MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PRINCETON UNIVERSITY MAKES NO REPRESENTATIONS OR WARRANTIES OF MERCHANT- ABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE LICENSED SOFTWARE, DATABASE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS. The name of Princeton University or Princeton may not be used in advertising or publicity pertaining to distribution of the software and/or database. Title to copyright in this software, database and any associated documentation shall at all times remain with Princeton University and LICENSEE agrees to preserve same.
### OpenOffice-MyThes-1.0
> Copyright 2003 Kevin B. Hendricks, Stratford, Ontario, Canada
> And Contributors. All rights reserved.
>
> Redistribution and use in source and binary forms, with or without
> modification, are permitted provided that the following conditions
> are met:
>
> 1. Redistributions of source code must retain the above copyright
> notice, this list of conditions and the following disclaimer.
>
> 2. Redistributions in binary form must reproduce the above copyright
> notice, this list of conditions and the following disclaimer in the
> documentation and/or other materials provided with the distribution.
>
> 3. All modifications to the source code must be clearly marked as
> such. Binary redistributions based on modified source code
> must be clearly marked as modified versions in the documentation
> and/or other materials provided with the distribution.
>
> THIS SOFTWARE IS PROVIDED BY KEVIN B. HENDRICKS AND CONTRIBUTORS
> ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
> LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
> FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
> KEVIN B. HENDRICKS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
> INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
> BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
> LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
> HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
> LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
> OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
> SUCH DAMAGE.### SCOWL-wordlist-en_US-large
> COPYRIGHT, SOURCES, and CREDITS:
> The English dictionaries come directly from SCOWL
> and is thus under the same copyright of SCOWL. The affix file is
> a heavily modified version of the original english.aff file which was
> released as part of Geoff Kuenning's Ispell and as such is covered by
> his BSD license. Part of SCOWL is also based on Ispell thus the
> Ispell copyright is included with the SCOWL copyright.
>
> The collective work is Copyright 2000-2016 by Kevin Atkinson as well
> as any of the copyrights mentioned below:
>
> Copyright 2000-2016 by Kevin Atkinson
>
> Permission to use, copy, modify, distribute and sell these word
> lists, the associated scripts, the output created from the scripts,
> and its documentation for any purpose is hereby granted without fee,
> provided that the above copyright notice appears in all copies and
> that both that copyright notice and this permission notice appear in
> supporting documentation. Kevin Atkinson makes no representations
> about the suitability of this array for any purpose. It is provided
> "as is" without express or implied warranty.
>
> Alan Beale also deserves special credit as he has,
> in addition to providing the 12Dicts package and being a major
> contributor to the ENABLE word list, given me an incredible amount of
> feedback and created a number of special lists (those found in the
> Supplement) in order to help improve the overall quality of SCOWL.
>
> The 10 level includes the 1000 most common English words (according to
> the Moby (TM) Words II [MWords] package), a subset of the 1000 most
> common words on the Internet (again, according to Moby Words II), and
> frequently class 16 from Brian Kelk's "UK English Wordlist
> with Frequency Classification".
>
> The MWords package was explicitly placed in the public domain:
>
> The Moby lexicon project is complete and has
> been place into the public domain. Use, sell,
> rework, excerpt and use in any way on any platform.
>
> Placing this material on internal or public servers is
> also encouraged. The compiler is not aware of any
> export restrictions so freely distribute world-wide.
>
> You can verify the public domain status by contacting
>
> Grady Ward
> 3449 Martha Ct.
> Arcata, CA 95521-4884
>
> [email protected]
> [email protected]
>
> The "UK English Wordlist With Frequency Classification" is also in the
> Public Domain:
>
> Date: Sat, 08 Jul 2000 20:27:21 +0100
> From: Brian Kelk
>
> > I was wondering what the copyright status of your "UK English
> > Wordlist With Frequency Classification" word list as it seems to
> > be lacking any copyright notice.
>
> There were many many sources in total, but any text marked
> "copyright" was avoided. Locally-written documentation was one
> source. An earlier version of the list resided in a filespace called
> PUBLIC on the University mainframe, because it was considered public
> domain.
>
> Date: Tue, 11 Jul 2000 19:31:34 +0100
>
> > So are you saying your word list is also in the public domain?
>
> That is the intention.
>
> The 20 level includes frequency classes 7-15 from Brian's word list.
>
> The 35 level includes frequency classes 2-6 and words appearing in at
> least 11 of 12 dictionaries as indicated in the 12Dicts package. All
> words from the 12Dicts package have had likely inflections added via
> my inflection database.
>
> The 12Dicts package and Supplement is in the Public Domain.
>
> The WordNet database, which was used in the creation of the
> Inflections database, is under the following copyright:
>
> This software and database is being provided to you, the LICENSEE,
> by Princeton University under the following license. By obtaining,
> using and/or copying this software and database, you agree that you
> have read, understood, and will comply with these terms and
> conditions.:
>
> Permission to use, copy, modify and distribute this software and
> database and its documentation for any purpose and without fee or
> royalty is hereby granted, provided that you agree to comply with
> the following copyright notice and statements, including the
> disclaimer, and that the same appear on ALL copies of the software,
> database and documentation, including modifications that you make
> for internal use or for distribution.
>
> WordNet 1.6 Copyright 1997 by Princeton University. All rights
> reserved.
>
> THIS SOFTWARE AND DATABASE IS PROVIDED "AS IS" AND PRINCETON
> UNIVERSITY MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
> IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PRINCETON
> UNIVERSITY MAKES NO REPRESENTATIONS OR WARRANTIES OF MERCHANT-
> ABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE
> LICENSED SOFTWARE, DATABASE OR DOCUMENTATION WILL NOT INFRINGE ANY
> THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
>
> The name of Princeton University or Princeton may not be used in
> advertising or publicity pertaining to distribution of the software
> and/or database. Title to copyright in this software, database and
> any associated documentation shall at all times remain with
> Princeton University and LICENSEE agrees to preserve same.
>
> The 40 level includes words from Alan's 3esl list found in version 4.0
> of his 12dicts package. Like his other stuff the 3esl list is also in the
> public domain.
>
> The 50 level includes Brian's frequency class 1, words appearing
> in at least 5 of 12 of the dictionaries as indicated in the 12Dicts
> package, and uppercase words in at least 4 of the previous 12
> dictionaries. A decent number of proper names is also included: The
> top 1000 male, female, and Last names from the 1990 Census report; a
> list of names sent to me by Alan Beale; and a few names that I added
> myself. Finally a small list of abbreviations not commonly found in
> other word lists is included.
>
> The name files form the Census report is a government document which I
> don't think can be copyrighted.
>
> The file special-jargon.50 uses common.lst and word.lst from the
> "Unofficial Jargon File Word Lists" which is derived from "The Jargon
> File". All of which is in the Public Domain. This file also contain
> a few extra UNIX terms which are found in the file "unix-terms" in the
> special/ directory.
>
> The 55 level includes words from Alan's 2of4brif list found in version
> 4.0 of his 12dicts package. Like his other stuff the 2of4brif is also
> in the public domain.
>
> The 60 level includes all words appearing in at least 2 of the 12
> dictionaries as indicated by the 12Dicts package.
>
> The 70 level includes Brian's frequency class 0 and the 74,550 common
> dictionary words from the MWords package. The common dictionary words,
> like those from the 12Dicts package, have had all likely inflections
> added. The 70 level also included the 5desk list from version 4.0 of
> the 12Dics package which is in the public domain.
>
> The 80 level includes the ENABLE word list, all the lists in the
> ENABLE supplement package (except for ABLE), the "UK Advanced Cryptics
> Dictionary" (UKACD), the list of signature words from the YAWL package,
> and the 10,196 places list from the MWords package.
>
> The ENABLE package, mainted by M Cooper ,
> is in the Public Domain:
>
> The ENABLE master word list, WORD.LST, is herewith formally released
> into the Public Domain. Anyone is free to use it or distribute it in
> any manner they see fit. No fee or registration is required for its
> use nor are "contributions" solicited (if you feel you absolutely
> must contribute something for your own peace of mind, the authors of
> the ENABLE list ask that you make a donation on their behalf to your
> favorite charity). This word list is our gift to the Scrabble
> community, as an alternate to "official" word lists. Game designers
> may feel free to incorporate the WORD.LST into their games. Please
> mention the source and credit us as originators of the list. Note
> that if you, as a game designer, use the WORD.LST in your product,
> you may still copyright and protect your product, but you may *not*
> legally copyright or in any way restrict redistribution of the
> WORD.LST portion of your product. This *may* under law restrict your
> rights to restrict your users' rights, but that is only fair.
>
> UKACD, by J Ross Beresford , is under the
> following copyright:
>
> Copyright (c) J Ross Beresford 1993-1999. All Rights Reserved.
>
> The following restriction is placed on the use of this publication:
> if The UK Advanced Cryptics Dictionary is used in a software package
> or redistributed in any form, the copyright notice must be
> prominently displayed and the text of this document must be included
> verbatim.
>
> There are no other restrictions: I would like to see the list
> distributed as widely as possible.
>
> The 95 level includes the 354,984 single words, 256,772 compound
> words, 4,946 female names and the 3,897 male names, and 21,986 names
> from the MWords package, ABLE.LST from the ENABLE Supplement, and some
> additional words found in my part-of-speech database that were not
> found anywhere else.
>
> Accent information was taken from UKACD.
>
> The VarCon package was used to create the American, British, Canadian,
> and Australian word list. It is under the following copyright:
>
> Copyright 2000-2016 by Kevin Atkinson
>
> Permission to use, copy, modify, distribute and sell this array, the
> associated software, and its documentation for any purpose is hereby
> granted without fee, provided that the above copyright notice appears
> in all copies and that both that copyright notice and this permission
> notice appear in supporting documentation. Kevin Atkinson makes no
> representations about the suitability of this array for any
> purpose. It is provided "as is" without express or implied warranty.
>
> Copyright 2016 by Benjamin Titze
>
> Permission to use, copy, modify, distribute and sell this array, the
> associated software, and its documentation for any purpose is hereby
> granted without fee, provided that the above copyright notice appears
> in all copies and that both that copyright notice and this permission
> notice appear in supporting documentation. Benjamin Titze makes no
> representations about the suitability of this array for any
> purpose. It is provided "as is" without express or implied warranty.
>
> Since the original words lists come from the Ispell distribution:
>
> Copyright 1993, Geoff Kuenning, Granada Hills, CA
> All rights reserved.
>
> Redistribution and use in source and binary forms, with or without
> modification, are permitted provided that the following conditions
> are met:
>
> 1. Redistributions of source code must retain the above copyright
> notice, this list of conditions and the following disclaimer.
> 2. Redistributions in binary form must reproduce the above copyright
> notice, this list of conditions and the following disclaimer in the
> documentation and/or other materials provided with the distribution.
> 3. All modifications to the source code must be clearly marked as
> such. Binary redistributions based on modified source code
> must be clearly marked as modified versions in the documentation
> and/or other materials provided with the distribution.
> (clause 4 removed with permission from Geoff Kuenning)
> 5. The name of Geoff Kuenning may not be used to endorse or promote
> products derived from this software without specific prior
> written permission.
>
> THIS SOFTWARE IS PROVIDED BY GEOFF KUENNING AND CONTRIBUTORS ``AS IS'' AND
> ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
> IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
> ARE DISCLAIMED. IN NO EVENT SHALL GEOFF KUENNING OR CONTRIBUTORS BE LIABLE
> FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
> DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
> OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
> HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
> LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
> OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
> SUCH DAMAGE.