Skip to content

Commit

Permalink
Merge pull request #59 from StoicLoofah/39-v1_release
Browse files Browse the repository at this point in the history
v1 release
  • Loading branch information
StoicLoofah authored May 18, 2018
2 parents a76c954 + db816b8 commit 34e6aa5
Show file tree
Hide file tree
Showing 3 changed files with 31 additions and 23 deletions.
9 changes: 8 additions & 1 deletion CHANGELOG.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,14 @@
CHANGELOG
============

0.8.0 -
1.0.0 - May 18, 2018
--------------------
* Added support for protocol 48258 through 64469
* Update game data and scripts for generating game data
* Fix ggtracker/sc2reader CircleCI build for python 3
* Added support for parsing Co-op replays

0.8.0 - December 16, 2016
---------------------------
* Merged into ggtracker/sc2reader, which mostly means that we have a bunch of parsing fixes. Thanks @StoicLoofah!

Expand Down
39 changes: 20 additions & 19 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -12,16 +12,16 @@ Who Uses sc2reader?

sc2reader is currently powering:

* Websites: `ggtracker.com`_, `gamereplays.org`_, `sc2companion.com`_
* Websites: `gggreplays.com`_, `gamereplays.org`_, `spawningtool.com`_
* Tools: `The Core`_
* Experiments: `Midi Conversion`_

If you use sc2reader and you would like your tool, site, project, or implementation listed above, drop us a line on our `mailing list`_ or stop by our #sc2reader IRC channel and say hi!


.. _ggtracker.com: http://ggtracker.com
.. _gggreplays.com: http://gggreplays.com
.. _gamereplays.org: http://www.gamereplays.org/starcraft2/
.. _sc2companion.com: http://sc2companion.com
.. _spawningtool.com: https://lotv.spawningtool.com
.. _The Core: http://www.teamliquid.net/forum/viewmessage.php?topic_id=341878
.. _Midi Conversion: https://github.com/obohrer/sc2midi

Expand All @@ -47,7 +47,7 @@ Replays can be parsed for the following general types of information:
- Unfiltered Unit commands (attack, move, train, build, psi storm, etc)
- Camera Movements for all players and observers.

Replays from release 2.0.8 on ward make additional state information available:
Replays from release 2.0.8 onward make additional state information available:

- Unit states - creation time, positions, and deaths times
- Player resource stats - collection rates/unspent totals
Expand Down Expand Up @@ -142,7 +142,7 @@ If you want to load a collection of replays, you can use the plural form. Loadin

replays = sc2reader.load_replays('path/to/replay/directory')

.. _sc2reader.scripts: https://github.com/GraylinKim/sc2reader/tree/master/sc2reader/scripts
.. _sc2reader.scripts: https://github.com/ggtracker/sc2reader/tree/upstream/sc2reader/scripts


Loading Maps
Expand Down Expand Up @@ -214,46 +214,46 @@ or with setuptools (specify a valid x.x.x)::
cd sc2reader-x.x.x
python setup.py install

Releases to PyPi can be very delayed (sorry!), for the latest and greatest you are encouraged to install from Github master.
Releases to PyPi can be very delayed (sorry!), for the latest and greatest you are encouraged to install from Github upstream.


From Github
--------------------------

Github master is generally stable with development branches more unstable.
Github upstream is generally stable with development branches more unstable.

We use `travis-ci`_ to provide a record of our `continuous testing`_ and `coveralls.io`_ provides a record of our `test coverage`_. Please verify that tests are passing before installing development versions.
We use `circle-ci`_ to provide a record of our `continuous testing`_. Please verify that tests are passing before installing development versions.

Install from the latest source on Github with pip::

pip install -e git+git://github.com/GraylinKim/sc2reader#egg=sc2reader
pip install -e git+git://github.com/ggtracker/sc2reader#egg=sc2reader

or with setuptools::

wget -O sc2reader-master.tar.gz https://github.com/GraylinKim/sc2reader/tarball/master
tar -xzf sc2reader-master.tar.gz
cd sc2reader-master
wget -O sc2reader-upstream.tar.gz https://github.com/ggtracker/sc2reader/tarball/upstream
tar -xzf sc2reader-upstream.tar.gz
cd sc2reader-upstream
python setup.py install

.. _travis-ci: https://travis-ci.org/
.. _circle-ci: https://circleci.com/
.. _coveralls.io: https://coveralls.io
.. _test coverage: https://coveralls.io/r/GraylinKim/sc2reader
.. _continuous testing: https://travis-ci.org/GraylinKim/sc2reader
.. _continuous testing: https://circleci.com/gh/ggtracker/sc2reader


For Contributors
-------------------

Contributors should install from an active git repository using setuptools in `develop`_ mode. This will install links to the live code so that local edits are available to external modules automatically::

git clone https://github.com/GraylinKim/sc2reader.git
git clone https://github.com/ggtracker/sc2reader.git
cd sc2reader
python setup.py develop

Please review the `CONTRIBUTING.md`_ file and get in touch with us before doing too much work. It'll make everyone happier in the long run.

.. _develop: http://peak.telecommunity.com/DevCenter/setuptools#development-mode
.. _CONTRIBUTING.md: https://github.com/GraylinKim/sc2reader/blob/master/CONTRIBUTING.md
.. _CONTRIBUTING.md: https://github.com/ggtracker/sc2reader/blob/upstream/CONTRIBUTING.md


Testing
Expand All @@ -273,8 +273,8 @@ When repeatedly running tests it can be very helpful to make sure you've set a l
To run just one test:

SC2READER_CACHE_DIR=local_cache PYTHONPATH=. python -m unittest test_replays.test_all.TestReplays.test_38749


Good luck, have fun!


Expand All @@ -290,7 +290,7 @@ Issues and Support
We have an `issue tracker`_ on Github that all bug reports and feature requests should be directed to. We have a `mailing list`_ with Google Groups that you can use to reach out for support. We are generally on FreeNode in the #sc2reader and can generally provide live support and address issues there as well.

.. _mailing list: http://groups.google.com/group/sc2reader
.. _issue tracker: https://github.com/GraylinKim/sc2reader/issues
.. _issue tracker: https://github.com/ggtracker/sc2reader/issues


Acknowledgements
Expand All @@ -310,6 +310,7 @@ and kept this project going.
their `s2protocol`_ full reference implementation.


.. _ggtracker.com: http://ggtracker.com
.. _phpsc2replay: http://code.google.com/p/phpsc2replay/
.. _sc2replay-csharp: https://github.com/ascendedguard/sc2replay-csharp
.. _s2protocol: https://github.com/Blizzard/s2protocol
Expand Down
6 changes: 3 additions & 3 deletions setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@
setuptools.setup(
license="MIT",
name="sc2reader",
version='0.8.0',
version='1.0.0',
keywords=["starcraft 2", "sc2", "replay", "parser"],
description="Utility for parsing Starcraft II replay files",
long_description=open("README.rst").read()+"\n\n"+open("CHANGELOG.rst").read(),

author="Graylin Kim",
author_email="graylin.kim@gmail.com",
author="Kevin Leung",
author_email="kkleung89@gmail.com",
url="https://github.com/ggtracker/sc2reader",

platforms=["any"],
Expand Down

0 comments on commit 34e6aa5

Please sign in to comment.